Integration Server 10.15 | Built-In Services Reference Guide | Flow Folder | Summary of Elements in this Folder | pub.flow:invokeService
 
pub.flow:invokeService
WmPublic. Dynamically invokes any Integration Server public service and optionally returns the output from the invoked service in the pipeline for pub.flow:invokeService.
Input Parameters
ifcname
String The flow interface name of the service to be invoked. For example, pub.math.
svcname
String The name of the service to invoke. For example, addInts.
pipeline
Document. Optional. The name of the pipeline for the pub.flow:invokeService service.
Note:
If pipeline is not specified, the invoked service returns the output parameters in its own pipeline.
Output Parameters
If you specify a value for pipeline, the pub.flow:invokeService service returns the output parameters defined for the service specified by ifcname and svcname. For example, pub.flow:invokeService invokes pub.math:addInts as follows:
ifcname = "pub.math"
svcname = "addInts"
pipeline = "mypipeline"
mypipeline.num1 = "100"
mypipeline.num2 = "200"
In this case, pub.flow:invokeService returns the output parameter as follows:
mypipeline.value = "300"
If you do not specify a value for pipeline, the invoked service returns the output, not pub.flow:invokeService. For example, if you use pub.flow:invokeService to invoke pub.math.addInts, the output is returned in the pipeline for pub.math.addInts.
Usage Notes
If the parameters specified by the service invoked by pub.flow:invokeService are not present or not properly specified, Integration Server issues an exception appropriate for the invoked service.
Integration Server issues a ServiceException for pub.flow:invokeService if either of the following is not present in the flow service:
*The interface specified by ifcname
*The service specified by svcname