A variable should be added to the Action Flow, where you can bind it to one of the Recorder Variables and set its value and other properties.

Transcription

1 Variables Using Variables from Action Library you can assign the following values to Recorder variables: Random value, Constant value, Expression result. Actions Library Actions Description How to Use Variables Random Value String Date Number Table List Boolean Constant Value Number String Date Table List Boolean Expression Value Number Variable List Variable Table Variable Number Format Reformat String Convert Number to String Convert String to Number Date Format Reformat String Convert Date to String Convert String to Date How to Use Variables A variable should be added to the Action Flow, where you can bind it to one of the Recorder Variables and set its value and other properties. The types of Action Library Variables correspond to the types of the Recorder Variables. The Recorder Variables should be declared before binding to the Action Library Variables. Random Value The Random Value variable is used to generate a value at random according to pre-defined mask. The Random Value variable has the following properties: Variable a Recorder Variable which gets the value from the Random Value variable. The type of the value is the same as the type of the respective Recorder Variable declared in Recorder Variables list. Randomize options the rules to generate the random value. The rules are specific for each type of variables: String

2 A random text generated according to the following patterns: String length the length of the generated value Character set the list of characters to be used to generate the value. The characters can be: alpha the value will contain alphabetical characters only numeric the value will contain numeric characters only alpha-numeric both alphabetic and numerical characters are used to generate the value Date A random date is picked up from the time span between the first and last dates defined: from the first date for the time span

3 to the last date for the time span Number A random number generated according to the following patterns: Pick a number between the range to take the number from integer only integer numbers are used decimal the number contains a decimal part Table

4 A random table generated according to the following patterns: Rows number of rows in the table Columns number of columns in the table Character set the list of characters to be used to generate the content for table cells. The characters can be: alpha the value will contain alphabetical characters only numeric the value will contain numeric characters only alpha-numeric both alphabetic and numerical characters are used to generate the value List

5 A random list generated according to the following patterns: Create a random list with length the maximum number of items in the list Character set the list of characters to be used to generate the list items. The characters can be: alpha the value will contain alphabetical characters only numeric the value will contain numeric characters only alpha-numeric both alphabetic and numerical characters are used to generate the value Boolean true or false is written by random (no pre-selection is possible). Constant Value The Constant Value Action is used to assign a constant value to the Recorder Variable. The Constant Value Action has the following properties: Variable a Recorder Variable which gets the value from the Constant Value. The type of the value is the same as the type of the Recorder Variable which the Action Variable is bound to. Value the value to be assigned. The value corresponds to the type of the Recorder Variable, where the value is set to: Number

6 Set value enter the constant number value String Set value enter the string constant value Date

7 Table Fixed a date is selected by the user Current date the current date is set automatically during playback

8 Modify table click the button to create/modify the table: Define the numbers of rows and columns and enter the content in the cells. List

9 Modify list click the button to create/modify the list: Add or delete elements to/from the list. Boolean

10 select true or false. Expression Value The Expression Value has two functions, depending on the type of the assigned variable: with a variable of Number type, it computes a value from operations with a number of the Recorder variables; with a variable of List type, it appends a text or content from another list to the list; or gets a size of the list and saves the size to a numeric variable; with a variable of Table type, it appends content of a list to the table either as a row or a column; or gets the number of table rows or columns and saves the size to the respective numeric variable. The Expression Value variable has the following properties: Number Variable Variable a Recorder Variable which gets the value computed in the expression. Attention

11 Expressions can be used with numeric values only. The Recorder Variables serving as inputs for the expression and to store the result should be defined as "Number". Expression a sequence of operators and variables that performs a combination of the actions to compute a value. Attention A variable for expression has the following syntax: ${variablename} Variable syntax in Expression where variablename is a name of a Recorder Variable. The following expressions are supported: "*" multiplication "/" division "+" sum "-" subtraction "%" remainder after division (for example, 13%6 =1) "()" precedence of operators List Variable Push (append) the content from a List or String variable is appended to the List variable assigned to the action

12 Get size the length of the list is calculated and saved to a Number variable: Table Variable Push (append) the content from a List variable is appended to the Table variable assigned to the Action as a row or a column.

13 Get size the number of rows or columns in the table is calculated and saved to a Number variable: Number Format The Number Format Action enables conversions of number values to/from string values and has got three functions: Reformat string extracts a number value in a pre-defined format from a string variable, applies another format to the extracted number value and saves the result to a string variable; Convert number to string converts a number variable value to a string value using a pre-defined format and saves the result to a string variable; Convert string to number converts a string variable value to a number value using a pre-defined format and saves the result to a number variable. Reformat String The Reformat String option helps changing the format of the number value containing in a string.

14 Input a String value or a Recorder Variable of String type containing a value. Input string a string value defined either explicitly or as a Recorder Variable to extract the numerical part from according to the pre-defined format. Format a format that applies a mask to extract the Number from the string value. The format can be selected from Presets or user-defined. Show Presets opens a list of preset formats defining how to parse the value from the Input string. Locale regional settings that define the decimal symbol. The selected locale is applied to both the preset and the custom formats. Attention The decimal symbol in the Input string should match with that one defined by Location. The characters, which do not match the format defined, are skipped starting from the first such character found. Ouput a Recorder Variable of String type to save the resulting value. Select variable a dropdown to choose a Recorder Variable to save the resulting string value to. Format a format to be applied to the resulting string value. The format can be selected from Presets or user-defined. Show presets opens a list of preset formats to be applied to the resulting string value. Locale regional settings that define the decimal and digit grouping symbols. The selected locale is applied to both the preset and the custom formats.

15 Example Input Input string 123,456,789ABC Format #,##0 Locale English (United States) Output Format 0 Resulting value Convert Number to String The Convert Number to String option is used to convert a number value to a string value in a defined format.

16 Input a Recorder Variable of Number type containing a number value to be converted to a string. Select variable a dropdown to choose a Recorder Variable with a number value to be converted. Ouput a Recorder Variable of String type to save the converted value. Select variable a dropdown to choose a Recorder Variable to save the resulting string value to. Format a format to be applied to the resulting string value. The format can be selected from Presets or user-defined. Show presets opens a list of preset formats to be applied to the resulting string value. Locale regional settings that define the decimal and digit grouping symbols.the selected locale is applied to both the preset and the custom formats. Example Input Number Output Format #,##0.00 Locale English (United States)

17 Resulting value 125,477, Convert String to Number The Convert String to Number option is used to extract a number value in a defined format from a string and save it to a Number variable to process further as a number value. Input a string value to be converted to a number. Input string a string value defined either explicitly or as a Recorder Variable to extract the numerical part from according to the pre-defined format. Format a format that applies a mask to extract the Number from the string value. The format can be selected from Presets or user-defined. Show Presets opens a list of preset formats defining how to parse the value from the Input string. Locale regional settings that define the decimal symbol. The selected locale is applied to both the preset and the custom formats. Attention The decimal symbol in the Input string should match with that one defined by Location.

18 The characters, which do not match the format defined, are skipped starting from the first such character found. Ouput a Recorder Variable of Number type to save the converted value. Select variable a dropdown to choose a Recorder Variable to save the resulting number value to. Example Input String 125,477, USD Format #,##0 Locale English (United States) Resulting value Date Format The Date Format Action enables conversions of dates and time using different formats and has got three functions: Reformat string extracts a date or/and time in a pre-defined format from a string variable, applies another format to the extracted date /time and saves the result to a string variable; Convert date to string converts a DateTime variable value to a string value using a pre-defined format and saves the result to a string variable; Convert string to date converts a string variable value to a date/time value using a pre-defined format and saves the result to a DateTime variable. Reformat String The Reformat String option helps changing the format of the date/time value containing in a string.

19 Input a String value or a Recorder Variable of String type containing a value. Input string a string value defined either explicitly or as a Recorder Variable to extract the date from according to the predefined format. Format a format that applies a mask to extract the date from the string value. The format can be selected from Presets or user-defined. Show Presets opens a list of preset formats defining how to parse the value from the Input string. Locale regional settings that define the short and long date format and the time format. The selected locale is applied to both the preset and the custom formats. Attention The the date and time formats including separators in the Input string should match with that one defined by Location. Ouput a Recorder Variable of String type to save the resulting value. Select variable a dropdown to choose a Recorder Variable to save the resulting string value to. Format a format to be applied to the resulting string value. The format can be selected from Presets or user-defined. Show presets opens a list of preset formats to be applied to the resulting string value. Locale regional settings that define the short and long date format and the time format. The selected locale is applied to both the preset and the custom formats. Example

20 Input Input string 30/01/18 Format dd/mm/yy Locale English (United States) Output Format yyyy-mm-dd Resulting value Convert Date to String The Convert Date to String option can be used to change the format of the date/time to the required directly without any other actions such as Text or applications like Notepad. For example, when the date is used in file names, but the separator (/) is not the proper one.

21 Input a Recorder Variable of DateTime type containing a date/time value to be converted to a string. Attention The the date and time formats in the Recorder Variable are defined in the regional settings of the operating system. Select variable a dropdown to choose a Recorder Variable with a number value to be converted. Ouput a Recorder Variable of String type to save the converted value. Select variable a dropdown to choose a Recorder Variable to save the resulting string value to. Format a format to be applied to the resulting string value. The format can be selected from Presets or user-defined. Show presets opens a list of preset formats to be applied to the resulting string value. Locale regional settings that define the short and long date format and the time format.the selected locale is applied to both the preset and the custom formats. Example Input Date 2018-Jan-30 15:00:00 (CET) Output Format EEEE, dd MMMM, yyy, HH:mm:ss

22 Locale Chinese (China) Resulting value, 30, 2018, 15:00:00 Convert String to Date The Convert String to Date option can be used to change the format of the date/time acquired from other applications or files to correspond to the format, which is set up on the machine where RPA Express runs. Input a string value to be converted to a date/time. Input string a string value defined either explicitly or as a Recorder Variable to extract the date/time from according to the predefined format. Format a format that applies a mask to extract the date/time from the string value. The format can be selected from Presets or user-defined. Show Presets opens a list of preset formats defining how to parse the value from the Input string. Locale regional settings that define the short and long date format and the time format. The selected locale is applied to both the preset and the custom formats. Attention

23 The the date and time formats including separators in the Input string should match with that one defined by Location. Ouput a Recorder Variable of DateTime type to save the converted value. Select variable a dropdown to choose a Recorder Variable to save the resulting number value to. Example Input String 22/01 14:51 Format dd/mm HH:mm Locale English (United States) Resulting value T14:51:00+03:00[CET] Attention The the date and time formats in the Recorder Variable are defined in the regional settings of the operating system.