Automate Schedule - Get variable

Declaration

<AMSKYBOT ACTIVITY="get_variable" SESSION="text" IP="text" PORT="number" USERNAME="text" PASSWORD="text (encrypted)" HTTPS="YES/NO" PROXYTYPE="text (options)" PROXYSERVER="text" PROXYPORT="number" PROXYUSERNAME="text" PROXYPASSWORD="text (encrypted)" VARIABLENAME="text" RESULTVARIABLE="text" />

Related Topics   

Description

Retrieves information about a Automate Schedule variable and populates an existing Automate Desktop variable with results.

NOTE: To retrieve data regarding Automate Schedule variables, you must have View authority to the “Automate Schedule Variables” secured area.

Practical usage

Can be used to retrieve details about a Automate Schedule variable.

Parameters

Connection

Property Type Required Default Markup Description
Connection --- --- --- --- Indicates where this activity's Automate Schedule credentials should originate from. The available options are:
  • Host - Denotes that a custom set of credentials will be entered for this activity. This option is normally selected if only a single Automate Schedule activity is required to complete a task or operation.
  • Session - Denotes that credentials should derive from a session created by a previous Automate Schedule - Create session step. This allows several Automate Schedule activities to be linked to a particular session, eliminating redundancy. Multiple sessions can exist within a single task, allowing several Automate Schedule operations to be automated concurrently.
NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes.

Connection - Session

Property Type Required Default Markup Description
Session Text Yes, if Connection is set to Session Automate ScheduleSession1 SESSION="Session1" The name of the session to associate this activity with. This parameter is active only if the Connection parameter is set to Session. If the Connection parameter is set to Host, this parameter is ignored and the remainder of the parameters specified below becomes active.
NOTE: Use the Automate Schedule - End session activity to end an active Automate Schedule session.

Connection - Host > Credentials

Property Type Required Default Markup Description
Server Number/Text Yes (Empty) IP="xxx.xxx.xxx.xxx" The Domain Name System (DNS) name (for example, www.domain.com) or IP address (for example, xxx.xxx.xxx.xxx ) of the Automate Schedule Server of where to establish communication.
Port Number Yes (Empty) PORT="0880" The TCP/IP port assigned to enable communication with the Automate Schedule server.
User name Text No (Empty) USERNAME="jdoe" A valid username of a user configured to access the Automate Schedule Server.
NOTE: Certain Automate Schedule activities may or may not be permitted depending on the permissions set for the user.
Password Text No (Empty) PASSWORD="text (encrypted)" The correct password for the user entered above.
Session Text Yes (Empty) SESSION="SkySession" The name of the session to use to link to other Automate Schedule activities.
Use Https Yes/No No No HTTPS="YES" If selected, specifies that the server protocol type is HTTPS (secure HTTP). If disabled, the server protocol type is HTTP. This parameter is disabled by default.

Connection - Host > Proxy

Property Type Required Default Markup Description
Proxy type Text (options) No Default
  • PROXYTYPE="none"
  • PROXYTYPE="http"
 The type of proxy required for Automate Schedule connections that pass through a proxy server. The available options are:
  • System default (default) - Points to the default proxy used by the system.
  • None - No proxy authentication required.
  • HTTP - Proxy type authentication is through HTTP.
Use authentication --- --- --- --- If enabled, indicates that proxy authentication is implemented. This parameter is active only if the Proxy type parameter is set to HTTP.
NOTE: This parameter does not contain markup and is only displayed in visual mode for task construction and configuration purposes.
Proxy server Text No (Empty) PROXYSERVER="proxy.host.com" The hostname (server.domain.com) or IP address (xxx.xxx.xxx.xxx) of the proxy server. This parameter is available only if the Proxy type parameter is set to HTTP.
Proxy username Text No (Empty) PROXYUSERNAME="ProxyUser" The proxy username to use to authenticate and establish the connection. This parameter is available only if the Use authentication parameter is enabled.
Proxy password Text No (Empty) PROXYPASSWORD="encrypted" The proxy password to use to authenticate and establish the connection. This parameter is available only if the Use authentication parameter is enabled.
Proxy port Number No 8008 PROXYPORT="8008" The port to use to connect to the proxy server. This parameter is available only if the Proxy type parameter is set to HTTP. The default value is 8008.

Variable

Property Type Required Default Markup Description
Name Text Yes (Empty) VARIABLENAME="theVar" The name of the Automate Schedule variable to retrieve data from. Enter the name manually in the provided text box or click the folder icon to open the Automate Schedule browser which allows connection to the server in order to browse available Automate Schedule variables.
Populate variable with Automate Schedule variable definition Text Yes (Empty) RESULTVARIABLE="theVar" The name of an existing Automate Desktop variable to populate with information about the notification list.

Description

Error Causes

On Error

Additional notes

Enabling Automate Schedule Web Service

By default, Automate Schedule has the web services option disabled. This will prevent Automate Schedule actions from running. To enable the Automate Schedule Web Service, log into Automate Schedule's UI and select from the main menu Admin > System Settings. Scroll down to the Configure Features section and select EDIT. Select Allow Web Service Requests (as shown below) and save the settings.

Example

NOTE:
  • Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
  • To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.

Description

This sample task demonstrates use of the Automate Schedule - List variables and Get variable activities. A List variables step populates a dataset with a list of Automate Schedule variables. A Loop dataset step is then used to loop through the dataset. A Get variable step retrieves the name of an individual variable during each iteration and displays the data in a message dialog.

Copy 
<AMVARIABLE NAME="Var_data" VALUE="" />
<AMSKYBOT SESSION="Skybot_1" IP="10.0.1.69" PORT="8008" USERNAME="admin" PASSWORD="AM4xbZm+mwQN5MGOCNMiHvJ5srNQYnFndV8aME" />
<AMSKYBOT ACTIVITY="list_variable" SESSION="Skybot_1" RESULTDATASET="VarInfo" />
<AMLOOP ACTIVITY="dataset" DATASET="VarInfo"><AMSKYBOT ACTIVITY="get_variable" SESSION="Skybot_1" VARIABLENAME="%VarInfo.VariableName%" RESULTVARIABLE="Var_data" /><AMSHOWDIALOG>%Var_data%</AMSHOWDIALOG></AMLOOP>
<AMSKYBOT ACTIVITY="get_variable" SESSION="Skybot_1" VARIABLENAME="%VarInfo.VariableName%" RESULTVARIABLE="Var_data" />
<AMSHOWDIALOG>%Var_data%</AMSHOWDIALOG>
<AMLOOP ACTIVITY="end" />
<AMSKYBOT ACTIVITY="close_skybot" SESSION="Skybot_1" />