Show TOC

Configuring a Service ConsumerLocate this document in the navigation structure

Use

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 in five ways. Depending on the way you choose to create a logical port, you need the following information:

Method to Create a Logical Port

What You Need to Know

Based on the WSDL document for a service

  • 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.

  • The access parameters for the WSDL document (Alternatively, you have the WSDL document stored as a file.)

Manual Configuration

If a WSDL document is not available, you need to 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.

Based on the Services Registry

Information about the binding that you want to call so that you can search for its WSDL in the Services Registry.

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

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.
Procedure

Creating a Logical Port

  1. From the main screen of SOA Manager, go to the Service Administration tab.

  2. Select Web Service Configuration.

  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 about consumer proxies:

    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 five 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

    Based on the Services Registry

    1. Specify a Services Registry in which you want to search for the binding.

    2. Search for the binding in the Services Registry.

      You can specify the Identifiable Business Context or the service definition as search criteria.

    3. Select a binding.

    4. Continue with step 3 from the WSDL-based configuration above.

  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. Click the internal name of the consumer proxy to display configuration and design time information.

  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.

More Information