Add/ Remove KPI Widget functionality for User Dashboard

[metas-mk]

Type of issue

Feature request

Current behavior

Currently, the User Dashboard is static. The Widgets are shown and can only by moved, but not removed and not added.

Expected behavior

Similar to the new Dashboard/ Swimland Functionality, a functionality shall be provided for the user to add/ remove KPI widgets from the board.

[teosarca]

We need to prepare the API first.

[teosarca]

NOTE: as discussed, i've unified GET /kpis/available and GET /targetIndicators/available.
See metasfresh/metasfresh-webui-api-legacy#464 .
Will be available on next rollout.

[damianprzygodzki]

From endpoints:

POST /rest/api/dashboard/targetIndicators/new
POST /rest/api/dashboard/kpis/new

I am getting:

"exception": "de.metas.ui.web.exceptions.EntityNotFoundException"

for KPIS: 1000004, and for TI: 1000002

[teosarca]

checking....

[teosarca]

fixed, shall work now.

[damianprzygodzki]

@teosarca How can we set position of widget when adding new one?

[teosarca]

we can't :(

I am thinking to add "position" field on
http://w101.metasfresh.com:8081/swagger-ui.html#!/dashboard-rest-controller/addKPIItemUsingPOST
and
http://w101.metasfresh.com:8081/swagger-ui.html#!/dashboard-rest-controller/addTargetIndicatorItemUsingPOST

wdyt?

[teosarca]

metasfresh/metasfresh-webui-api-legacy#474 is rolleded out. API shall be available on w101

[teosarca]

Quick checked to change KPIs order (same issue on target indicators too).

The problem is with that endpoint call.
When patching a KPI/target indicator, there is no "position" field. Because changing the position for one KPI implies changing the position on all others.
For that reason, the "position" path is not supported.

To change the order of KPIs or target indicators, please use:

• http://w101.metasfresh.com:8081/swagger-ui.html#!/dashboard-rest-controller/changeKPIsDashboardUsingPATCH
• http://w101.metasfresh.com:8081/swagger-ui.html#!/dashboard-rest-controller/changeTargetIndicatorsDashboardUsingPATCH

The PATCH request body shall look like:

[
  {
    "op": "replace",
    "path": "orderedItemIds",
    "value": { itemId1, itemId2 .... itemIdLast}
  }
]

[damianprzygodzki]

As discussed on skype: we should somehow unify board and dashboard behavior. So or we are going to use that way of replacing property "orderedItemIds", or change "position" property for both entities.

[teosarca]

checking

[teosarca]

UPDATE: implemented "position" support in metasfresh/metasfresh-webui-api-legacy#486
Will be available on next rollout.

[metas-rc]

Results of IT

Tested on mf15releasetest

Adding and removing KPI widgets works correcty in webui.
Stress-tested and had no problems either.