IBM BPM, V8.0.1, All platforms > Customize and rebranding interfaces > Customize Process Portal > Building Process Portal spaces > Building customized Process Portal spaces > Use custom form renderers for the Task Information widget
Developing custom form renderers for the Task Information widget
By default, the forms used in the Task Information widget are Dojo-HTML forms, IBM Forms, or coach-based forms. If you want to customize the widget to use other types of form rendering for some or all of your tasks, you must also develop a custom form renderer.
If you want to use existing form technologies and form implementations, you can create a custom form renderer to provide a wrapper that implements the integration and communication with the Task Information widget.
For example, you might have an existing web application that uses JavaServer Pages (JSP) technology to provide the task forms. In this case, the custom form renderer provides the logic to derive the URL for the task form from the task details and adds an HTML <iframe> element to the JSP form.
A custom form renderer is a Dojo class that is derived from the com.ibm.task.form.Renderer interface and made available in a custom extension service.
When a task is opened in the Task Information widget, the widget determines which form renderer to use, based on the user interface client type that was specified for the task in Integration Designer. A new instance of the custom form renderer is created for each form.
Procedure
- Create a Dojo class for the custom form renderer that implements the com.ibm.task.form.Renderer interface.
- Implement the methods for the lifecycle operations of the renderer. The widget calls these methods, for example, when the widget is loaded, unloaded, or resized.
- Provide for the appropriate callbacks from the renderer to the widget. The callbacks provide the widget with information about the form and its state, for example, when an action in the form is enabled or disabled.
What to do next
Configure the endpoint for the custom extension service so that the Task Information widget can use the custom form renderer.