Show TOC

Procedure documentationConfiguring the Consumer Side of Business Scenarios Locate this document in the navigation structure

 

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 toolsets and deployed on your client system. You create the collection and use it for a particular business scenario, which 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 ports contain the exact policies and settings and enable the applications in the scenario to consume a Web service.

Prerequisites

  • You have deployed consumer applications on your client system.

  • You have configured connections to provider systems on which the Web services are running.

    More information: Creating Connections to Provider Systems

  • You have configured user accounts for all Web services that you want to consume.

    More information: Creating User Accounts

Procedure

  1. Log on to the SAP NetWeaver Administrator.

  2. Choose   SOA Management   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.

Creating a Business Scenario

  1. Choose New.

  2. In the Scenario Info step, enter the name and description of the scenario and then choose Next.

  3. In the Consumer Side step, add Service Groups to the business scenario and then assign provider systems to the Service Groups, as follows:

    1. Add a Service Group to the business scenario.

      The Adding and Removing Service Groups to a Business Scenario section below outlines the steps you have to complete to add a Service Group.

    2. Choose a Service Group from the table, and then choose Assign Provider System.

    3. From the Assign Provider System window, choose a provider system, and then choose OK.

      The Assigning and Unassigning a Provider System to a Service Group section below outlines the steps you have to complete to assign or unassign a provider system to a Service Group.

  4. Choose Finish.

Editing a Business Scenario

  1. Choose a business scenario from the table, and then choose Edit.

  2. On the Service Groups tab, proceed as follows:

    • The Adding and Removing Service Groups to a Business Scenario section below outlines the steps you have to complete to add or remove a Service Group.

    • The Assigning and Unassigning a Provider System to a Service Group section below outlines the steps you have to complete to assign or unassign a provider system to a Service Group.

  3. Choose Save.

Adding and Removing Service Groups to a Business Scenario

  • Add a Service Group

    1. Choose Add.

    2. On the Add Service Groups window that opens, search for the Service Groups that are deployed on the local client system:

      • Search for Service Groups 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 Service Groups window.

        2. In the Find field, enter the Service Group name, and then choose Go.

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

      • Search for Service Groups 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 Service Groups window.

        2. In the Find field, enter the Service Group name.

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

        3. Choose a Service Group 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 Groups

        1. Choose theBrowse tab.

        2. From the dropdown menu, select a Service Group classification.

    3. Select a Service Group 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 Groups.

  • Remove a Service Group

    1. To remove a Service Group from the business scenario, choose an entry from the Service Groups table.

    2. Choose Remove.

Assigning and Unassigning Provider Systems to Service Groups

  • Assign a provider system to a Service Group

    1. Choose a Service Group from the table.

    2. Choose Assign Provider System.

      The Assign Provider System window opens.

    3. To find provider systems, in the Value field, enter a name of a system 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 provider system

    1. To unassign a provider system from a Service Group, choose an entry from the Service Groups table.

    2. Choose Unassign Provider System.

Activating and Deactivating a Business Scenario

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 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, which refers to the Service Group. The logical port has the runtime settings of the connection to the provider system.

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 keep existing on the system, and you can activate and use it again at a later stage.

For every Service Group in the deactivated scenario, the system deletes the logical port of the consumer proxy which refers to the Service Group.

Result

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, which 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.

In a table on the Service Groups tab, the system displays additional information about the Service Groups and the service references in the consumer application, the connectivity type that is used, and the provider system that is assigned. You can open this additional information by choosing a Service Group and then the button that displays a magnifier glass on the top right corner of the Service Groups table.

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.

More information:

Log Viewer

Note Note

In Single Service Administration, you can browse the created logical ports only for Java EE consumers and Composite Application Framework (CAF) applications that consume Web services. You cannot browse configuration entities of the following consumer proxies:

  • Callable objects created with Guided Procedures framework

  • Automated activities and events created with Galaxy framework

  • Adaptive Web service models created with Web Dynpro framework

  • Web service operations created with Visual Composer framework

End of the note.