Metadata details #

Defining metadata details is a way to enhance the user experience by improving the metadata management workflow on an asset or a device. There are multiple features you can use :

• Translation (mandatory)
• Group (optional)
• Editor hint (change UI elements) (optional)

Translations (mandatory) #

This property allows to add a localized user-friendly name and description to the metadata. Those will be automatically substitued according to the user's language.

Example

{
  metadataMappings: {
    company: { type: "keyword" },
  },
  metadataDetails: {
    locales: {
      en: {
        friendlyName: "Manufacturer",
        description: "The company that manufactured the plane",
      },
      fr: {
        friendlyName: "Fabricant",
        description: "L'entreprise qui a fabriqué l'avion",
      },
    },
  },
}

Group (optional) #

This property allows to group metadata together.

First, create a metadataGroups object at the same level as metadataDetails, using the group's name as a key and mapping them to their localization details. Then in the metadataDetails object, specify the group of the metadata by using the group property.

Example

{
  metadataMappings: {
    company: { type: "keyword" },
  },
  metadataDetails: {
    company: {
      group: "companyInfo",
    },
  },
  metadataGroups: {
    companyInfo: {
      locales: {
        en: {
          groupFriendlyName: "Company Information",
          description: "All company related informations",
        },
        fr: {
          groupFriendlyName: "Informations sur l'entreprise",
          description: "Toutes les informations relatives a l'entreprise",
        },
      },
    },
  },
}

Editor hint (optional) #

This property allows to specify the frontend whether it should display a custom widget to edit the metadata, like a dropdown of values, a clock picker or date picker with or without time, make a metadata read-only, and so on.

You have to set the enum type associated to the hint you want and fill the properties with your values.

This is the list of the available hints:

• Read only
• Dropdown of values
• Date/Datetime/Clock picker

Read only #

The read-only feature allows to prevent users to edit a metadata.

NOTE: The readOnly property can be set with any Enum type.

Enum type: BASE

⚠️ Set to BASE if you only want the readOnly property.

Example

{
  metadataMappings: {
    network: { type: "keyword" },
  },
  metadataDetails: {
		network: {
			editorHint: {
				type: EditorHintEnum.BASE,
				readOnly: true,
			},
		},
	}
},

Dropdown of values #

The dropdown feature allows to display a list of values to choose in a dropdown.

Enum type: OPTION_SELECTOR

Example

{
  metadataMappings: {
    company: { type: "keyword" },
  },
  metadataDetails: {
		company: {
			editorHint: {
				type: EditorHintEnum.OPTION_SELECTOR,
				values: ["red", "blue"],
				customValueAllowed: true,
			},
		}
  },
},

Visual

Date/Datetime/Clock picker #

This feature allows to display either a date picker with or without a time picker, or a clock picker.

Enum type: DATETIME

Example

{
  metadataMappings: {
    date: { type: "date" },
  },
  metadataDetails: {
    date: {
			editorHint: {
				type: EditorHintEnum.DATETIME,
				date: true,
				time: true,
				customTimeZoneAllowed: true,
			},
    }
  },
},

Visual