Create a server variable

See Server variables

Create server variables in the same manner as process variables.

  1. Navigate to System data > Server variables.

    The Server variables page appears.

  2. Click New.

    The New server variable dialog box is displayed.

  3. Select the Category in which to place your server variable.

    The default is the working category for the current user.

  4. Enter a unique Name for the variable, such as COMPANY_NAME. The variable name should be maximum of 50 characters without any spaces.
    By default, the name of the variable becomes the ID of the variable; however, you can change the ID if needed.
  5. Enter a unique ID for the variable, such as CUSTID.
    For naming convention of name and ID, see Name conventions.
  6. On the Type list, select the data type for the variable, such as Complex. (Default: String)

    Available data types are:

  7. Select, enter or configure a Value for the variable.
    Note
    • To provide a dynamic value, at runtime, leave the Value empty.

    • In some nodes such as Email, C#, VBNET, and Decision, plain text is being replaced by variable with the same name. For example, if you have a variable called ID and if you type the text VOID, the plain text will be replaced by VO[ID]. This only happens at design time; at runtime the values validate and appear correctly.

  8. Select Secure to protect the server variables of type String and Nullable string so that values (for example, passwords) are not human readable can be stored as encrypted values. However, these values can be decrypted as needed within TotalAgility.

    Note
    • This option is only available if the data type is String or Nullable string.

    • When creating or editing an encrypted server variable, the value is initially visible; on reloading the variable, this value is hidden.

    • Clearing the checkbox for Secure clears the value on confirmation.

    • If you use an encrypted server variable in an automatic activity, the value of the variable is decrypted at runtime.

    • Do not use a secure server variable as input or output to a manual activity.

  9. Click Save.

    The variable appears on the Server variables page.

Maintain a server variable

You can modify and delete a server variable.

  1. Navigate to System data > Server variables.
    The Server variables page displays the variables available within your working category.
  2. To display the variables within a specific category, select the category on the Category list.

    Alternatively, to display a specific variable, enter the name of the variable in the Search field and click .

  3. Click the variable to modify.

    The Edit server variable dialog box is displayed.

  4. Make changes as needed.
  5. Click Save.
  6. To delete a server variable, on the context menu for the variable to delete, click Delete.
    On confirmation, the selected variable is deleted.