(Example) Configure the Update Process Data Activity

Video: Add Conditions and Salesforce Actions

Video: Configuring Process Data

Good to Know

• The Update Process Data activity was frequently used in AgilePoint BPMS 5.x, which did not have many of the features for managing data and variables that now come out-of-the-box with AgilePoint NX. These include eForms, Data Entities, and many process activities that connect with third-party technologies. In older AgilePoint products, the Update Process Data activity was often used to set or change values in the schema.

  In AgilePoint NX, the Update Process Data activity is usually used in exception cases when data values can not be set any other way. In other words, this activity is still used in many NX apps, but the best practice is to use this activity as a final option, rather than the default.

How to Start

1. Click Build Apps .

   
   
   

2. On the Application Explorer screen, do one of these:
   • Open a Process.
   • Create a Process.
3. Do one of these:
   • Add an activity:
     1. In the Process Builder, in the Activity Library, open the Common tab.
     2. On the Common tab, drag the Update Process Data activity onto your process.
   • Change an activity:
     1. In your process, double-click your activity.
4. Complete the fields on the General Configuration screen.
5. Click Next.
6. On the Update Custom Attributes screen, click the Process Data tab.

   
   
   

7. On the Process Data tab, in the Model Data, click Edit .

   
   
   

8. On the Data Model screen, right-click processFields and click Element.

   
   
   

9. In the Element Name field, enter PersonResponsible.

   
   
   

10. Click OK.

Procedure

1. On the Update Custom Attributes screen, in the Process Data Variable field, drag PersonResponsible.

   
   
   

2. In the Expression field, drag ProcessInitiator.

   
   
   

3. Click Validate

   
   
   

   This creates C# code that looks like this:

   
   
   

Result

After the process completes, you can view the result in Manage Center on the Process Detail screen > Data tab > Form Variable tab.

The variable PersonResponsible stores the current value of the ProcessInitiator when the Update Process Data activity runs..

Procedure

1. On the Update Custom Attributes screen, in the Process Data Variable field, drag PersonResponsible.

   
   
   

2. In the Expression field, enter "Mary Poppins".

   The string value must be enclosed within the quotation marks (" ").

   
   
   

3. Click Validate .

   
   
   

   This creates C# code that looks like this:

   
   
   

Result

After the process completes, you can view the result in Manage Center on the Process Detail screen > Data tab > Form Variable tab.

The PersonResponsible variable stores the value Mary Poppins from the Expression field.

Procedure

1. On the Update Custom Attributes screen, in the Process Data Variable field, drag PersonResponsible.

   
   
   

2. In the Expression field, enter the expression in this format.

   Format:

   ([Drag the Employee1 variable from Form Data]).ToString().ToUpper() + " and " +([Drag the Employee2 variable from Form Data]).ToString().ToUpper()

   Example:

   (${/pd:AP/pd:formFields/pd:Employee1}).ToString().ToUpper() + " and " +(${/pd:AP/pd:formFields/pd:Employee2}).ToString().ToUpper()

   The Employee1 and Employee2 are form fields in the form.

   
   
   

3. Click Validate .

   
   
   

   This creates C# code that looks like this:

   
   
   

Result

After the process completes, you can view the result in Manage Center on the Process Detail screen > Data tab > Form Variable tab.

The values of Employee1 (Poppins) and Employee2 (Van Dyke) are converted to all capital letters. It also combines both values with the word "and". This is the result: POPPINS and VAN DYKE.