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: Specifies the page data for the formal parameters associated with the eventname event.
Note: If the data payload contains ComplexSpec parameters, you can view their structure in TIBCO Business Studio. There is no API to determine the structure. To view the structure in TIBCO Business Studio, you must export the XML schema, which shows the structure to which the data must conform. For information, see Obtaining Information from 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\"}]}"
            }
        }
    }
}