Add User Tasks To The Onboard Supplier Process

In the previous lesson, you created a process with two user activities. When you added those activities, a user task page was created for each with some default components. In this lesson, you will add to the user interfaces to allow you to run each of those activities. You will also build a user interface to show your list of tasks. 

Detail the Initiate Onboarding Activity

1. Navigate to the process by selecting share from the ribbon, then selecting the Onboard Supplier process.
2. Select the Initiate Onboarding activity from the process diagram:
   
3. Open the user task page using the launch button:
   
4. In the Template, click on the Fields component. This will expand it to allow you to add some instructions before it:
   
5. Above Fields, type "par" to find and add the Paragraph component, clicking on it to add it:
   
6.  For the inner text of the paragraph, add some instructions for the Purchasing person assigned to this task:
   
7. To collect the information for this activity, we need to add some information parameters to the process. Open the Business Objects page using the category button on the ribbon.
8. Click on the Onboard Supplier process business object. This business object was added when you created the process.
   
9. Add 4 properties as strings: supplierName, contactName, contactEmail and employerIdentificationNumber:
   
10. Generate the app and look at the running app.
    
11. Since this task is performed by Purchasing and they may not know the Employer Identification Number, you should remove that field from the page. Click the Recent Items button in the toolbar at the top of the page history  
12. Select the Initiate Onboarding page:
     
13.  Select the onboardSupplier property:
    
14. In the read configuration, click into the Add a configuration item field:
    
15. Select Include Fields.
16. Click into Include Fields to add a field.
17. Select supplierName to add it as a field to include:
    
18. Select two other fields to include: contactName and contactEmail:
    
19. Click the Generate UI button autorenew 
20. Check the page to see that only the 3 fields that you included are shown: 
    

Assign the Complete Application Task

1. From the ribbon, select the Processes page, then select the Onboard Supplier process.

1. Click the Process Variables icon button category .
2. Select the Process Business Object mixin to see the configuration.
   
3. Add contactEmail to the list of exposed paths, making it available within the process.
   
4. Select the Complete Application task.
   
5. Select the Task Assignment tab for the task.
   
6. For Assignment Type, select User.
7. Type "contactEmail" in the Assigned User Process Variable field.
   
8. Generate the process.

Add a My Tasks Page

We need a way for users to see their tasks and open them. Now, you will create a page to do that.

1. Open the User Interfaces page using the laptop button from the ribbon.
2. Add a page called "My Tasks". After typing the name, select the last option shown.
   
3. Add a breadcrumb from the Dynamic Components library:
   
4. Add the My Tasks Table component from the Camunda Library:
   
5. Use the settings button to open settings for the user interface.
6. Set the Sidenav Icon Name for the icon to display in the ribbon:
   
7. Generate the app and run the app to try it out.
8. Navigate to the My Tasks page:
   
9. Select the task to run. (If you have more than one, do not worry! Just pick the latest one):
   
10. Populate each field, including your own email address for Contact Email.
    
11. Complete the task by pressing the Submit button.
12. Still in the app, navigate back to the task list using the My Tasks button on the ribbon assignment_turned_in
13. Select the Complete Application task to open it:
    
14. Click on the Show Process Diagram button share and notice that the highlighted box is now the second activity in the process.

Detail the Complete Application Activity

1. Back in Apex Designer, navigate to the Process page using the share button in the ribbon.
2. Open the Onboard Supplier process by selecting it.
3. Select the Complete Application activity:
   
4. Open the user interface for this activity, by clicking the Open Task in Designer button launch 
   
   
5. Add a Paragraph with instructions for the user:
   
6. Since the Contact Name and Email are not necessary on this page, you can remove them. First, select the onboardSupplier property on the left:
   
7. In the read configuration, click Add a configuration item:
   
8. Click on Exclude Fields.
9. Exclude contactName and contactEmail by selecting them from the Exclude Fields selection list:
   
   
10. Generate the user interface using the autorenew button on the dialog. Notice that the two fields for contact are no longer shown:
    
11. The Supplier Name field remains, but it should be required. With the onboardSupplier property open, select Require Fields:
    
12. Select supplierName as a required field:
    
13. Generate the UI and verify that the field is now required:
    
14. Do not submit the task yet, you will use it in the next lesson.

In this lesson you detailed the Initiate Onboarding and Complete Application activities, both as tasks assigned to users. You also created the My Tasks page to view and select tasks to work on. In the next lesson, you will add a system activity to complete the onboarding process.