Executing Mapping Check

Use

Mapping needs to be error-free to generate a service. SIW provides you two different mapping checks: the Mapping Completeness Check and the Mapping Check.

Mapping Completeness Check

The Mapping Completeness Check checks if you have entered all names correctly in the system and if there are any inconsistencies in any of your project data names. SIW starts this check automatically when you save your mapping. To see the Mapping Completeness status, double-click your project. The detail screen is displayed. At top of the screen, you can see an icon that indicates the current mapping completeness of your project. The following completeness statuses are possible:

  • The system displays the green icon, if the mapping is complete, and if the mapping check result is error-free.

  • The system shows the red icon, if the mapping is not complete, and/or if the mapping check result contains errors.

Mapping Check

The Mapping Check is relevant only for API-based services with generated ES Repository content. SIW starts it either automatically when you generate a service, or you can start it manually in Service Implementation Workbench or SIW Monitor.

The system checks the following:

  • If all proxy name proposals comply with this prefix,

  • If the specified global data types (GDTs) exist and match the specified core data types (CDTs),

  • If the names of intermediate data types (IDTs) are unique.

    The system checks if the names of the IDTs follow the ES Repository naming conventions. For example, if the core data type is "Identifier" the suffix of the IDT must be ID. If this is not the case, the Mapping Check report displays a warning message.

Prerequisites

You have finished the mapping, which includes the following tasks:

  • You have defined a name for each field (simple type).

  • You have defined a global data type (GDT) or core data type (CDT) for each field (simple type).

  • You have defined a name for each field, for each structure, and table (intermediate data types).

For more information, see Completing Signatures (Mapping).

Procedure

To start the check in the dialog of Service Implementation Workbench, select the Mapping Check pushbutton on the symbol bar of the transaction.

To start the Mapping Check in the SIW Monitor, proceed as follows:

  1. Search for your project (See Finding Projects). The system then displays a list that contains the project data.

  2. Select your project.

  3. Choose Check in the symbol bar and select With extended Mapping Check in the dialog box that is displayed.

  4. Choose Check.

Result

The system then displays a dialog box with all log messages.

To navigate directly to the incorrect mapping entry, double-click the corresponding log message. The system then opens the detail screen of the relevant element without closing the log so that you can correct the mistake immediately. It also displays the relevant mapping element in yellow in the project tree to simplify the correction of your mapping. To update the log, choose the Mapping Check pushbutton again.

In addition, it derives one of the following Mapping statuses:

  • Undetermined

    The system displays the undetermined status, if you have not yet executed a Check. You must check your project to see if the mapping is complete and if all mapping elements of the service signature exist in the ES Repositor.

  • No entry

    The system leaves the field blank, if the service creation type does not use any mapping.

  • Green

    The system displays the green icon, if the mapping in your backend system is complete with all names entered in the system, and if all mapping elements of the service signature exist in the ES Repository.

  • Red

    The system displays the red icon, if there are any inconsistencies in the names of your project data, or if any mapping elements do not exist in the ES Repository. To correct incorrect elements, open the Service Implementation Workbench, open your project in the project tree, and navigate to its mapping node. All erroneous elements are displayed in red. To correct the mistakes, proceed as follows: Check whether you have entered the names of the incorrect elements. If not, enter them now. Check whether the incorrect elements exist in the ES Repository. If not, check your local namespace in the ES Repository and insert the missing elements. For more information, see Completing Signatures (Mapping).