Summary
The AgileWork sample copies the list of participants that actually completed the AgileWork's WorkItems to a custom process attribute specified by the process modeler from within Envision. The attached sample contains the AgileWork assembly, the AgileWork project files and source code, and a sample process model that demonstrates the use of the AgileWork.
The SaveParticipantInfoAgileWork sample demonstrates the following important AgileWork concepts and techniques:- The sample demonstrates how a custom design-time property can be exposed within Envision that allows the process modeler to configure an AgileWork's settings and behavior. In this sample, the AgileWork's descriptor class accomplishes this by declaring the "SaveCompletedByTo" property.
-
The sample demonstrates how the value of a design-time property (as specified by the process modeler) can be retrieved at runtime.
In this sample, the AgileWork's class accomplishes this using the code within the "GetAgileWorkParameterValue" method.
- The sample demonstrates how an AgileWork can validate design-time configuration changes (e.g. to ensure that design-time properties have valid values). In this sample, the AgileWork's descriptor class accomplishes this with the code in the overridden "Validate" method, which ensures that the value of the "SaveCompletedByTo" property is not left blank.
- The sample demonstrates how an AgileWork can interact with the AgilePoint Server API at runtime. In this sample, the AgileWork's class accomplishes this within the "OnCompleteWorkItem" method, which both retrieves and modifies the custom process attributes of the AgileWork's associated Process Instance.
- The sample demonstrates how an AgileWork can access current information about the Work Items (i.e. tasks), Activity (i.e. shape), Process Instance, and Process Definition (i.e. the process model diagram) objects associated with the running instance of the AgileWork. In this sample, the AgileWork's class accomplishes this using the code within the "OnCompleteWorkItem" method, which retrieves and uses IDs and other properties of the AgileWork's associated Process Definition, Process Instance, Activity Instance, and Work Items.
Details
The SaveParticipantInfoAgileWork sample process demonstrates the following scenario:
- Two copies of the AgileWork shape are used to assign an "Approve" task to an AgilePoint GROUP. One requires one participant, the other requires 2 participants.
- After both AgileWorks' tasks have been completed, an email notification is sent to the Process Initiator. The email notification will contain the usernames of the participants that actually completed the tasks.
- After the email is sent, two regular Manual AgileShapes are used to assign "Publish" tasks to the exact same participants that actually completed the "Approve" tasks.
