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