Injecting Data into a Business Service

You can inject data into a business service multiple times while it is in progress, regardless of whether the flow from any previous occurrence is still in progress.

You can use an event handler to do this. An event handler is a catch intermediate event with no specific trigger and incoming flow that can be triggered by an external client application using the objectAPI. Note that the event handler does not have to happen for the business service to complete.

The following example illustrates injecting data into a business service. It involves listing all the deployed business services, starting a business service, and while it is running, injecting data.

Injecting Data into a Business Service

Procedure

  1. Find out the list of deployed business services by calling listBusinessServices.

    This function returns the module version number, which is required as an input when calling startBusinessService.

    You can choose to start one of the business services returned.

  2. Call startBusinessService and specify the module name and process name to start the selected business service.

    This returns the instance ID that is required for the next step in which data is injected into the business service.

  3. Call injectBusinessService.

    This injects the provided DataPayload into the formal parameters associated with the business service.