Cd167 Exercises Vho Final

FLOORPLAN MANAGER: FROM FEEDER CLASS

TO APPLICATION

CD167

Exercises Dirk Becker / SAP AG Jens Bckenhauer / SAP AG Christian Gnther / SAP AG Simon Hoeg / SAP AG

2

In this exercise you will create an entire FPM application with feeder classes and configuration. In this

application, you will start with the search for flights and select a single flight for which you will show details

and bookings. The bookings are editable and introduce the transactional behaviour of the framework.

As a preparation, we have centrally provided a singleton class for data access which takes care of the

backend processes: CL_CD167_FLIGHT_ACCESS is available and referenced several times in the

exercises.

Furthermore, sample feeder classes are available for your reference; you can use them for review, copy or

even directly in configuration. You will notice that the comments therein reference to the steps in the

exercises. These are:

- CL_CD167_FLIGHT_SEARCH (exercise 1)

- CL_CD167_FLIGHT_LIST (exercise 3)

- CL_CD167_FLIGHT_FORM (exercise 4)

- CL_CD167_FORM_REP (exercise 5)

This exercise requires ABAP development skills. Depending on your degree of ABAP knowledge, there

are several levels of executing the exercises; you can also switch between these levels, e.g. if time runs out.

1.) Perform the entire exercise step by step and do the coding on your own.

2.) Perform the exercises step by step but leave out the steps marked with OPTIONAL.

3.) Perform the exercises step by step, but instead of writing the coding on your own, copy the coding

from the sample feeder classes listed above. In this case you should read the coding in order to

understand the business logic.

4.) For the virtual Hands-on we recommend dont code at all. Start directly with exercise 2; leave out the coding parts in exercises 3, 4 and 5. In configuration, enter the names of the sample feeder classes listed above.

3

5.) Start SAP Logon on the desktop

LOGON INFORMATION System / client: M24 / 800

Your user name: CD167-A-

A = your session

= your group number

If your group number is 01, your user name is CD167-A-01.

Your password: welcome

4

Overview of the Exercise

The following schema explains the entities that you will create during this exercise and their relations. It describes also the naming conventions that you should follow. It is essential that you follow the rules and take Y for your session and xx for your group number. Example: If you are in session A and your group number is 01, you have to substitute with A01 for all occurrences of the construct .

FPM application Z_CD167_FLIGHTS

OVP Initial Page INIT OVP Main Page Main

Search GUIBBZ_CD167_FLIGHTS_SEARCH

Feeder class:ZCL__CD167_FLIGHTS_SEARCH

Form GUIBBZ_CD167_FLIGHTS_FORM

Feeder class:ZCL__CD167_FLIGHTS_FORM

Form Repeater GUIBBZ_CD167_BOOK_FORMREP

Feeder class:ZCL__CD167_BOOK_FORMREP

Result List GUIBBZ_CD167_FLIGHTS_LIST

Feeder class:ZCL__CD167_FLIGHTS_LIST

Central singleton class:CL_CD167_FLIGHTS_ACCESS

The singleton class CL_CD167_FLIGHTS_ACCESS is centrally available and can be used by you as it is. For your reference, the corresponding Solutions document contains the entire coding which has to be written during this exercise plus the entire central singleton class.

5

1. Exercise Search Feeder (Optional !)

In this exercise, you will create your first feeder. This feeder is intended to search for flights. You will get to learn basis

functionalities of feeder interfaces and feeder classes with FPM and in detail you will implement the methods

GET_DEFINITION and PROCESS_EVENT.

1.1. Start the class builder transaction code SE24 and create your own feeder class

ZCL__CD167_FLIGHT_SEARCH as local object. Take care for the naming conventions: Y

denominates the session and xx your group; therefore if you are in session A and your group number is 01,

your feeder class will be called ZCL_A01_CD167_FLIGHT_SEARCH.

1.2. Implement the feeder interface IF_FPM_GUIBB_SEARCH. You will notice that IF_FPM_GUIBB is

implemented automatically.

1.3. Implement all interface methods: In the class builder, switch to edit mode, enter void method code for each

method and after you have gone through all methods, finally save. There must not occur any warning when

you process a syntax check.

1.4. Now you define the field description: Therefore you have to implement code for method

IF_FPM_GUIBB_SEARCH~GET_DEFINITION as follows: Create a runtime type descriptor for DDIC structure

CD167_SEARCH_ATTRIBUTE by calling CL_ABAP_TYPEDESCR=>DESCRIBE_BY_NAME and cast the

result to the exporting parameter EO_FIELD_CATALOG_ATTR.

1.5. Implement IF_FPM_GUIBB_SEARCH~PROCESS_EVENT.

1.5.1. Implement the following only if the event ID is FPM_EXECUTE_SEARCH (IO_EVENT->MV_EVENT_ID

equals constant IF_FPM_GUIBB_SEARCH=>FPM_EXECUTE_SEARCH).

1.5.2. In this case use method FPM_ATTRIBUTE_INTO_ABAP_RANGE of the search conversion passed as

parameter IO_SEARCH_CONVERSION to convert the input into an ABAP range table for each search

attribute (i.e. you have to call the method 5 times) Take care: you will receive data references, so you

will need to use field symbols for assigning the content.

1.5.3. Pass the range tables to method SELECT of the single instance of class CL_CD167_FLIGHT_ACCESS

which you can always retrieve by calling CL_CD167_FLIGHT_ACCESS=>GET_INSTANCE.

1.6. Save and dont forget to activate feeder class.

6

2. Exercise Create Application with Search GUIBB

In this exercise, you will create the application itself. You will get to know the Application creation Tool and the

configuration editor, FLUID. You will integrate your recently created feeder class and finally you can review that data is

retrieved from the backend and shown in the frontend.

This application is the basis for the entire exercise, therefore the following steps are essential for a successful Hands-

On experience.

2.1. Start the Application Creation Tool. You will find this tool in your menu entry which is prepared for the

exercise. If it would not be in the menu, you needed to call application FPM_CFG_BO_MODEL_ACT with the

application configuration of the same name manually.

2.1.1. On the first page of the tool, enter Web Dynpro Application name CD167_FLIGHTS. It is important

that you assign your local name space Z_: Therefore use the button Apply Namespace in the

toolbar of the initial screen. The rule is as before: Y is for virtual Hands-on A and xx your group

number; if your group number is 01, your namespace reads ZA01.

2.1.2. Select Floorplan Overview Page. You might want to add descriptions, but those are not needed

throughout this exercise.

7

2.1.3. Navigate to the next step and there press Save.

Attention: Leave the confirmation page open for the rest of the exercise. In case you lose it due to a time-

out, you can find the generated objects in your local objects (SE80). (see 3.7.1 page 14)

2.2. Launch the Configuration Editor (FLUID) by pressing the link Launch Configuration Editor on the

confirmation screen.

2.2.1. Open the Navigation Panel by clicking on the corresponding button choices (see illustration below):

8

There you create a new page type Initial Screen and rename Page Id to INIT and Title to Search Flights (or any other name you prefer).

2.2.2. Go to the Overview Page Schema: Select the UIBB line (1) and delete (2) the dummy UIBB which was

rendered automatically by the system.

1

2

9

2.2.3. Then add a UIBB for the Search Component and set Configuration ID

Z_CD167_FLIGHT_SEARCH (Y = A and xx = group number). You will receive an error that this

configuration does not yet exist; you can ignore the error and save the configuration.

10

2.3. Now you configure the Search UIBB: Press button Configure UIBB in the schema toolbar (see below; the

new Search UIBB must be selected). (save component = Yes)

2.3.1. On the appearing initial screen, press New; add a description if you like and choose Local object on

the TADIR popup.

11

2.3.2. On the feeder class popup, enter the sample feeder class CL_CD167_FLIGHT_SEARCH.

If you created your own feeder class in exercise 1, you can also use your own newly created feeder class

ZCL__CD167_FLIGHT_SEARCH (Y = A and xx = group number). The feeder class has no

parameters; therefore you have to confirm the next popup with Ok.

2.3.3. Open the Repository (click on ).

Mark all Search Criteria (use button shift and click on rows)

12

Move all search attributes from the Repository via drag and drop into Preview or Search UIBB

Schema. Save and close the browser window.

2.4. Execute the application. You can either do it from the Confirmation Page of the Application Creation Tool (see

above)

Or especially if this page is no longer open or if you experienced a time out you will find your application in

your local objects in SE80 and can start it from there.

13

You will notice that you can fill the Search, but that nothing happens when you click on Search. This is

because we have not yet passed the data to a Result List. This will be part of Exercise 3.

14

3. Exercise Result List (Feeder & Configuration)

In this exercise, you will create the corresponding Result List so that you can

display and select Flights. First you will create the feeder class for the result

list and in a second step you add the configuration.

Step 3.1 to 3.6 is optional! You may copy the class

CL_CD167_FLIGHT_LIST to ZCL__CD167_FLIGHT_LIST or you use

CL_CD167_FLIGHT_LIST in the exercise.

3.1. In the class builder, create the feeder class

ZCL__CD167_FLIGHT_LIST (Y = A (session id) and xx =

group number) as local object.

3.2. Implement the list feeder interface IF_FPM_GUIBB_LIST.

3.3. Implement all methods (see exercise 1.3).

3.4. Implement IF_FPM_GUIBB_LIST~ GET_DEFINITION:

3.4.1. Create the field catalog (parameter EO_FIELD_CATALOG) from DDIC structure SFLIGHT (Call

CL_ABAP_TYPEDESCR=>DESCRIBE_BY_NAME, cast on data descriptor CL_ABAP_STRUCTDESCR

and call CL_ABAP_TABLEDESCR=>CREATE.

3.4.2. OPTIONAL Set field MANDT to technical field and set default display type of CONNID to Link to Action

(append a line to ET_FIELD_DESCRIPTION and use constant

IF_FPM_GUIBB_CONSTANTS=>GC_DISPLAY_TYPE-LINK_TO_ACTION).

3.4.3. Now you define the action to navigate from the result list to the main page. Define navigate action by

adding a line to ET_ACTION_DEFINITION: The action ID is FPM_NAVIGATE (IF_FPM_CONSTANTS

=> GC_EVENT-NAVIGATE); dont forget to set the action to enabled; assign

FPM_S_EXT_NAVIGATION_INFO_ADD5 as event parameter structure (This is needed because we

have 3 key fields acting as event parameters)

3.5. Implement IF_FPM_GUIBB_LIST~GET_DATA: Retrieve the flights from the singleton class

CL_CD167_FLIGHT_ACCESS and pass it to CT_DATA; in addition you have to set EV_DATA_CHANGED

accordingly; execute this coding only if data has been changed (Check in advance whether method

HAS_NEW_DATA of the singleton returns ABAP_TRUE).

3.6. Save and activate the feeder class

3.7. Go to FLUID and edit the Search GUIBB configuration

3.7.1. If your confirmation screen of the application creation tool is still alive, you can again use the link Launch

Configuration Editor.

Alternatively you can press the button Show Configurable Areas of the running application and click in

15

the search area afterwards.

Than navigate to OVP: ZA01CD167_FLIGHTS_OVP

Or you can find your search configuration in your local objects in SE80. Double click on the Component Configuration

Select the UIBB element and click on Configure UIBB.

Then click on Start Configurator

Then click on Continue in Display Mode

In the Component Configuration

16

Select the Page Type Initial Screen

Select the UIBB element and click on Configure UIBB

3.7.2. In the Search UIBB Schema you Add a List UIBB;

A new line is created

17

Open the Attributes panel (if needed); enter configuration name Z_CD167_FLIGHT_LIST (Y = A and xx = group number). Again, you can ignore the errors and save the configuration.

Then click on Configure UIBB in the schema toolbar to enter the List UIBB configuration.

18

3.8. List UIBB configuration

3.8.1. In the upcoming Initial Screen select New,

Add a description if you like and create the configuration as Local Object. In the feeder class dialog, enter your feeder class ZCL__CD167_FLIGHT_LIST (Y = session and xx = group number) and continue (This feeder class has no parameters).

Now you have two options: In the feeder class dialog, enter your feeder class ZCL__CD167_FLIGHT_LIST (Y = session and xx = group number) and continue (This feeder class has no parameters).

Or as recommended use the sample feeder class CL_CD167_FLIGHT_LIST instead of your own feeder

class in case that you encountered difficulties with the coding in the preceding exercise steps 3.1 3.6.

19

3.8.2. Bring all fields from the Repository to the List UIBB Schema (e.g. by drag and drop).

Open the Repositories

Drag and drop the fields

3.8.3. In the General Settings panels: Set Search Results Objects Name to Flights and Selection mode No

selection (see below).

20

3.8.4. Change the Display Type (if not already done in optional step 3.4.2 before) of CONNID to Link To

Action (either in the List UIBB Schema or in the Attributes panel).

3.9. Save and close the window.

3.10. Execute the application.

You can refresh the browser if it is still open, or go to your local objects and start the Application Configuration

ZAxx_CD167_FIGHTS

21

You will notice that you get a list of flights out of your search. But it is still not possible to select a flight and

continue to a details page. This will be done in exercise 4.

22

4. Exercise Main page with form (Feeder & Configuration)

In this exercise, you will create the Main Page in the Overview Floorplan (OVP)

which enables you to navigate from the Result List to a Flight Details view. You will

learn how to enable the explace navigation and to pass the selected flight to the

Main Page. As usual, you will start with the creation of a feeder class for a Form

GUIBB which displays the details for the select flight.

Step 4.1 to 4.6 is optional! You may copy the class CL_CD167_FLIGHT_FORM

to ZCL__CD167_FLIGHT_FORM or you use CL_CD167_FLIGHT_LIST in

the exercise.

4.1. In the class builder (SE24) , create the feeder class

ZCL__CD167_FLIGHT_FORM (Y = session and xx = group number) as local object.

4.2. Implement the form feeder interface IF_FPM_GUIBB_FORM.

4.3. Implement all methods (see exercise 1.3).

4.4. Implement IF_FPM_GUIBB_FORM~GET_DEFINITION:

4.4.1. Create the field catalog from SFLIGHT (similar to Exercise 1.4).

4.4.2. OPTIONAL: Make field MANDT a technical field (technical_field is a Boolean attribute of the field

description); this removes the field MANDT from the Repository so that it cannot appear on the UI.

4.5. Implement IF_FPM_GUIBB_FORM~GET_DATA: Retrieve the single flight from the singleton use method

CL_CD167_FLIGHT_ACCESS=> GET_SELECTED_FLIGHT for this purpose. Set EV_DATA_CHANGED =

ABAP_TRUE if data have changed.

4.6. Save and activate your feeder class

4.7. Navigate to FLUID, e.g. from the running application (other options see above at 3.7 on page 15).

4.7.1. Navigate to the OVP Main Page (PAGE_1) in the Navigation panel.

23

4.7.2. There rename Page ID to MAIN and Title to Flight Detail and Bookings.

4.7.3. In the Overview Page Schema: Add a form component by pressing Add UIBB and select Form

Component from the list.

In the Attributes Panel, set the Configuration ID to Z_CD167_FLIGHT_FORM (Y = A and xx

= group number) and set the Title to Flight. You have to enter a title in this place, because UIBBs on

the OVP Main Page are rendered as Panel per default and the Panel Title has to be set here.

24

4.7.4. Ignore the error message and save the configuration,.

4.8. Drill down to the form configuration via button Configure UIBB. As before:

On the upcoming initial screen, press New; on the following popups, enter a description text (if you like to),

then assign Local Object;

Now you have two options: Enter your form feeder class ZCL__CD167_FLIGHT_FORM (Y = session and xx = group number) the feeder class does not offer any no parameters. It is indeed an option to use the sample feeder class CL_CD167_FLIGHT_FORM instead of your own feeder

class in case that you encountered difficulties with the coding in the preceding exercise steps 4.1 4.7.

25

4.8.1. In the form configuration on the panel General Settings: Set the Layout Type to 16/2 (see below).

4.8.2. In the Preview panel, you will find a form layout with two layout columns divided by a red line and 16

configuration columns (8 for each layout column). In order to populate the form, you can use drag and

drop to move elements from the Repository to the Preview.

Open the Repositories

Move the fields

Airline (CARRID), Connection Number (CONNID) Flight Date (FLDATE) If you want to, you can multi-select them to the left layout column; you will notice that the system automatically chooses 3 configuration columns for the label and 5 for the value which is according to the UI Design Guidelines.

Then move the fields

Maximum capacity economy class (SEATSMAX), Occupied seats economy class (SEATSOCC) Airfare (PRICE) to the right layout column.

Shorten the input field of PRICE (Airfare) to 4 columns so that you can drag and drop the element Airline local currency (CURRENCY) into column I on the right hand side of the airfare. You will notice that the label is automatically omitted since only one configuration column can be used.

See the intended result below.

26

4.8.3. Multi-select all form fields (either in the Preview or in Form UIBB Schema), open the Attributes panel

and set the Display Type to Text View (this automatically applies to all selected fields). If you have

forgotten one or more fields in your selection you can convert the Display Type individually still for each

field.

4.8.4. Save the form configuration.

4.8.5. Use the breadcrumb (see below) to navigate back into the OVP configuration.

4.8.6. Select Initial Screen (INIT) in the Navigation panel; drill down into the configuration of

the Search UIBB (either via Preview or via Overview Page Schema) and therein select the List UIBB

(either in the Preview or in the Search UIBB Schema) navigate further into the

configuration of the Result List UIBB.

4.9. In this step, you realize the connection from the Result List to the newly created form on the Main Page. In the

List UIBB configuration: select Connection Number (CONNID) either in the List UIBB Schema or in the

Preview; open the Attributes panel (if needed); therein assign action FPM_NAVIGATE to FPM Event ID.

27

Additional fields appear in the Attributes panel which are relevant for the navigation event: Set Processing

Mode to Execute Search and Leave; set Edit Mode to Read-Only. Assign CARRID and FLDATE as

Additional Source Attributes (take two of the five available input fields for Additonal Src Attr). This is

necessary since the flight key consists of CARRID and FLDATE in addition to CONNID which already acts as

a key field for navigation.

4.9.1. Save your configuration and close the browser window.

4.10. Execute the application and ensure that you can navigate to the main page and that the selected flight is

shown.

28

5. Exercise Form Repeater (Feeder & Configuration)

In this exercise, you will dive deeper into the Floorplan manager and its

transaction handling. You will learn how to modify and save Flight Bookings. For

the display and maintenance of the flight bookings, we will introduce the Form

Repeater GUIBB which displays tabular data in small and repeated forms.

First, you will start to create the feeder class for the Form Repeater and add the

transactional coding. This exercise is already pretty advanced and requires some

deeper knowledge in Floorplan Manager and Web Dynpro ABAP.

You might consider to take the sample coding for your reference and learn from

the solution if you are running out of time.

Step 5.1 to 5.13 is optional! You may copy the class CL_CD167_BOOK_FORM_REP

to ZCL__CD167_BOOK_FORM_REP or you use CL_CD167_BOOK_FORM_REP in the exercise.

5.1. In the class builder, create the form repeater feeder class ZCL__CD167_BOOK_FORM_REP (Y =

session and xx = group number) as local object.

5.2. Implement the form repeater feeder interface IF_FPM_GUIBB_FORM_REPEATER and extended feeder

interface IF_FPM_GUIBB_FORM_REPEATER_EXT which is required later for the data loss popup.

5.3. Implement all methods (as in exercise 1.3)

5.4. Implement the method IF_FPM_GUIBB_FORM_REPEATER~GET_DEFINITION:

5.4.1. Create the field catalog from SBOOK remember that we are dealing with a data collection which is

represented by an ABAP table and need to undergo the same steps as in Exercise 3.4.1.

5.4.2. Set the key fields of the booking to read only (these must not be changed in the booking form repeater)

therefore use the read_only attribute of the field description for the elements CARRID, CONNID, FLDATE

and BOOKID.

5.4.3. OPTIONAL: Mark field MANDT a technical field (TECHNICAL_FIELD is a Boolean attribute of the field

description); this removes the field MANDT from the Repository so that it cannot appear on the UI.

5.5. Define a private class type TT_BOOK as standard table of SBOOK.

5.6. Declare a private instance attribute MT_BOOK type TT_BOOK and a private instance attribute

MV_READ_FROM_DB (type ABAP_BOOL initial value ABAP_TRUE)

5.7. Implement IF_FPM_GUIBB_FORM_REPEATER~GET_DATA:

5.7.1. Get the selected flight from the singleton (method CL_CD167_FLIGHT_ACCESS=>

GET_SELECTED_FLIGHT) and select the bookings from the data base table SBOOK into the instance

attribute MT_BOOK for the selected flight key (CARRID, CONNID and FLDATE).

5.7.2. Execute the selection (i.e. the above code) only if we have to read the data from the DB, i.e.

MV_READ_FROM_DB is true. You also have to reset the indicator MV_READ_FROM_DB. This will

ensure that we reconcile our internal bookings buffer MT_BOOK with the database only at the beginning

and after the transactional events for save and cancel.

5.7.3. Move the booking data into CT_DATA and set the change indicator EV_DATA_CHANGED. For

performance reasons, you should execute this step only if MT_BOOK and CT_DATA differ.

5.8. EASY WAY: Implement IF_FPM_GUIBB_FORM_REPEATER~FLUSH and move the entire IT_DATA to

MT_BOOK. This will dump the entire table to the data base even if only one field was changed. Alternatively,

the advanced (OPTIONAL) solution below (5.9, 5.10 and 5.11.2) describes a much better and performant

way:

5.9. OPTIONAL PERFORMANCE (1): Create a private instance attribute MT_CHANGED_LINES as sorted table

of I (integer) with unique default key.

5.10. OPTIONAL PERFORMANCE (2): IF_FPM_GUIBB_FORM_REPEATER~FLUSH: All the changes are

tracked in parameter IT_CHANGE_LOG; you have to apply these changes to the booking table. Therefore

29

you will need to declare field-symbols for the change log, for the booking table and for the old and the new

value. While looping over the change log table access the relevant booking by the given line_index in table

MT_BOOK, take over the new_value and insert the index into the MT_CHANGED_LINES buffer table; this

table is needed in IF_FPM_GUIBB_FORM_REPEATER~PROCESS_EVENT.

5.11. Implement IF_FPM_GUIBB_FORM_REPEATER~PROCESS_EVENT

5.11.1. Create a case distinction for the event ID: For the save event (FPM_SAVE IF_FPM_CONSTANTS

=>GC_EVENT-SAVE) you will update the SBOOK from table MT_BOOK (only in case of the EASY

WAY)

5.11.2. OPTIONAL PERFORMANCE (3): If you did the optional performance steps above, in case of SAVE,

you will update only the changed lines which you have saved before in the buffer table

MT_CHANGED_LINES. Dont forget to reset the buffer table.

5.11.3. After the data base update you have to perform a COMMIT_WORK and request the new data selection

by setting MV_READ_FROM_DB to ABAP_TRUE.

5.11.4. For the cancel event (FPM_CANCEL IF_FPM_CONSTANTS =>GC_EVENT -CANCEL) request the

new data selection by setting MV_READ_FROM_DB to ABAP_TRUE and just reset the buffer table.

5.11.5. For the local edit event (FPM_LOCAL_EDIT IF_FPM_CONSTANTS =>GC_EVENT LOCAL_EDIT)

first check whether the event was raised by the own UIBB (cf. parameter IV_RAISED_BY_OWN_UI) to

ensure that the local edit was not requested by any other UIBB. Then request the new data selection by

setting MV_READ_FROM_DB to ABAP_TRUE.

5.11.6. OPTIONAL: This optional step takes care of locking the selected flight: Also in the local event event,

you have to try to lock the selected flight. The locking is only needed if there are bookings available

(check MT_BOOK). Take any line of the table MT_BOOK and call the Function Module

ENQUEUE_ESFLIGHT with the flight key CARRID, CONNID and FLDATE. If messages occur, append

them to the message table ET_MESSAGE and set the event result EV_RESULT to failed (FAILED

IF_FPM_CONSTANTS => GC_EVENT_RESULT-FAILED). Remark 1: If you like you can encapsulate

the coding in a separate method. Remark 2: You can easily check the locking mechanism by selecting

the same flight twice and try to enter the edit mode in both windows.

5.11.7. OPTIONAL: If you have implemented the locking mechanism in the previous step, you need to unlock

your locked records in case of CANCEL. Therefore go back to the Cancel part of the coding and call

function module DEQUEUE_ESFLIGHT with the flight key.

5.12. OPTIONAL: Implement IF_FPM_GUIBB_FORM_REPEATER_EXT~NEEDS_CONFIRMATION: For the

data loss popup, check for the cancel event and in case the buffer MT_CHANGED_LINES is not empty, set

EO_CONFIRMATION_REQUEST to CL_FPM_CONFIRMATION_REQUEST=> GO_DATA_LOSS.

5.13. Save and activate feeder class.

5.14. Go to the configuration (FLUID, e.g. out of the running application) and navigate to the OVP Main Page

(MAIN).

5.14.1. In the Overview Page Schema add an Form Repeater Component directly underneath the existing

Form Component and enter the Configuration ID Z_CD167_BOOK_FORM_REP (Y = A and xx

= group number) with Title Bookings. You can as usual ignore the errors and save the

configuration.

30

5.15. Configure Form Repeater

5.15.1. Drill-down to the configuration via

On the upcoming initial screen select New, give a description (if you like to), save as Local Object,

then enter your form repeater feeder class ZCL__CD167_BOOK_FORM_REP (Y = session and

xx = group number) with no feeder parameters.

It is indeed a valid option for you to use the sample feeder class CL_CD167_BOOK_FORM_REP instead

of your own feeder class in case that you encountered difficulties with the coding in the preceding

exercise steps 5.1 5.13.

5.15.2. In the General Settings panels: Select Layout Type 16/2 and set Separator to Horizontal Gutter.

You should also select Row Count to 5 in order to get a paginator lateron.

Drag and drop various fields from the Repository to the Form Repeater Preview. Open the Repositories

On the left side of the form, start with the Booking Number (BOOKID), add the Travel Agency Number (AGENCYNUM), Class (CLASS) and the Invoice Flag (INVOICE). You will notice that the Booking Number will be rendered as non-enterable because we have set this to read-only programmatically before (compare with 5.4.2).

31

5.15.3. In the Attributes panel set for the element Class (CLASS) the Display Type to Drop Down.

And the Display Type of the element Invoice Flag (INVOICE) to Check Box.

5.15.4. Drag and drop (Part 2): Drag and drop the Customer Number (CUSTOMID), Passenger Name

(PASSNAME) and DOB of Passenger (PASSBIRTH) to the right part of the form.

5.15.5. Save your configuration

5.16. Use the breadcrumb to navigate back to the OVP floorplan configuration.

5.16.1. In the Form Repeater you will have to enter the Edit button: In the OVP configuration go to the

Toolbar Schema (you will find it as a stacked panel behind the Overview Page Schema) and select the

Toolbar of UIBB: Bookings and press Add Toolbar Element (see below).

In the popup, select Button.

Result:

32

In the Attributes Panel set the Text of the button to Edit, for the Image Source chose the Edit Icon

(~Icon/Edit) by pressing the Value Help.

And finally set FPM Event ID to FPM_LOCAL_EDIT

5.16.2. In the OVP Global Toolbar you will create a Save and a Cancel button: In the toolbar schema select

the Global Toolbar,

choose Add Toolbar Element and select the Save button, choose again Add Toolbar Element and

select the Cancel button.

5.16.3. Save your configuration.

33

5.17. Restart your application and test the transactional behavior: Click on edit and check whether the form

repeater switches to local edit mode, change the data: Check whether the data loss popup appears in case of

Cancel and check whether the data is saved successfully in case of Save.

34

PART I SOLUTIONS OF THE EXERCISES

This solution document contains only the coding of the class methods of the exercises.

EXERCISE 1 SEARCH FEEDER

(ad 1.4) GET_DEFINITION

METHOD if_fpm_guibb_search~get_definition.

*+++++++++++++++++ 1. Excercise: 1.4 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- field catalog from structure

eo_field_catalog_attr ?= cl_abap_typedescr=>describe_by_name( 'CD167_SEARCH_ATTRIBUTE' ).

ENDMETHOD. "if_fpm_guibb_search~get_definition

(ad 1.5) PROCESS_EVENT METHOD if_fpm_guibb_search~process_event.

*+++++++++++++++++ 1. Excercise: 1.5 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

DATA:

lr_carrid TYPE REF TO data,

lr_connid TYPE REF TO data,

lr_fldate TYPE REF TO data,

lr_seatsmax TYPE REF TO data,

lr_seatsocc TYPE REF TO data.

FIELD-SYMBOLS:

TYPE STANDARD TABLE,




TYPE STANDARD TABLE.

*+++++++++++++++++ 1. Excercise: 1.5.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- which event?

CASE io_event->mv_event_id.

*----- execute search

WHEN if_fpm_guibb_search=>fpm_execute_search.

*+++++++++++++++++ 1. Excercise: 1.5.2 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- range for carrier id

CALL METHOD io_search_conversion->fpm_attribute_into_abap_range

EXPORTING

iv_search_attribute = 'CARRID'

IMPORTING

et_range_tab_ref = lr_carrid.

ASSIGN lr_carrid->* TO .

*----- range for connection id


EXPORTING

iv_search_attribute = 'CONNID'

IMPORTING

et_range_tab_ref = lr_connid.

ASSIGN lr_connid->* TO .

*----- range for flight date


EXPORTING

35

iv_search_attribute = 'FLDATE'

IMPORTING

et_range_tab_ref = lr_fldate.

ASSIGN lr_fldate->* TO .

*----- range for maximum capacity


EXPORTING

iv_search_attribute = 'SEATSMAX'

IMPORTING

et_range_tab_ref = lr_seatsmax.

ASSIGN lr_seatsmax->* TO .

*----- range for occcupied


EXPORTING

iv_search_attribute = 'SEATSOCC'

IMPORTING

et_range_tab_ref = lr_seatsocc.

ASSIGN lr_seatsocc->* TO .

*+++++++++++++++++ 1. Excercise: 1.5.3 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- let the singleton select from database

cl_cd167_flight_access=>get_instance( )->select(

irg_carrid =

irg_connid =

irg_fldate =

irg_seatsmax =

irg_seatsocc =

iv_max_num = iv_max_num_results ).

ENDCASE.

ENDMETHOD. "if_fpm_guibb_search~process_event

36

EXERCISE 3 RESULT LIST FEEDER

(ad 3.4) GET_DEFINITION

METHOD if_fpm_guibb_list~get_definition.

*+++++++++++++++++ 3. Excercise: 3.4 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

DATA:

lo_rtti TYPE REF TO cl_abap_structdescr.

FIELD-SYMBOLS:

LIKE LINE OF et_field_description,

LIKE LINE OF et_action_definition.

*+++++++++++++++++ 3. Excercise: 3.4.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- field catalog: table from sflight

lo_rtti ?= cl_abap_typedescr=>describe_by_name( 'SFLIGHT' ).

eo_field_catalog = cl_abap_tabledescr=>create( lo_rtti ).

*+++++++++++++++++ 3. Excercise: 3.4.2 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- hide client field

APPEND INITIAL LINE TO et_field_description ASSIGNING .

-name = 'MANDT'.

-technical_field = abap_true.

*----- suggest link to action when the connection id is configured


-name = 'CONNID'.

-default_display_type = if_fpm_guibb_constants=>gc_display_type-link_to_action.

*+++++++++++++++++ 3. Excercise: 3.4.3 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- provide (explace) navigation event for leaving the search page

APPEND INITIAL LINE TO et_action_definition ASSIGNING .

-id = if_fpm_constants=>gc_event-navigate.

-text = -id.

-enabled = abap_true.

-visible = cl_wd_uielement=>e_visible-visible.

-event_param_strukname = 'FPM_S_EXT_NAVIGATION_INFO_ADD5'.

ENDMETHOD. "if_fpm_guibb_list~get_definition

(ad 3.5) GET_DATA

METHOD if_fpm_guibb_list~get_data.

*+++++++++++++++++ 3. Excercise: 3.5 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- new data?

CHECK cl_cd167_flight_access=>get_instance( )->has_new_data( ) = abap_true.

*----- retrieve selected flights from singleton

cl_cd167_flight_access=>get_instance( )->get_flights(

IMPORTING

et_flight = ct_data ).

*----- indicate changed data (new search)

ev_data_changed = abap_true.

ENDMETHOD. "if_fpm_guibb_list~get_data

37

EXERCISE 4 FORM FEEDER

(ad 4.4) GET_DEFINITION METHOD if_fpm_guibb_form~get_definition.

*+++++++++++++++++ 4. Excercise: 4.4 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

FIELD-SYMBOLS:

LIKE LINE OF et_field_description.

*+++++++++++++++++ 4. Excercise: 4.4.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- field catalog from sflight

eo_field_catalog ?= cl_abap_typedescr=>describe_by_name( 'SFLIGHT' ).

*+++++++++++++++++ 4. Excercise: 4.4.2 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*



-name = 'MANDT'.


ENDMETHOD. "if_fpm_guibb_form~get_definition

(ad 4.5) GET_DATA METHOD if_fpm_guibb_form~get_data.

*+++++++++++++++++ 4. Excercise: 4.5 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

DATA:

ls_flight TYPE sflight.

*----- get flight from singleton

ls_flight = cl_cd167_flight_access=>get_instance( )->get_selected_flight( ).

*----- accept changed data

IF ls_flight cs_data.

cs_data = ls_flight.


ENDIF.

ENDMETHOD. "if_fpm_guibb_form~get_data

38

EXERCISE 5 FORM REPEATER FEEDER

(ad 5.4) GET_DEFINITION METHOD if_fpm_guibb_form_repeater~get_definition.

*+++++++++++++++++ 5. Excercise: 5.4 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

DATA:

lo_rtti TYPE REF TO cl_abap_structdescr.

FIELD-SYMBOLS:

LIKE LINE OF et_field_description.

*+++++++++++++++++ 5. Excercise: 5.4.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- field catalog from sbook

lo_rtti ?= cl_abap_typedescr=>describe_by_name( 'SBOOK' ).

eo_field_catalog = cl_abap_tabledescr=>create( lo_rtti ).

*+++++++++++++++++ 5. Excercise: 5.4.2 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- display key fields read-only


-name = 'CARRID'.

-read_only = abap_true.


-name = 'CONNID'.



-name = 'FLDATE'.



-name = 'BOOKID'.


*+++++++++++++++++ 5. Excercise: 5.4.3 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*



-name = 'MANDT'.


ENDMETHOD. "if_fpm_guibb_form_repeater~get_definition

(ad 5.5, 5.6, 5.9 and 5.11) PRIVATE SECTION private section.

types:

*+++++++++++++++++ 5. Excercise: 5.5 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

tt_book TYPE STANDARD TABLE OF sbook WITH DEFAULT KEY .

*+++++++++++++++++ 5. Excercise: 5.6 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

data MT_BOOK type TT_BOOK .

data MV_READ_FROM_DB type ABAP_BOOL value ABAP_TRUE. "#EC NOTEXT . . . . . . . . " .

data:

*+++++++++++++++++ 5. Excercise: 5.9 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

mt_changed_lines TYPE SORTED TABLE OF i WITH UNIQUE DEFAULT KEY .

*+++++++++++++++++ 5. Excercise: 5.11.6 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

methods LOCK_FLIGHT

returning

value(RT_MESSAGE) type FPMGB_T_MESSAGES .

*+++++++++++++++++ 5. Excercise: 5.11.7 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

methods UNLOCK_FLIGHT .

39

(ad 5.7) GET_DATA METHOD if_fpm_guibb_form_repeater~get_data.

*+++++++++++++++++ 5. Excercise: 5.7 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

DATA:

ls_flight TYPE sflight.

*+++++++++++++++++ 5. Excercise: 5.7.2 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- reread from data base is necessary?

IF mv_read_from_db = abap_true.

mv_read_from_db = abap_false.

*+++++++++++++++++ 5. Excercise: 5.7.1 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- get current flight

ls_flight = cl_cd167_flight_access=>get_instance( )->get_selected_flight( ).

*----- select bookings from data base for current flight

SELECT * FROM sbook INTO TABLE mt_book

WHERE carrid = ls_flight-carrid

AND connid = ls_flight-connid

AND fldate = ls_flight-fldate.

ENDIF.

*+++++++++++++++++ 5. Excercise: 5.7.3 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- return changed data

IF mt_book ct_data.

ct_data = mt_book.


ENDIF.

ENDMETHOD. "if_fpm_guibb_form_repeater~get_data

(ad 5.10) FLUSH METHOD if_fpm_guibb_form_repeater~flush.

*+++++++++++++++++ 5. Excercise: 5.10 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

FIELD-SYMBOLS:

LIKE LINE OF it_change_log,

LIKE LINE OF mt_book,

TYPE data,

TYPE data.

*------ all changes

LOOP AT it_change_log ASSIGNING .

*----- get booking record for changelo index

READ TABLE mt_book INDEX -line_index ASSIGNING .

CHECK sy-subrc = 0.

*----- get the new (changed) value

ASSIGN -new_value->* TO .

CHECK sy-subrc = 0.

*----- put a pointer on the old value

ASSIGN COMPONENT -name OF STRUCTURE TO .

CHECK sy-subrc = 0.

*----- if truely changed, accept new value and buffer changed line index

CHECK .

= .

INSERT -line_index INTO TABLE mt_changed_lines.

ENDLOOP.

ENDMETHOD. "if_fpm_guibb_form_repeater~flush

40

(ad 5.10) PROCESS_EVENT METHOD if_fpm_guibb_form_repeater~process_event.

*+++++++++++++++++ 5. Excercise: 5.11 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

DATA:

lv_index TYPE i,

ls_book LIKE LINE OF mt_book.

*----- which event?


*+++++++++++++++++ 5. Excercise: 5.11.2 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- save

WHEN if_fpm_constants=>gc_event-save.

*----- save changed bookings

LOOP AT mt_changed_lines INTO lv_index.

READ TABLE mt_book INDEX lv_index INTO ls_book.

CHECK sy-subrc = 0.

UPDATE sbook FROM ls_book.

ENDLOOP.

*+++++++++++++++++ 5. Excercise: 5.11.3 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

COMMIT WORK.

*----- clean up: read again after save

mv_read_from_db = abap_true.

CLEAR mt_changed_lines.

*+++++++++++++++++ 5. Excercise: 5.11.4 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- cancel

WHEN if_fpm_constants=>gc_event-cancel.

*----- clean up



*+++++++++++++++++ 5. Excercise: 5.11.7 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

unlock_flight( ).

*+++++++++++++++++ 5. Excercise: 5.11.5 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- edit

WHEN if_fpm_constants=>gc_event-local_edit.

*---- only own local edit

CHECK iv_raised_by_own_ui = abap_true.

*----- clean up: read again for edit



*+++++++++++++++++ 5. Excercise: 5.11.6 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*---- lock flight

APPEND LINES OF lock_flight( ) TO et_message.

*---- prevent edit mode in case lock fails

IF lines( et_message ) > 0.

ev_result = if_fpm_constants=>gc_event_result-failed.

ENDIF.

ENDCASE.

ENDMETHOD. "if_fpm_guibb_form_repeater~process_event

41

(ad 5.12) NEEDS_CONFIRMATION METHOD if_fpm_guibb_form_repeater_ext~needs_confirmation.

*+++++++++++++++++ 5. Excercise: 5.12 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*

*----- which event?


*----- cancel

WHEN if_fpm_constants=>gc_event-cancel.

*----- send a data loss popup in case data bookings have been changed

CHECK lines( mt_changed_lines ) > 0.

eo_confirmation_request = cl_fpm_confirmation_request=>go_data_loss.

ENDCASE.

ENDMETHOD. "if_fpm_guibb_form_repeater_ext~needs_confirmation

42

PART II APPENDIX

The Appendix is intended for reconstructing the exercise in any system which contains SAP Net Weaver 7.03/7.31.

Application Creation Tool The Application Creation Tool is available as Web Dynpro application FPM_CFG_BO_MODEL_ACT with Web Dynpro application configuration FPM_CFG_BO_MODEL_ACT.

Availability of the Form Repeater The Form Repeater which is part of Exercise 5, was introduced with SAP Net Weaver 7.03/7.31 Support Package 4. In case you do not have this Support Package available, you use a GUIBB List instead of the Form Repeater to achieve a similar transactional behavior. The exact description on how to do this is not part of this document.

Coding of the central singleton class The singleton class CL_CD167_FLIGHT_ACCESS which you could rely on during your exercises, is not part of any SAP delivery. Therefore you will need this coding if you want to reconstruct the exercises later. You find the entire source code attached: *----------------------------------------------------------------------*

* CLASS CL_CD167_FLIGHT_ACCESS DEFINITION

*----------------------------------------------------------------------*

*

*----------------------------------------------------------------------*

CLASS cl_cd167_flight_access DEFINITION

PUBLIC

FINAL

CREATE PUBLIC .

PUBLIC SECTION.

TYPES:

trg_carrid TYPE RANGE OF sflight-carrid .

TYPES:

trg_connid TYPE RANGE OF sflight-connid .

TYPES:

trg_fldate TYPE RANGE OF sflight-fldate .

TYPES:

trg_seatsmax TYPE RANGE OF sflight-seatsmax .

TYPES:

trg_seatsocc TYPE RANGE OF sflight-seatsocc .

TYPES:

t_flight TYPE STANDARD TABLE OF sflight WITH DEFAULT KEY .

DATA mv_index TYPE i READ-ONLY .

METHODS select

IMPORTING

!irg_carrid TYPE trg_carrid

!irg_connid TYPE trg_connid

!irg_fldate TYPE trg_fldate

!irg_seatsmax TYPE trg_seatsmax

!irg_seatsocc TYPE trg_seatsocc

!iv_max_num TYPE i DEFAULT 0 .

CLASS-METHODS get_instance

RETURNING

value(ro_instance) TYPE REF TO cl_cd167_flight_access .

METHODS get_flights

EXPORTING

!et_flight TYPE t_flight .

METHODS set_index

IMPORTING

!iv_index TYPE i .

METHODS get_selected_flight

RETURNING

43

value(rs_flight) TYPE sflight .

TYPE-POOLS abap .

METHODS has_new_data

RETURNING

value(rv_new_data) TYPE abap_bool .

PROTECTED SECTION.

PRIVATE SECTION.

CLASS-DATA so_instance TYPE REF TO cl_cd167_flight_access .

DATA mt_flight TYPE t_flight .

TYPE-POOLS abap .

DATA mv_new_data TYPE abap_bool VALUE abap_false. "#EC NOTEXT .

ENDCLASS.

CLASS CL_CD167_FLIGHT_ACCESS IMPLEMENTATION.

* ---------------------------------------------------------------------------------------+

* | Instance Public Method CL_CD167_FLIGHT_ACCESS->GET_FLIGHTS

* +-------------------------------------------------------------------------------------------------+

* | [GET_SELECTED_FLIGHT

* +-------------------------------------------------------------------------------------------------+

* | [ 0.

READ TABLE mt_flight INDEX mv_index INTO rs_flight.

ENDMETHOD. "GET_SELECTED_FLIGHT

* ---------------------------------------------------------------------------------------+

* | Instance Public Method CL_CD167_FLIGHT_ACCESS->HAS_NEW_DATA

* +-------------------------------------------------------------------------------------------------+

* | [

44

ENDMETHOD. "has_new_data

* ---------------------------------------------------------------------------------------+

* | Instance Public Method CL_CD167_FLIGHT_ACCESS->SELECT

* +-------------------------------------------------------------------------------------------------+

* | [--->] IRG_CARRID TYPE TRG_CARRID

* | [--->] IRG_CONNID TYPE TRG_CONNID

* | [--->] IRG_FLDATE TYPE TRG_FLDATE

* | [--->] IRG_SEATSMAX TYPE TRG_SEATSMAX

* | [--->] IRG_SEATSOCC TYPE TRG_SEATSOCC

* | [--->] IV_MAX_NUM TYPE I (default =0)

* +--------------------------------------------------------------------------------------

METHOD select.

*----- refresh buffer

CLEAR mt_flight.

*----- select flights from data base

SELECT * UP TO iv_max_num ROWS

FROM sflight INTO TABLE mt_flight

WHERE carrid IN irg_carrid

AND connid IN irg_connid

AND fldate IN irg_fldate

AND seatsmax IN irg_seatsmax

AND seatsocc IN irg_seatsocc.

*----- use initial index 1

mv_index = 1.

*----- set new data indicator

mv_new_data = abap_true.

ENDMETHOD. "select

* ---------------------------------------------------------------------------------------+

* | Instance Public Method CL_CD167_FLIGHT_ACCESS->SET_INDEX

* +-------------------------------------------------------------------------------------------------+

* | [--->] IV_INDEX TYPE I

* +--------------------------------------------------------------------------------------

METHOD set_index.

*---- set internal index

mv_index = iv_index.

ENDMETHOD. "set_index

ENDCLASS.

2012 by SAP AG. All rights reserved. SAP and the SAP logo are registered trademarks of SAP AG in Germany and other countries. Business Objects and the Business Objects logo are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company. Sybase and the Sybase logo are registered trademarks of Sybase Inc. Sybase is an SAP company. Crossgate is a registered trademark of Crossgate AG in Germany and other countries. Crossgate is an SAP company.

Documents

Cd167 Exercises Vho Final