Configure a Subprocess

To configure a subprocess, do the procedure in this topic.

Figure: Subprocess screen

Subprocess screen

Examples

Good to Know

  • This procedure is based on the latest AgilePoint NX release. If there are differences between this procedure and your version of AgilePoint NX, refer to the documentation for the specific fields or screens where the differences occur.
  • In most text fields, you can use process data variables as an alternative to literal data values.
  • You can configure whether this activity waits for other activities before it runs.

    For more information, refer to How Do I Configure an Activity to Wait for Other Incoming Activities?

How to Start

  1. On the Application Explorer screen, do one of these:
  2. Do one of these:
    • Add an activity:
      1. In the Process Builder, in the Activity Library, open the Common Common icon tab.
      2. On the Common Common icon tab, drag the Subprocess Subprocess icon activity onto your process.
    • Change an activity:
      1. In your process, double-click your activity.

Procedure

  1. Complete the fields on the General Configuration screen.

    For more information, refer to Configure General Options for a System Activity.

  2. Click Subprocess Subprocess icon.
  3. You can call a On the Subprocess screen, do one of these:
    • To use a specified process model for your subprocess, do this procedure.
      1. Select Predefined Subprocess (Only From This Application) or Predefined Subprocess (From All The Application).
      2. Click Subprocess Template Subprocess Template icon.
      3. On the Subprocess Model screen, in the Subprocess Model field, select the process from the list.
      4. Click Subprocess Configuration Subprocess Configuration icon.
      5. On the Subprocess Configuration screen, do this procedure.
        1. To specify the format for the name of the subprocess, do one of these:
          • To use the name of the process model to create the process instance name, in the Subprocess Instance Name Format field, select Name .
          • Select Custom to specify a different format.

            In the Custom field, enter the name of the process, or drag a process data variable from the Process Data screen.

        2. (Optional) To add a GUID to the custom subprocess name, select If the subprocess name already exists, append the name with @${GUID}.
        3. To specify the name of the process that starts the subprocess, do one of these:
          • To let the parent process start the subprocess, in the Subprocess Initiator Name, select Process Initiator.
          • To let a different process start the subprocess, select Custom.

            In the Custom field, enter the name of the process, or drag a process data variable from the Process Data screen.

      6. Click Subprocess Mapping Attributes Subprocess Mapping Attributes icon.
      7. On the Mapping Attributes screen, do one of these:
        • To share all the process data variables from parent to child, select Share all Attributes (Basic).
        • To specify variables to share from parent to child, do this procedure:
          1. Select Map Specific Attributes (Advanced).
          2. Click Schema Mapping Schema Mapping icon.
          3. On the Schema Mapper screen, drag the variables from the parent process model schema to child process model schema as necessary to connect them.
    • To use a subprocess you created based on a variable in schema, do this procedure:
      1. Select Dynamic Subprocess (Advanced).
      2. Click Subprocess Configuration Subprocess Configuration icon.
      3. On the Subprocess Configuration screen, do this procedure.
        1. In the Subprocess Model field, enter the name of the process, or drag a process data variable from the Process Data screen.
        2. To specify the format for the name of the subprocess, do one of these:
          • To use the name of the process model to create the process instance name, in the Subprocess Instance Name Format field, select Name .
          • Select Custom to specify a different format.

            In the Custom field, enter the name of the process, or drag a process data variable from the Process Data screen.

        3. (Optional) To add a GUID to the custom subprocess name, select If the subprocess name already exists, append the name with @${GUID}.
        4. To specify the name of the process that starts the subprocess, do one of these:
          • To let the parent process start the subprocess, in the Subprocess Initiator Name, select Process Initiator.
          • To let a different process start the subprocess, select Custom.

            In the Custom field, enter the name of the process, or drag a process data variable from the Process Data screen.

      4. Click Subprocess Mapping Attributes Subprocess Mapping Attributes icon
      5. On the Mapping Attributes screen, do one of these:
        • To share all the process data variables from parent to child, select Share all Attributes (Basic).
        • To copy all the process data variables from parent to child, select Copy all Attributes (Advanced).
        • To specify variables to share from parent to child, do this procedure.
          1. Select Map Specific Attributes (Advanced).
          2. Click Initial Attributes Initial Attributes icon.

            An initial attribute is a process data variable in a subprocess that is populated with a value from the parent process when the parent process starts the subprocess.

          3. (Optional) To share the parent process's variables with the subprocess if the subprocess uses the same data, do this procedure.
            1. On the Initial Attributes screen, in the Name field, enter the name of a variable to connect with a subprocess.
            2. In the Value field, enter the value for the attribute, or drag a process data variable from the Process Data screen.

              The value in the child process is connected to the variable in the parent process.

            3. To add more attributes, click Add Add icon.