The Information behavior enables you to create labels, hints (tool tips), and help information for data nodes that appear in a web client. Before you define a behavior's properties, you must first create the behavior at either the data element level, task level, or order level.
When editing order and task data in an editor, you can right-click a behavior and select Open Properties View to access the behavior properties.You use the Properties view tabs to model Information 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 Information behavior properties:
From the Design perspective, right-click the behavior and select Open Properties View.
The Behaviors Properties view is displayed.
Click the Labels tab.
In the Language field, select a predefined language in which to display the label to the web client user.
See "Defining Language Preferences" for more information about defining and using languages in Design Studio. See "Defining Information Behaviors in Multiple Languages" for information about how to change the language in which data fields appear in the web client.
In the XPath Expression field, enter an XPath Expression or enter a literal (enclosed by single quotes) to describe the label that you want to display to the web client user.
See "Information Behavior Properties View Labels Tab" for more information about entering XPath expressions.
Click the Hints tab.
In the Language field, select a predefined language in which to display the hint to the web client user when they scroll over the associated field.
See "Defining OSM Preferences" for more information about defining and using languages in Design Studio. See "Defining Information Behaviors in Multiple Languages" for information about how to change the language in which hints are displayed in the web client.
In the XPath Expression field, enter an XPath Expression or enter a literal (enclosed by single quotes) to describe the hint that you want to display to the web client user.
See "Information Behavior Properties View Hints Tab" for more information about entering XPath expressions.
Click the Help tab.
In the Language field, select a predefined language in which to display the help text to the web client user when they click Help button for the associated field.
See "Defining OSM Preferences" for more information about defining and using languages in Design Studio.
In the Topic field, enter the topic name for this help message.
In the Message field, enter the help documentation that will be displayed in the web client when the user clicks the associated field Help button.
Use valid HTML to enter the help message.
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.
Click the Conditions tab.
Use the Conditions tab to add conditional logic to the Information behavior. See "Defining Behavior Condition Properties" for more information about defining conditions for behaviors.
Click the Notes tab.
Use the Notes tab to describe the functionality or include internal documentation about the Information behavior.
Note:
When you define Information behavior properties for a data element with a range where the minimum is zero, the Task web client applies the behavior only when you add a data node. If there are no data nodes, the help or hint does not appear, and the field uses the Display Name from the Data Dictionary.See OSM Concepts for more information about behavior default values, inheritance, and declarative syntax.
Defining Information Behaviors in Multiple Languages
Information Behavior Properties View Labels Tab
Information Behavior Properties View Hints Tab
Information Behavior Properties View Help Tab
About Web Client Behavior Support
You can use Information behaviors to configure web client labels and field level tool tips (called hints in Design Studio) in multiple languages. The configuration that you complete in Design Studio can enable a web client to display field labels and hints in a preferred language when a web client detects changes to Internet browser language preferences.
The following example demonstrates how to define labels in a preferred language. The steps for defining hints are identical, except that you define the language and XPath expression in the Information Properties view Hints tab.
To create labels and hints in multiple languages:
From the Window menu, select Preferences.
The Preferences dialog box is displayed.
In the Preferences dialog box, click Oracle Design Studio.
The Design Studio Language Preferences options are displayed.
Add the language to the group of languages with which you intend to work.
See "Defining OSM Preferences" for more information about adding languages to the Preferences dialog box.
Click OK.
Design Studio closes the Preference dialog box.
Determine at which level you will create the Information behavior.
You can create behaviors at the data, order, and task levels. For example, behaviors defined at the data level apply to the data node in all orders and tasks; behaviors applied at the order level apply to all tasks in the order; and behaviors defined at the task level apply to a single task in the order.
See "Defining Behaviors at the Data Schema Level" for information about creating behaviors at the data schema level.
See "Defining Manual Task Behaviors" for information about creating behaviors at the task level.
See "Defining Order Behaviors" for information about creating behaviors at the order level.
In the Data Schema, Order, or Task editor, select a data node and create the Information behavior.
Right-click the Information behavior icon and select Open Properties View.
The Information Properties view Labels tab is displayed.
In the Information Properties view Labels tab Language field, select the language for which you want to define a label.
No changes to Language field are necessary if you are defining labels in the default language.
Note:
By default, the system uses the Display Name defined for the data node and the default language defined in the Design Studio Preferences dialog box when labeling fields in the web client.In the XPath Expression field, enter the text for the new label.
Use single quotes to wrap the text when entering literals in an XPath expression. See "Information Behavior Properties View Labels Tab" for more information about entering XPath expressions.
Click Save.
Clean, build, and deploy your cartridge to the run-time environment.
See "Packaging and Deploying OSM Cartridges" for more information and cleaning, building, and deploying cartridges.
In the web client, navigate to the browser language preferences to select the language in which you defined your labels and hints.
For example, in Internet Explorer:
Select Tools, Internet Options.
Click Language.
The Language Preferences dialog box is displayed.
Click Add.
The Add Language dialog box is displayed.
Select the language in which you created new field labels or hints in Design Studio.
Click OK.
Select the language, and click Move Up to move the language to the first position.
Click OK.
The system displays the new labels in the web client.
Information Behavior Properties View Labels Tab
Information Behavior Properties View Hints Tab
On the Properties view Labels tab, you can create labels by selecting a language and defining an expression.
| Field | Use |
|---|---|
| Language | You can declare Information 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. |
| XPath Expression | Enter a mathematical expression or an XPath Expression.
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 XPath Expression field to define the XPath expression. To drag a data node into the Properties view Labels 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. |
On the Properties view Hints tab, you can create hints (tool tips) in the web client by selecting a language and defining a message.
| Field | Use |
|---|---|
| Language | You can declare Information 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. |
| XPath Expression | Enter a mathematical expression or an XPath Expression.
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 XPath Expression field to define the XPath expression. To drag a data node into the Properties view Hint 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. |
On the Properties view Help tab, you can create context-sensitive, online help in the web client by selecting a language and defining the help topic and text.
| Field | Use |
|---|---|
| Language | You can declare Information 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. |
| Topic | Enter the topic name for this help message. |
| Message | Enter the help documentation that will be displayed in the web client when the user clicks the associated field Help button.
Note: Use valid HTML to enter the help message. |