In certain integration scenarios, it can be useful to make SAP data available for flexible data selection in cascading dropdown lists. This is also possible with JavaScript and REST services in Nintex Forms (see previous example).

In this example, an SAP material number is entered in an input field and the possible hits are displayed in a dropdown list. If a material is selected in the drop-down list, the material text is to be displayed in another field.

Step 1: Define text fields

In our Nintex form we need three fields with designations:

The first field Material Number of type Single Line Textbox is the input field and contains the material number. In the second field Suggested material of type Choice, the possible hits for the material number entered are displayed in a dropdown list and can be selected. The third field Material of type Single Line Textbox displays the material long text for the selected material.


First call the settings for the field Material Number and set the option Store Client ID in JavaScript Variable to Yes.
Enter field_input as the name in the Client ID JavaScript variable name field.


Then call up the settings for the Choice field.
Select Drop down list as the display format and enter e.g. Start typing for Choices. What you enter here does not matter, as the input will be overwritten by JavaScript later (in this example with the sentence Start typing in the input above).
Then set the option Store Client ID in JavaScript Variable to Yes and enter the name field_select in the field Client ID JavaScript variable name.


Then recall the settings for the Single Line Textbox next to Material. Set the option Store Client ID in JavaScript Variable to Yes and enter the name field_output in the field Client ID JavaScript variable name.

Since this is only a display field, you can also define under Appearance that the field is only to be displayed and that no entries are allowed.


Step 2: Insert JavaScript code

Add a reference to our JavaScript library under Form Settings -> Advanced -> Custom JavaScript Includes:


Insert the JavaScript code under Form Settings -> Advanced -> Custom JavaScript.


The function tEcs.executeXql is called in the code to read the material number and the material long text from the SAP table MAKT.

NWF$(document).ready(function() {
    theobald.ready(function() {
        var $ = NWF$,
            // material number input and dropbox
            tsInput = $('#' + field_input),
            // in combobox properties set custom text e.g. "Start typing in the field above..."
            tsSelect = $('#' + field_select),
            // description output
            tsInputDescription = $('#' + field_output),
            // literals
            strings = {
                loading: 'Loading...',
                matches: ' matches',
                noMatchText: 'No direct match!',
                noMatches: 'No matches',
                errComm: 'Communication error, please see console',
                select: 'Please select',
                type: 'Start typing in the input above'
            domOptionString1parameter = '{0}',
            domOptionString = '{0} ({1})',
            // xql query
            xqlString = "SELECT TOP 10 MATNR, MAKTX FROM MAKT WHERE (MATNR LIKE '%{0}%' OR MAKTX LIKE '%{0}%') AND SPRAS = 'EN'",
            ecsCoreConnection = {
                ecs: {
                    coreApiKey: 'C30B8CD6E8DA474DBDC22CAE1958D14XX',
                    instance: 'SAP',
                    url: ''
            queryFunction = function(val) {
                var tEcsOptions = {
                    data: tEcs.format(xqlString, val)
                    tEcsOptions.connection = ecsCoreConnection;
                return tEcs.executeXql(tEcsOptions);
        var firstOption = tsSelect.find("option:nth-child(1)").clone();
        tsSelect[0].selectedIndex = -1;
        // user types into input, each character triggers search (SAP query)
        tsInput.on('input', function() {
            var newOption = firstOption.clone();
            newOption.prop('selected', 'selected');
                .done(function(data) {
                    var newOptionAfterInput = firstOption.clone();
                    newOptionAfterInput.prop('selected', 'selected');
                    if (data.length > 0) {
                        newOptionAfterInput.text(tEcs.format(domOptionString,, data.length + strings.matches));
                        $.each(data, function(i, v) {
                            var $option = firstOption.clone();
                            $option.text(tEcs.format(domOptionString, tEcs.util.ltrim(v.MATNR, '0'), v.MAKTX));
                            $option.attr('tsdescription', v.MAKTX);
                    } else {
                    tsSelect[0].selectedIndex = 0;
                }).fail(function(xhr, et) {
                    console.log(xhr, et);
        // when user selects an option
        tsSelect.on('change', function() {

For more information see JavaScript Library for REST.

Step 3: Executing the Nintex Form

Now execute the form and enter a material number. The hits for the entry are read from SAP and displayed in the dropdown list (Suggested Materials).


If you select a material from the list, the long text for this material is displayed in the material field.