Renewable energy management - IBM/intelligence-suite-supply-chain-solutions GitHub Wiki

Detail pages:

This use case assumes you are familiar with implementing solutions in SCIS. You can find relevant tutorials for all of the instructions here in the User interface, Data platform, and Data import-export wikis.

Note - these tutorials are provided as-is for educational purposes only. We do our best to make them fully useable, however there will be gaps as published. If you have suggestions for improvements please submit an issue.

The “Energy production” tab contains 4 summary, 1 active filter, 1 filter selection, 1 map, and 4 chart widgets. The “Operations” tab contains contains 1 summary, 1 active filter, 1 filter selection, 1 map, 1 list, 1 starred work queue table, 1 meter, and 1 bar chart widgets.

There are also 2 detail pages. The first is a detail page that allows the user to view all assets in one place; it is the "View all assets" detail page. It can be navigated to by clicking "View all" on the footer link of the Assets table on the Operations tab. The second detail page is the "Asset detail" page that can be navigated to by clicking on a linked Asset ID in the Asset table shown on the Operations tab or on the View all assets detail page.

For description purposes, we will describe a metric indicating an exception or problem as a "KPI" a metric indicating something informational a "measurement". These are the main KPIs and measurements on the dashboard:

• Low energy duration - Windmills with a forecast of repeated low wind for a certain number of hours in a row.

The business concepts in the Energy management dashboard are driven by the Location, and Product business objects. Supporting information exists in master data objects Product and Location. There are 2 additional business objects that will need to be added as well - Asset and AssetTimeSeries. There are also 4 custom attributes for 2 of these business objects (diameterFloat and heightFloat for Product and currentWindFloat and infoLinkString for Location).

All json registration content is available in this zip file. Please note - you will need to change the tenantId in all json files to your tenant ID

1. Load sample data and create custom attributes
2. Register work queues
3. Create dashboard widgets
4. Create dashboards
5. Test on https://www.supply-chain.ibm.com/

• Register data import rules to pick up files from object storage (if your tenant does not already have CSV import rules registered)
  • CSV: Data-import-102
• Load sample data to your COS bucket

The first step is to download the data, there are 3 CSV files and 5 JSON files provided.

Documentation provided here.

You need to create the custom attributes (for more info) in order to ensure that all data will be uploading successfully. For the data provided, you will need to create 4 different custom attributes. For Product you will need diameterFloat and heightFloat. For Location you will need currentWindFloat and infoLinkString.

Use an HTTP tool such as Insomnia.

You will need to make the call to the following URL:

https://api.ibm.com/infohub/run/metadata/api/v1/na/schema/custom-attributes

Request Method: POST

Headers Required:

• Authorization: Bearer <<JWT>>
• X-IBM-Client-Id: infohub-<<tenantId>>
• Content-Type: application/json

Request Body: example:

{
    "tenantId": "<tenant_id>",
    "name":"myAttribute01String",
    "scalarType": "STRING",
    "businessObjectType": "Order"
}

The Request Bodies for the data provided: (Note that you will need to make a new request for each attribute.)

{
    "tenantId": "<<tenantId>>",
    "name":"diameterFloat",
    "scalarType": "FLOAT",
    "businessObjectType": "Product"
}

{
    "tenantId": "<<tenantId>>",
    "name":"heightFloat",
    "scalarType": "FLOAT",
    "businessObjectType": "Product"
}

{
    "tenantId": "<<tenantId>>",
    "name":"currentWindFloat",
    "scalarType": "FLOAT",
    "businessObjectType": "Location"
}

{
    "tenantId": "<<tenantId>>",
    "name":"infoLinkString",
    "scalarType": "STRING",
    "businessObjectType": "Location"
}

Make a request to the following URL

https://api.ibm.com/infohub/run/metadata/api/v1/na/schema/custom-attributes?tenantId=<<tenantId>>

Request Method: GET

Headers Required:

• Authorization: Bearer <<JWT>>
• X-IBM-Client-Id: infohub-<<tenantId>>
• Content-Type: application/json

The response will be all the custom attributes created for that tenant, you should see all the once created in the last step here.

Documentation provided here. After completing the steps you should be able to see the when the import is done and if it was successful in Job Manager for your tenant.

Note: Upload catalog.csv before product.csv and location.csv.

Documentation provided here. After completing the steps, you should be able to see the when the import is done and if it was successful in Job Manager for your tenant.

POST https://api.ibm.com/infohub/run/metadata/api/v1/na/workqueues
POST https://api.ibm.com/infohub/run/metadata/api/v1/na/

<<>>

POST https://api.ibm.com/supplychainui/run/na/api/v1/wms/widget_definitions
POST https://api.ibm.com/supplychainui/run/na/api/v1/wms/subscriptions/subscribe

Energy production tab

Operations tab

View all assets page

Asset detail page

POST https://api.ibm.com/supplychainui/run/na/api/v1/wms/layout_templates

Energy production tab: template-defaultEnergyProductionLayoutTemplate.json

Operations tab: template-defaultOperationsLayoutTemplate.json

View all assets detail page: template-viewAllAssetsLayoutTemplate.json

Asset detail page: template-assetDetailLayoutTemplate.json