This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Writing a Human Task Artifact using the Editor

Owned by Former user (Deleted)
Last updated: Mar 20, 2017 by Former user (Deleted)
4 min read

The following tutorial guides you through creating a human task artifact using the human task editor. For more information on human task artifacts, see Writing a Human Task Artifact. 

Before you begin,

  1. Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.
  2. Download the WSO2 EI ZIP file from here, and then extract the ZIP file. 
    The path to this folder will be referred to as <EI_HOME> through out this tutorial.
  3. Select and download the relevant EI tooling ZIP file based on your operating system from here and then extract the ZIP file.
    The path to this folder will be referred to as <EI_TOOLING> through out this tutorial.

This tutorial includes the following sections:

 

Creating a human task artifact

  1. In WSO2 EI Tooling, go to File -> New -> Other and select Human Task Project.

  2. Fill in the following details in the form that appears on the wizard and click Finish.
    • Project Name: humanTaskProject
    • File Name: newfile
    • Task Name: OrderApproval
    • Target Namespace:www.wso2.org
  3. Once the project is created, you will the Human Task GUI editor similiar to the screen below with the sections of your .ht file listed out.

Task properties

Expand the Task Properties panel and do the following:

  • Change the name of the task.

  • Add documentation for the task.

  • Set the priority of the corresponding task. For this field, you can either add an Xpath expression or an integer.

Task input 

Expand the Task Input panel and do the following:

  • To add a new input data mapping, click the + button on the top left side and fill in the required details (element name and data type). The presentation parameters are auto-generated according to the element name you provide. 
  • To delete an input data mapping, click on the delete button corresponding to the relevant input.

Task output

Expand the Task Output panel and do the following:

  • To add a new output data mapping, click the + button on the top left side and fill in the required details (element name and data type). The presentation parameters are auto-generated according to the element name you provide. 
  • To delete an output data mapping, click on the delete button corresponding to the relevant output. 
  • Set the callback service properties. The values for Callback Service Name, Callback Operation Name and Callback Service URL are properties of the callback WSDL and the values you provide will deal with the callback WSDL file directly.

Presentation elements

Expand the Presentation Elements panel and do the following:

  • Set the Display Name, Display Subject and the Description of the task. These will be shown as the task info in BPS. 
  • The presentation parameters of the the task are auto generated according to the inputs and outputs.

People assignments 

In this section, you can do the following:

  • Assign different users or roles as different stakeholders to this task. For example, you can add the users with the role name ‘clerk’ as potential owners of this task by filling out the Potential Owners field. In this sample you have to first select the Role and enter the user role name "Clerk". If you are assigning a user as an expression you can add it using XPath. The Xpath suggestions for the corresponding task will appear when you start entering it to the expression field.


Note: To add another task, you can select the + button next to the task tab and add a new task. All the tasks can be viewed as tabs on top of the UI. To delete a task, click the X sign on the task tab and delete the task.


Creating the deployable artifacts

  1. Right-click on the project. Select Export Project as a Deployable Archive. The project export dialog box will appear. 
  2. Provide the location you want to save the artifiact in and click Finish. This will generate a .zip archive that can be deployed directly in EI-Business Process runtime.

Deploying the artifacts

  1. Start the EI-Business Process runtime by going to <EI_HOME>/wso2/business-process/bin  and using the command line terminal and executing one of the following commands:
    • On Linux/Mac OS:  sh wso2server.sh

    • On Windows:  wso2server.bat --run

  2. In a new browser window or tab, open  https://localhost:9445/carbon/  and log into the EI-Business Process management console using admin for both the username and password.
  3. Navigate to Home -> Manage -> Human Tasks ->Add. Upload the zip file that you just exported.