Subprocess (Multi)

This shape is used to start one sub-process for each record returned by a query.

If the Wait parameter is set to True, the process continues once all the subprocesses that were initiated by this shape are completed.

Typically this is used to manage the lifecycle of child entities, for example Order Line Items of an Order.

Navigation

In AgilePoint Envision, open a process template.
Navigate to the XRM Automatic Activities 2011 or XRM Automatic Activities 4 stencil.
On the XRM Automatic Activities 2011 or XRM Automatic Activities 4 stencil, drag the Subprocess (Multi) AgileShape, and drop it on the process template.
To view the entire list of properties, in the Design Tasks pane, click Show Properties.

Properties for This AgileShape

Field Name	Definition
EntityIds	Definition: This could be a list of entity record IDs separated with a semicolon (;). It can take dynamic variable(s)
EntityName	Definition: Select the entity type. This can be a static or dynamic value
NamePrefix	Definition: SubProcesses and SubDialogs Instance Names can be overridden by using this property. It can have static and dynamic values, e.g. “Order Detail ${OrderItemID}”. This is added as such to the name of the process instance: processInstanceID + “_!_” + NamePrefix + “_!_” NOTE: The value of this property overrides the one set at SubProcess/SubDialog level in the Process Name tab of the XRM Connection window in Envision.
QueryExpression	Opens the Following Window: Advanced Find - QueryExpression Configuration Window
Sub Process	Opens the Following Window: Process Selector Window Purpose of this Window: This opens the Process Selector dialog for choosing which process and version to initiate.
SubProcessParams	Opens the Following Window: Subprocess Parameters Window Purpose of this Window: This opens the Subprocess Parameters dialog for passing variables to the sub-process:
Wait	Definition: Default value: True True - The process will wait for the sub-process to finish before considering this step completed (i.e. synchronous) False – The process will launch the sub-process but will not wait for it to complete(i.e. asynchronous)

Common AgilePart Properties

This AgilePart inherits the following common properties. For more information, see AgilePart - Common Setup. Note that only the relevant properties are available in AgilePoint Envision. Unneeded properties are hidden.

Name, (UID), Description, Debug, Audit Level, SessionMode, Wait All Incoming, AssemblyName, ClassName, Method, Optimizing, Activity Entry Message (Email), Task Completed Message (Email), ConfigureAttachments, Reference URL, ExceptionHandlerScope, SaveErrorMessageTo, SaveStatusTo, Configure Yammer Credentials, Retries, HandleException

BPMN Properties

Each AgileShape includes a set of BPMN properties. For more information, see Adding or Modifying BPMN Properties for an AgileShape.

Common AgilePart Tasks

Collapse/Expand Shape

Right-clicking the shape brings up the Collapse menu action. Clicking it collapses the shape to a small circle. Right-clicking a collapsed shape shows the Expand menu item, restoring the shape to its original form.

Use Collapse shape to minimize the visual effect of steps in the process which are not of any interest to the Business User.

Add/Remove Timer

Right-clicking the shape brings up the Add Timer menu action. Clicking it adds a timer to the shape, allowing the process modeler to add an alternative route out of the shape when the configured Time Span times out.

Right-clicking a shape with a Timer shows a Remove Timer menu action, which would remove the timer from the shape.