Setting locale values

You set locale values on an application or batch object to validate the language and regional settings for that node. You can dynamically override the locale values that are inherited by the child nodes of the batch object. To override these locale values, assign a different locale value to the child node.

About this task

You can set locale variables at the following levels:
System-wide locale settings
Use the Windows Regional and Language settings.
Applications that use one language or multiple languages
Set the locale value at the application level in the Datacap Application Manager.
Applications with workflows, documents, pages, or fields that use different languages
Set the locale value at any node level in the DCO or on an action that is bound to a node.

Procedure

To set the locale on an application or on the nodes in an application:

  1. Assign a locale value to an application.
    1. In the Start menu select IBM Datacap Services Datacap Application Manager.
    2. In the Applications pane, select the application for which you want to set the locale.
    3. Click the Main tab.
    4. In the Locale field, select the language that you want and press Enter. You can select the System option from the Locale language list to reset the locale value.
      When you set the locale in the Datacap Application Manager, at run time the specified value is automatically created. The value is created in the hr_locale variable at the batch level of the runtime DCO.
    5. Run the following steps. Set the locale property on the action to change this value at run time when you must change the current language during task execution.
  2. Set the locale value on nodes in the DCO:
    1. In Datacap Studio, click the Document Hierarchy tab.
    2. Click the Lock DCO for Editing icon to lock the application for editing.
    3. Select the node to which you want to set the locale.
    4. Right-click and select Manage Variables and then click New.
    5. Type hr_locale and press Enter.
    6. Type the language code for the hr_locale.
    7. Click Done, then click Save Changes.
    8. Select the node and click the Properties tab to verify that hr_locale was added.
    9. Click Unlock DCO.
  3. Set the locale property on the action:
    1. In Datacap Studio, click the Rulemanager tab.
    2. Select the ruleset for which you want to set the locale.
    3. Click Lock ruleset for Editing.
      Locking the ruleset does not lock the DCO.
    4. Add the rrSet action to the ruleset.
      Important: The rrSet action must precede the action on the node to which you want to set the locale property.
    5. Using smart parameter syntax, configure the rrSet action to set the hr_locale variable to the locale value that you want.
      For example, use rrSet(en-US,@P.hr_locale) on a Page object or rrSet(en-US,@F.hr_locale) on a field object.
      The locale setting is used on all of the subsequent actions in the ruleset.
    6. Click Save to save the changes to the ruleset.
      The ruleset is published and unlocked.