Generic

Summary

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

Name	Type	Description	Mandatory
branch	Attribute	Type of branch support for the model.	False
default_filter	Attribute	Default filter used to search for a node in addition to its ID. (deprecated: please use human_friendly_id instead)	False
description	Attribute	Short description of the model, will be visible in the frontend.	False
display_label	Attribute	Attribute or Jinja2 template to use to generate the display label	False
display_labels	Attribute	List of attributes to use to generate the display label (deprecated)	False
documentation	Attribute	Link to a documentation associated with this object, can be internal or external.	False
generate_profile	Attribute	Indicate if a profile schema should be generated for this schema	False
hierarchical	Attribute	Defines if the Generic support the hierarchical mode.	False
human_friendly_id	Attribute	Human friendly and unique identifier for the object.	False
icon	Attribute	Defines 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_menu	Attribute	Defines if objects of this kind should be included in the menu.	False
label	Attribute	Human friendly representation of the name/kind	False
menu_placement	Attribute	Defines where in the menu this object should be placed.	False
name	Attribute	Node name, must be unique within a namespace and must start with an uppercase letter.	True
namespace	Attribute	Node Namespace, Namespaces are used to organize models into logical groups and to prevent name collisions.	True
order_by	Attribute	List of attributes to use to order the results by default	False
restricted_namespaces	Attribute	Nodes inheriting from this Generic schema must belong to one of the listed namespaces	False
state	Attribute	Expected state of the node/generic after loading the schema	False
uniqueness_constraints	Attribute	List of multi-element uniqueness constraints that can combine relationships and attributes	False
used_by	Attribute	List of Nodes that are referencing this Generic	False
attributes	Relationship		False
relationships	Relationship		False

Reference Guide

branch

Key	Value
Name	branch
Kind	Text
Description	Type of branch support for the model.
Optional	True
Default Value	aware
Constraints
Accepted Values	aware agnostic local

default_filter

Key	Value
Name	default_filter
Kind	Text
Description	Default filter used to search for a node in addition to its ID. (deprecated: please use human_friendly_id instead)
Optional	True
Default Value
Constraints	Regex: ^[a-z0-9\_]*$

description

Key	Value
Name	description
Kind	Text
Description	Short description of the model, will be visible in the frontend.
Optional	True
Default Value
Constraints	Length: min -, max 128

display_label

Key	Value
Name	display_label
Kind	Text
Description	Attribute or Jinja2 template to use to generate the display label
Optional	True
Default Value
Constraints

display_labels

Key	Value
Name	display_labels
Kind	List
Description	List of attributes to use to generate the display label (deprecated)
Optional	True
Default Value
Constraints

documentation

Key	Value
Name	documentation
Kind	URL
Description	Link to a documentation associated with this object, can be internal or external.
Optional	True
Default Value
Constraints

generate_profile

Key	Value
Name	generate_profile
Kind	Boolean
Description	Indicate if a profile schema should be generated for this schema
Optional	True
Default Value	True
Constraints

hierarchical

Key	Value
Name	hierarchical
Kind	Boolean
Description	Defines if the Generic support the hierarchical mode.
Optional	True
Default Value	False
Constraints

human_friendly_id

Key	Value
Name	human_friendly_id
Kind	List
Description	Human friendly and unique identifier for the object.
Optional	True
Default Value
Constraints

icon

Key	Value
Name	icon
Kind	Text
Description	Defines the icon to use in the menu. Must be a valid value from the MDI library https://icon-sets.iconify.design/mdi/
Optional	True
Default Value
Constraints

include_in_menu

Key	Value
Name	include_in_menu
Kind	Boolean
Description	Defines if objects of this kind should be included in the menu.
Optional	True
Default Value	True
Constraints

label

Key	Value
Name	label
Kind	Text
Description	Human friendly representation of the name/kind
Optional	True
Default Value
Constraints	Length: min -, max 64

menu_placement

Key	Value
Name	menu_placement
Kind	Text
Description	Defines where in the menu this object should be placed.
Optional	True
Default Value
Constraints

name

Key	Value
Name	name
Kind	Text
Description	Node name, must be unique within a namespace and must start with an uppercase letter.
Optional	False
Default Value
Constraints	Regex: ^[A-Z][a-zA-Z0-9]+$ Length: min 2, max 32

namespace

Key	Value
Name	namespace
Kind	Text
Description	Node Namespace, Namespaces are used to organize models into logical groups and to prevent name collisions.
Optional	False
Default Value
Constraints	Regex: ^[A-Z][a-z0-9]+$ Length: min 3, max 64

order_by

Key	Value
Name	order_by
Kind	List
Description	List of attributes to use to order the results by default
Optional	True
Default Value
Constraints

restricted_namespaces

Key	Value
Name	restricted_namespaces
Kind	List
Description	Nodes inheriting from this Generic schema must belong to one of the listed namespaces
Optional	True
Default Value
Constraints

state

Key	Value
Name	state
Kind	Text
Description	Expected state of the node/generic after loading the schema
Optional	True
Default Value	present
Constraints
Accepted Values	present absent

uniqueness_constraints

Key	Value
Name	uniqueness_constraints
Kind	List
Description	List of multi-element uniqueness constraints that can combine relationships and attributes
Optional	True
Default Value
Constraints

used_by

Key	Value
Name	used_by
Kind	List
Description	List of Nodes that are referencing this Generic
Optional	True
Default Value
Constraints

attributes

Key	Value
Name	attributes
Kind	List
Description

relationships

Key	Value
Name	relationships
Kind	List
Description