Customizing the MFP/AP Dashboard

The application Dashboard gets data from the regular dashboard workbook template like any other workbook segments to define the measures used in metric tiles that are shown in the dashboard. This Dashboard can be customized using the same extensibility rules for regular workbooks for adding new measures into that dashboard workbook (pl_db). The customer can then update the MFP/AP Dashboard JSON file to include the newly added custom measures to show as tiles in the Dashboard.

Following are the steps for customizing the Dashboard:

  1. Update application Configuration to include the required new custom measures and rules to include those measures in the existing dashboard template (pl_db) in the application Configuration within regular extensibility framework. Patch the domain with the new updated configuration.

  2. Download the application dashboard JSON file (dashboardSettings.json) from the Starter kit or directly from the customer-provisioned environment by running the Online Administration Tools task Patch Application Task -> Manage JSON Files -> Retrieve JSON files to Object Storage. This will download the JSON file into the Object Storage location at outgoing/dashboardSettings.json.

  3. Open the downloaded dashboard JSON file using the RPASCE Configuration Tools -> Utilities -> Deployment Tool and selecting the Open option under dashdoardSettings.json.

  4. It should open the dashboard JSON file in edit mode. The customer can then edit the dashboard to add the newly added measures into their required profiles. They can also add new profiles or change profiles but can only use the measures available in the dashboard workbook. For more information on working with the JSON file using RPASCE Configuration Tools, see the Oracle Retail Predictive Application Server Cloud Edition Configuration Tools User Guide.

  5. Once the JSON file is updated, it can be uploaded into the MFP environment by uploading the file to the Object Storage location as incoming/config/dashboardSettings.json, and running the Online Administration Tool task Patch Application Task -> Manage JSON Files > Update JSON files from Object Storage. Successful completion of the task will copy the file to the required location under the application domain.

  6. After uploading, rebuild the dashboard to view the updated dashboard.

  7. The entire process can be validated in the Virtual machine before trying to upload the completed JSON file into the customer environment.