Skip to main content

Node

Summary

Below is the list of all available options to define a Node in the schema

NameTypeDescriptionMandatory
branchAttributeType of branch support for the model.False
childrenAttributeExpected Kind for the children nodes in a Hierarchy, default to the main generic defined if not defined.False
default_filterAttributeDefault filter used to search for a node in addition to its ID. (deprecated: please use human_friendly_id instead)False
descriptionAttributeShort description of the model, will be visible in the frontend.False
display_labelsAttributeList of attributes to use to generate the display labelFalse
documentationAttributeLink to a documentation associated with this object, can be internal or external.False
generate_profileAttributeIndicate if a profile schema should be generated for this schemaFalse
hierarchyAttributeInternal value to track the name of the Hierarchy, must match the name of a Generic supporting hierarchical modeFalse
human_friendly_idAttributeHuman friendly and unique identifier for the object.False
iconAttributeDefines the icon to use in the menu. Must be a valid value from the MDI library https://icon-sets.iconify.design/mdi/False
include_in_menuAttributeDefines if objects of this kind should be included in the menu.False
inherit_fromAttributeList of Generic Kind that this node is inheriting fromFalse
labelAttributeHuman friendly representation of the name/kindFalse
menu_placementAttributeDefines where in the menu this object should be placed.False
nameAttributeNode name, must be unique within a namespace and must start with an uppercase letter.True
namespaceAttributeNode Namespace, Namespaces are used to organize models into logical groups and to prevent name collisions.True
order_byAttributeList of attributes to use to order the results by defaultFalse
parentAttributeExpected Kind for the parent node in a Hierarchy, default to the main generic defined if not defined.False
stateAttributeExpected state of the node/generic after loading the schemaFalse
uniqueness_constraintsAttributeList of multi-element uniqueness constraints that can combine relationships and attributesFalse
attributesRelationshipList of supported Attributes for the Node.False
relationshipsRelationshipList of supported Relationships for the Node.False

Reference Guide

branch

KeyValue
Namebranch
KindText
DescriptionType of branch support for the model.
OptionalTrue
Default Valueaware
Constraints
Accepted Valuesaware agnostic local

children

KeyValue
Namechildren
KindText
DescriptionExpected Kind for the children nodes in a Hierarchy, default to the main generic defined if not defined.
OptionalTrue
Default Value
Constraints

default_filter

KeyValue
Namedefault_filter
KindText
DescriptionDefault filter used to search for a node in addition to its ID. (deprecated: please use human_friendly_id instead)
OptionalTrue
Default Value
ConstraintsRegex: ^[a-z0-9\_]+$

description

KeyValue
Namedescription
KindText
DescriptionShort description of the model, will be visible in the frontend.
OptionalTrue
Default Value
ConstraintsLength: min -, max 128

display_labels

KeyValue
Namedisplay_labels
KindList
DescriptionList of attributes to use to generate the display label
OptionalTrue
Default Value
Constraints

documentation

KeyValue
Namedocumentation
KindURL
DescriptionLink to a documentation associated with this object, can be internal or external.
OptionalTrue
Default Value
Constraints

generate_profile

KeyValue
Namegenerate_profile
KindBoolean
DescriptionIndicate if a profile schema should be generated for this schema
OptionalTrue
Default ValueTrue
Constraints

hierarchy

KeyValue
Namehierarchy
KindText
DescriptionInternal value to track the name of the Hierarchy, must match the name of a Generic supporting hierarchical mode
OptionalTrue
Default Value
Constraints

human_friendly_id

KeyValue
Namehuman_friendly_id
KindList
DescriptionHuman friendly and unique identifier for the object.
OptionalTrue
Default Value
Constraints

icon

KeyValue
Nameicon
KindText
DescriptionDefines the icon to use in the menu. Must be a valid value from the MDI library https://icon-sets.iconify.design/mdi/
OptionalTrue
Default Value
Constraints

include_in_menu

KeyValue
Nameinclude_in_menu
KindBoolean
DescriptionDefines if objects of this kind should be included in the menu.
OptionalTrue
Default ValueTrue
Constraints

inherit_from

KeyValue
Nameinherit_from
KindList
DescriptionList of Generic Kind that this node is inheriting from
OptionalTrue
Default Value
Constraints

label

KeyValue
Namelabel
KindText
DescriptionHuman friendly representation of the name/kind
OptionalTrue
Default Value
ConstraintsLength: min -, max 64
KeyValue
Namemenu_placement
KindText
DescriptionDefines where in the menu this object should be placed.
OptionalTrue
Default Value
Constraints

name

KeyValue
Namename
KindText
DescriptionNode name, must be unique within a namespace and must start with an uppercase letter.
OptionalFalse
Default Value
ConstraintsRegex: ^[A-Z][a-zA-Z0-9]+$
Length: min 2, max 32

namespace

KeyValue
Namenamespace
KindText
DescriptionNode Namespace, Namespaces are used to organize models into logical groups and to prevent name collisions.
OptionalFalse
Default Value
ConstraintsRegex: ^[A-Z][a-z0-9]+$
Length: min 3, max 32

order_by

KeyValue
Nameorder_by
KindList
DescriptionList of attributes to use to order the results by default
OptionalTrue
Default Value
Constraints

parent

KeyValue
Nameparent
KindText
DescriptionExpected Kind for the parent node in a Hierarchy, default to the main generic defined if not defined.
OptionalTrue
Default Value
Constraints

state

KeyValue
Namestate
KindText
DescriptionExpected state of the node/generic after loading the schema
OptionalTrue
Default Valuepresent
Constraints
Accepted Valuespresent absent

uniqueness_constraints

KeyValue
Nameuniqueness_constraints
KindList
DescriptionList of multi-element uniqueness constraints that can combine relationships and attributes
OptionalTrue
Default Value
Constraints

attributes

KeyValue
Nameattributes
KindList
DescriptionList of supported Attributes for the Node.

relationships

KeyValue
Namerelationships
KindList
DescriptionList of supported Relationships for the Node.