Skip to main content

system.mes.dashboard.validateDashboard

Description

Validates the specified parameters for a Dashboard and returns any validation errors. This does not save the object.

Syntax

system.mes.dashboard.validateDashboard(**dashboard)

Parameters

ParameterTypeNullableDescription
nameStringFalseThe user-given name for the dashboard.
urlStringFalseURL-friendly version used for page routing.
isPublicBooleanFalseTrue if the dashboard is public.
usernameStringTrueOwner’s Ignition username (null if public).
iconPathStringTruePath to an icon for the dashboard.
packBooleanFalseWhen true, sizes to fit content; otherwise uses fixed grid settings.
gridStringFalseGrid layout mode (e.g., STRETCH).
rowCountIntegerFalseNumber of grid rows (fixed layout).
columnCountIntegerFalseNumber of grid columns (fixed layout).
rowGutterSizeIntegerFalseVertical spacing between rows (fixed layout).
columnGutterSizeIntegerFalseHorizontal spacing between columns (fixed layout).
instancesJsonStringFalseJSON for Perspective dashboard component props.instances.
idString (ULID)TrueThe ULID of the dashboard.
notesStringTrueNotes related to the dashboard.
enabledBooleanTrueIndicates if the dashboard is active and enabled.
spare1StringTrueAdditional field for user-defined context.
spare2StringTrueAdditional field for user-defined context.
spare3StringTrueAdditional field for user-defined context.

Returns

Returns a JSON object where keys are field names and values are lists of validation violation messages.

Code Examples

db = system.mes.dashboard.newDashboard()
db['name'] = '' # invalid
violations = system.mes.dashboard.validateDashboard(**db)
print(violations)