Processing conversion annotations

An annotation on a converted transform shows that although the transform is successful, you might want to review that it behaves as you expect. You can either confirm or reject the annotated transform in your graphical data map.

About this task

If you are using the scenario files, after you follow the steps in Converting the message map your file looks like the following image:

Screen capture of the message map after converting it to a graphical data map.

You can see that MEMBER_NAME_PART.PERSON_GIVEN_NAMES now takes the output from both an If and Else transform. Both transforms have warnings, and there is an annotation on the If transform. Follow the steps to review an annotated transform.


  1. In the Graphical Data Mapping editor, select the If transform that shows a conversion annotation icon. The transform properties are displayed in the Properties view.
  2. In the Properties view, click the Documentation tab to review details about the transform.

    The Documentation tab in the Properties View for the If transform.

    The If transform Documentation field advises that the esql:trim function used in the previous message map, which is not a valid type in a graphical data map, is converted to an XPath fn:normalize-space function. However, the behavior might be changed, and so the text in the field suggests that you should review the transformation.

  3. Review the transformation logic that was created by the conversion to ensure that it produces the correct output for your application.
    You can review the online documentation for XPath expressions to check how fn:normalize-space works. In the scenario, the If transform behavior is correct, so you can accept it.
  4. In the Graphical Data Mapping editor, right-click the transform. Click Accept to remove the warning from this transform.

    An image of a transform warning with available right-click menu options to Accept or Reject this transform, or all transforms in the map.

    Alternatively, after you review all the transforms in a converted map, you can use a menu action to accept or reject all annotated transforms. Select an area of the map so that no transform is selected and right-click the area to open the menu.

  5. Save your updated map.


You resolved all annotations in your graphical data map.

There are still warnings on the child transforms of MEMBER_NAME_PART in the scenario map. The Graphical Data Mapping editor provides a warning here because the map's logic assumes that the input message has PERSON_NAME_PARTS present, which is defined as a choice in the message schema model with PERSON_NAME_WHOLE. For the scenario, this assumption comes from the original message map, and therefore it is valid.

To avoid this warning, and the one on the PERSON_SURNAME mapping, you can add an If or Else check for PERSON_NAME_PARTS or PERSON_NAME_WHOLE. This is an optional task, because warnings do not affect the behavior of the map. You do not have to remove the warnings to complete the scenario.