Window package

Use the Window package to automate tasks relating to the window.

Window is a data type available for storing application window titles. It is the only data type that can be used in all the actions of the Window package. Create a variable of data type Window and select or assign a window title.

Note: When you create a Window type variable, note that selecting Browser as default value supports only Google Chrome tabs whereas selecting Application as default value supports any application window.

Use this variable in any number of actions within the automation task. If the application window title changes, then change the value assigned to the variable. The new application title is reflected in all the actions where the variable is used.

Actions in the Window package

The Window package includes the following actions:


Action	Description
Activate	Activates a window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. In the Window title field, specify the title. Insert a wildcard character () in the Window title field to search for window titles that can change. You can specify one or more wildcards () at the start, middle, or end of the value. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. You can use a regular expression (regex) to identify a window title. Select the regular expression condition as either String or a Pattern and then enter the value. By default, the Window title field is case-sensitive. To identify a browser title, you can enable the Case sensitive option to match the letter case, or disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum Bot Agent version installed on your system is the version that was released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then by default, the window title will be identified only with matching letter case (case-sensitive). For example, you can enter the String value as `((\w)-Notepad` for all window title names starting with `((\w)-Notepad`, or use Pattern value as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. To prevent the run time error, ensure that when you add the string input as `-title`, the application with the specific title is open. The asterisk (``) is just a character, not a wild card character. When you use a regular expression of type Pattern with `-title` as the input value for a window title in any action, the bot might encounter a run time error because the input value `-title` is incorrect. Ensure that you use valid regex patterns.
Assign	Assigns a source window variable's value to a designated window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. In the Select the destination window variable/value field, specify the variable. Note: The regular expression (regex) is currently not supported.
Close	Closes the application window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. Insert a wildcard character () in the Window title field to search for window titles that can change. You can specify one or more wildcards () at the start, middle, or end of the value. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. You can use a regular expression (regex) to identify a window title. Select the regular expression condition as either String or a Pattern and then enter the value. By default, the Window title field is case-sensitive. To identify a browser title, you can enable the Case sensitive option to match the letter case, or disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum Bot Agent version installed on your system is the version that was released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then by default, the window title will be identified only with matching letter case (case-sensitive). For example, you can enter the String value as `((\w)-Notepad` for all window title names starting with `((\w)-Notepad`, or use Pattern value as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. To prevent the run time error, ensure that when you add the string input as `-title`, the application with the specific title is open. The asterisk (``) is just a character, not a wild card character. When you use a regular expression of type Pattern with `-title` as the input value for a window title in any action, the bot might encounter a run time error because the input value `-title` is incorrect. Ensure that you use valid regex patterns. Note: When multiple Excel windows are opened, the bot closes all the open Microsoft Excel windows even when a specific Excel window name is selected to close. When you select Currently active as the window title, to close any active windows, and then run the bot, the Shut Down Windows pop-up is no longer activated, even if there are no active windows on the machine.
Close all	Closes all the windows In the Add window field, you can provide the title of the application windows that you do not want to close. You can also search the window titles by using () as a wildcard character. Specify one or more () wildcards at the start, middle, or end of the title. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. Note: To keep the Bot editor window open, ensure that you add it in the Add window field. For example, enter `Control Room \| Automation Anywhere` in the window title to keep it open.
Get active window title	Retrieves the title of the active window. In the Assign the window title to variable field, specify the variable. The Control Room shows a descriptive default variable name. If you create several output variables, subsequent variable names are appended with a -1, -2, -3, and so on to avoid duplication. Note: The regular expression (regex) is currently not supported.
Maximize	Maximizes a window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. Insert a wildcard character () in the Window title field to search for window titles that can change. You can specify one or more wildcards () at the start, middle, or end of the value. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. You can use a regular expression (regex) to identify a window title. Select the regular expression condition as either String or a Pattern and then enter the value. By default, the Window title field is case-sensitive. To identify a browser title, you can enable the Case sensitive option to match the letter case, or disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum Bot Agent version installed on your system is the version that was released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then by default, the window title will be identified only with matching letter case (case-sensitive). For example, you can enter the String value as `((\w)-Notepad` for all window title names starting with `((\w)-Notepad`, or use Pattern value as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. To prevent the run time error, ensure that when you add the string input as `-title`, the application with the specific title is open. The asterisk (``) is just a character, not a wild card character. When you use a regular expression of type Pattern with `-title` as the input value for a window title in any action, the bot might encounter a run time error because the input value `-title` is incorrect. Ensure that you use valid regex patterns.
Minimize	Minimizes a window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. Insert a wildcard character () in the Window title field to search for window titles that can change. You can specify one or more wildcards () at the start, middle, or end of the value. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. You can use a regular expression (regex) to identify a window title. Select the regular expression condition as either String or a Pattern and then enter the value. By default, the Window title field is case-sensitive. To identify a browser title, you can enable the Case sensitive option to match the letter case, or disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum Bot Agent version installed on your system is the version that was released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then by default, the window title will be identified only with matching letter case (case-sensitive). For example, you can enter the String value as `((\w)-Notepad` for all window title names starting with `((\w)-Notepad`, or use Pattern value as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. To prevent the run time error, ensure that when you add the string input as `-title`, the application with the specific title is open. The asterisk (``) is just a character, not a wild card character. When you use a regular expression of type Pattern with `-title` as the input value for a window title in any action, the bot might encounter a run time error because the input value `-title` is incorrect. Ensure that you use valid regex patterns.
Resize	Resizes a window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. Insert a wildcard character () in the Window title field to search for window titles that can change. You can specify one or more wildcards () at the start, middle, or end of the value. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. You can use a regular expression (regex) to identify a window title. Select the regular expression condition as either String or a Pattern and then enter the value. By default, the Window title field is case-sensitive. To identify a browser title, you can enable the Case sensitive option to match the letter case, or disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum Bot Agent version installed on your system is the version that was released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then by default, the window title will be identified only with matching letter case (case-sensitive). For example, you can enter the String value as `((\w)-Notepad` for all window title names starting with `((\w)-Notepad`, or use Pattern value as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. To prevent the run time error, ensure that when you add the string input as `-title`, the application with the specific title is open. The asterisk (``) is just a character, not a wild card character. When you use a regular expression of type Pattern with `-title` as the input value for a window title in any action, the bot might encounter a run time error because the input value `-title` is incorrect. Ensure that you use valid regex patterns. In the Left, Top, Width, and Height fields, specify values for resizing the window.
Restore	Restores a window. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. Insert a wildcard character () in the Window title field to search for window titles that can change. You can specify one or more wildcards () at the start, middle, or end of the value. For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: Microsoft. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title. You can use a regular expression (regex) to identify a window title. Select the regular expression condition as either String or a Pattern and then enter the value. By default, the Window title field is case-sensitive. To identify a browser title, you can enable the Case sensitive option to match the letter case, or disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum Bot Agent version installed on your system is the version that was released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then by default, the window title will be identified only with matching letter case (case-sensitive). For example, you can enter the String value as `((\w)-Notepad` for all window title names starting with `((\w)-Notepad`, or use Pattern value as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. To prevent the run time error, ensure that when you add the string input as `-title`, the application with the specific title is open. The asterisk (``) is just a character, not a wild card character. When you use a regular expression of type Pattern with `-title` as the input value for a window title in any action, the bot might encounter a run time error because the input value `-title` is incorrect. Ensure that you use valid regex patterns.
Set title	Assigns a new window title to a window variable. In the Window field, select an option: Choose from the Application, Browser, or Variable tab. Application: Select from a list of windows, including browser windows, that are currently open on the Bot Creator device. Browser: Select from a list of supported browser tabs. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Variable: Select an existing window variable to specify the title of the application window title. In the New window title field, enter the new title. Note: The regular expression (regex) is currently not supported.

Automation 360