Show TOC

Process documentationCreating Forms

 

This document describes how to configure a Floorplan Manager (FPM) form for a user interface building block (UIBB) to process data with the MDG Web Dynpro application USMD_OVP_GEN. You can use this configuration description for implementations of the following form UIBBs:

  • FPM form GUIBB GL2: FPM_FORM_UIBB_GL2

  • FPM form GUIBB: FPM_FORM_UIBB

The FPM form GUIBB has been replaced by the new FPM form GUIBB GL2.

MDG delivers the feeder class CL_MDG_BS_GUIBB_FORM which you can use in such a configuration. The feeder class retrieves the attributes of the entity type for which the form is configured. With this you can configure the layout of the form. During runtime the feeder class reads, writes, and checks the data of the entity that is currently being processed.

Note Note

An FPM form GUIBB GL2 is included in the example configuration USMD_SF_OVP_CARR. This example configuration is located in the generic MDG Web Dynpro application USMD_OVP_GEN in package MDG_FND_SAMPLE_IMPLEMENTATIONS.

End of the note.

For information on assigning UI fields for each entity type, see the Generic Interaction Layer (genIL) section in Building Blocks for the UI Framework.

Prerequisites

You have completed the following:

  1. You can use an active MDG data model with at least one entity type with storage and use type 1. You have assigned a business object type code (OTC) to this entity type.

  2. You have generated the required structures in the Customizing activity Generate Data Model-Specific Structures under Start of the navigation path General Settings Next navigation step Data Modeling End of the navigation path.

  3. You have set the standard data model in your user profile.

  4. The data model is in the customer namespace. If the data model is not in the customer namespace follow the description in Creating genIL Components and Transaction Handler Manually.

  5. You can use a configuration of the generic MDG Web Dynpro application USMD_OVP_GEN that includes an FPM overview page (OVP) FPM_OVP_COMPONENT to which you can add the UIBB. You can open and edit the configuration of this page in the FPM editor. Alternatively, you can create Customizing for this configuration.

For more information, see Creating User Interfaces for Single Object Processing.

Process

Configuration of a FPM Form GUIBB

Follow these steps to create a new configuration of a FPM form GUIBB:

  1. Create a new configuration for the form component FPM_FORM_UIBB_GL2 by copying the template FPM_FORM_UIBB_GL2_TEMPLATE from package APB_FPM_GUIBB.

    Recommendation Recommendation

    For the configuration ID, follow a naming convention that includes the MDG data model, the entity type and FORM. For example, Z_MDG_SF_CARR_FORM.

    End of the recommendation.

  2. In the configuration of the component, enter the following values for the parameters of the feeder class CL_MDG_BS_GUIBB_FORM:

    • Component

      Enter ZSP<data_model>. This is the genIL component for single-object processing that was created for your MDG data model, with <data_model> being the ID of your MDG data model.

    • Object Name

      Enter an entity type for which you want the form to be configured.

    • Editable

      Select the Edit checkbox.

  3. Add the fields you want to process with the form and adapt the layout as required.

    Caution Caution

    The highlight changes function uses the tooltip to inform the user about the previous value. This is not possible if a fixed value for the tooltip is either entered in the UI configuration or the UI customizing. In this case this fixed value is displayed.

    End of the caution.

Add Form to Overview Page Component

After you have created the new configuration, you need to add it to the OVP component that is part of the MDG Web Dynpro application USMD_OVP_GEN mentioned in step 3 of the Prerequisites section of this document.

  1. Add the form component and the page on which the entity data should be displayed to the OVP.

  2. In the wiring of the page, create a wire for the form.

    If this is the first form and it displays the main entity of the object you want to process with this configuration, use the following parameters so that the application configuration can be used in combination with the generic MDG search UI USMD_SEARCH:

    • Component and Config ID: Enter the form that you have added.

    • Source Component and Source Config Name: Leave empty.

    • Connector Class: Enter the class CL_USMD_CONNECTOR_BOL_QRY.

    • Component Name: Enter the value ZSP<data_model>. This is the genIL component that was created for your MDG data model, with <data_model> being the ID of your MDG data model.

    • Dynamic Query Name: Select the value DynamicQuery<YOUR_ENTITY_TYPE>.

    • Skip initial screen if result is unique: Choose Initial screen will be skipped.

    Note Note

    If this is the first form and it displays the main entity, do not forget to update the MDG Communicator settings. For more information, see Creating User Interfaces for Single Object Processing.

    End of the note.

    If this is a form in a master/detail layout that should display the details of a selected entity in a list UIBB, use the following parameters for the wire:

    • Component and Config ID: Enter the form that you have added.

    • Source Component and Source Config Name: Enter the list component in which you select the entity to be displayed in the form.

    • Port Type: Lead Selection

    • Connector Class: Enter the class CL_FPM_CONNECTOR_BOL_IDENTITY.

  3. In the toolbar schema of the FPM OVP, add the following button for the form UIBB:

    Text

    Image Source

    Tooltip

    FPM Event ID

    Edit

    ~Icon/Edit

    Edit

    FPM_LOCAL_EDIT