Show TOC

Procedure documentationCreating an Adaptable Application Locate this document in the navigation structure

 

You can create an adaptation of your application to use in context-specific cases.

For example, you can create an adaptation of an application that displays a form so that the form looks different depending on who runs the application. When a manager runs the application, he or she is presented a form with a section in which to write notes. When an employee runs the same application, the form is displayed without the notes section.

Prerequisites

You have an existing application configuration that you would like to convert to an adaptable configuration.

Procedure

  1. Create the Adaptation Schema and Dimensions

    Open transaction SM34. Enter FPM_VC_ADAPT_SCHEMA as the View Cluster name and create a new adaptation schema, for example, MY_SCHEMA, and the dimensions that you need (for example, Role and Country).

    Note that the index is used to determine the dominating adaptation dimension to avoid possible collisions. The data element is used for design-time purposes, allowing you to provide field help while configuring context-based adaptations.

  2. Create the New Adaptation Wrapper Application

    In transaction SE80, locate the package that contains your application.

    Open the   Web Dynpro   Web Dynpro Applications   folder and choose Create from the context menu. Enter a name and description for your application. A new folder appears inside this folder.

    When you create a non adaptable FPM application you use one of the FPM_<FLOORPLAN_ID>COMPONENT components for your application. For adaptable application you must use FPM_ADAPTABLE_<FLOORPLAN_ID> instead. For example, if your existing application uses the OVP floorplan you must create the new application using the following values:

    • Component = FPM_ADAPTABLE_OVP

    • Interface View = FPM_WINDOW

    • Plug Name = DEFAULT

    Add the adaptation dimensions that you created in the previous step to your application, so that they can be passed as parameters to your application. Enter them on the Parameters tab in your application.

  3. Create the Application Configuration for the Adaptation Wrapper

    Under the Web Dynpro Applications folder, select the folder you have just created in the above step. In the context menu, choose Create/Change Configuration. Enter a name for the new configuration in Configuration ID and choose New. Enter the package details. The standard Web Dynpro application configuration editor is displayed.

    As well as the normal floorplan component (and IDR component for OIF and GAF floorplan components) there is now an extra 'adaptable' component. Enter the following details and choose New to create the application configuration for the adaptation wrapper:

    • Adaptation floorplan component

      Enter an arbitrary name as this configuration does not yet exist. This configuration is then created and contains the necessary data for the context-based adaptations.

    • Floorplan component

      Enter the original application’s root component configuration.

  4. Configure the Application Configuration of the Adaptation Wrapper

    Choose the configData context node and enter the name of your adaptation schema.

    Save the configuration. If you now run the new application it looks exactly like the original.

  5. Create an Adaptation

    Call up your new application configuration and navigate from there to the floorplan component configuration. The toggle button Adaptations appears on the main toolbar. Choose it to display the Adaptations panel.

    Choose Add Adaptation and, in the dialog box that appears, enter values in the relevant adaptation dimension fields. After saving, the new adaptation appears in the Adaptations panel. In edit mode, make your desired changes to the adaptation (for example, add a Notes component (FPM_NOTES_WRAPPER GUIBB) for a manager role).

  6. Test your Adaptation

    Run the application as you would normally. You see the original application, unchanged. To see how the adapted application looks, add the relevant parameter and values to the URL (for example &ROLE=MANAGER and refresh the screen. Note that the values you enter for your parameter in the URL are case-sensitive.

More Information