Adding Custom SOAP Applications

Application Integration - Software AG Hosted Environment : Integration Cloud : Applications : Adding Custom SOAP Applications

The Applications screen allows you to create a Custom SOAP Application. The Custom SOAP Application enables you to access third party Web Services hosted in the cloud or on-premise environment. The Custom SOAP Application uses a WSDL to create consumer operations and can be a trigger or action or both.

The following features are supported for Custom SOAP Applications:

A Web Service implementation that follows the WS-I Basic Profile 1.1 specification.

Custom SOAP Applications can be created by uploading a WSDL file or by using a valid WSDL URL that can be accessed over a network.

Web Services that use WS-Security. Custom SOAP Applications can be created with WSDLs that are annotated with WS-Security Policy/Policies.

Web Services with SOAP version 1.1 and 1.2 and Style/Use as Document/Literal and RPC/Literal (RPC/Encoded model is not supported for SOAP version 1.2).

The following SOAP Binding types are supported:

SOAP over HTTP.

SOAP over HTTPS.

Authentication type: HTTP Basic Token.

Custom SOAP Applications have the following restrictions:

The WSDL and associated schema(s) must be accessible through a publicly or locally accessible URL.

Only WSDLs with WS-Security policies are supported. Any other policies, for example, WS-Addressing, WS-Reliable Messaging, and so on, are not supported. If you create Custom SOAP Applications with WSDLs having non-WS-Security Policies, exceptions may appear while executing Integrations.

Manual addition of WS-Security Policies in a Custom SOAP Application is not supported. Custom SOAP Applications with WS-Security can be created with only policy-annotated WSDLs, that is, WSDLs that already have WS-Security Policies annotated in them.

SOAP over JMS is not supported.

Only Basic Authentication is supported. Other authentication types such as Digest, NTLM, and Kerberos are not supported.

You will not be able to attach or upload a file while executing an Integration.

To add a Custom SOAP Application

1. From the Integration Cloud navigation bar, click Applications.

2. Click Add New Application.

3. Provide a name and description of your Custom SOAP Application. The description you enter here will appear in the Applications page. Required fields are marked with an asterisk on the screen.

4. In the Type field, select the Application type. For example, select SOAP if you want to create a SOAP-based Application.

5. Click Browse next to the Application Icon if you want to select a different icon for your custom Application. The icon must be an svg file and the size cannot exceed 50 KB.

6. Click Next and specify the WSDL source. Select URL if you want to specify the URL of the WSDL. The URL should begin with http:// or https://. The URL is used to retrieve the WSDL for the Web Service. Select File, and then click Choose File if you want to select the WSDL from your local file system. You can click the

icon beside the Choose File button if you want to add separate elements of a service definition after import, as WSDLs or XSDs to the primary WSDL.

Note:

Ensure that you add the primary WSDL as the first WSDL, and then add the separate elements of the service definition, for example, dependent WSDLs and XSDs to the primary WSDL.

7. Enter the user name and password in the Authentication section if authentication is required to access the WSDL URL.

8. Click Next to review the details you have entered, and then click Finish to create the Custom SOAP Application.