SOAP API - startBusinessService

The table summarizes the SOAP API - startBusinessService.

Request Uses the startBusinessService element (from the BusinessService schema).
Parameter notes
  • businessServiceDefinition: can be obtained from listBusinessServices . It consists of the moduleName, processName, and version of the specified business service.
  • formalParams: details of formal parameters used. You must obtain this information directly from the relevant project in TIBCO Business Studio.

    Also, 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.

  • responseFeedType: specifies the feed type expected in the response. The value can be one of XML or JSON.
  • cacheTimeout: specifies the time to wait for the specified business service to start.
Response Returns a startBusinessServiceResponse element (from the BusinessService schema)
Example Request:
<soapenv:Body>
      <bus:startBusinessService>
         <businessServiceDefinition moduleName="/PageflowSolution/Process Packages/ProcessPackage.xpdl" processName="RequestCall" version="1.0.0.201108111516"/>
       </bus:startBusinessService>
   </soapenv:Body>
  Response:
<SOAP-ENV:Body>
      <startBusinessServiceResponse xmlns="http://business.api.busserv.n2.tibco.com">
         <pageResponse executionState="IN_PROGRESS" xmlns="">
            <context>
               <pageFlowTemplate hasFormalParameters="false" moduleName="/PageflowSolution/Process Packages/ProcessPackage.xpdl" processName="RequestCall" version="1.0.0.201108111516"/>
               <processReference>
                  <id>pvm:0a101o</id>
                  <name>RequestCall</name>
               </processReference>
            </context>
            <pageData>
               <pageReference activityId="pvm:001g1o.3" activityModelId="_qTxqOlnREd-qRKl4nKSPqA" activityName="CollectData" moduleName="/PageflowSolution/Process Packages/ProcessPackage.xpdl" moduleVersion="1.0.0.201108111516" processName="RequestCall"/>
               <payload payloadMode="XML">
                  <XmlPayload>
                     <inouts array="false" name="UserName" optional="true" type="String">
                        <simpleSpec/>
                     </inouts>
                     <inouts array="false" name="PhoneNumber" optional="true" type="String">
                        <simpleSpec/>
                     </inouts>
                  </XmlPayload>
               </payload>
            </pageData>
         </pageResponse>
      </startBusinessServiceResponse>
   </SOAP-ENV:Body>