Prepare to extend generated JSF code

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
Prepare to extend generated JSF code

Before you can extend generated JSF code for a client, you must update the faces-config.xml file of the client to be enhanced to add support for the new human task.

When you generate a user interface, a dynamic web project is generated. This project contains the generated artifact, which consists of several Java™ Server Faces (JSF) pages, Java code, and the required configuration files. The artifacts are automatically packaged into an EAR file, which is ready to be deployed and run on WebSphere Application Server. However, you might need to extend the JSF client code if the work scope increases. Before you extend this code, you must update the faces-config.xml file.
To update the faces-config.xml file:

Procedure

Generate a new JSF client for all the affected human tasks.

Complete the actions in the following table.

Newly generated faces-config.xml file section Description Action
Where clause extension for open and under work ToDos Contains the configuration of toDosWhereExtension Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.
Where clause extension for sub ToDos Contains the configuration of subToDosWhereExtension Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.
Application meta info Contains the configuration of toDosClientTypes, toDosInEqualsOut, toDosMainInEqualsSubIn Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.
Navigation rules Contains the map of logical name-to-file name for all infrastructure, overview, and main pages. Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.

Save the faces-config.xml file of the client to be enhanced.

What to do next

After you update the faces-config.xml file, download the ModifyEnhanceJSFClient.pdf file and sample (OrderSolution_PI_V7.zip) in Understanding and enhancing the generated Java Server Faces client for human tasks for information about how to extend your generated JSF client for human tasks.

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
Generate JSF clients for your human tasks
Customize clients
Deploying a generated client to an external runtime environment

Related reference:
Design considerations for user interface generation

Newly generated faces-config.xml file section	Description	Action
Where clause extension for open and under work ToDos	Contains the configuration of toDosWhereExtension	Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.
Where clause extension for sub ToDos	Contains the configuration of subToDosWhereExtension	Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.
Application meta info	Contains the configuration of toDosClientTypes, toDosInEqualsOut, toDosMainInEqualsSubIn	Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.
Navigation rules	Contains the map of logical name-to-file name for all infrastructure, overview, and main pages.	Copy the newly generated faces-config.xml file section to same section in the faces-config.xml file of the client to be enhanced.