GeneXus For SAP Systems KPI Worklist Floorplan

Official Content
This documentation is valid for:

The KPI Worklist Floorplan is a set of layouts that allows you to query and view data and it also calculates a KPI that you define. 

This article describes how to apply it to a Transaction or Web Panel to obtain a page like the following:

image_20221125155218_1_png

In the shown image, the KPI calculated corresponds to the average population of the country.

Note: The design guideline of this floorplan is at SAP's documentation.

How to apply the KPI Worklist Floorplan

Look at the Patterns tab of the Country Transaction. If you have never applied the Fiori for Web pattern in your Knowledge Base before, read here. Otherwise, by positioning on the Fiori for Web Pattern tab, check the Apply this pattern on save checkbox and select the offered link to choose a floorplan:

GeneXusForSAPSystems_ListAndReportPattern_Image83

Then, select the KPI Worklist option from the list given by GeneXus:

image_20221125153611_1_png

This floorplan can be applied to a Transaction object or a Web Panel object.

Learn how to apply it to a Web Panel.

How to set the KPI

By default, the KPI is an unset variable. In order to set it, you have to open the Object KPI Worklist Web Panel. 

image_2022112515412_1_png

Note: Temporarily the Web Panel's name is not WebPanelNameKPIWorklist but it is WebPanelNameListReport.

Once there, go to the Events section.

You can program the KPI behavior on the Refresh Event.

If you want to have a dynamic KPI (the calculation changes when a filter is applied) you can solve it by using the Data Selector object generated by GeneXus:

image_2022112515428_1_png

Note: Temporarily the Data Selector's name is not YourObjectNameSimpleWorklistDS but it is YourObjectNameListReportDS.

Remember to do it outside the code generated by GeneXus (to avoid being overwritten by GeneXus).

KPIBehaviorWebPanel_png

How to customize it

The following section explains how to customize your KPI Worklist.

Add/Modify/Delete actions

You can add, modify or delete actions by positioning on the KPI Worklist tab. However, if you want to do this, you may prefer the GeneXus For SAP Systems List Report Floorplan.

To add actions, right-click on the GridActions node and then, select Add / UserAction from the contextual menu. The action will be added outside the grid (in the section where is located the button to insert).

AddUserActionKPIWorklist_png

To modify these actions, right-click on the action node and select the 'Go to Event' option. Then, you can modify the event code, but remember to do it outside the code generated by GeneXus (to avoid being overwritten by GeneXus).

If you want to add an action inside the grid for every line, right-click on the Grid node and select Add / UserAction in the contextual menu:

AddGridUserActionKPIWorklist_png

In order to modify these actions, you have to follow the next steps:

1. Right-click on the KPI Worklist tab and select Open YourObjectNameKPIWorklist.

OpenCountryKPIWebPanel_2018419112748_1_png

2. Once in the KPI Worklist Web Panel, go to the Events Section.

KPIWebPanelEventsSection_2018419112754_1_png

3. While there, you only have to create the Click event for your customized actions.

ClickEventKPIWorklistWebPanel_png

Manage filters

You can manage the filters by positioning on the KPI Worklist tab.

To add filters you have to right-click on the Table Filter node, select Add in the contextual menu and then choose the kind of filter you want.

AddFilterKPIWorklist_201841910562_1_png

For more information, see GeneXus For SAP Filters.

Manage Orders

You can manage the Orders by positioning on the KPI Worklist tab. Once there, you have to right-click on the GridActions node and then select Add > Orders.

image_2019621114521_1_png

After having created the Orders node, right-click on Orders and then choose Add > Order to add a new one.

image_201962111466_1_png

For each order you create, you have to complete its Name property:

image_2019621114725_1_png

and you have to add the attribute(s) by which the list will be sorted:

image_201962111483_1_png

For each attribute, you can change the Ascending property to choose whether you want the list to be sorted in ascending or descending order considering that attribute(s) value(s).

image_2019621114840_1_png

Customize the information to be shown on the list.

You can manage the attributes to show by positioning on the KPI Worklist tab.

To prevent attributes from being shown on the KPI worklist you have to right-click on the attribute and select Delete. Don't worry, it will be deleted from the Web Panel, not from the Transaction.

DeleteAttrKPIWorklist_png

To add attributes to be shown in the list, you have to right-click on the Grid node, then select Add / GridAttribute:

AddAttrKPIWorklist_png

Then, GeneXus will display a list of attributes for you to choose which ones you want to add. 

AttrListKPIWorklist_png

See Also

GeneXus For SAP Systems Launchpad Object
GeneXus For SAP Systems List Report Floorplan
GeneXus For SAP Systems Simple Worklist Floorplan
GeneXus For SAP Systems Simple Worklist with global action Floorplan
GeneXus For SAP Systems Split Screen Master List Floorplan
GeneXus For SAP Systems Split Screen Master List with amount Floorplan
GeneXus For SAP Systems Wizard Floorplan