Creating an assign statement

When you create an assign statement, you assign context items in the table in the Properties tab for the Assign activity. You can create multiple assignments in a single Assign activity.

To add a new assign statement

1. Drag an Assign activity from the TrueSight Orchestration Development Studio Activity Palette to the process canvas.

2. Double-click the Assign activity on the process canvas.

3. Click the green plus at the top of the property panel to create a new assign statement.

4. (optional) Enter a description of the assign statement in the Description field.

5. Enter the value to assign in the Input pane:

   1. Select the input parameter type.

   2. Assign the appropriate input for the selected parameter type.
      
      Types of parameters for assign statements

      Parameter type	Description
      String	Assigns a string value. Any string value can be typed into the input box. To add the contents of a context or configuration item to the string, use the Insert Context/Config button to the right of the input area. Multiple context and configuration items can be added to a single string. In TrueSight Orchestration Platform version 7.9.01 or later, you can concatenate a string and a context item that points to a secure module configuration item. The resulting output is another secure data item. To use predefined XML samples, or to save the contents of the input box as a resource, use the buttons to the left of the input box.
      Numeric	Assigns a numeric value.
      Date	Assigns a date value.
      XML	Assigns an XML value.
      Context Item	Assigns a value from a previously defined context item to this context item. Use the Context Browser button to add the name of the context. The Edit button (pencil) can be used to manually enter or edit a context name. New contexts can be created using the Context Browser and Edit buttons in the assignment input section; however, if the context name is not created by a previous step in the process, an undefined context error might occur when the process executes.
      Module Configuration	Assigns a module configuration item or group. You can select any item in the Module Configuration hierarchy tree. Selecting leaf nodes enables you to select an individual configuration item. Selecting a non-leaf node enables you to select an XML document containing all children of that node.
      System Parameter	Assigns a system value determined at process run time. Contains the following parameters for which values are retrieved: ASSIGNED PEER_NAME: Retrieves the name of the peer on which the process is run. If you run the process in TrueSight Orchestration Development Studio, the host name is returned in the response. HOST_NAME: Retrieves the host name of the server on which the process is run. IP_ADDRESS: Retrieves the IP address of the server on which the process is run. JOB_EXECUTOR_USERID: Retrieves the user ID which is executing the job. JOB_EXECUTOR_CREDENTIALS: This parameter is always empty. MODULE_NAME: Retrieves the name of the module which contains the process. OS_NAME: Retrieves the name of the operating system on the process is run. ROOT_JOB_ID: Retrieves the job ID for the process. ROOT_PROCESS_NAME: Retrieves the name of the process. ROOT_PROCESS_ID: Retrieves the module and the process name.
      Dynamic Context	Assigns a dynamic context to a context item. Use the Context Browser button to add the context item containing the name of the dynamic context item.

      
      

6. (optional) To use a transform to assign a more specific value to an input parameter type of XML, context item, dynamic context, or module configuration, click Basic or Advanced to open a transform editor.

   The down arrow on the right of the Transform button can be used to select the Basic transform editor or the Advanced transform editor.

7. Enter a context item for the output in the Output pane.

8. Select a context type.
   
   Context types for assign statements
   

   Context type	Description
   Context Item	Specifies the name of a context in which to store the result. Enter the context name by selecting it with the Context Browser, or type it using the Edit button (pencil). If you select an existing context, the contents of that context will be replaced. If a new context name is entered, new context item will be created.
   Dynamic Context	Specifies the name of a context that contains the name of the dynamic context. Select the context name using the Context Browser.
   Remove	Visible only if the input parameter type is Context Item or Dynamic Context. Specifies a dynamic context item named by using the Input pane. The dynamic context item removed is named by the contents of the context item or dynamic context item in the input section.

9. (optional) To store the assign statement result in a concept element in a context:

   1. In the Output pane, select the Concept check box, and then select a Concept Type hierarchy.

   2. Click OK to save the assign statement and return to the Assign activity properties.

   3. Click OK to save the Assign activity and return to the design canvas.