Sending data to a web service

To send data to a web service, the model in ION Desk is as follows. A document flow contains a web service activity, usually at the end of the flow. In the activity, the web service connection point to be used is selected. This diagram is an example document flow:

In the web service connection point the connection settings must be defined and the WSDL must be loaded, as described earlier.

After that, you can model:

• The operation to be used.
• The BOD document to be used. The document is defined using a document type (such as SalesOrder) and a verb. In this scenario, you can use these verbs : Sync, Acknowledge, Load or Update.
• The transformation from the BOD document to the web service input.

  • You can use an automatic transformation. In that case the web service input must be inside the noun element of the BOD. Because the required input for the web service operation is known, an XSD is included in the WSDL. A custom BOD can be generated in the ION Registry.

    In case of automatic transformation, the incoming BOD must contain exactly one noun instance. If it contains no noun instance or multiple noun instances the BOD is rejected, resulting in a Confirm BOD.

  • You can use your own transformation by selecting Advanced. In that case you must provide an XSLT to map the incoming BOD to the web service request. This provides more flexibility. For example, you can set header elements in the web service request, or you can retrieve the required data from an incoming standard BOD. But it is more complex to model.

    When using the Advanced transformation, click Details to specify the transformation. If no XSLT was specified before, a default XSLT is provided. Use this template as a starting point. It is not a working XSLT.

    The Advanced transformation option supports both XSLT "1.0" and "2.0" standards. Specify the appropriate version you want to use in the version attribute of the XSLT header.