Output Endpoint with ServiceConfiguration (API/Web Service Call)

Please refer to the following post for more details: eFORMz API Management (Developer Resources)

There are two primary endpoints available to eFORMz customers. These are the ‘director’ and ‘output’ endpoints. For more on the ‘director’ endpoint, consult the following post: Director Endpoint with ServiceConfiguration (API/Web Service Call)

An “endpoint” is one end of a communication channel. When an API interacts with another system, the touchpoints of this communication are considered endpoints. For APIs, an endpoint can include a URL of a server or service. The place that APIs send requests and where the resource lives is called an endpoint.

The ‘director’ endpoint returns success or failure only. It processes data in the background. The ‘output’ endpoint processes data during the call and returns the results as part of the web service call. Both of these endpoints can take parameters either through the URL or in the data.

While the portion of the URL with authentication is encrypted for transmission, many people have policies restricting this practice. Passing the parameters in the data, including authentication, is possible using either XML or JSON. The order or sequence of elements in either format is not relevant to the processing.

URL

http://localhost:8001/servlet/com.minisoft.AppServer.AppServer?APP=com.minisoft.eformz.eFORMzApp&config=projects/OutputGuideServer/configOutputUsePostData.xml

XML

<?xml version="1.0" encoding="utf-8"?> 
<ServiceConfiguration ServiceType="output" project="projects/OutputGuideServer/MapPackSlipData0.efz" format=".xml"> 
  <InputData format="XML"> 
    <Root> 
      <abc>test</abc> 
    </Root> 
  </InputData> 
</ServiceConfiguration> 

The root node must be named ServiceConfiguration and the parameters are specified as attributes of that node. The output parameter directs the eFORMz web service to return the output of an eFORMz project specified by the project parameter. The calling application can pass in input data for the project in a variety of ways. The InputData node with the attribute format specifies the format of the embedded data. The data passed to the project is the Root node and all of its descendant nodes (abc in this example).

References

For more details on the eFORMz API, consult the following posts:

eFORMz API .NET Web Service Call
eFORMz API URL Parameters
Web Service POST call to “Wake Up” a “Sleeping” Queue: Part 1
Web Service POST call to “Wake Up” a “Sleeping” Queue: Part 2
Web Service POST call to “Wake Up” a “Sleeping” Queue: Part 3
Web Service POST Call Output Advantages
Web Service POST Call Output