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
ifcnameThe service specified by
svcname