PUTDASHBOARD()`¶

About PutDashboard¶

Creates a dashboard if it does not already exist, or updates an existing dashboard. If you update a dashboard, the entire contents are replaced with what you specify here.

All dashboards in your account are global, not region-specific.

A simple way to create a dashboard using PutDashboard is to copy an existing dashboard. To copy an existing dashboard using the console, you can load the dashboard and then use the View/edit source command in the Actions menu to display the JSON block for that dashboard. Another way to copy a dashboard is to use GetDashboard, and then use the data returned within DashboardBody as the template for the new dashboard when you call PutDashboard.

When you create a dashboard with PutDashboard, a good practice is to add a text widget at the top of the dashboard with a message that the dashboard was created by script and should not be changed in the console. This message could also point console users to the location of the DashboardBody script or the CloudFormation template used to create the dashboard.

Method Signature¶

IMPORTING¶

Required arguments:¶

`iv_dashboardname` `TYPE /AWS1/CWTDASHBOARDNAME` `/AWS1/CWTDASHBOARDNAME`¶

The name of the dashboard. If a dashboard with this name already exists, this call modifies that dashboard, replacing its current contents. Otherwise, a new dashboard is created. The maximum length is 255, and valid characters are A-Z, a-z, 0-9, "-", and "_". This parameter is required.

`iv_dashboardbody` `TYPE /AWS1/CWTDASHBOARDBODY` `/AWS1/CWTDASHBOARDBODY`¶

The detailed information about the dashboard in JSON format, including the widgets to include and their location on the dashboard. This parameter is required.

For more information about the syntax, see Dashboard Body Structure and Syntax.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_cwtputdashboardoutput` `/AWS1/CL_CWTPUTDASHBOARDOUTPUT`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->/aws1/if_cwt~putdashboard(
  iv_dashboardbody = |string|
  iv_dashboardname = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_dashboardvalidationmsgs( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_datapath = lo_row_1->get_datapath( ).
      lv_message = lo_row_1->get_message( ).
    ENDIF.
  ENDLOOP.
ENDIF.

/AWS1/CL_CWT=>PUTDASHBOARD()¶