The Transform Step (Outbound, REST)
Add this step if you need to invoke an XSLT transformation file to transform the native service's response messages into the format required by the consumer applications, before
CloudStreams returns the responses to the consumer applications. For more information about when to use the Transform step, see
The
Transform Step (Inbound, REST).
To add the
Transform step (outbound, REST)
1. Open Software AG Designer and display the CloudStreams Development perspective by clicking Window > Open Perspective > Other > CloudStreams Development.
2. In the CloudStreams Governance view, expand your CloudStreams Governance project and double-click the virtual service name.
3. In the virtual service editor, expand Out Sequence.
4. To add the Transform step, right-click Out Sequence and select Transform.
The Transform step is added under the Out Sequence step.
5. Click Transform and complete the following fields in the General page in the Properties view.
Option | Description |
Name | You can optionally change the step name to any other name. There are no naming restrictions. |
XSLT File | The XSLT file to transform the response message before it is returned to the consuming application. Click Browse to select a file from your file system and click Save. The XSL file uploaded by the user should not contain the XML declaration in it (xml version="1.0" encoding="UTF-8"). This is because when the virtual service is deployed to CloudStreams, CloudStreams embeds the XSL file in the virtual service definition (VSD), and since the VSD itself is in XML format, there cannot be an XML declaration line in the middle of it. This can lead to unexpected deployment issues which can be avoided by making sure the XSL file does not contain the declaration line. Note:
If you make changes to the XSLT file in the future, you must re-deploy the virtual service. |
6. To create an additional Transform step, right-click In Sequence and select Transform from the context menu.
7. To delete a Transform step, right-click Transform and click Delete.