Subprocess

When entered, this AgileShape will initiate another AgileXRM process instance as a sub-process.

This functionality is useful for breaking complex processes to more manageable chunks and also allows creating more modular processes, and enhances reusability.

It allows selecting any AgileXRM Process. For initiating other types of processes, use the Subprocess shape in the Generic stencil.

This shape does NOT share the context of the caller with the child, assuming that the Main Entity of the child is different. To pass variables to the child process use the SubProcessParams property.

child

When selecting a sub-process, it is possible to initiate the latest version or a particular version. Please see below for details of choosing which version of the sub-process template to initiate.

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 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
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.
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.