Show TOC

Procedure documentationConfiguring a Consumer Proxy Locate this document in the navigation structure

 

To configure a consumer proxy to access a particular service, you need to create and configure one or more logical ports.

A logical port is created for a specific consumer proxy to access one particular binding on the provider system. You can create more than one logical port for the same consumer proxy. However, each logical port can point to only one binding.

You can create a logical port using the following methods. Depending on the method you choose to create a logical port, you need the following information:

Method to Create a Logical Port

What You Need to Know

WSDL Based Configuration

  • The URL that points to the WSDL document for the service. This is the URL for the binding that was generated for the Web service provider. You also need the access parameters for the WSDL document.

  • The WSDL file that you intend to use, either saved on your local machine or already uploaded to the system.

Manual Configuration

If a WSDL document is not available, you can create a logical port manually.

  • The URL of the binding

  • The configuration settings that the provider expects

Process Integration Runtime

The consumer system must be configured as a Process Integration Engine so the logical port that you create can use the Process Integration runtime.

Local Shortcut Configuration

The service definition name. A local shortcut does not leave the system, so the service definition is called using a function.

Template Based Configuration

and

WSDL Based Configuration with Template

Using templates is for advanced users only and should only be employed in cooperation with SAP. You should create a support incident using component BC-ESI-WS-ABA-CFG.

Caution Caution

When using templates to configure consumer proxies, no checks are performed for data consistency or correctness. Therefore, any errors contained in templates will only be displayed when they occur during runtime.

End of the caution.

Procedure

Creating a Logical Port
  1. From the main screen of SOA Manager, go to the Service Administration tab.

  2. Select Web Service Configuration.

    Note Note

    The navigation of the Web Service Configuration page has been updated and improved. You can switch to the previous version using the link that appears at the top of the window when you first open the page. The option of switching to the old version is provided with every session of SOA Manager.

    End of the note.

    Caution Caution

    The new user interface for Web Service Configuration allows more security settings to be configured than in the previous version. If you configure any web service settings that are only available in the new user interface, you can no longer make changes to the Web service using the old interface.

    End of the caution.
  3. Specify or search for a consumer proxy.

    There are many search criteria that you can choose from. You can add rows for additional search criteria by choosing the Add icon.

    More information:

    Generating a Consumer Proxy

  4. Select the consumer proxy from the overview and click the internal name to display configuration and design time information about the consumer proxy.

  5. Go to the Configurations tab.

    All logical ports of the consumer proxy are displayed in a list.

  6. To create a new logical port, choose Create and select one of the above-mentioned configuration types.

  7. Specify a name and an optional description for the new logical port.

    To make this logical port the default logical port, select Logical Port is Default. If a consumer application is not configured to call a specific logical port, it calls the default logical port.

  8. Depending on the method of configuration, proceed as follows in the table below:

    WSDL-Based Configuration

    1. Specify the WSDL URL and the access settings or import the WSDL file.

      For WSDL based configuration, the system extracts the binding URL from the WSDL document for the service.

    2. Select a binding.

    3. Depending on the binding you choose, configure the consumer security, for example user/password.

    4. (Optional) Modify the settings of the transport binding.

    5. (Optional) Configure further parameters for the SOAP Protocol.

    6. (Optional) Specify operation settings, for example, SOAP Action or Inbound Message Action.

    Manual Configuration

    1. Specify the consumer security settings.

    2. Specify the settings of the transport binding (URL and transport binding type).

    3. (Optional) Configure further parameters for the SOAP Protocol.

    4. (Optional) Specify operation settings, for example, SOAP Action or Inbound Message Action.

    Process Integration Runtime

    You do not have to specify anything as the Process Integration Runtime is used.

    Local shortcut configuration

    Specify the service definition.

  9. Choose Finish.

  10. Check the configuration.

  11. Save.

    The consumer proxy is now generated and configured.

Editing a Logical Port
  1. Go to the Service Administration tab and select Web Service Configuration.

  2. Specify a consumer proxy.

  3. 3.Click the internal name of the consumer proxy to display configuration and design time information.

  4. 4.To edit a logical port, choose the Edit icon in the Actions column.

  5. Specify the settings that you require.

    More information: Creating a Logical Port (above)

  6. Save.