Modeling client-side human services
When you model a client-side human service, you build the service flow that defines the activities, the dashboards, or the instance user interfaces that case workers or people who participate in processes use in IBM® Process Portal.
About this task
To build the service flow, you can use coaches, client-side
scripts, services, intermediate and end events to model the process or case activities. For each
activity that is used in the service flow, you can define data variables,
build coaches, and create the user interface that users see. Depending
on what type of user interface the client-side human service is used
for, you can also map input and output data and set the exposure type
for the service.
Important: While modeling your client-side
human services, remember that information in the service flows is
to be used in support of the user interfaces that you are creating.
To avoid unwanted information being exposed through a user interface,
ensure that you provide input information that can safely surface
in a user interface and that your output information can safely flow
into a business process definition (BPD) or process instance.
For a suggested order of tasks to build a client-side human service, see Building a client-side human service. The following diagram illustrates the main tasks and activities that are associated with building a client-side human service at a high level.
- Tools available from the client-side human services palette
Learn about the tools that are available when you are modeling client-side human services. - Building a client-side human service
To create a user interface for a new case instance or process instance, create a client-side human service by using the options in the library. To build the client-side human service, use the IBM Process Designer web editor to define the service flow for the client-side human service, which consists of a series of interconnected steps. You can then test and run the client-side human service in the web browser. - Implementing an interactive BPD task by using a client-side human service
To create an interactive task that participants can perform in a web-based user interface, you can implement an activity in your business process definition (BPD) by using a client-side human service. To create a client-side human service for the implementation of your activity, use the Activity wizard. - Declaring variables for client-side human services
For each client-side human service that you create, you must declare variables to capture the data that steps or activities in that service flow use. - Calling another service from a client-side human service
You can call a IBM BPM service from within your client-side human service by adding an activity to the service flow. This activity calls another service that you can specify. The called service cannot be another client-side human service or a heritage human service. - Implementing exclusive gateways in client-side human services
An exclusive gateway controls the divergence of a sequence flow by determining the branching of the paths that the flow can take at run time. When you add an exclusive gateway to your client-side human service, you model a point in the execution of the service flow where only one of several paths can be followed, depending on a condition. - Adding notes to client-side human services
To provide additional textual information to your client-side human service, you can add notes to the service flow diagram by using the Note tool from the client-side human services palette. - Saving the state of a client-side human service during execution
To allow runtime users to save the state of a partially completed task, you can enable the execution context to be saved. By enabling the execution context to be saved, you enable a user who starts working on a task that includes multiple steps to close the browser and resume work later without losing work. - Validating coaches in client-side human services
To ensure that a coach that is in your client-side human service passes valid data in the flow, use the coach validation pattern to check its data. - Handling errors in client-side human services
You can handle errors in a client-side human service by using a stand-alone error event handler or you can catch errors at a particular step by attaching a boundary error event to an individual service. To throw specific errors and end the processing of the service flow at a specified step, you can use error end events. - Handling data changes in client-side human services
In instance details and task UIs, data can be changed both locally by the user or remotely by another user or service. The remote changes must be propagated to the user's browser to keep the data in the UI current. However, the user might have unsaved changes that need to be reconciled with incoming server updates. Use a data change event handler to react to and handle remote data changes. - Exposing client-side human services
In addition to implementing activities in a business process definition (BPD) or a case type, other people can use the client-side human services that you create in IBM Process Designer to create custom dashboards for IBM Process Portal or instance user interfaces for case instances. Or they can be exposed as URLs. - Adding HTML meta tags to client-side human services
To optimize your HTML pages for being viewed on a mobile device, you can define HTML meta tags in the underlying client-side human service. The HTML meta tags are added to the HTML header when the client-side human service is run. - Enabling work to be postponed and resumed at run time
If you want to enable Process Portal users to postpone and resume work at run time, you can add a postpone event to the client-side human service flow. The postpone event can be used only with client-side human services that implement tasks within a BPD or case type. - Navigation options for after service completion
To help the user go to a specific page after the client-side human service completes, you can configure the end event of the service to provide an alternative destination. - Running and debugging client-side human services
When you author a client-side human service, you use the Inspector in IBM Process Designer to iteratively test and observe how the client-side human service behaves at a detailed level. The Inspector can also be used for problem determination and to identify the source of errors. - Keyboard accessibility for client-side human services
In the Process Designer web editor, you can perform many actions by using built-in keyboard accessibility features. The keyboard accessibility features help you go to and edit client-side human service diagrams in the web editor without using the mouse. 
Managing client-side human services for multiple devices by using IBM MobileFirst
To enable users to complete business tasks on multiple device types, you can use IBM MobileFirst Platform Foundation to develop applications that are based on client-side human services that you modeled in IBM BPM and that are configured for use on multiple devices. The applications that you develop, optimize, and secure in MobileFirst can be deployed to multiple device types.