Show TOC

Configuring Individual Web Service ClientsLocate this document in the navigation structure

Use

A logical port is a reference to a service endpoint available at a unique service endpoint URL on the provider system. That is why, you create a logical port based on the service endpoint URL of the respective service endpoint. You can create a logical port in any of the following ways:

  • Based on the location of the WSDL document (WSDL URL) of the service, which holds the service endpoint of a configured service definition.

    The WSDL document of the service contains the service endpoint URLs of all the service endpoints grouped into the service. You can take the WSDL URL of the WSDL document from the details of the service definition (see the Prerequisites below).

  • Manually, by using the exact location of a particular endpoint (service endpoint URL).

    The endpoint URL is available in the WSDL document of a service. It is displayed in the location property of a port as the code excerpt below shows:

    <service xmlns="http://schemas.xmlsoap.org/wsdl/" name="service name">
 <port name="endpoint name" xmlns:bref="http://ip.test/" binding="bref:DefaultService_">
  <address xmlns="http://schemas.xmlsoap.org/wsdl/soap/" location="endpoint URL" />
 </port>
</service>
    Note

    For every consumer proxy deployed on the application server, by default system creates a logical port. This logical port points to the URL on which the Web service was available when the proxy was generated for that Web service (Normally, this would be a development or a test system, not a productive one). If you want to use this default logical port, you have to manually edit by setting the service endpoint URL of the service endpoint that you want the logical port to call.

    Note

    In Single Services Administration application, the system does not display the following entities (consumer proxies):

    • Callable objects that are created with Guided Procedures framework

    • Automated activities and events that are created with Business Process Management framework

    • Adaptive Web service models that are created with Web Dynpro framework

    • Web service operations that are created with Visual Composer framework

    The system displays information about the following consumer proxies:

    • Consumer proxies which use RFC connectivity.

    • Consumer proxies that are created with Composite Designer framework and contain extension points.

    You cannot configure these entities in Single Service Administration application.

Prerequisites

  • To create a logical port based on the location of a WSDL document, you need the following information:

    • The URL to the WSDL document of the service.

      You have to use the URL to the WSDL of a configured service definition. It contains the settings of the service definition in the form of policy assertions compliant with the WS-Policy standard. You can copy the WSDL URL from the details about the service definition. It ends with the following parameter: mode=ws_policy .

      More information: Managing WSDL Documents .

    • The name of the service endpoint for which you want to create a logical port.

  • To create a logical port manually by using the service endpoint URL directly, you have to know the service endpoint URL.

Procedure

Finding a Consumer Proxy

  1. Log on to the SAP NetWeaver Administrator using the following address: http://[host]:[port]/nwa

  2. Navigate to Start of the navigation path SOA Next navigation step Management Next navigation step Application and Scenario Communication Next navigation step Single Service Administration End of the navigation path

    Alternatively, you can use the quick link /ssadmin as follows: http://<host>:<port>/nwa/ssadmin

  3. Find the consumer proxies that you want to configure. Proceed as follows:

    • Search for consumer proxies by name (basic)

      1. Choose the Search tab, and then choose Basic.

        The basic search mode is enabled if the Advanced switch is displayed on the Add Services window.

      2. In the Find field, enter a consumer proxy name.

        You can use an asterisk (*), or a question mark (?), as wildcards in the search string.

      3. In the Search by dropdown menu, select the search method you want to use.

        The table below outlines the meaning of each state.

        Search Item

        Meaning

        WSDL Porttype Name

        This option enables search by the porttype name of the consumer proxy, included in the WSDL document.

        Internal Name

        This option enables search by the internal name with which the consumer proxy is deployed on the system.

      4. In the State dropdown menu, choose the state of the consumer proxy.

        The table below outlines the meaning of each state.

        State

        Meaning

        Activated/Deployed

        The consumer proxy does not have a callable logical port with runtime configuration settings.

        Configured

        The consumer proxy has a callable logical port with runtime configuration settings.

      5. Choose Go .

    • Search for consumer proxies by name (advanced).

      1. Choose the Search tab, and then choose Advanced .

        The advanced search mode is enabled if the Basic switch is displayed on the Add Services window.

      2. In the Find , Search by , and State fields, enter the basic search criteria.

      3. Choose a consumer proxy classification from the Select Classification dropdown menu.

      4. Choose a classification from the tables, and then add or remove it using the arrows.

      5. Choose Go .

    • Browse consumer proxies by classification.

      1. Choose the Browse tab.

      2. From the dropdown menu, select a consumer proxy classification. The system lists all available consumer proxies, which match your search criteria.

    The system lists all available consumer proxies that match your search criteria.

  4. Choose the consumer proxy you want to configure, and choose the Configuration tab.

    You can create and configure a new logical port or edit an existing one.

Creating a Logical Port

Choose the New button.

  • To configure XI transport for an outbound proxy, choose XI 3.0 Transport Binding and proceed as follows:

    1. Enter name for the logical port.

    2. In the Sender Party field, enter new sender party name.

    3. In the Sender Service field, enter new sender service name.

    4. Choose Finish .

  • To configure SOAP transport for an outbound proxy, choose SOAP Transport Binding and proceed as follows:

    1. Choose Next .

    2. Choose the source of the endpoint URL that you want to use. The following options are available:

      • Import from WSDL URL

        The system automatically extracts the endpoint URL from the WSDL document of a service.

        1. Choose Import from WSDL URL , and then choose Next .

        2. At the WSDL URL step, enter the path to the WSDL document, and then enter a user name and a password, and then choose Next .

        3. At the Service Endpoint step, choose the name of the endpoint for which you want to create a logical port, and then choose Next .

        4. At the Details step, the Logical PortName and the Web Service EndpointURL fields are automatically populated with the name of the service endpoint, and the service endpoint URL. Proceed as follows:

          1. Choose Set as default if you want to mark the logical port as the default one. In this case, if the consumer application is not designed to call a specific logical port for a service, it calls the logical port marked as default.

          2. Set the necessary runtime configuration settings.

            The Configuring Web Service Connectivity Options to Logical Ports document explains the runtime settings you can apply for the logical ports.

            More information: Configuring Web Service Connectivity Options to Logical Ports

        5. Choose Save .

      • Enter Manually

        The system uses the exact endpoint URL to create a logical port.

        1. Choose Enter Manually , and then choose Next .

        2. At the Details step, proceed as follows:

          1. Enter a unique name for the logical port.

          2. Choose Set as default if you want to mark the logical port as the default one. In this case, if the consumer application is not designed to call a specific logical port for a service, it calls the logical port marked as default.

          3. In the WS EndpointURL field, enter the endpoint URL.

          4. Set the necessary runtime configuration settings.

            The Configuring Web Service Connectivity Options to Logical Ports document explains the runtime settings you can apply for the logical ports.

            More information: Configuring Web Service Connectivity Options to Logical Ports

        3. Choose Save .

Editing a Logical Port

  1. In the Logical Ports table, choose a logical port, and then choose Edit .

    Note

    If you want to edit logical port that the system created during the deployment of the consumer proxy, you have to manually edit its current service endpoint URL. You have to provide the URL to a service endpoint in your landscape.

  2. To edit the Web service endpoint URL, choose the Details tab, and then in the WS Endpoint URL field, enter a valid service endpoint URL.

  3. Set the necessary runtime configuration settings.

    The Configuring Web Service Connectivity Options to Logical Ports document explains the runtime settings you can apply for the logical ports.

    More information: Configuring Web Service Connectivity Options to Logical Ports

  4. Choose Save .