Data Instance Behavior Properties View Data Tab

Use the Properties view Data tab to define the data provider configuration that will interface with the external system.

Field Use

Language

You can declare Data Instance behaviors specific to a given language by using the optional Language attribute. If this attribute is set, OSM automatically selects the appropriate instance using the user's language preferences set in the web browser.

Note: If you declare multiple language-based instances, consider the following:

  • To appear in the Language drop-down list, languages other than the default must be selected from the Oracle Design Studio languages group. See "Defining Language Preferences."

  • One Data Instance behavior is created per language selected.

  • In order to differentiate among language-based behaviors, the system appends (internally) a language code to the data instance name using the "name of the data instance"_"language code" pattern. For example:

    DataInstanceX_en-ca

    The language codes used are from the Oracle Design Studio languages group.

  • If you need to refer to this instance from any other behavior (for example, Lookup), you must specify the full value in the behavior's XPath expression. For example:

    instance('DataInstanceX_en-ca')/lookupEntry

Data Provider

You can reuse an existing data provider configuration for this Data Instance behavior by clicking the Select button. To create a new data provider configuration, click New. After you have selected or created a data provider, click Open to access the Data Provider editor, where you can define input parameters, result documents, and cache settings. Click Clear (red X) to clear the selected value from the field.

Parameters, Expression, Use Default Expression

Select a parameter to define the value for the input parameter that the data provider requires when retrieving the data from the external system. The value is evaluated at runtime and is based on the XPath or XQuery expression you define in the Expression field. Select the Use Default Expression option if you want to use the default values for the input parameters that you defined using the Data Provider editor Interface tab.

You can select a data node from the Order Template tab (when working in the Order editor) or from the Task Data tab (when working in a Task editor) and drag the selected data node into the Parameters field to define the XPath expression.

Note: To drag a data node into the Properties view Data tab, press and hold the Alt key before you select and drag the data node to the XPath Expressions field.

XPath uses path expressions to select data nodes in XML documents. A path expression with a single dot (.) represents the current node. Two dots (..) represents the parent of the current node. A slash (/) represents the root node.

XPath and XQuery fields are limited to 4000 characters.

Inline

Select if you want to make static information available to the task. This option assumes that the information is not located on an external system. When you select this option, you can declare an XML document statically within the XML field.

Note: You can use the Inline option early in development cycles when you know you want to employ a data provider to an external system, but you haven't yet built it. Using the Inline option, you can create an dummy information structure for testing purposes. You can remove the inline XML static information and clear the inline option later in the cycle after you build the data provider configuration. When using the Inline option, consider that there exists no XML validation in the static document field.