Show TOC

Creating a Form with the UI Mapping FeatureLocate this document in the navigation structure

Use

The UI mapping feature delivered by Floorplan Manager (FPM) BOPF Integration (FBI) is the standard extended data mapper class, /BOFU/CL_FBI_VIEW_MAPPER_EXT, which offers generic conversion techniques and the capability to add or enhance application-specific conversions. You can use the FBI Mapping feature to map the UI structure fields to BO node fields and BO node fields to UI structure fields. There are 5 categories of UI conversion:

  • Time Stamp Conversion

    Timestamp conversion is used when the data and time needs to be displayed separately in the UI as different fields. For example, in the root node structure, date and time are stored in a field as time stamp. In the UI structure, you want date and time to be displayed separately in two different fields. The logic to convert that time stamp to Date and Time fields is in the mapper class.

  • Code Description Conversion

    Code description conversion is used when the descriptions of the status fields need to be displayed in the UI.

  • Alternative Key (Alt Key) Conversion

    Alternative key conversion is used when the GUID key on the node needs to be converted to an alternative key which is easier to remember .

  • Identity Conversion

    In many cases, a UI field has the identity of a field in the back end of the system. In this mapper class, such identity conversions are enabled.

  • Location Dependent Time Stamp Conversion

    Location dependent timestamp conversions are done when the timestamp needs to be converted to time and date fields based on the time zone derived from a specific location.

Prerequisites

In an SAP development system, you have created a Web Dynpro application and created an initial screen. For more information, see:

Procedure

Creating an FBI View

  1. In an SAP development system, enter transaction code SE80.

  2. In the navigation area, select Web Dynpro Comp./Intf.

  3. Select the /BOFU/FBI_VIEW component and choose Display.

  4. Right-click the /BOFU/FBI_VIEW object.

  5. Choose Create/Change Configuration. The Editor for the Web Dynpro ABAP Component Configuration screen appears.

  6. In the Web Dynpro: Component / Create Interface dialog box, enter an appropriate configuration ID and choose New.

  7. In the Create Configuration dialog box, enter an appropriate description for the configuration and choose OK.

  8. In the Select Package dialog box, enter the package name and choose OK. The Component Configuration screen appears. Here, you can view and edit the FBI view.

Configuring the FBI View

  1. On the Header tab, enter the following details:

    • Business Object: BO name

    • Node: BO node name

    • Node UI structure: Enter the node UI structure.

    • Mapper Class: Enter the mapper class.

      Note

      The standard Mapper classes are /BOFU/CL_FBI_VIEW_MAPPER and /BOFU/CL_FBI_VIEW_MAPPER_EXT. The standard Interface provided is /BOFU/IF_FBI_VIEW_DATA_MAPPER. The application can create their own mapper class and implement specific mapping logic.

  2. Save the component configuration.

Entering values in the Field Mapping Tab in the FBI View

  1. Choose the Field Mapping tab.

  2. To add a conversion category, choose the Add button.

    The first row of the table is selected.

  3. In the Conversion Category cell of the selected row, type the number of the conversion category or choose the search icon to search for the required conversion category number.

  4. Enter the conversion category.

  5. Enter the BO Node field that needs to be mapped in the BO Node Field columns.

  6. Enter the corresponding UI Structure field to which the BO node fields are mapped in the UI Structure Field columns.

    Note

    You also can map UI Structure fields to BO Node fields.

  7. Save your entries.

Creating and Configuring a Form UIBB

  1. Choose the UIBB button and select Add Form Component.

  2. Enter the following details for the form GUIBB:

    • Component: FPM_FORM_UIBB

    • View: FORM_WINDOW

    • Configuration Name: An appropriate configuration name

  3. Save your entries.

  4. Choose the Configure UIBB pushbutton.

  5. To create the configuration for your UIBB, in the Editor for the Web Dynpro ABAP Component Configuration screen, choose New

  6. In the Create Configuration dialog box, enter any required description and confirm your entry.

  7. In the Select Package dialog box, enter your required package and confirm your entry.

  8. In the Edit Feeder Class dialog box, enter the /BOFU/CL_FBI_GUIBB_FORM feeder class and choose the Edit Parameters pushbutton.

  9. Enter the name of the FBI view as created in the section Creating an FBI View in the FBI View field.

  10. Choose OK.

  11. Save your entries.

Add Group Elements

  1. On the Component Configuration screen, on the form UIBB Schema tab choose the Element pushbutton and select Add Group.

  2. In the Group Title column, enter a suitable title for the group.

  3. Choose the Child Element pushbutton and select Add Elements to Group.

  4. In the Edit Group dialog box, select the elements and choose OK.

  5. Save the UIBB configuration.