Grouping and Configuring Web Services in Business Scenarios

Use

To have Web services that run on your local system consumed by applications, you have to create runtime configuration for these Web services. SAP NetWeaver Administrator enables you to group and configure service definitions at one go in business scenarios. You configure the groups of service definitions by assigning communication profiles to them. The communication profiles apply policies and settings to the service definitions, and the system creates configuration entities - service endpoints, based on these profiles.

You create a business scenario and group multiple services that logically operate together in a particular business process. By grouping the service definitions in business scenarios and assigning different communication profiles to them, you configure and consume these services according to your business case.

Note

You cannot add XI 3.0-compatible Web services to a business scenario and cannot configure them using the procedure described below.

Prerequisites

You have created communication profiles. For more information, see Preparing Communication Profiles .
If you want to edit, activate or deactivate a business scenario, the scenario has to be available.

Procedure

Accessing Business Scenarios

Log on to the 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

Creating a Business Scenario

Choose New .
On the General step, enter a name and description of the scenario and then choose Next twice.
On the Provider Side step, add service definitions to the business scenario and then assign a communication profile as follows:
1. Add a service definition to the business scenario.
  
  The Adding Service Definitions to a Business Scenario section below outlines the steps you have to complete to add a service definition.
2. Choose a service definition from the table, and then choose Assign Profile .
3. From the Assign Profile window that opens, choose a communication profile, and then choose OK .
  
  The Assigning and Unassigning a Communication Profile to a Service Definition section below outlines the steps you have to complete to assign or unassign a profile to a service definition.
Choose Finish .

Editing a Business Scenario

Choose a business scenario from the table, and then choose Edit .
On the Provided Services tab, proceed as follows:
- The Adding Service Definitions to a Business Scenario section below outlines the steps you have to complete to add a service definition.
- To remove a service definition from the business scenario, select it in the service definition table and choose Remove .
- The Assigning and Unassigning a Communication Profile to a Service Definition section below outlines the steps you have to complete to assign or unassign a profile to a service definition.
Choose Save .

Adding Service Definitions to a Business Scenario

Choose Add .

On the Add Services window that opens, search for the service definitions that are deployed on your local system:

Search for service definitions by name (basic)

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.
In the Find field, enter the service definition name.

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

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

The table below outlines the meaning of each state.

State	Meaning
WSDL Porttype Name	This option enables search by the port type name of the Web service, included in the WSDL document.
Internal Name	This option enables search by the internal name with which the Web service is deployed on the system.
Free Text	This option enables searching by free text, executed by the search engine.

In the State dropdown menu, choose the state of the service definition.

The table below outlines the meaning of each state.

State	Meaning
Modeled	The service interface is only modeled and does not have any implementation. The service definition does not have a callable service endpoint with runtime configuration settings.
Activated/Deployed	The service definition does not have a callable service endpoint with runtime configuration settings. However, the service operations already have an implementation.
Configured	The service definition has a callable service endpoint with runtime configuration settings.

Choose Go .

Search for service definitions 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 service definition 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 service definitions by classification.
1. Choose the Browse tab.
2. From the dropdown menu, select a service definition classification.

Select a service definition from the result table and then choose OK .

To select multiple entries from the list, on your keyboard press and hold the SHIFT or CTRL keys and then choose the relevant service definitions.

Assigning and Unassigning a Communication Profile to a Service Definition

Assign a communication profile.
1. Choose a service definition from the table.
2. Choose Assign Profile .
  
  The Assign Profile window opens.
3. To find communication profiles, in the Value field, enter a name of a profile and then choose Go .
  
  You can use an asterisk (*), or a question mark (?) as wildcards in the search string.
4. Select an entry from the table, and then choose OK .
Unassign a communication profile.
1. To unassign a profile from a service definition, choose an entry from the table.
2. Choose Unassign Profile .

Activating and Deactivating Business Scenarios

From the list of business scenarios, choose an entry, and then to activate or deactivate the scenario, choose Activate or Deactivate respectively.

The table below outlines the effect of the possible changes you can make to the status of a business scenario.

User Action	System Response
You set the status of a business scenario to Active .	For every service definition in the activated scenario to which an active communication profile has been assigned, the system creates a service endpoint. If the communication profile has more than one version, the system creates a service endpoint for each active profile version. The service endpoint has the runtime settings of the profile version.
You set the status of a business scenario to Inactive .	When you deactivate scenarios, the system considers them deleted. However, the business scenario and its assignments still exist in the system, and you can activate and use it again at a later stage. For every service definition in the deactivated scenario, the system deletes the service endpoint.

User Action

System Response

You set the status of a business scenario to Active .

For every service definition in the activated scenario to which an active communication profile has been assigned, the system creates a service endpoint. If the communication profile has more than one version, the system creates a service endpoint for each active profile version. The service endpoint has the runtime settings of the profile version.

You set the status of a business scenario to Inactive .

When you deactivate scenarios, the system considers them deleted. However, the business scenario and its assignments still exist in the system, and you can activate and use it again at a later stage.

For every service definition in the deactivated scenario, the system deletes the service endpoint.

Result

After you save the business scenario, the system performs a background process and applies the communication profile policies to the service definition. The framework creates configuration entities called service endpoints. When the service endpoints are available, you can configure the consumer proxies that consume the configured service definitions. You can check the service endpoints that are created in the Single Service Administration application.

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

For more information, see Log Viewer .