FPM BOPF INTEGRATION (FBI)

PDF download from SAP Help Portal: http://help.sap.com/erp2005_ehp_05/helpdata/en/03/1c7fb2a6fe409da7fd5e3a405854a7/content.htm Created on February 22, 2014
The documentation may have changed since you downloaded the PDF. You can always find the latest information on SAP Help Portal.

Note This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure. Subtopics from other structures are not included.

2014 SAP AG or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Please see www.sap.com/corporateen/legal/copyright/index.epx#trademark for additional trademark information and notices.

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 1 of 8

TABLE OF CONTENT
1 FPM BOPF Integration (FBI) 1.1 Creating an Initial Screen 1.2 Configuring the Main Page Form UIBB 1.3 Creating Wires In Wiring Schema 1.4 Alternative Key Feeder 1.5 Creating and Configuring the Alternative Key 1.6 Bootstrap Feeder 1.7 Configuring the Bootstrap 1.8 Creating and Configuring an FPM OVP Application

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 2 of 8

1 FPM BOPF Integration (FBI)

Floor Plan Manager (FPM) enables you, to create modification-free Web Dynpro ABAP UI applications composed of discrete UI Building Blocks (UIBBs). The Generic UIBBs (GUIBBs) are centrally provided UIBBs, where the application only provides the data and a layout configuration. FPM BOPF Integration (FBI) offers configurable and codeless integration of FPM technology and BOPF-based BOs. FBI provides generic GUIBB feeder classes and relevant application configurations that allow you to use the services of BOPF-based BOs in FPM applications. This enables you to create UI layouts as Web Dynpro configurations for standard GUIBBs and assemble such discrete GUIBB configurations in an application configuration. The GUIBB configurations are reusable objects. These configurations can be used in more than one application. FBI configuration objects (FBI View) are reusable objects. These design time configurations can be used in more than one application. The following figure shows an overview of FBI and its components:

Features
FBI supports service calls to BOPF-based BOs, including the following: Editing data from BO node instances in a list, form, or tree GUIBB Accepting action parameter values and invoking actions on BO node instances Overviews based on BO node queries Entering alternative key on an initial screen and subsequently converting alternative key to internal IDs, also known as alternate key conversions In addition, FBI supports the following UI-specific services: Navigating to multiple targets Calling dialogs and the editing application data in dialogs Supporting UI-specific nonBOPF actions

1.1 Creating an Initial Screen

The initial screen requires two UIBBs. You use the first UIBB to set the alternate key and the second UIBB to set the bootstrap. The bootstrap acts as an interface between the main page and the initial page.

Prerequisites
In an SAP development system, you have already created a Web Dynpro application. For more information see, Creating and Configuring an FPM OVP Application.

Procedure
1. 2. 3. 4. 5. 6. 7.

You need to create and configure the alternate key. For more information, see Creating and Configuring Alternate key. Now you need to configure the bootstrap. For more information, see Configuring the Bootstrap. Choose the Toolbar Schema. Choose the Global Toolbar row. Choose the Toolbar Element. Choose Continue to add the Continue button on the Initial screen. After configuring the bootstrap, configure the application specific parameters.

Configure the UIBB and Application-specific Parameters Return to the component configuration screen by clicking the second link below the toolbar. Under General Settings, choose the Floorplan Settings button and select Application Controller Settings. 3. In the Change Application-Specific Parameters dialog, enter the following parameters and choose the OK button: Web Dynpro component/class:/BOFU/WDC_FBI_CONTROLLER Configuration Name: /BOFU/WDCC_FBI_CONTROLLER_NEW
1. 2.

More Information
Creating Wires in the Wiring Schema

1.2 Configuring the Main Page Form UIBB

Prerequisites
PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved. Page 3 of 8

In the SAP development system, you have created a Web Dynpro application and created an initial screen. For more information, see: Creating and Configuring an FPM OVP Application Creating and Configuring an Initial Screen

Procedure
1. 2. 3.

4. 5. 6. 7. 8. 9.

On the Component Configuration screen, choose the New button and select Main Page. To create a form UIBB for the Main page, on the Overview Page Schema tab, choose the UIBB button and select Add Form Component. The system adds another UIBB row to the table with predefined entries for the selected component in the Component and Window Name columns. Enter any required configuration name in the Configuration Name column. The form component is FPM_FORM_UIBB. Save the configuration. Choose the Configure UIBB button. To create the configuration for your UIBB, in the Editor for the Web Dynpro ABAP Component Configuration screen, choose the New button. In the Create Configuration dialog box, enter any required description and confirm your entry. In the Select Package dialog box, enter your required package and confirm your entry. In the Edit Feeder Class dialog box, enter the /BOFU/CL_FBI_GUIBB_FORM feeder class and choose the Edit Parameters button. Business Object: Name of the business object (BO) to which you have referred; for example, /BOFU/DEMO_SALES_ORDER Node: Name of the node; for example, ROOT

Add Group Elements On the Component Configuration screen, on the form UIBB Schema tab choose the Element button and select Add Group. In the Group Title column, enter a suitable title for the group. 3. Choose the Child Element button and select Add Elements to Group. 4. In the Edit Group dialog box, select the elements and choose the OK button. 5. Save the UIBB configuration.
1. 2.

Configure the UIBB and Application-specific Parameters Return to the component configuration screen by clicking the second link below the tool bar. Under General Settings, choose the Floorplan Settings button and select Application Controller Settings. 3. In the Change Application-Specific Parameters dialog box, enter the following parameters and choose the OK button: Enter /BOFU/WDC_FBI_CONTROLLER as Web Dynpro component/class Enter /BOFU/WDCC_FBI_CONTROLLER_NEW as the configuration name
1. 2.

More Information
Creating wires in the wiring schema

1.3 Creating Wires In Wiring Schema

The wires in the wiring schema enable you as the application developer to connect the different UIBB configurations within an FPM application. The runtime interdependencies between UIBBS are defined by configuration entries called wires.

Prerequisites
In the SAP development system, you have created a Web Dynpro application and created an initial screen. For more information, see: Creating a Web Dynpro Application Creating and Configuring an Initial screen Configuring the Main page

Process
The figure below illustrates the wiring process and is followed by explanation:

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 4 of 8

Note
The basic concept of wiring is to link one UIBB to other UIBB. The data flows from the source UIBB to the target UIBB through the connector class /BOFU/CL_FBI_CONNECTOR . In case the source UIBB is a Form UIBB the Collection arrow is used for connecting the UIBBs through the wire. In case the source UIBB is a list UIBB the Selection arrow should is used to connect the UIBBs.
1. 2. 3. 4. 5. 6. 7. 8. 9. 10.

To complete the wiring, on the Wire Schema tab, choose the Graphical Wire Editor . Select the UIBBs under Available UIBBs. Drag and drop the UIBBSs to the panel on the right-hand side. The configuration box, has two arrows, Selection and Collection , that you use to move data to other UIBBs. Select the Collection arrow of the initial screen box and join it to the arrow head on top of the bootstrap form. In the Connector Details dialog box, select /BOFU/CL_FBI_CONNECTOR as the connector class. Connect the Collection arrow of the bootstrap form to the arrow head of the main form UIBB. In the Connector Details dialog box, select /BOFU/CL_FBI_CONNECTOR as the connector class. Similarly complete the wiring for other UIBBs if any. Choose the Done button. The configuration screen appears. Save the component configuration.

1.4 Alternative Key Feeder

You use the alternative key to identify an instance of the node that has business semantics. FBI provides the class /BOFU/CL_FBI_GUIBB_ALTKEY_FDR as the generic alternative key feeder class. You use this to convert the alternative key specified on the user interface (UI) to the globally unique identifier (GUID). In the business object (BO) node structure, every node instance has a 16-bit code as a unique identifier also known as the GUID. The GUID specifies a particular instance or record. An alternative key can be used to identify that record on the UI. This alternative key is converted to the 16 bit GUID using the alternative key feeder. The alternative key is usually used in the initial screen of an FPM application.

Structure
In the alternative key feeder class /BOFU/CL_FBI_GUIBB_ALTKEY_FDR enter the following parameters: Business Object: Name of the BO; for example, /BOFU/DEMO_SALES_ORDER Node: Name of the node; for example, ROOT Alternative Key: The alternative key name; for example, ORDER_ID

Example
In a Sales Order BO, Order Number can be the alternative key.

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 5 of 8

More Information
Creating and Configuring the Alternative Key

1.5 Creating and Configuring the Alternative Key

In the Business Object node structure, every node instance has a 16-bit code as a unique identifier also known as the GUID. The GUID specifies a particular instance or record. In the user interface an alternative key can be used to identify that record.

Prerequisites
In a SAP development system, you have already created a Web Dynpro application. For more information see, Creating and configuring an FPM OVP Application.

Procedure
Creating an Alternative Key for a Form UIBB On the Component Configuration screen, choose the New button and select Initial screen. To create a form UIBB for the Initial screen, on the Overview Page Schema tab, choose the UIBB button and choose ADD Form Component. 3. The system adds another UIBB row in the table with predefined entries for the selected component in the Component and Window Name columns. Enter a configuration name in the Configuration Name column. The form component is FPM_FORM_UIBB. 4. Save the configuration. 5. Choose the Configure UIBB button.
1. 2.

Configuring the Alternative Key

1. 2. 3. 4. 5.

6. 7.

To create the configuration for your UIBB, in the Editor for the Web Dynpro ABAP Component Configuration screen, choose the New button. In the Create Configuration dialog box, enter any required description and confirm your entry. In the Select Package dialog box, enter your required package and confirm your entry. In the Edit Feeder Class dialog box, enter the /BOFU/CL_FBI_GUIBB_ALTKEY_FDR feeder class and choose the Edit Parameters button. In the Edit Parameters dialog box, enter the following parameters and choose the OK button: Business Object: Name of the BO which you have referred to; for example, /BOFU/DEMO_SALES_ORDER Node: Name of the node; for example, ROOT Alternative Key: Name of the alternative key you use to query the root node; for example, ORDER_ID Click OK. Save the UIBB configuration.

Adding Group Elements for Alternative Key On the Component Configuration, on the Form UIBB Schema tab choose the Element button and select Add Group. In the Group Title column, enter a suitable title for the group. 3. Choose the Child Element button and select Add Elements to Group. 4. In the Edit Group dialog box, select the element and choose the OK button 5. Save the UIBB configuration.
1. 2.

More Information
Alternative Key Feeder

1.6 Bootstrap Feeder

You use a bootstrap feeder to send the globally unique identifier (GUID) from the initial screen to the main screen. Based on the GUID sent by the bootstrap, the corresponding data is retrieved from the Business Object Processing Framework (BOPF) business object (BO) and displayed in the main screen. FBI provides the class /BOFU/CL_FBI_GUIBB_BOOTSTRAP as the generic bootstrap feeder class.

Structure
In the bootstrap feeder class /BOFU/CL_FBI_GUIBB_BOOTSTRAP enter the following parameters: Business Object : Name of the BO; for example, /BOFU/DEMO_SALES_ORDER

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 6 of 8

Node : Name of the node; for example, ROOT URL Key Provider : /BOFU/CL_FBI_URL_KEYPROVIDER; this is appended to the key in the URL Preselection Key Provider: /BOFU/CL_FBI_PRESEL_KEYPROVIDER; the GUID of the alternate key that you enter on the initial screen is provided by the preselection key provider. The preselection key provider transports the key to the next screen

1.7 Configuring the Bootstrap

You use the bootstrap feeder to send the Globally Unique Identifier (GUID), from the Initial screen to the Main screen. The GUID retrieves data from the from the Business Object Processing Framework (BOPF) business object and displays it on the main screen.

Prerequisites
In a SAP development system, you have already created a Web Dynpro application. For more information, see Creating and Configuring an FPM OVP Application.

Procedure
Configuring the Bootstrap
1. 2. 3.

4. 5. 6. 7. 8. 9.

10.

Return to the component configuration screen by choosing the second link below the tool bar. To create a form UIBB for the initial screen, on the Overview Page Schema tab, choose the UIBB button and select Add Form Component. The system adds another UIBB row in the table below with predefined entries for the selected component in the Component and Window Name columns. Enter any required configuration name in the Configuration Name column. The form component is FPM_FORM_UIBB. Save the configuration. To create the configuration for your UIBB, in the Editor for the Web Dynpro ABAP Component Configuration screen, choose the New button. In the Create Configuration dialog box, enter any required description and confirm your entry. In the Select Package dialog box, enter your required package and confirm your entry. In the Edit Feeder Class dialog box, enter the /BOFU/CL_FBI_GUIBB_BOOTSTRAP feeder class and choose the Edit Parameters button. In the Edit Parameters dialog box, enter the following parameters and choose the OK button: Business Object: Name of the BO to which you have referred; for example, /BOBF/DEMO_SALES_ORDER Node: Name of the node; for example, ROOT URL Key Provider: /BOFU/CL_FBI_URL_KEYPROVIDER Preselection Key Provider: /BOFU/CL_FBI_PRSEL_KEYPROVIDER Save the UIBB configuration and return to the component configuration screen

1.8 Creating and Configuring an FPM OVP Application

Floorplan Manager (FPM) enables you as an application developer to create modification-free applications composed of discrete User Interface Building Blocks (UIBBs). Floorplan Manager enables you to create and configure floorplan applications using the Overview Page Floorplan. Generic UIBBs (GUIBBs) are generic UIBBs, for which the application provides only the data and a layout configuration. FPM BOPF Integration (FBI) aims at providing generic GUIBB feeder classes to consume BO services in FPM applications. This enables you to create UI layouts as Web Dynpro configurations for standard GUIBBs and assemble these discrete GUIBB configurations in an application configuration. An FBI view is an FBI design-time configuration object that helps join application data across multiple related BO nodes. This enables you to easily present application data in the GUIBBs. You can create and configure Web Dynpro applications by selecting the objects from the Object List selector. You can use any one of the objects in the object navigator: Packages, Local Objects, or Web Dynpro Comp./Intf. In this procedure, we use Web Dynpro Comp./Intf. as an example.

Procedure
Creating a Web Dynpro Application using the FPM_OVP Component In the SAP development system, open a new session and enter the transaction code SE80. In the navigation area, select Web Dynpro Comp./Intf. 3. Select the FPM_OVP_Component. You use this component to create the floorplan. Floorplan Manager enables you to create and configure Floorplan applications using the Overview Page Floorplan. 4. In the context menu of Web Dynpro Applications, choose Create. 5. In the Create Web Dynpro Application dialog box, enter an application name and choose the Continue button.
1. 2.

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 7 of 8

On the Create Web Dynpro Application screen, enter the following field values: Description: Enter the appropriate description Component: FPM_OVP_Component Interface View: FPM_Window Plug Name: Default 7. Save the Web Dynpro application to the appropriate package.
6.

Configuring a Web Dynpro Application

1. 2. 3. 4. 5.

6. 7. 8. 9. 10. 11.

In the context menu of your newly created application, choose Create/Change Configuration. On the Change Web Dynpro Application screen, in the Configuration ID field, enter the required field and choose the New button. In the Create Configuration dialog box, add a description, if required, and choose the OK button. In the Select Package dialog box, choose the appropriate package and choose the OK button. To assign the configuration to a Web Dynpro component, on the Application Configuration screen, choose the Assign Configuration Name button. When creating a Web Dynpro Application you can assign the floorplan and configure the application using the configuration editor for Floorplan Manager. In the Assign Configuration Name dialog box, add your configuration name and choose the OK button. The configuration name that was entered appears as link. Save the configuration. To configure the newly created component, select the link of the configuration name you just added. On the Editor for the Web Dynpro ABAP Component Configuration screen, choose the New button. In the Create Configuration dialog box, enter any required description and confirm your entry. In the Select Package dialog box, enter your required package and confirm your entry.

More Information
Overview Page Editor for Floorplan Manager Configuration Editor for Floorplan Manager

PUBLIC 2013 SAP AG or an SAP affiliate company. All rights reserved.

Page 8 of 8