Configuring the Consumer Side of Business Scenarios

Prerequisites

You have deployed consumer applications on your client system.
You have configured connections to provider systems on which the Web services are running.

For more information, see Creating Connections to Provider Systems .
You have configured user accounts for all Web services that you want to consume.

For more information, see Creating User Accounts .

Context

SAP NetWeaver Administrator allows you to create and configure the consumer side of business scenarios out of different consumer applications. To create a business scenario, you create a collection of Service Groups from the applications that are built in different tool sets and deployed on your client system. You create the collection and use it for a particular business scenario that may involve multiple applications.

When you configure the consumer side of a business scenario, you specify the runtime settings that apply to the applications in the scenario. You configure the consumer side of a business scenario by assigning a connection to a provider system to each of its Service Groups. The framework creates configuration entities (logical ports) for the consumer proxies that consume the Web services grouped in the Service Groups. The logical port contains the exact policies and settings and enables the applications in the scenario to consume a Web service. If the consumer application is not designed to call a specific logical port for a service, it calls the logical port that is marked as default . The newly created logical port is marked as the default one only if the application does not have an existing default logical port by the time of the configuration (the assignment of the Service Group).

Procedure

Log on to SAP NetWeaver Administrator .
Choose SOA Application and Scenario Communication Business Scenario Communication

Alternatively, you can use the quick link /businesscfg as follows:

http://<host>:<port>/nwa/businesscfg

The Business Scenario Communication screen opens.
Proceed with one of the following:
- Create a new scenario. For more information, see Creating Business Scenarios .
- Edit an existing scenario. For more information, see Editing Business Scenarios .
- Select a business scenario and activate or deactivate it using the corresponding button. The effects of performing each of these actions is as follows:
  - For every Service Group in the activated scenario to which an active provider system connection has been assigned, the system creates a logical port to the consumer proxy that refers to the Service Group. The logical port has the runtime settings of the connection to the provider system.
  - When you deactivate scenarios, the system considers them deleted. However, the business scenario and its assignments keep existing on the system, and you can activate and use them again at a later stage.
    
    For every Service Group in the deactivated scenario, the system deletes the logical ports of the consumer proxies that refer to the service references.

Results

After you save the business scenario, the system performs a background process. During the background process, the framework examines the connections to the provider systems that you assigned to the Service Groups, and creates configuration entities for the consumer proxies - logical ports. The system applies the settings from the provider system's connections to the logical ports.

The Processing State column of the Service Group table shows the state of the configuration. You can display more information about the processing state in the Log Viewer application.

You can display the logging and tracing information about a Service Group or a service provided in a consumer application by choosing the Show Log or Show Trace buttons, respectively. The system opens the log viewing application and displays additional information about the current assignment. For more information, see Log Viewer .

Note

If the WSDL document of the service endpoint that the client application consumes (using a service reference) does not contain any policies or SAP-specific features, the security mechanism of a service endpoint cannot be determined. In this case, SOA configuration for connectivity examines only the security policies of the communication profile that is used in the system connection and the assigned user account. The system tries to consume the service endpoint using the available security mechanisms and creates a logical port for the successful attempts.

Despite the created configuration entities, it is possible that the logical port remains inconsistent with the security policies of the service endpoint and thus cannot consume the Web service correctly. In this case, the system displays the Processed with Warnings status of the Service Group assignment. This warning shows that the communication between the logical port and the service endpoint may be corrupted or even impossible. We recommend that you manually create configuration entities (logical ports) of the Service Groups (and the respective service references) which consume service endpoints whose security policies cannot be determined.