Create a Dashboard
post
/api/dashboard/Dashboards
Creates a new dashboard.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- DashboardName
- OwnerUserID
- OwnerUserGroupID
- Viewers
- PanelParams
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
DashboardName: string
The dashboard name.
To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.Example:Basic Services Dashboard
-
HideHeader: integer
Whether the header should be shown when the dashboard is rendered (1) or not (0).Example:
0
-
MaxColumns: integer
The maximum number of columns the dashboard will render before wrapping additional panels onto the next row.Example:
4
-
OwnerUserGroupID: integer
The owner user group ID.Example:
0
-
OwnerUserID: integer
The ID of the user that owns the dashboard. This can never be an externally-authenticated transient user. 0 means it is public to all users in the owning group.Example:
0
-
PanelParams: string
A JSON string of parameters relating to the panel.Example:
[{"PartTypeID":"6","width":100,"DashboardName":"Basic Services Dashboard","InitialExpansion":"0","InitialExpansionDynamic":"1","InitialView":"Summary","InitialViewDynamic":"1","LinkTarget":"NewWindow","LinkTargetDynamic":"1","PanelName":"Test","PartTypeID":"6","RefreshRate":"","RootID":"root","RootIDDynamic":"1","ShowToolbar":"1","SummaryInitialExpansion":"all","SummaryInitialExpansionDynamic":"1","SummaryNodeSize":"Normal","SummaryNodeSizeDynamic":"1","SummaryTreeType":"LeftToRight","SummaryTreeTypeDynamic":"1","TimeRangeDynamic":"1","TimeRange":"now-24h..now..","Width":"1","recordID":"DashboardsDashboard","width":"1","AutoHeight":1}]
-
ReloadRate: integer
The number of seconds between automatically refreshing the content of panels on the dashboard. Use null to prevent the dashboard from auto refreshing.Example:
oracle.doceng.json.BetterJsonNull@740fefc6
-
Viewers: array
Viewers
The list of user groups that can view the dashboard.
Nested Schema : Viewers
Type:
array
The list of user groups that can view the dashboard.
Show Source
Nested Schema : items
Type:
Show Source
object
-
UserGroupID: integer
The user group ID.
-
UserGroupName: string
The user group name.
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulAddOperation
The response body for a successful add operation.
-
object
type
Nested Schema : SuccessfulAddOperation
Type:
object
The response body for a successful add operation.
Show Source
-
message: string
The response message.Example:
Added record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object
-
data: array
data
The properties of the new dashboard.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : dashboardDashboardsRead
Type:
Show Source
object
-
DashboardID: integer
The dashboard ID.Example:
12
-
DashboardName: string
The dashboard name.Example:
Basic Services Dashboard
-
DashboardTypeID: integer
Dashboard Type IDExample:
1
-
DashboardTypeName: string
The dashboard type name.Example:
Basic
-
HideHeader: integer
Whether the header should be shown when the dashboard is rendered (1) or not (0).Example:
0
-
MaxColumns: integer
The maximum number of columns the dashboard will render before wrapping additional panels onto the next row.Example:
4
-
Owner: string
The name of the owner.Example:
[Public to All Users and Groups]
-
OwnerUserGroupID: integer
The owner user group ID.Example:
0
-
OwnerUserID: integer
The ID of the user that owns the dashboard. This can never be an externally-authenticated transient user. 0 means it is public to all users in the owning group.Example:
0
-
PanelParams: string
A JSON string of parameters relating to the panel.Example:
[{"PartTypeID":"6","width":100,"DashboardName":"Basic Services Dashboard","InitialExpansion":"0","InitialExpansionDynamic":"1","InitialView":"Summary","InitialViewDynamic":"1","LinkTarget":"NewWindow","LinkTargetDynamic":"1","PanelName":"Test","PartTypeID":"6","RefreshRate":"","RootID":"root","RootIDDynamic":"1","ShowToolbar":"1","SummaryInitialExpansion":"all","SummaryInitialExpansionDynamic":"1","SummaryNodeSize":"Normal","SummaryNodeSizeDynamic":"1","SummaryTreeType":"LeftToRight","SummaryTreeTypeDynamic":"1","TimeRangeDynamic":"1","TimeRange":"now-24h..now..","Width":"1","recordID":"DashboardsDashboard","width":"1","AutoHeight":1}]
-
ReloadRate: integer
The number of seconds between automatically refreshing the content of panels on the dashboard. Use null to prevent the dashboard from auto refreshing.Example:
oracle.doceng.json.BetterJsonNull@740fefc6
-
Viewers: array
Viewers
The list of user groups that can view the dashboard.
Nested Schema : Viewers
Type:
array
The list of user groups that can view the dashboard.
Show Source
Nested Schema : items
Type:
Show Source
object
-
UserGroupID: integer
The user group ID.
-
UserGroupName: string
The user group name.
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.