User-defined variables

Creating a variable using the Variables window

You need to have a robot open to use the Variables window.

• Click Add/Modify button on the Variables pane. The Variables window will appear.

  

• Click the new button and select the type of the variable to create a variable.

• Type name and value and click save.

The initial value depends on the selected variable type. If there is a mismatch between type and value, an error will be shown.

Available types for manual creation

Only the following types of variables can be created using the variable window. There are many more types of Automatic Variables created by activities, they are only for passing data between activities and cannot be created by a user.

Primitives

Type	Assignable Values
String	String and numbers. e.g. 2, abc
Integer	Integers e.g. 123
System.Boolean	Boolean values True, False

Objects

Type	Assignable Values
Date	Date values - 12/05/2012
DateTime	Datetime values - 12-01-2021-12:11:33
File	A path to a file
Folder	A path to a folder
Process	The name of a windows process. e.g. svchost
Application	The name of a windows application. e.g. notepad.exe
List

Advanced

Type	Assignable Values
Computed	A C# script to access properties exposed by the variables.

Detailed Description

Integer

The Integer value type represents negative and positive integers. It can't store a floating-point number or a character.

Properties

Property	Description
RawValue	Gets the value of the variable.
LongValue	Gets the int64 value of the variable.
IntValue	Gets the int32 value of the variable.
RawType	Gets the type of the value of the variable.

Functions

Function	Description
HasIntValue()	Returns a Boolean value indicating whether the variable value is of type int32.
HasLongValue()	Returns a Boolean value indicating whether the variable value is of type int64.

String

A string value stores text information as a collection of characters.

Properties

Property	Description
Length	Gets the number of characters

Functions

Function	Description
Compare(String, Int32, String, Int32, Int32, Boolean)	Compares substrings of two specified String objects, ignoring or honoring their case, and returns an integer that indicates their relative position in the sort order.
Compare(String, String)	Compares two specified String objects and returns an integer that indicates their relative position in the sort order.
Compare(String, String, Boolean)	Compares two specified String objects, ignoring or honoring their case, and returns an integer that indicates their relative position in the sort order.
CompareOrdinal(String, Int32, String, Int32, Int32)	Compares substrings of two specified String objects by evaluating the numeric values of the corresponding Char objects in each substring.
CompareOrdinal(String, String)	Compares two specified String objects by evaluating the numeric values of the corresponding Char objects in each string.
CompareTo(Object)	Compares this instance with a specified Object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified Object.
CompareTo(String)	Compares this instance with a specified String object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified string.
Concat(IEnumerable<String>)	Concatenates the members of a constructed IEnumerable<T> collection of type String.
Concat(Object)	Creates the string representation of a specified object.
Concat(Object, Object)	Concatenates the string representations of two specified objects.
Concat(Object, Object, Object)	Concatenates the string representations of three specified objects.
Concat(Object[])	Concatenates the string representations of the elements in a specified Object array.
Concat(String, String)	Concatenates two specified instances of String.
Concat(String, String, String)	Concatenates three specified instances of String.
Concat(String, String, String, String)	Concatenates four specified instances of String.
Concat(String[])	Concatenates the elements of a specified String array.
Contains(Char)	Returns a value indicating whether a specified character occurs within this string.
Contains(String)	Returns a value indicating whether a specified substring occurs within this string.
EndsWith(Char)	Determines whether the end of this string instance matches the specified character.
EndsWith(String)	Determines whether the end of this string instance matches the specified string.
Equals(Object)	Determines whether this instance and a specified object, which must also be a String object, have the same value.
Equals(String)	Determines whether this instance and another specified String object have the same value.
Equals(String, String)	Determines whether two specified String objects have the same value.
Format(String, Object)	Replaces one or more format items in a string with the string representation of a specified object.
Format(String, Object, Object)	Replaces the format items in a string with the string representation of two specified objects.
Format(String, Object, Object, Object)	Replaces the format items in a string with the string representation of three specified objects.
Format(String, Object[])	Replaces the format item in a specified string with the string representation of a corresponding object in a specified array.
IndexOf(Char)	Reports the zero-based index of the first occurrence of the specified Unicode character in this string.
IndexOf(Char, Int32)	Reports the zero-based index of the first occurrence of the specified Unicode character in this string. The search starts at a specified character position.
IndexOf(Char, Int32, Int32)	Reports the zero-based index of the first occurrence of the specified character in this instance. The search starts at a specified character position and examines a specified number of character positions.
IndexOf(String)	Reports the zero-based index of the first occurrence of the specified string in this instance.
IndexOf(String, Int32)	Reports the zero-based index of the first occurrence of the specified string in this instance. The search starts at a specified character position.
IndexOf(String, Int32, Int32)	Reports the zero-based index of the first occurrence of the specified string in this instance. The search starts at a specified character position and examines a specified number of character positions.
IndexOfAny(Char[])	Reports the zero-based index of the first occurrence in this instance of any character in a specified array of Unicode characters.
IndexOfAny(Char[], Int32)	Reports the zero-based index of the first occurrence in this instance of any character in a specified array of Unicode characters. The search starts at a specified character position.
IndexOfAny(Char[], Int32, Int32)	Reports the zero-based index of the first occurrence in this instance of any character in a specified array of Unicode characters. The search starts at a specified character position and examines a specified number of character positions.
Insert(Int32, String)	Returns a new string in which a specified string is inserted at a specified index position in this instance.
IsNullOrEmpty(String)	Indicates whether the specified string is null or an empty string ("").
IsNullOrWhiteSpace(String)	Indicates whether a specified string is null, empty, or consists only of white-space characters.
Join(Char, Object[])	Concatenates the string representations of an array of objects, using the specified separator between each member.
Join(Char, String[])	Concatenates an array of strings, using the specified separator between each member.
Join(Char, String[], Int32, Int32)	Concatenates an array of strings, using the specified separator between each member, starting with the element in value located at the startIndex position, and concatenating up to count elements.
Join(String, IEnumerable<String>)	Concatenates the members of a constructed IEnumerable<T> collection of type String, using the specified separator between each member.
Join(String, Object[])	Concatenates the elements of an object array, using the specified separator between each element.
Join(String, String[])	Concatenates all the elements of a string array, using the specified separator between each element.
Join(String, String[], Int32, Int32)	Concatenates the specified elements of a string array, using the specified separator between each element.
LastIndexOf(Char)	Reports the zero-based index position of the last occurrence of a specified Unicode character within this instance.
LastIndexOf(Char, Int32)	Reports the zero-based index position of the last occurrence of a specified Unicode character within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string.
LastIndexOf(Char, Int32, Int32)	Reports the zero-based index position of the last occurrence of the specified Unicode character in a substring within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string for a specified number of character positions.
LastIndexOf(String)	Reports the zero-based index position of the last occurrence of a specified string within this instance.
LastIndexOf(String, Int32)	Reports the zero-based index position of the last occurrence of a specified string within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string.
LastIndexOf(String, Int32, Int32)	Reports the zero-based index position of the last occurrence of a specified string within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string for a specified number of character positions.
LastIndexOfAny(Char[])	Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array.
LastIndexOfAny(Char[], Int32)	Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array. The search starts at a specified character position and proceeds backward toward the beginning of the string.
LastIndexOfAny(Char[], Int32, Int32)	Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array. The search starts at a specified character position and proceeds backward toward the beginning of the string for a specified number of character positions.
PadLeft(Int32)	Returns a new string that right-aligns the characters in this instance by padding them with spaces on the left, for a specified total length.
PadLeft(Int32, Char)	Returns a new string that right-aligns the characters in this instance by padding them on the left with a specified Unicode character, for a specified total length.
PadRight(Int32)	Returns a new string that left-aligns the characters in this string by padding them with spaces on the right, for a specified total length.
PadRight(Int32, Char)	Returns a new string that left-aligns the characters in this string by padding them on the right with a specified Unicode character, for a specified total length.
Remove(Int32)	Returns a new string in which all the characters in the current instance, beginning at a specified position and continuing through the last position, have been deleted.
Remove(Int32, Int32)	Returns a new string in which a specified number of characters in the current instance beginning at a specified position have been deleted.
Replace(Char, Char)	Returns a new string in which all occurrences of a specified Unicode character in this instance are replaced with another specified Unicode character.
Replace(String, String)	Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string.
StartsWith(Char)	Determines whether this string instance starts with the specified character.
StartsWith(String)	Determines whether the beginning of this string instance matches the specified string.
Substring(Int32)	Retrieves a substring from this instance. The substring starts at a specified character position and continues to the end of the string.
Substring(Int32, Int32)	Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length.
ToCharArray()	Copies the characters in this instance to a Unicode character array.
ToCharArray(Int32, Int32)	Copies the characters in a specified substring in this instance to a Unicode character array.
ToLower()	Returns a copy of this string converted to lowercase.
ToLowerInvariant()	Returns a copy of this String object converted to lowercase using the casing rules of the invariant culture.
ToString()	Returns this instance of String; no actual conversion is performed.
ToUpper()	Returns a copy of this string converted to uppercase.
ToUpperInvariant()	Returns a copy of this String object converted to uppercase using the casing rules of the invariant culture.
Trim()	Removes all leading and trailing white-space characters from the current string.
Trim(Char)	Removes all leading and trailing instances of a character from the current string.
Trim(Char[])	Removes all leading and trailing occurrences of a set of characters specified in an array from the current string.
TrimEnd()	Removes all the trailing white-space characters from the current string.
TrimEnd(Char)	Removes all the trailing occurrences of a character from the current string.
TrimEnd(Char[])	Removes all the trailing occurrences of a set of characters specified in an array from the current string.
TrimStart()	Removes all the leading white-space characters from the current string.
TrimStart(Char)	Removes all the leading occurrences of a specified character from the current string.
TrimStart(Char[])	Removes all the leading occurrences of a set of characters specified in an array from the current string.

Boolean

A Boolean or System. Boolean type has values of either true or false.

Properties

Property	Description
FalseString	Represents the Boolean value false as a string
TrueString	Represents the Boolean value true as a string.

Functions

None

Object

Object or System. Object variables are generic and they can hold any type of data at run-time.

Accessible properties

None