Designer > Human Tasks > Providing Renderings for Task Clients

Providing Renderings for Task Clients

About Task Presentation in Process Central

Select a rendering.
Process Central is a client application that contains tasks and notifications, as well as Process Request Forms and Reports.
In Process Central, tasks and notifications are shown in a list, and users can select an item to work on and you can configure both the task list presentation as well as individual task presentation.
Here is an overview of the presentation properties you can configure.
Process Central Task List Presentation
All configuration of the task list is provided in a configuration file that you deploy. The basics include the following:
Process Central Individual Task Presentation
Process Developer provides a comprehensive design environment for presenting a task to users. For details, see Rendering a Task Interface into a User Interface.

Rendering a Task Interface into a User Interface

Rendering is the application of a friendly user interface for the task’s interface input and output messages. When a user views a task in a task client application, the details are displayed in an HTML form. A user reads the input message data and uses a variety of controls to enter and submit a response for the output message.
Informatica Business Process Manager has different rendering mechanisms for different task client applications.

Creating an Process Central Task Form

Create an HTML form to render a task's input and output messages for ActiveVOS Central task client. The form opens in a Web Page Editor.
In the Renderings tab of a task’s properties, you can create a new task form or browse to a file that is already available in the workspace.

Creating a Task Form

To Create a Task Form:
  1. 1. Display the Properties view for a task that you have defined.
  2. 2. In the Renderings tab of a Task’s Properties view, select the Process Central Form tab, if needed.
  3. 3. Select Create Form.
  4. 4. In the Create Form dialog, select the default folder and filename for the form. The default filename is the task interface operation name.
  5. 5. Select Advanced to do the following:
  6. Select Merge input and output fields if you want to use the input fields to format the output. This selection is appropriate for some tasks, but not all. It is most useful for task forms in which the input data is very similar to the output. For example, if the task input is a work item, and the task output is the same work item that is being updated, you can generate much of the format for the output by merging input and output. For details, see Merging Input and Output Fields in a Task Form.
    Select the checkbox to Externalize Strings for multilingual support. For details, see Providing Multilingual Support for Task Forms.
  7. 6. Select OK to open the HTML form in the Web Page Editor.
See also:

Merging Input and Output Fields in a Task Form

Create an HTML form to render a task's input and output messages for Process Central task client. The form opens in a Web Page Editor.
Use the Input to Output Merge Mappings dialog to map a task input message element to a task output element of the same type.
When a task form is generated, the form's input and output sections are generated as separate sections. In cases where the task's input and output messages have the same or similar elements, this leads to a lot of redundancy in the form that is generated. For example, in the case where the input and output messages are exactly the same, the input section provides a read-only view of the data, and the output section provides an editable view of the same fields. Also, initially, when the form is loaded, the output section would be empty and the task owner would have to reenter data from the input fields to the output fields. The use of merge mappings in these scenarios makes the form simpler and easier to use.
Merge mappings is a way to specify that certain sections of the input and output are the same, and are to be treated as such. When such a mapping is specified, the generated task form shows a consolidated view of those mapped elements. The fields contain initial values from the task's input data, and when the task form is saved, the values are saved to the task's output elements.
When you create a new task form, be sure to select the checkbox for Merge input and output fields. The task form wizard presents a dialog for you to add individual mappings between input fields and output fields.
For each element in input that needs to be mapped to an output element, create a new entry in the mappings table. Select Add to open the Merge Mapping dialog and select an input element and an output element. Validation messages in this dialog assist you in selecting compatible entries.

Working in Development Mode or Production Mode

Generate task details forms that are easy for Inbox users to use.
You can view and update the rendered task details layout in an Process Developer task client without redeploying the BPEL process or even creating a new instance of the process.
In the Renderings tab of the Task Properties view, you can enable Development Mode for testing your renderings. In this mode, when you deploy the process, the rendering files are read from the file system.
Rendering files must be on the same machine as Process Developer when in Development Mode.
Development Mode works as follows:
Note: If you do not enable Development Mode, you can logout and login to Process Central to view changes to your forms and configuration files.
When you enable the Development Mode, you can test your rendering files as follows:
  1. 1. Deploy the process, start it, and sign in to the Process Developer task client. Sign in as one of the users you specified in the people activity assignments.
  2. 2. In Designer, open a rendering file in an editor and make updates, as desired.
  3. 3. Refresh the task client to see your changes.
To Remove Development Mode:
When you are done editing the rendering files, you can do the following:

Understanding the Task Form Template

During creation of a task form, Process Developer does the following:
For details on modifying a task form, see "Editing HTML in Process Central Forms" in the Process Designer help.

Examples of Task Forms for End Users

As you generate task forms, you can view the HTML rendering.
Each part of a message is rendered in simple table, with each row occupying the HTML input field. For example, if the input message has two parts, then there are two tables that display.
Repeating elements are supported by repeating the UI pattern for each input element. Two command buttons are added: Add and Remove so that users can add or remove items such as parts for a purchase order.
Simple data types are rendered as HTML controls as follows:
Data Type/Attribute
HTML Control
radio button
text input
text input (includes a date chooser)
text input
xsi mixed
text input
xsi any
text input (User must enter well formed XML content to pass validation)
selection box
Add/Remove buttons
asterisk added to the label to indicate “required field”

Adding a New Service Operation to a Task Form

If desired, you can modify an existing task form by adding or changing fields and functions generated from service operations. A service operation is a WSDL operation from a Workspace WSDL that represents the endpoint of a BPEL process running in an Process Server. The operation must have a service name associated with it.
For details, refer to Adding a New Service Operation for a Request or Task Form in the Process Developer Online Help.

Providing Multilingual Support for Task Forms

You can create task forms that support different languages. To do so, you create a new task form, plus a default properties file and additional properties files for each language supported. The steps to accomplish this support are described below.
To Create a New Task Form and a Default Properties File:
  1. 1. Create a new task form, described in Creating an Process Central Task Form.
  2. 2. In the Create Form dialog, select the Externalize Strings check box.
  3. 3. Select the dialog button next to Property File.
  4. 4. Name the new properties file. Do not include an underscore in the name.
  5. 5. Browse to the forms folder to store the file.
When you select to externalize strings, the following events occur:
For Each Additional Supported Language:
  1. 1. Make a copy of the default properties file and paste it into the project form folder.
  2. 2. Name the copied file with the syntax shown below. Note that you must use the exact same name for each file, followed by an underscore, followed by an ISO 639 Code for the Representation of Names of Languages.
  3. Syntax
    myFile_[ISO639Code]_{optional locale code}.properties
  4. 3. Open the file in a text editor and replace the English values with another language.
Note: You can also add multilingual support for a task's presentation elements, namely the Subject and Description. For details, see Adding MultiLingual Support for Task Subject, Description, and Display Name.
See also Deploying a Task Form and Properties Files.

Deploying a Task Form and Properties Files

A task form and multilingual properties file are resources that must be included in a deployment package.
All forms in the project forms folder are automatically added to a BPR export archive in the Additional Resources section.

Creating an Process Central Configuration File for Tasks

For details of this topic, see "Configuring Task Role Filters" in yjr Process Developer Online Help.
The Task Role Filters section of the .avcconfig file configures the following:
Here is an illustration showing the Task categories you can customize:
ActiveVOS Central

Creating a Custom Rendering

Type in the XML and other details for a custom rendering of a task or notification.
The Custom Rendering dialog is available when you want to provide your own custom client application for rendering task details. Use this dialog to provide XML rendering hints for your application.
In addition, you can add a custom rendering to the Renderings list. For details, see Contributing a Custom Task Rendering Hint Editor.
For an overview of this topic, see Rendering a Task Interface into a User Interface.

Contributing a Custom Task Rendering Hint Editor

Refer to the files to be used to provide rendering hints for this task or notification.
If desired, you can add a custom rendering to the rendering selection list. The rendering selection list includes custom. You can add to this list by contributing a custom rendering hint editor to Process Developer.
Your application can use the com.activee.bpel4peopleep plugin, which provides an extension point allowing you to contribute your own custom rendering hint editors. This extension point appears in the plugin.xml file.
You can contribute to the Task Rendering Hint Editor Extension Point.
The plugin.xml file already contains extension points for the JSP and XSL editors. You can use these as examples to contribute your own editor.