REST API - injectBusinessServiceEvent

The table summarizes the REST API - injectBusinessServiceEvent.

Request

Format
POST <baseurl>/businessservice/inject/<eventname>/<modulename>/<processid>/<processname>
Path parameters
  • eventname: Name of the event to be injected into the business service. Note: You cannot obtain this name programmatically. You must obtain it by examining the process in TIBCO Business Studio.
  • modulename: Name of the module that contains the business service.
  • processid: Unique identifier of the business service instance.
  • processname: Name of the business service.

modulename, processid and processname can be obtained from the previous startBusinessService or updateBusinessService response.

Query parameters responsetype=long (optional, default=JSON): Enumerated value defining the format of the data payload to be used in the response message - either XML or JSON.
Body dataPayload element: Secifies the page data for the formal parameters associated with the eventname event.

Note: You cannot determine the names of these formal parameters programmatically. Instead, you must obtain them by examining the process in TIBCO Business Studio.

Response

JSON Returns a JSON representation of the contents of an injectBusinessServiceEventResponse element.
XML Returns the contents of an injectBusinessServiceEventResponse element (from the BusinessService schema)

Example

Request
POST <baseurl>/businessservice/inject/Override/%2FUpdateDetails%2FProcessPackages%2FUpdateDetails.xpdl/pvm%3A0a10h/UpdateDetails
Request body
<payload payloadMode="JSON"> <serializedPayload>{"items":[{"$param":"UserName","$value":"Fortescue","type":"String","mode":"INOUT"}]}</serializedPayload>
    </payload>
Response
{
    "xml-fragment": {
        "@executionState": "IN_PROGRESS",
        "context": {
            "pageFlowTemplate": {
                "@moduleName": "/UpdateDetails/ProcessPackages/UpdateDetails.xpdl",
                "@processName": "UpdateDetails",
                "@version": "1.0.0.201302041238"
            },
            "processReference": {
                "id": "pvm:0a10h",
                "name": "UpdateDetails"
            }
        },
        "pageData": {
            "payload": {
                "@payloadMode": "JSON",
                "serializedPayload": "{\"items\":[{\"$param\":\"UserName\",\"$value\":[\"Fortescue\"],\"type\":\"String\",\"mode\":\"INOUT\"}]}"
            }
        }
    }
}