Defining Lookup Behavior Properties

When editing order and task data in an editor, you can right-click data node behaviors and select Open Properties View to access the behavior properties.You use the Properties view tabs to model Lookup behaviors.

Note:

The level at which you create a behavior (at the data element level, task level, or order level) determines where you access and configure the behavior's properties. See "Creating New Behaviors" for more information.

To define Lookup behavior properties:

  1. From the Design perspective, right-click the behavior and select Open Properties View.

    The Behaviors Properties view is displayed.

  2. Click the Nodeset tab.

  3. In the XPath Expression field, enter the XPath expression that selects the set of data nodes that will comprise the lookup results.

  4. Click the Value/Name tab.

    A default column, called ValueColumn, is displayed in the Value Name table. The OSM server uses this value to populate the data node to which the Lookup behavior is attached.

  5. (Optional) Click Add.

    Design Studio creates an additional column in the drop down list. For example, you can add a second column to create a label for the data retrieved.

  6. Specify the value that OSM server should use for the corresponding data node.

    If you have multiple columns defined in the Value Name table, select the column whose value you want the OSM server to use for the data node, and click Set as Value.

    For example, if you have two columns, a code column and description column, you might elect to have the user make a selection based on the description field, but identify the code column as the value that the OSM server should use to update the task.

  7. In the Name field, enter a name for the selected column value.

  8. In the Node field, enter an XPath expression to define the relative path to the node in the nodeset.

    For example, if the nodeset contains 2 data nodes, you must identify which of the two data nodes the OSM server should retrieve for the select column.

  9. Click the Details tab.

    The Behaviors Properties view Details tab is displayed. The Name, Type, and Path field values are read-only, and cannot be modified on this tab. See "Defining Behavior Detail Properties" for more information about the options that you can define on this page.

  10. Click the Conditions tab.

    Use the Conditions tab to add conditional logic to the Lookup behavior. See "Defining Behavior Condition Properties" for more information about defining conditions for behaviors.

  11. Click the Notes.

    Use the Notes tab to describe the functionality or include internal documentation about the Lookup behavior.