Variables Page

As a developer and object designer, when you create an executable object, you can define variables that are specific to that object and store them with the object. To distinguish them from other types of variables, they are referred to as object variables. You define them on the Variables page of executable objects. The object variables that you have defined on this page can be used throughout the object, including its Process Pages.

The object variables that you define in objects can be inherited by their children.

Notes:

• When you restart an object, the variables are taken from the object definition and not from the referenced execution. The reason for this behavior is that when an error occurs because of an object variable, the user can correct the value in the object. This value is then used also when restarting.
• As opposed to script variables, object and PromptSet variables do not have a particular data type. You can use the script function CONVERT in order to assign a particular data type to the variables. For more information, see Script Variable Data Types.

• To use object variables in scripts you need the :PSET script statement. It dynamically creates an object variable, which is valid for that particular execution. If an object variable of the same name already exists, its value is replaced by the new value.

  If the object variable is modified by using the script elements :SET, :RSET or :READ, the value that has last been assigned is available in the object (Process, Post Process, Child Post Process pages). It is not necessary to explicitly assign this value using the script element :RSET (for example, to the Post Process tab).

To Access the Object Variables

You define and edit object variables on the Variables page of the object.

1. Open the executable object.
2. On the navigation pane, expand Variables & Prompts.
3. Select Variables.

To Add Object Variables

1. Open the executable object.
2. On the navigation pane, expand Variables & Prompts and select Variables.
3. Put your cursor in the Name cell and type the name of the object variable. For more information, see Variable Names.

4. In the Value column you have two options:

   • For simple vales, type it in the cell.
   • For more complex values, click the editor icon and enter the value in the Cell Editor.

   You can specify the values of object variables with or without quotation marks. Both single and double quotation marks are allowed.

   This list explains how the values are resolved depending on how you use the quotation marks:

   • string1234 resolves as string1234
   • 'string1234' resolves as string1234
   • "string1234" resolves as "string1234"
   • string'1234 resolves as string'1234
   • 'string'1234' resolves as string
   • 'string''1234' resolves as string'1234

5. Object variables can be used as external factors for calculating the Estimated Runtime of the object with the adaptive method. For this method to calculate and process the value of the variable correctly, you have to select the correct data type from the Use for adaptive ERT drop-down list.

6. To define whether this object can inherit the object values of its parent object (for example, a Workflow or a Schedule), on the lower half of the page, expand the Settings section. In Inherit from Parent choose one option:

   • All Variables

     The object inherits all variables and VARA objects defined for its parent.

   • Only defined Variables

     The object inherits only the object variables defined for its parent. Prompt Set variables are only inherited if the Prompt Set object complies with these values and the value to be overwritten has not been changed in the Variables page.

   • No Variables

     The object does not inherit any variables from its parent object.

7. Save your changes. You can start using this object variable in any of the attributes of this object that support variables.

See also:

• Inheriting Object and PromptSet Variables
• Examples: Inheriting Object Variables
• Variables and VARA Objects
• Runtime Page