Metadata directives - introduction
To display asset data on an asset page, censhare Web provides the Properties (aka metadata) widget. The Properties widget uses the censhare metadata directives to retrieve and output data. This article introduces the key concept and usage of the <cs-metadata-row/> directive.
Context
Asset properties can be displayed on an asset page. For this purpose, censhare provides the Properties widget.
Prerequisites
The requirement for working with metadata directives in censhare Web is correctly set up features in the Master data of the censhare Admin Client. To use the censhare metadata directives and write the respective templates, you have to be familiar with the censhare data model as well as with XML and HTML editing.
Introduction
The metadata directives retrieve asset data and create an output of these data in the Properties widget on an asset page. for more information, see the Properties widget configuration.
The censhare metadata directives are XML elements that retrieve data from an asset and render an output that is configured in the attributes of the element. To configure the widget, you have to create a template that uses the censhare metadata directives.
For a simple Properties widget configuration, use the <cs-metadata-row/> directive.
Key concepts
The configuration of content display and edit dialog is written in standard HTML and CSS. censhare provides specific CSS classes for styling. In addition, censhare UI directives are used to reference asset metadata (the properties to be displayed and edited in the widget). The censhare UI directives can be enriched with parameters that allow you to control the output. The following section introduces the <cs-metadata-row/> directive. There are more directives available for specific UI controls and configurations. In order to configure these, see the censhare Developer guide.
cs-metadata-row
To configure the <cs-metadata-row/> directive in a Properties widget, the property to be displayed/edited must be referenced. Additionally, you can add a mapping that renders either the default UI control for the selected value type or overwrites it with another UI control parameter. The configuration can have additional attributes (see table below) that control how the directive is rendered.
The optional parameters unit/unit set, language, and color that are configured in the feature definition are rendered automatically. The same goes for child features if they are configured in the feature definition in the censhare Admin Client.
Attribute | Mandatory | Description |
property | yes | This attribute references the feature to be displayed or edited in the widget. The value is built following the pattern: "asset.traits.TRAIT.PROPERTY". Replace TRAIT by the trait key and PROPERTY by the property key of the feature to get a unique identifier. Remember that traits must be added to the dialog asset, otherwise, nothing is shown in the widget and the dialog. |
read | no | If this attribute is set, the property is rendered in read-only mode. The attribute has no value. This attribute must be set in the display configuration. In the dialog configuration, use the "disabled" attribute instead. |
row-label | no | This attribute overwrites the feature name. |
disabled | no | This attribute is similar to the "read" attribute and renders the property in read-only mode. Other than in "read" mode, it renders the respective input field but users cannot enter or edit anything. For consistency reasons, we recommend using this attribute in the dialog configuration instead of the "read" attribute. |
required | no | Not in "read" mode. With this attribute, censhare renders a mandatory field. The field is highlighted in the dialog and the OK button is disabled unless the user enters or selects a value. |
translate-prefix | no | Only in "read" mode. This attribute can be used for standard keys. For these keys localizations are available in the "~work/runtime-web/../csMainFrame" directory. The attribute maps the value to these keys so that they are displayed in the language selected for the user interface. |
filter | no | Only in "read" mode. This attribute applies the defined filter to display conditional values. |
hide-root | no | Not to be set in "read" mode. This attribute hides the root node of hierarchical value lists. With other value types, this attribute will be ignored. |
multilines | no | Deprecated. Only for string values. Not in "read" mode. This attribute renders a text area input field with the number of lines given in the value of the parameter (for example: multilines="3"). This attribute is deprecated and will be removed in future releases. Instead, use the UI control parameter in the feature definition instead. This renders an extendable 10-line text area. |
inline | no | Deprecated. Use the For more information see this article [LINK:3989181] directive instead. |
validate-selected | no | To enable validation of value list items, set to "true". If "true, load-options-by-domain and/or load-options-by-domain2 must be set as well. |
load-options-by-domain | no | To enable validation of value list items for the Main domain, set to "asset.traits.domain.domain.value[0].value". The validate-selected attribute must be "true". |
load-options-by-domain2 | no | To enable validation of value list items for the Second domain, set to "asset.traits.domain.domain2.value[0].value". The validate-selected attribute must be "true". |
Dialog validation
The dialog validation checks, if the first and/or second domain of a value corresponds to the first and or second domain of the current asset. If an asset is moved to another domain, invalid property values are highlighted in the Edit properties dialog. The asset can still be saved with invalid values, but users get notified every time they edit the properties of an asset.
Dialog validation can be configured in Value list and Hierarchical value list features, and for Dynamic value lists. The domains of the value list items must be added to the value list items:
In Value lists: In the censhare Admin Client, create a list item and set the main domain and/or second domain for this item.
In Hierarchical value lists: In the censhare Admin Client, create a list item and set the parent item, main domain and/or second domain for this item.
In Dynamic value lists: Set the main domain and/or second domain in the assets that are assigned to the Value list. For more information, see (2022.1) Dynamic value lists.
(1) Invalid fields are only shown in the Edit properties dialog, not in the Widget.
(2) The dialog validation does not work with inline editing, feature inheritance, and editing of multiple assets.
Result
The templates you created with the <cs-metadata-row/> directive shows the respective asset data if you set up the template in a Properties widget.