Show TOC

Procedure documentationAdding a Data Service for Choosing Banks Locate this document in the navigation structure

 

In this example, you add a second data service to the model, to serve as input for the iView. The user will be able to input a country in the input form and select from a list of banks in that country. You also add a sort operator to sort the results returned by the first data service.

Prerequisites

You have created the model in Creating the Base Model and it is open in Storyboard.

Procedure

  1. Copy-and-paste the first iView. This will retain your original version for future modeling.

    1. Go to the Design board and at the top level (SecondExample) of your model, select the BanksA icon and copy it (clicking the Copy button in the main toolbar or by right-clicking and choosing Copy from the context menu).

    2. Paste the iView onto the workspace and rename it BanksB (using the context menu).

  2. Open (drill down into) the BanksB iView and add a second data service:

    1. Click the Find Data button in the task-panel toolbar and drag BAPI_BANK_GETLIST onto the Design board on the left. You may have to move the existing elements to the right first. In the Define Data Service dialog box, select the BANK_LIST output port and click OK.

    2. You can test the functionality of the Bank Getlist data service (choosing Test Data Service from the context menu) using US, DE or GB as input to the Bank Ctry field and any number for the Max Rows field.

  3. Define the input to the new data service by dragging out from the Input port of Bank Getlist and choosing Add Input Form. In the Select Input Fields dialog box, select both checkboxes. The fields of the form are mapped automatically to the data service.

  4. Define the output from the data service:

    1. Because the data from the Bank Getlist data service should serve as input to the existing Bank Getdetail data service, the Input Form connected to the Input port of Bank Getdetail is not needed. Select it and delete it.

    2. Add a sort operator:

      1. Drag your mouse out from the Bank List output port of Bank Getlist and from the context menu, choose Sort Data. The Sort operator is added to your model.

      2. Double-click on the operator to display the Configure Element task panel.

      3. At the bottom of the task panel, click the Add (Add) button and from the drop-down list in the Sort by column, select BANK_NAME, to indicate that the list should be sorted alphabetically according to bank name. In the Direction column, leave the up option (meaning that the list will be sorted from A to Z).

    3. Add the table view:

      1. Drag out from the output port of the Sort operator and choose Add Table View from the context menu. In the Select Display Fields data box, click Select All at the top and click OK.

      2. Rename the newly-added table view icon: Bank List Table.

      3. All of the fields from the Bank List output port of the Bank Getlist data service will be channeled through the Sort operator to the input port (in) of the Bank List Table. The fields selected for display are listed in the table at the bottom of the Configure Element task panel.

    4. Map the output table to the input of Bank Getdetail:

      1. Drag out from the out port of Bank List Table to the Input port of Bank Getdetail.

      2. Double-click the select line. A list of fields is displayed at the bottom of the Configure Element task panel. Click in the BANKCOUNTRY row, click the fx at the right of the Assigned Value column, and from the drop-down list, select the corresponding field name. This maps the input field of the data service ( InputField column) to the field that is output from the table (Assigned Value column). Do the same for the BANKKEY field.

      3. Click the Input port of the Bank Getdetail data service and select the BANKKEY row. Clear the Required checkbox at the bottom. The data service will not require that field as input from the table.

  5. Rearrange the iView layout by clicking the Layout tab and making the changes you require. You should move the new Input Form to the top left, the Bank Address Form to the top right and the Bank List Table up beneath the Input Form. You may want to change the field labels as well.

  6. Save the iView. It should look similar to the following:

    Adding a Second Data Service to the Model (Adding a Second Data Service to the Model)

  7. Deploy the iView by clicking the Deploy Model (Deploy Model) button in the toolbar.

  8. Export the model (choose   Model   Export to File  ), saving it on your hard disk for subsequent use in this example.