Show TOC

Function documentationRapid Applications Based on Web Services

 

To create a rapid application, you have the following options:

  • In the Administration work center, choose Start of the navigation path Manage Rapid Applications Next navigation step Rapid Application Next navigation step Create from Web Service End of the navigation path.

  • In the page configuration, choose Start of the navigation path Embedded Views Next navigation step Display All Next navigation step Rapid Applications Next navigation step Create from Web Service End of the navigation path.

Features

The function is provided in the form of a guided activity that guides you through the process of creating or changing a rapid application. Within the process, you can navigate backwards and forwards as required.

With the rapid applications function, a new, WebClient-UI-based tool for consumption of Web services is available and integrated into the guided activity. It is not compatible with the SAP-GUI-based Web service consumption tool. This means that you cannot use the new Web service consumption tool to view or edit Web service applications that you created with the SAP-GUI-based Web service consumption tool.

Note Note

To view the new genIL (generic interaction layer) component, call transaction GENIL_MODEL_BROWSER. To test the genIL component, call transaction GENIL_BOL_BROWSER. Unlike the SAP-GUI-based Web service consumption tool, you can make use of all operations provided by a Web service.

End of the note.

You can use the following web services:

  • Web services for which you can create consumers by using transaction SPROXY

  • Web services with read-only access to the data

    You cannot implement creation or change scenarios.

  • Services with simple structures and a unique request name

    Note in particular:

    • Services of the service-oriented architecture cannot be consumed.

    • Services that you created with the Web Service Tool cannot be consumed.

    Note Note

    You can implement read-only scenarios for services of the service-oriented architecture, or services that you created with the Web Service Tool, with the SAP-GUI-based tool for consuming web services. For more information, see Web Service Consumption.

    End of the note.
Creating a Rapid Application Based on a Web Service

Screen 1: Application Details

Enter the name and description of the rapid application.

Show Technical Details: The fields Search Page Target ID and Overview Page Target ID are filled automatically. You can enter a name of up to 10 characters.

Screen 2: Proxy Selection

Here you select the proxy of the Web service or create a new one. During the proxy generation, a proxy class is generated from which the actual proxy objects can be instantiated in programs. The proxy acts as an intermediary to the server of the required Web service.

Screen 3: Operation Selection

Here you select the operation of the Web service, in other words, the proxy method. The input and output parameters are displayed. The input parameters are used later in the rapid application as search criteria.

Nav. Link: Here you determine which column of the results table of the rapid application contains the link with which you can navigate to the overview page of the respective entry.

Screen 4: Profile Customizing

Here you define the access type used for the rapid application. You can assign the rapid application to a navigation bar profile. To do so, you add the business role for which you want the rapid application to be available. In the Create Logical Link column, you define the logical link to the create page. In the Search Logical Link column, you define the logical link to the search page. You choose the level on which you want to include the rapid application in the navigation bar: work center, work center link group, direct link group. For each of these levels, the following methods of inserting a rapid application are available:

  • Navigation Bar Profile

    The rapid application is hidden by default but can be displayed via the Customizing of the business role. For more information, see the Customizing documentation for UI Framework under Start of the navigation path Business Roles Next navigation step Define Business Role End of the navigation path.

  • Navigation Bar Profile and Business Role

    The rapid application is displayed for the business role.

Here you define the Customizing settings for the business role and the navigation bar profile. If you want to make additional settings for the navigation bar profile, you make these in Customizing for UI Framework under Start of the navigation path Technical Role Definition Next navigation step Define Navigation Bar Profile End of the navigation path. For more information, see the Customizing documentation.

To transport the Customizing settings, proceed as follows, depending on the client settings:

  • If the client settings do not allow you to create and transport Customizing settings, you create only the required metadata with the tool. To generate and transport the Customizing settings, use report AXT_EXT_GENERATE_CUST in the Customizing client or choose the Regenerate button on the WebClient UI.

  • If the client settings allow you to create but not transport Customizing settings, you create the Customizing settings with the tool. To transport the Customizing settings, use report AXT_EXT_GENERATE_CUST in the Customizing client or choose the Regenerate button on the WebClient UI.

  • If the client settings allow you to create and transport Customizing settings, you can transport the Customizing settings with a workbench request.

Note Note

You have to restart the session to make your settings visible.

End of the note.

Screen 5: Overview

Here you check your entries and choose Save and Generate. This generates the user interface of the rapid application and a new genIL component with a root BOL (business object layer) object and search objects. For more information about the generation, see Adding Custom Fields.

Note Note

Generating a rapid application can take some time and an HTTP timeout may occur. For more information about error handling during generation, see Error Handling.

End of the note.
Changing a Rapid Application Based on a Web Service

You can change existing rapid applications in the guided activity.

Note Note

Be sure to note the following:

  • You cannot change the proxy. If you need to change the database table or the proxy, create a new rapid application.

  • You cannot deactivate fields that are activated as search criteria. You can only define additional fields as search criteria.

End of the note.