Show TOC Start of Content Area

Procedure documentation Configuring Logical Ports  Locate the document in its SAP Library structure

Use

Logical ports (LPs) contain the configuration of the client-side SOAP runtime, such as the access URL or security settings. These are required if Web service calls are executed using proxies.

The Web service port is part of the WSDL description. This defines a URL where the service is to be called. As a rule, this URL is generated directly into the proxy object. However, this can cause problems whenever the proxy is transported into a system landscape (for example, from the test system into the productive system). In this case, the proxy would still attempt to call the Web service on the test server although the proxy should point to the productive system. The proxy could be re-generated or the coding could be changed manually. Due to the risk of errors with this method, the configuration data in the SAP Web Service Framework is separated from the implementation. After transport or re-deployment of the proxy, the URL and other important parameters can be adapted using a simple editor.  

The LPs provided correspond to the Web service configurations created for the Web service.

You can add LPs that enable you to access the Web service with different settings – for example, different users.

Note

If a WS client was generated on the basis of a tModel, no LP is available. An LP can only be generated from the WSDL document of the business service. 

Procedure

Open a logical port if you wish to change settings for the communication between the client and the Web service.

This graphic is explained in the accompanying text

Choose the communication type you want. If you will be using stateful communication, choose Use HTTP cookie-based sessions. Choose Use SAP Web AS 6.20 sessions if you want to access an SAP Web Application Server (Release 6.20). 

Choose Send Message ID, if you want to send an additional SOAP header containing a unique ID (GUID) that identifies the message. Application programs can then access this message ID.

If necessary, make the required settings in the Security tab to ensure security during exchange of data. You can specify the authentication data for deployable proxies at runtime in the Visual Administrator. (See also Authentication.) The authentication for standalone proxies takes place in the client program (see also, Using the Security Protocol).

To add an LP, proceed as follows:

...

       1.      Select Logical Ports in the Client Explorer in the Web Service Perspective and, from the context menu, choose New  Add Logical Ports.

This graphic is explained in the accompanying text

The <port type> information of the selected WSDL document must be identical to the WSDL document of the proxy.

       2.      Make the required settings in the logical port.

       3.      If required, assign the attribute Default Logical Port to a logical port through the context menu.

Note

Web service clients based on an SAP WSDL document must be generated again after Web service features have been changed. Logical ports cannot be adjusted automatically.

 

See also:

Logical Ports

 

 

End of Content Area