Add server variables

You can add a server variable from within a custom service group and save it to a category.

  1. Create a custom service group.
    On saving a custom service group, the option to create a server variable is enabled.
  2. In the New custom service group dialog box, click for server variables.
    The New server variable dialog box is displayed.
  3. 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.
  4. By default, the server variable belongs to the Category of the custom service group in which it is added.
    If you select a different category, the server variable is added to the selected category and does not appear on the current list. Only the server variables that belong to the current custom service group's assigned category will be listed under Server variables.
  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.
    • 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.

    • 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 is listed under Server variables.

    You can edit and delete a server variable.