Mappings Tab - EIS Workflow Messaging - Foundation 24.1 - Foundation 24.1 - Ready - OnBase - external - OnBase/EIS-Workflow-Messaging/Foundation-24.1/EIS-Workflow-Messaging/Configuration/Message-Item-Types/Editing-a-Message-Item-Type/Mappings-Tab - 2024-03-25

EIS Workflow Messaging
Platform
OnBase
Product
EIS Workflow Messaging
Release
Foundation 24.1
License

The Mappings tab allows you to create mappings to extract data from message items and apply the data to OnBase objects. Mappings are supported for up to 10 XML node levels (not including the root node).

Note:

This tab is not available for non-XML message item types.

To map message item type elements to OnBase objects:

  1. Click Add. The Mapping dialog box is displayed.
  2. Enter a name for the map in the Map Name field.
  3. Enter text in the Expression field to define an expression that will result in a value. For information on using the Expression field, see Using the Expression Field.
    When writing an expression as part of a mapping configuration, the XPath is executed before the expression is run. Therefore, when writing an expression for an XPath, it is generally desirable to be able to reference the result of the XPath. To reference the value returned by the XPath so that you can use it as an input value for an expression, use the control word xpathresult.
    For example:
    Append(xpathresult; " - Appended")
    This expression appends the value of " - Appended" to the XPath result, such that if the result of the XPath is Value, the return value for the expression will be Value - Appended.
  4. Select an element or attribute from the XML tree that you want to map.
    For complex elements, mappable attribute names are preceded with the @ prefix. If a complex element contains only attributes, the mappable value of the element is listed in the tree as #Value.
  5. Select one of the following options:

    • None: Select this option if you do not want to map the selected element to any OnBase object. This option is selected by default.

    • Property: Select this option to map the selected value to a Workflow property from the persistent property bag. Type the name of the Workflow property in the available field.

    • Keyword: Select this option to map the selected value to an OnBase Keyword Type. Select the Keyword Type from the available drop-down field.

    • Application: Select this option to map the selected value to a WorkView attribute. Select the application that contains the class that contains the relevant attribute from the Application drop-down list.

      • Class: Select the class that contains the relevant attribute from the Class drop-down list.

      • Attribute: Select the WorkView attribute you want to map to the selected value. Select the WorkView attribute from the available drop-down list.

        Select the Use attribute for matching option if multiple related WorkView objects exist and the mapper should only apply to the specific related objects that contain the matching attribute value. This option is not available for interaction unless a relationship attribute is selected from the Attribute drop-down list.

  6. Click Map. The selected XSD element is mapped to the selected OnBase object.
  7. Once you have finished mapping all relevant elements, click OK.