Associating Output Variables with Actions

Using output variables, you can incorporate quality results values into the action details of the following alert actions: Send an electronic mail notification, Execute a SQL script, and Execute an operating system script (see: Defining Collection Element Alert Actions), and the Launch a Workflow user-defined action. Output variables can also be used to incorporate quality results values into the action details of Assign a Value actions.

Additional Information: The above listed Alert actions can be defined for both collection elements and collection plan elements, but Assign a Value actions can only be defined for collection plan elements.

For example, you can use an output variable token (e.g. &DIAMETER) to represent numeric diameter values (e.g. 45 inches), so that these values can be included in the details (text) of a Send an electronic mail notification alert action.

Output variable tokens are defined by entering an ampersand (&) followed by a token name (for example, &ITEM_NUMBER) that represents a results value.

Prerequisites

arrow icon   To associate output variables with actions:

  1. From the Actions:Send Electronic Mail, Actions: SQL Script, Actions:Operating System Script, Assign a Value, or Launch a Workflow windows, choose the Variables button. The Output Variables window appears.

  2. Enter the Token Name.

    Do not enter the ampersand (&). For example if you included an &ITEM_NUMBER output variable token in the Message Text field of the Actions: Send Electronic Mail window, you would enter ITEM_NUMBER as the token name.

    Attention: If you are creating a Launch a Workflow output variable, the token must be entered exactly the same as the workflow attribute's internal name is written or the workflow will not launch.

  3. Select the collection element to associate with the token name.

    You can associate token names with any collection element, including common collection plan elements. For example, you can associate the Item collection element with the &ITEM_NUMBER token name as described above.

  4. Save your work.

  5. Choose OK to close the Output Variables window.