To enable access from the SAP cloud solution to a remote application, you can create an external Web service integration scenario using SOAP.
SOAP (Simple Object Access Protocol) is an xml-based protocol specification for exchanging structured information via Web services. The integrated Web service is described by a WSDL file. With SOAP, you can use different transport protocols, for example, HTTP or SMTP. SOAP uses named operations, each implementing business logic through different interfaces. WS-Security and Reliable Messaging are supported.
For more information, see External Web Service Integration.
You have opened a solution in the studio.
You have saved the WSDL file of the Web service that you want to integrate into your solution on your local computer.
If the WSDL file refers to one or more XML schema documents, you have saved the schema documents on your local computer.
If the WSDL file refers to XML schema documents and the value of the schemaLocation attribute in the WSDL file is a URL, you have replaced the URL with the location of the XML schema document on your computer. Note that the document’s location must be relative to the location of the WSDL file.
For more information about WSDL and XML schema document, see Web Services.
|
Save the WSDL file and the XML schema documents in the same location on your computer. In this case, the values of the schemaLocation attribute are the XML schema document names only. |
In the Solution Explorer, right-click your solution and select Add New Item.
The Add New Item dialog opens.
Select
SAP
Service Integration
External Web Service Integration
and click Add.
The External Web Service Integration Wizard opens.
In the Enter Web Service Name and Type step, enter a name for the Web service and select SOAP. Click Next.
In the Import WSDL File Documents step, do the following:
Select the WSDL file of the Web service that you want to integrate into your solution.
Select the Use Session ID checkbox, if you want the external Web service to allow stateful communication, that is, return a session ID/cookie when it is called.
Optional: If the WSDL file refers to one or more XML schema documents, click Add, select the XML schema document and click Open.
Change the port name, if required.
Click Next.
In the Define Communication Scenario step, do the following:
Optional: Select the Create Communication Scenario checkbox to create a communication scenario that includes the Web service integration that you have defined.
If you choose not to select this option, you must assign the Web service integration to a communication scenario later. For more information, see Define a Communication Scenario.
Enter a name for the communication scenario. It must start with a capital letter and can have 25 characters (letters, digits, and underscores).
Optional: Select the Allow Non-Secure URLs (HTTP) checkbox to allow non-secure communication.
Click Next.
On the Review page, review your entries and click Finish.
In the Solution Explorer, an external Web service integration file with the extension .wsid (
) together with the .wsdl file () appears. If you have created a communication scenario, the corresponding .csd file (
) is also
displayed.
In the Solution Explorer, right-click the .wsid file and click Activate.
If you have created a communication scenario, right-click the .csd file and click Activate.
You have created an external Web service integration and can now do the following:
Edit your external Web service integration.
To do so, right-click the .wsdl file. The document window opens where you can edit the Web service integration definition
For more information, see Modify an External Web Service Integration (SOAP).
Test the service operations.
Right-click the .wsid file and select Test Service Operations.
For more information, see Test a Service Operation.
Create a communication scenario
If you have not created a communication scenario yet, right-click the .wsid file and select Create Communication Scenario Definition.
For more information, see Define a Communication Scenario.
Create a communication system
If you have created a communication scenario, right-click the .csd file and select Manage Communication System. Afterwards, you can use the communication system to create a communication arrangement.
For more information, see Create a Communication System and Create a Communication Arrangement.