IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Developing business processes > Building human tasks > Set up a user interface for your human task

Generate JSF clients for your human tasks

You can generate a client either from a module, a business process, or a human task.

When you open the Human Task client generation wizard to generate a JSF client application, collaboration and invocation human tasks might be filtered to not show in the human tasks list in the Generate Human Task Interface window. These types of human tasks do not show if they are a part of a module that is associated with a toolkit.


Procedure

To generate a JSF client for your human task, complete the following steps:

  1. In the Business Integration view, right-click the human tasks for which you want to generate a user-interface, and select Generate Human Task User Interfaces. To generate a client for tasks in different modules, select those modules in the business integration view by holding the Ctrl key while you select each one. The User Interface Wizard for Human Tasks launches.

    • If the generated client is intended to be able to start a process, then this process must have a human task defined for the initial receive activities, or you must have another initiating task on the assembly diagram wired to the process .

    • If the human task is not represented on your assembly diagram, then you will get a warning message.

    • If a humans task contains an error of any kind, the task will not be listed in the wizard. A warning message will be shown.

  2. On the Client Generator Selection page, proceed as follows:

    1. In the Generator type field select JavaServer Faces client application.

    2. Use this list to choose the human tasks for which you want to generate the client. Expand the tree until you find the required human tasks, and then select the associated check boxes.

  3. On the JSF client configuration page, proceed as follows:

    1. Assign a name to this client in the Name of dynamic web project field.

    2. In the Company logo field, you can specify the file location of a graphic file containing a company logo. This logo will appear as a banner on the top of the generated client's web page. You can browse either to a GIF or JPEG file. If your image has a height higher than 60 pixels, then it will automatically be shrunk to fit the space available. You can adjust the height of your logo in the page Banner.jsp of the generated client. The background color of the banner is defined in the style sheet styles.css, refer to class .Banner. The CSS file is located in the generated web project in WebContent\theme\styles.css.

    3. In the Client view area, you have two choices. Choose Local if one server will be used to deploy both the generated client and the related processes and tasks. Choose Remote if two or more servers will be used in the same cell, and your generated client will be deployed on one server, and the related processes and tasks on another.

    4. In the Style area, you can choose from the two styles that are provided for your generated client, or add your own style file. This custom CSS file must reside in a web project in your workspace. The CSS file can contain your settings regarding color, font size and style, but these settings have to have proper names since they are used as reference in the generated client. The best approach is to modify a predefined style of a generated client (styles-IBM.css or styles-blue.css), and save it in the your CSS file. In the Style field, you can then click Add and Browse to select your CSS file.

    5. When you are done, click Next.

  4. On the second JSF client configuration page, you can select the custom properties (as defined in your business process) that you would like have generated with the client. You can use custom properties as filter criteria for the "Status" list.

  5. When you are done, click Finish.


Results

Your new client will be generated. Your next step is to deploy it to a runtime environment.


What to do next

For more information about customizing JSF clients, see the white paper Understanding and enhancing the generated Java Server Faces client for human tasks.

Building BPEL processes

Set up a user interface for your human task


Related concepts:
Before you begin: Client types and prerequisites


Related tasks:
Defining user interfaces for a human task
Generate HTML-Dojo pages or IBM Forms for Process Portal spaces
Integrating JavaScript in HTML-Dojo pages
Generate IBM Forms clients (deprecated)
Generate WebSphere Portal portlets
Prepare to extend generated JSF code
Customize clients
Deploying a generated client to an external runtime environment


Related reference:
Design considerations for user interface generation