Skip to Content
Overview Adapting SP Content Building CHIPs

Overview

This blog post is the third part of the SDN series about the Side Panel for Business Suite. For a first overview about the topic please refer to the blog post Side panel for SAP Business Suite – Overview. For a detailed description how to adapt SAP’s Side Panel content and create new content please refer to the blog post Side panel for SAP Business Suite (2).

This post describes the procedure how to build a master data and a chart-based CHIP. To understand the procedure how to achieve this, it is important to know the typical components of a Web Dynpro CHIP:

/wp-content/uploads/2013/04/1_208307.png

Please note: only for the feeder class a few lines of ABAP coding must be written, while all other parts are pure configuration.

More examples for other CHIPs can be found in the Business Suite Side Panel Documentation.

How to create a master data CHIP

Example

/wp-content/uploads/2013/04/2_208528.png

1.)   Search for an existing business object (BOR object)

A BOR object for our master data CHIP is needed on the one hand to define the business object the CHIP deals with and (more importantly) to ensure that the correct information is transported from the transaction to the CHIP via tagging. For a detailed description about tagging please refer to the blog post Side panel for SAP Business Suite (2).

The CHIP framework later automatically uses the BOR object to determine the key fields and to create so-called dynamical inbound ports to read these (tagged) fields.

Within the transaction SWO1 search for an already existing BOR object type for your master data object or create a new BOR object. If the CHIP should display detailed company data the corresponding BOR object could be BUS0014 (Company). Check if the key fields (in this example the CompanyID) are defined correctly and if a display method exists.

/wp-content/uploads/2013/04/3_208311.png

2.)   Create the feeder class for your master data CHIP

Before you actually create the feeder class for your CHIP, search for a BAPI or a RFC-enabled function module that returns detailed master data for your object. Analyze the defined structures of the BAPI result structures.

Within the ABAP workbench create a feeder class that inherits from super class CL_BSSP_DETAIL_FORM. This super class handles for example the creation of dynamical inbound ports based on the key fields of the BOR object, the import of GUI data and the automatic link to the master data maintenance transaction.

If relevant DDIC structures are not available in the development system, you have to create class types that correspond to the structures of the BAPI/RFC module result in the feeder class.

Redefine the following methods in the feeder class:

·     

  •    <IF_FPM_GUIBB>~INITIALIZE (BOR object + structure or class type for the field catalog)

/wp-content/uploads/2013/04/4_208312.png

  • <IF_FPM_GUIBB_FORM>~GET_DATA (call of BAPI/RFC function module(s) for selecting the master data)

/wp-content/uploads/2013/04/5_208313.png

  • <IF_FPM_GUIBB_FORM>~GET_DEFINITION (only if necessary, e.g. for adjustment of texts)

/wp-content/uploads/2013/04/6_208314.png

3.)   Create a Web Dynpro Component Configuration

Create a new Web Dynpro component configuration. Make sure the component name is set to FPM_FORM_UIBB_GL2.

/wp-content/uploads/2013/04/7_208315.png

Within the component configuration, set the Layout type to 8/1, the feeder class to the one you created in step 2.), the main key-field as a “Navigation Link” and assign the FPM-event LINK_SELECTED to the main key-field.

/wp-content/uploads/2013/04/8_208316.png

4.)   Create a Web Dynpro FPM Wrapper Component Configuration

Create a new Web Dynpro component configuration for the wrapper component FPM_UCW_COMPONENT. Make sure that the component configuration uses the UIBB configuration of the previous step.

/wp-content/uploads/2013/04/9_208317.png

5.)   Create a Web Dynpro CHIP

Create the actual Web Dynpro CHIP and provide both name and description for the CHIP. At “Component” fill FPM_UCW_COMPONENT and at “Component Name” use the previously created component configuration.

/wp-content/uploads/2013/04/10_208318.png

6.)   (Optional) Create Customer-specific CHIP Provider Pages for the CHIP catalog

If you want add your CHIP to the CHIP catalog BSSP_CHIP_CATALOG, you must create your own CHIP provider pages for the CHIP catalog.

Similar to step 3.), create a new Web Dynpro component configuration. Make sure the component name is set to WDR_CHIP_PAGE. The component configuration must follow the naming convention ZZSP_PROVIDER*. Enter the component configuration and select the CHIP Provider checkbox in the context attributes.

/wp-content/uploads/2013/04/11_208319.png

Add your CHIPs under the context node “chipUsages Variant (1) under New -> chipUsages.

/wp-content/uploads/2013/04/12_208320.png

For each CHIP, add the CHIP URL X-SAP-WDY-CHIP:CHIP_NAME (for instance X-SAP-WDY-CHIP:BSSP_COMPANY for the CHIP BSSP_COMPANY).

7.)   Further steps

Remark: All following steps are already described in the SDN blog post “Side panel for SAP Business Suite (2) – Adapting SAP’s Side Panel content and creating new content”.

  • Add the CHIP to an already existing side panel page or create a new one.
  • Assign the side panel page to a side panel folder in a PFCG role.
  • Maintain the tagging within the table view NWBC_VC_GUI_TAG using the SAP GUI Property Collector and the transaction SM30 in the backend system.

How to create a chart CHIP

Example

/wp-content/uploads/2013/04/14_208322.png

Superclasses for different data sources

There are various superclasses available for creating chart CHIPs which offer possibilities to access data from different data sources.

  • POWL (Personal Object Work List) used for data access: CL_BSSP_GRAPHICS_POWL
  • ODPs (Operational Data Providers) or BI Queries used for data access: CL_BSSP_GRAPHICS_ODP
  • oData (Open Data Protocol) used for data access: CL_BSSP_GRAPHICS_ODATA
  • ABAP remote function modules used for data access: CL_BSSP_GRAPHICS_FUNC

This article focuses on charts which read their data from an underlying POWL.

1.)   Search for an existing business object (BOR object)

Follow the steps which are described in the Section “How to create a master data CHIP” – 1.) Search for an existing business object (BOR object)”.

2.)   Create the feeder class for your chart CHIP

Before you actually create the feeder class for your CHIP, analyze whether it is possible to reuse an already existing POWL to show its data (for certain categories) in the chart CHIP.

Within the ABAP workbench create a feeder class that inherits from one of the super classes (CL_BSSP_GRAPHICS_*) above. This super class handles for example the creation of dynamical inbound ports based on the key fields of the BOR object, the import of GUI data and the data selection. We use here CL_BSSP_GRAPHICS_POWL in this article.

Redefine the following methods in the feeder class.

  • <IF_FPM_GUIBB>~INITIALIZE     (BOR Object Type and some different settings depending on which super class is used)
  • <CL_BSSP_GRAPHICS_* >~GET_CATEGORY_FIELDS               (categories for display)                      
  • <CL_BSSP_GRAPHICS_*>~CHANGE_SEL_CRITERIA (criteria for data selection)
  • <CL_BSSP_GRAPHICS_*>~CHANGE_DATA                 (standard data display)

/wp-content/uploads/2013/04/15_208323.png

Please note that you need to redefine other methods for other super classes:

1. For CL_BSSP_GRAPHICS_FUNC you have to redefine the following methods

  • <IF_FPM_GUIBB>~INITIALIZE  
  • <IF_BS_ANLY_GUIBB_CHART>~GET_DEFINITION
  • <IF_BS_ANLY_GUIBB_CHART>~GET_DATA

2. For CL_BSSP_GRAPHICS_ODATA you have to redefine the following methods

  • <IF_FPM_GUIBB>~INITIALIZE  
  • <IF_BS_ANLY_GUIBB_CHART>~GET_DEFINITION
  • <IF_BS_ANLY_GUIBB_CHART>~GET_DATA
  • <CL_BSSP_GRAPHICS_ODATA>~GET_FIELDMAPPING

3. For CL_BSSP_GRAPHICS_ODP you have to redefine the same methods as for CL_BSSP_GRAPHICS_POWL (except for the method <CL_BSSP_GRAPHICS_*>~CHANGE_DATA).

3.)   Create a Web Dynpro Component Configuration

Create a new Web Dynpro component configuration. Make sure the component name is set to BS_ANLY_CHART_UIBB.

Within the component configuration, fill the feeder class with the one you just create during step 2.).

/wp-content/uploads/2013/04/16_208324.png

Please note that for charts which read their data from an ODP or a function module you need to define as a next step a Web Dynpro FPM wrapper component configuration (as mentioned above for master data CHIPs).

4.)   Create a Web Dynpro CHIP

Create the actual Web Dynpro CHIP and provide both name and description for the CHIP. At “Component” fill BS_ANLY_CHART_UIBB and at “Component Name” use the previously created component configuration.

/wp-content/uploads/2013/04/17_208325.png

5.)   (Optional) Create Customer-specific CHIP Provider Pages for the CHIP catalog

Follow the steps which are described in the Section “How to create a master data CHIP” – 6.) (optional) Create Customer-specific CHIP Provider Pages for the CHIP catalog”.

Resources

Business Suite Documentation:

http://help.sap.com/erp2005_ehp_06/helpdata/en/58/327666e82b47fd83db69eddce954bd/frameset.htm

SDN Article “Side panel for SAP Business Suite – Overview”:
http://scn.sap.com/community/erp/blog/2013/02/25/side-panel-for-sap-business-suite

SDN Article “Side panel for SAP Business Suite (2) – Adapting SAP’s Side Panel content and creating new content”:
http://scn.sap.com/community/erp/blog/2013/03/18/side-panel-for-sap-business-suite-2–adapting-sap-s-side-panel-content-and-creating-new-content

More examples for other CHIPs can be found in the Business Suite Side Panel Documentation.

To report this post you need to login first.

1 Comment

You must be Logged on to comment or reply to a post.

Leave a Reply