Procedure

An AgilePart that enables to perform server-side, AgilePoint system task. You can associate system-related, automated activities to the AgileShape that needs to be executed. For example, generating a report at the end of a process, updating a database when a request is approved, and so on. The AgileShape supports application integration either synchronously or asynchronously, using C#, VB.NET, managed C++, COM, XML Web Service, Messaging queue, and others.

Good to Know

The AgileShape can only be used within a process template that is associated with an AgileStub. If you want to use the AgileShape, you must create an AgileStub using AgilePoint Developer.
The AgilePart and WebService AgileShapes do not require the creation of an AgileStub, and can be used instead of the Procedure AgileShape.

Navigation

In AgilePoint Envision, open a process template.
Navigate to the Generic BPM stencil.
On the Generic BPM stencil, drag the Procedure 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
Asynchronous	Definition: Determines whether the AgileShape exits immediately after invoking the associated .NET method or waits for the associated .NET method to finish executing before moving forward. Allowed Values: False - Specifies that the AgileShape invokes its associated .NET method synchronously. The AgileShape waits for the associated .NET method to finish executing before proceeding further in the process flow. True - Specifies that the AgileShape invokes its associated .NET method asynchronously (in a separate thread). The AgileShape exits immediately once the associated .NET method is invoked. You can use this setting to initiate long-running procedures that do not affect the rest of the process. Default Value: False

Field Name

Definition

Asynchronous

Definition:

Determines whether the AgileShape exits immediately after invoking the associated .NET method or waits for the associated .NET method to finish executing before moving forward.

Allowed Values:

False - Specifies that the AgileShape invokes its associated .NET method synchronously. The AgileShape waits for the associated .NET method to finish executing before proceeding further in the process flow.
True - Specifies that the AgileShape invokes its associated .NET method asynchronously (in a separate thread). The AgileShape exits immediately once the associated .NET method is invoked.
You can use this setting to initiate long-running procedures that do not affect the rest of the process.

Default Value:

False

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

Parent topic: Generic BPM