Background documentationContext-Based Adaptations

 

Context-based adaptations (CBA) are configurations of an application that can be launched by specific runtime parameters, each configuration adapted to the particular context in which it is called; a context is, for example, the role of the person who launches the application. CBA negates the need for making extra copies of applications or for writing lots of additional code.

 

An application configuration might display a form that is completed by both employees and their managers. You might want the form that is displayed to the managers to look different from that which is displayed to the employee. For example, the managers' form might have fewer entry fields or it might contain a section for notes. Instead of making several copies of an application configuration and adjusting them for every eventuality that you require, Floorplan Manager provides you with CBA. The adaptation that is launched is based on particular runtime parameters, such as the role of the person who launches the application or the country in which the application is launched.

Each adaptation of a configuration contains only the delta changes to its base configuration.

Structure

Applications that are adaptable applications are embedded inside a 'wrapper' application.

The adaptation wrapper application does not use the normal floorplan component (FPM_<floorplan ID>_COMPONENT, for example FPM_OVP_COMPONENT), but uses an 'adaptable' component instead (FPM_ADAPTABLE_<floorplan ID>, for example, FPM_ADAPTABLE_OVP).

Which particular adaptation of an application is displayed at runtime depends on the parameters passed to the application. Each wrapper application knows which parameters to expect.

A parameter that affects an adaptable application is known as an adaptation dimension. Adaptation dimensions are attached to adaptation schema. This is explained below in more detail:

  • Adaptation Schema

    A list of characteristics (or dimensions) which can be used for adaptations, for example a role or country.

    Adaptation schemas relate to a whole application area; it is not necessary to create a separate schema for each application.

  • Adaptation Dimension

    Represents an individual characteristic within an adaptation schema. It is maintained in transaction SM30 view FPM_V_ADAPT_DIM. Examples of adaptation dimensions include role and country.

    A dimension is defined by the following attributes:

    • Name

      For identification purposes.

    • Index

      Used to determine the dominating adaptation dimension in case there is a collision.

    • Data element

      Used only at design time, allowing the provision of field helps and F4 helps.

    The adaptation dimensions that are used in an adaptable application are found on the Parameters page of the application in transaction SE80.

The adaptations that you create always inherit attributes of the base configuration. If you make changes to the base configuration, these changes are present in the adapted configurations too, even if you created the adapted configurations before the changes to the base configuration were made.

Activities

Recognizing an Adaptable Application

Applications created using CBA are known as adaptable applications. You can recognize whether an application is adaptable in the following ways:

  • In the Web Dynpro hierarchy browser

    An extra component configuration is visible, the 'adaptable' floorplan component, for example FPM_ADAPTABLE_OVP.

  • At runtime, when you open the FPM configuration editor, FLUID, using the Customize Page icon on the main toolbar.

    The Adaptations toggle-button is visible on the main toolbar. Choosing this button displays the Adaptations panel, listing all existing adaptations of the application configuration.

Was this page helpful to you?