Create variables
You can create variables and add them to your application.
You cannot create two variables with the same name even if the variable type is different. You can add as many variables as needed and modify them. When you publish the application, the process variables are created for the workflow along with those set as initialization variables.
You cannot create a data model within RPA.
-
On the
Workflow Details tab, select
New adjacent to
Data.
The New dialog box is displayed.
-
Enter a
Name for the variable, such as Customer Name.
By default, the variable name is displayed for the unique identifier. You can change the unique identifier if needed.
-
On the
Type list, select the variable type. The workflow supports
Bool,
Data object,
Date,
Decimal,
Document,
Folder,
Numeric, and
String variable types.
For more information on "Variable types", refer to Tungsten TotalAgility Advanced Studio Help.
For more information on the supporting Folder variable in a workflow, see Workflow: Folder variable support.
-
When you select a Date variable, the
Value is optional
checkbox is displayed. Using this option, you can select whether to use a date variable or a nullable date
variable.
-
If selected, the date is cleared in the "Value" box. When you publish the solution, a nullable date variable is created.
-
If cleared, the current default value is available in the "Value" box. When you publish the solution, a date variable is created.
Once you publish the solution, you cannot switch between the date and the nullable date variable.
-
- Depending on the selected variable type, specify a Value for the variable.
- To set the variable as an initialization variable, select Initialization.
-
You can configure the display properties for Bool, Data object, Date, Decimal, Numeric, and String type variables.
- Label text: By default, the variable name is displayed as the label text. You can change the label text if you wish to display a longer text than the variable name.
- The following table describes the additional display properties as applicable.
Type Display properties Data object
Value: Set the values by selecting the required server or local data model.
The Label text option is not available for the Data object.
Date
-
Show time: If selected, displays the time element at runtime.
-
Min date and Max date: Set the minimum and maximum date values either by selecting the required date and time using the Calendar picker or by selecting fx and using the @Today macro to get the current date or past/future date. For example, to set the date as 5 days from the current date, set the value as @Today+5.
Decimal
-
Min value and Max value: Enter the acceptable range of values for minimum and maximum values. (Default minimum value: -900719925474 and default maximum value: 900719925474)
-
Decimal precision: Enter a value for decimal precision. (Default: 2)
Numeric
-
Min value and Max value: Enter the acceptable range of values for minimum and maximum values. (Default minimum: -2147483648 and default maximum: 2147483647)
String
-
Input type: Select one of the following controls as needed:
Single line
If selected, adds a text box for the single-line fields, such as name.
Multi line
If selected, adds a text box that may be more than one line, such as a customer address.
Drop down If selected, adds a drop-down list based on the selected Data source. Available data source options are:
Lookup Select an existing lookup.
Custom To enter custom data, do the following:
-
Select .
-
Add a Name.
-
Select Add and close.
To quickly add as many values as needed without navigating away, Select Add another.
-
To make it a default value, select Default.
Add more items as needed.
Email If selected, adds a text box to an Email field type.
-
-
Max length: Provide the maximum number of characters allowed to enter in the input type selected above. (Default: 10,000)
-
Mandatory: Select this option to make the input type mandatory.
-
Select
Add another to add as many variables as needed without navigating away from
the dialog box or select
Add and close to close the dialog box.
The variables are added and listed in the Data section. When you publish the application, the process variables are created for the workflow with those set as initialization variables.
-
You can change the display order of the initialization variables (the data required to submit a new workflow request).
-
Select the
Set display order link.
The Display order dialog box is displayed.
- Use to reorder the initialization variables.
-
Select
OK.
The initialization order takes effect only after the first time you publish the application.
-
Select the
Set display order link.
-
When you create a new variable, it is added as an output variable. You can exclude an output variable or change its
display order.
-
Select the
Outputs link.
The Output variables dialog box appears.
-
To change the display order of the variable, select the variable and select .
-
To exclude a variable, clear the Output check box for the variable.
-
- Select OK.
-
Select the
Outputs link.
- Select Save.
Workflow: Folder and Document variable support
You can add documents within the RPA by adding data of type Folder or Document. For the Document variable, by default, Value is Default Document.
In a workflow, the folder and document variables are unavailable for use as key data or within a condition node.
In a solution, when you use a folder or document variable, on publishing the solution:
-
If the Initialize from scan option is selected, it generates the Special_scan form.
-
If the Initialize from scan option is cleared, it generates the Create new job or Activity form.