NWBC Side Panel Demo Combining A SAP GUI Transaction With An HTML5-based FPM Chart GUIBB - SAP Blogs
NWBC Side Panel Demo Combining A SAP GUI Transaction With An HTML5-based FPM Chart GUIBB - SAP Blogs
Products
Products Industries
Industries Support
Support Training
Training Community
Community Developer
Developer Partner
Partner
About
About
Home / Community / Blogs + Actions
Oliver Welzel
more by this author
share
0 share tweet share
Follow RSS
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 1/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
There is no doubt that the side panel is a very popular feature of the SAP
NetWeaver Business Client (NWBC) for Desktop. Even though there are
already some blogs available about this topic, I want to describe a simple
example which combines interesting technologies in one scenario. The
scenario consists of a SAP GUI transaction on the one hand and a side panel
application showing a Floorplan Manager (FPM) chart GUIBB on the other
hand. The chart GUIBB is based on the JavaScript library CVOM (Common
Visual Object Modeler), but the handling of the library is completely hidden by
FPM. In contrast to IGS (Internet Graphics Service) charts the CVOM charts
are much more appealing because of their animation and interaction
capabilities.
Both the transaction (SEPM_SO) and the side panel application are part of the
NetWeaver Enterprise Procurement Model (NWEPM). The NWEPM is
comparable with the classical flight model which is used since a long time at
SAP for training, documentation, etc. NWEPM covers sales and purchasing
business processes allowing more realistic demos than the flight model does.
All applications of the NWEPM are only used for demo or test purposes. They
are not intended for productive usage. The data which is displayed in the
applications is demo data generated by a data generator.
The following NWBC for Desktop side panel demo is part of every SAP
NetWeaver 7.40 starting from SP6.The example is purely relying on SAP
Basis functionality, that’s why the BCV (Business Context Viewer) side panel
is out of scope and Business Suite naming conventions do not apply.
Business Scenario
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 2/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Implementation
The following chapters cover all the necessary steps for the implementation of
the scenario from creating the tags and the PFCG role entries, via creating a
side panel CHIP page and a Web Dynpro CHIP up to the creation of an FPM
UIBB CHIP wrapper for a chart GUIBB.
The reader should already have some basic knowledge in ABAP Web Dynpro,
NWBC and PFCG, because the focus of this blog is not so much on a detailed
description of how to use each development tool but more to get a general
overview what has to be done and how the different steps depend on each
other. Like a matryoshka doll the description is structured from the outer to the
inner components.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 3/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
1. Tag De nition
The exchange of data between the SAP GUI transaction and the side panel
application is based on matching tag names. The source field on the SAP GUI
transaction screen is given a tag name and the same tag name must be used
to identify the target parameter of the CHIP inport in the side panel.
The first step is to define a tag on the source side. This is done by starting the
SAP GUI transaction SEPM_SO in the SAP NWBC and opening the SAP GUI
property collector. In order to start the property collector it is necessary to keep
the CTRL-key pressed while opening the NWBC menu Help -> Tools -> SAP
GUI Property Collector. The tool allows the selection of a Dynpro field on the
SAP GUI screen, in this case the field Business Partner ID, and creates a data
line in the property collection table. The created data line must be selected
and copied to the clipboard.
To store the copied tag information in the SAP system start transaction SM30,
create a new entry for maintenance view NWBC_VC_GUI_TAG, paste the
clipboard content and add a tag name. In this example the tag name is
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 4/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
2. PFCG Role
The present scenario is part of the PFCG role SAP_BC_EPM_DEMO which is
shipped with SAP NetWeaver 7.40 (SP6 or higher).
When starting transaction PFCG, open the role in edit mode, switch to the
Menu tab and press the button Other Node Details. The transaction
SEPM_SO is added as role menu entry to the PFCG role. From this menu
entry a user, who has the role assigned, will start the whole scenario.
Additionally a menu entry for the side panel is required. Therefore the Web
Dynpro application WDR_CHIP_PAGE is added as menu entry with the
application configuration S_EPM_SIDE_PANEL. The next chapter contains
more details regarding this application configuration.
The side panel menu entry should look like in the below screenshot from
PFCG. Important are the value Side Panel in field Node Option and the
assignment of the transaction to the side panel application by the value in field
Application Alias. Instead of assigning the transaction SEPM_SO in general, it
would also be possible to define a role specific assignment. In this case the
value would be {REF= 182} with 182 being the node ID of the menu entry for
transaction SEPM_SO within this role.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 5/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Also the CVOM chart that is used in this scenario requires a certain rendering
mode. For this reason the option WDPREFERREDRENDERING must be set
to Standards Mode which has an impact on the available browsers. When
using Internet Explorer, version 9 or higher is mandatory.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 6/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
The next steps explain how to create a CHIP that can finally be added to a
CHIP page.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 7/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 8/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
The FPM chart GUIBB cannot be used directly in a Web Dynpro CHIP. It must
be wrapped by the Web Dynpro component FPM_UCW_COMPONENT. The
wrapping is simply done by creating a component configuration
S_EPM_SALES_CHART_UCW for the Web Dynpro component
FPM_UCW_COMPONENT which references the FPM_CHART_UIBB
component with the configuration EPM_SALES_CHART_CFG. More
information about the FPM GUIBB configuration EPM_SALES_CHART_CFG
follows in the chapter below.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 9/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
As chart type the Column type is used. Furthermore the chart consists of two
axes. One is the time axis with the six months and the other one is the sales
axis with the cumulated sales amounts. The two axes are configured on the
tab Chart UIBB Schema by choosing TIMES as a dimension and SALES as a
measure. TIMES and SALES are fields of the chart data structure from the
feeder class.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 10/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Finally a feeder class for the chart GUIBB is required. This ABAP class must
implement the FPM interfaces IF_FPM_GUIBB_CHART and
IF_FPM_CHIP_FEEDER.
The CHIP inport and parameter are defined in the method CHIP_INIT of the
interface IF_FPM_CHIP_FEEDER. Also the parameter is associated in this
method with the tag name EPM_BUYER_ID which was specified in
transaction SM30.
Below there is a code snippet with the relevant methods. All other methods of
the interfaces IF_FPM_GUIBB_CHART and IF_FPM_CHIP_FEEDER are
implemented empty. The code uses some of the nice new ABAP language
features coming with SAP NetWeaver 7.40.
PRIVATE SECTION.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 11/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
METHOD if_fpm_chip_feeder~chip_init.
mo_chip_api = io_chip_api.
DATA(lv_type_name) =
mo_chip_api->add_dynamic_inport(
inport_description =
cl_chip_port_helper=>create_port_descr_from_ddic(
display_name = gc_buyer_inport
description = text-003
type_name = lv_type_name
display_name = gc_buyer_id
description = text-004
activate_immediately = abap_true ).
ENDMETHOD.
METHOD if_fpm_guibb_chart~get_data.
” The chart shall display the sales history of a buyer given by its ID that covers
” the last six months including the current month. The monthly sales figure is the
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 12/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
” sum of all sales order gross amounts of the given buyer in that month.
io_event->mo_event_data->get_value(
EXPORTING
iv_key = if_fpm_constants=>gc_event_param-chip_port_event
IMPORTING
ev_value = lo_inport_event ).
mo_chip_api->get_data_from_inport_event(
EXPORTING
inport_event = lo_inport_event
CHANGING
data_change = lv_buyer_id ).
DATA(lv_date) =
CONV sydatum( |{ sy-datlo(4) }{ sy-datlo+4(2) – 5 WIDTH = 2 ALIGN = RIGHT PAD = ‘0’ }01| ).
DATA(lt_bp_id_selection) =
VALUE if_epm_so_header=>tt_sel_par_partner_ids(
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 13/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
DATA(lt_time_selection) =
” Calculate the sum of gross amounts for each of the six months
DO 6 TIMES.
DATA(lv_month) = lv_date+4(2).
” Set the first day of this month as low value of the time selection range.
” Set the last day of this month as high value of the time selection range.
” Calculate the gross amount sum of all sales orders of the given buyer for this month.
INTO @<ls_chart_data>-sales
ENDDO.
ENDIF.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 14/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
” Set the sales history data. The data might be empty if no buyer ID is given.
ENDIF.
ENDMETHOD.
” Define the structure and some text properties of the chart data
io_chart_model->get_table_model( )->set_definition(
io_field_catalog =
it_field_description =
ENDMETHOD.
METHOD if_fpm_guibb~initialize.
TABLES
month_names = mt_month_names
EXCEPTIONS
OTHERS = 1.
” If there are no month names in the language of the user, take the English names
IF sy-subrc <> 0.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 15/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
EXPORTING
language = ‘E’
TABLES
month_names = mt_month_names.
ENDIF.
ENDMETHOD.
Alert Moderator
20 Comments
You must be Logged on to comment or reply to a post.
Raf Boudewijns
As of step 4 things are different in our version… we have other chip components instead
of the FPM_UCW_COMPONENT. We have a S_EPM_CHART_DISPLAY and an
additional S_EPM_MAP_DISPLAY. Not sure whether I need a “wrapper” configuration for
those (but I think not).
Anyways, assuming that we don’t need this wrapper, then something else is still
wrong/not configured as our side-panel doesn’t show any data. Will investigate this
further…
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 16/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Hi Raf,
yes, the wrapper is only needed if you want to use an FPM UIBB in a
sidepanel CHIP like in the scenario described in this blog.
FPM_UCW_COMPONENT is a Web Dynpro component that does also
exist in 7.31. It is not part of NWEPM but belongs to FPM and wrapps
UIBBs generically to provide the UIBB with an FPM runtime within the CHIP
environment. The reason why the scenario of this blog is not available in
7.31 is because FPM does not offer the chart UIBB there.
Ciao
Oliver
Raf Boudewijns
Hey Oliver,
The scenario for 7.31 will actually work when following the
steps from your blog up until steps 4/5. The side panel shows
a chart and a map. The latter doesn’t work for me (at the
client) because I currently don’t have (direct) internet access
over there (due to changes in their firewall). The chart only
shows data for 1 month (in my example as I didn’t generate
much data for the EPM data model yet) and by default it shows
a couple of months worth. Only the last month is filled (in my
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 17/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
case) and since the side panel wasn’t wide enough, it didn’t
show.
Cheers,
Raf
Hi Raf,
Ciao
Oliver
Simon Kemp
Hi Oliver,
Thanks for taking the time to share this, it has helped me a lot to understand how the
whole thing hangs together. I have to admit my brain still hurts when I look at the
Application and Component Configurations… having not done a whole lot of WDA
development myself I think I need to review how that all works exactly. Have you come
across any good (simple) explanations of the different types of configurations?
Thanks,
Simon
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 18/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Hi Simon,
The last section of the following SAP help page might give you an idea why
there are two types of configurations in Web Dynpro.
Translated into the scenario of this blog there are three relevant entities in
the sidepanel:
Ciao
Oliver
Former Member
Hi Oliver,
I’ve had a look at your guide. I’ve done as you have described above on a NW 7.40 SP
4 system, but my chart is empty. No errors or anything.
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 19/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
I’ve debugged the get data and there is data in the tables. Do you have any idea why i
might not get the charts?
Hi Jakob,
did you expand the sidepanel far enough to see all six months? By default
the NWEPM data generator creates only sales orders for the current month
which is displayed on the very right side and might not be visible.
In order to have a nicer demo you can generate data for the last six months.
Just start transaction SEPM_DG, enter 2000 Sales Orders on the tab Basic
Settings, provide a six month interval on the tab Sales Orders under
“Created On – Options”, “Selected Date Interval” with “Date To” beeing the
end of the current month and press F8.
Ciao
Oliver
Raf Boudewijns
Former Member
Hi Oliver,
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 20/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Former Member
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 21/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Hi Jakob,
Ciao
Oliver
Former Member
Hi Oliver,
Erik Hoven
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 22/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Thanks….great blog
Christian Punz
hi Oliver,
worked well on our system (Suite on HANA, NWBC ABAP patch 43, IE11, NWBC 5.0 PL
3). Thank you for the hint regarding the generation of EPM data with TCODE SEPM_DG
and the setting for browser STANDARD MODE.
Also thanks to Julie Plummer for the reference in her blog NWBC at SAP TechEd Berlin
2014 – Wrapup.
Hopefully I am able to find a way for integrating the CVOM-graphics in the workcenters
as well (instead of the obsolete flash-islands)…
br
christian
Former Member
Hi Oliver
How do I get my SAP GUI Property Collector filled with values from NWBC transaction?
Mine is empty but filled from Standard GUI for Windows. But I dont think the Property
value is the same?
Thanks Kim
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 23/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Hi Kim,
so, you could use the property collector with SAP logon but not with SAP
GUI in NWBC? You can switch the input source via the drop-down field
“Process”. For NWBC you have to choose “SAP GUI in NWBC”.
Finally it is not relevant whether you start the target transaction (here
SEPM_SO) within the SAP logon or within SAP GUI in NWBC. In both
variants you would copy the same properties via the SAP GUI Property
Collector.
Ciao
Oliver
Former Member
Hi Oliver
I can start the property collector both from within NWBC and
SAP GUI.
When I choose “SAP GUI in NWBC” nothing is collected.When
I choose “SAP Logon” my screen is correctly collected but
property is only set “lid:/[0]/titl.Text and not the wanted field
name. How do i get a tab-field name collected instead of the
titl.Text?
Thanks
Kim
Hi Kim,
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 24/25
9/18/2018 NWBC Side Panel Demo combining a SAP GUI Transaction with an HTML5-based FPM Chart GUIBB | SAP Blogs
Ciao
Oliver
Former Member
Hi Oliver
That works!
Many thanks.
Brgds Kim
https://blogs.sap.com/2013/11/21/nwbc-side-panel-demo-combining-a-sap-gui-transaction-with-an-html5-based-fpm-chart-guibb/ 25/25