Configuring metadata schemas
A metadata schema defines the metadata fields that need completion on the Metadata screen of an asset. Each schema defines the following settings:
The metadata fields and their type
The default field values
If the fields are required
Whether fields are editable
Which fields appear in the HTML source code of the page.
Once you have added a metadata schema, you can configure its settings on its associated asset screens. These screens are often the same as (or similar to) those for a standard page. Read the Asset screens documentation for more information about common asset screens.
Metadata schemas offer unique fields on the Details and Usage screens. Read on to learn more about these screens.
- Details screen
- Usage screen
- Applying a metadata schema
- Regenerating a metadata schema
The Details screen allows you to set up your metadata schema by adding sections and fields.
By default, the name used in the schema name field to create the metadata schema will appear here. You can change the name of the metadata schema by clicking into the schema name field and entering the new name for the metadata schema.
This section shows the sections and fields added to the metadata schema. It also allows you to delete fields and sections. If you have not added any sections, no information will appear.
Once you add a section, it will appear in this section of the screen, as shown in the example below.
Each blue heading represents a section added to the metadata schema. For example, in the figure below, two blue headings appear. This coloring signifies the two sections added to this metadata schema.
For each section listed, the following fields are available:
To delete a section and all of its fields, click this box and save the screen. This action will remove the section from the metadata schema.
- Section description
This field will not appear on the screen until you have added a metadata field to the section. Once you have added a metadata field, this field will allow you to enter a description for the metadata section to display on the frontend.
- Current restrictions
This field will not appear on the screen until you have added a metadata field to the section. Once you have added a field, this section will list which asset types to which this metadata section will apply. By default, it lists no asset types. Once you have selected an asset type from the new restriction list, it will appear in this section, as shown:Figure 3. Field created
If no asset types are listed, the metadata section will display for all assets to which the metadata schema is applied.
A good practice is to set an asset type restriction so that cascading actions do not apply your schema to unintended assets.
- New restriction
This field will not appear on the screen until you have added a metadata field to the section. Once you have added a metadata field, this field restricts to which asset types the metadata section can apply.
For example, select Standard Page from the restriction list to apply the metadata schema to all assets but restrict the metadata section to standard pages. To select multiple asset types, click the More… button. An additional field will appear on the screen. The asset types selected will appear in the current restrictions list.
This field lists the metadata fields added to the section. If you have not added any fields to the section, no information will appear. When you add a field, it will appear in this section of the screen. To edit a field, click the Edit metadata field link. The Details screen for that field will appear. To delete a field from a section, check the Delete box and click Save.
To rearrange the order of the fields, you can move the field assets that appear under the metadata schema in the asset tree.
- New field name
To add a new field to the section, enter the field’s name into the box provided.
Your metadata field names can only contain alphanumeric characters, full stops, hyphens, and underscores.
- New field type
When you are adding a new field, select the type of field from the list provided. The options include:
A select field generated with options from a pre-defined list of thesaurus terms.
A standard text field that can also be a textarea input.
A select field, checkbox list field, or radio button list field.
- Multiple text
Multiple dynamic text fields that automatically increase as the user enters values into them.
A date and/or time field.
A hierarchy field is similar to a select field, generated with a pre-defined list of values. This list, however, can show a hierarchy of information.
A WYSIWYG editor field.
- Related asset
An asset picker that lets you associate the editing asset with another.
For more information about each of these fields, refer to the corresponding chapters in this manual.
This section allows you to add new sections to the metadata schema. Enter the name of the new section into the section name field and save the screen. A new section will appear in the sections defined for this metadata schema section.
Changing a metadata schema already applied to assets will require you to regenerate the metadata files before your changes are applied. To do this, check the regenerate metadata files box and click Save.
|In environments that include a high number of assets, this can be a non-trivial task. To avoid processing bottlenecks, restrict regenerating metadata files to off-peak times.|
This section allows you to decide whether to show the metadata schema in the HTML source code of the page.
By default, this value is
yes, meaning that all sections and fields will appear in the HTML source code.
Metadata does not automatically appear within the HTML source code of a page unless your design includes the metadata design area or the
For more information on this design area, refer to the Designs documentation on Matrix Manuals.
The Usage screen shows the assets in the system that are using the metadata schema. This view means that the metadata schema is currently either applied or denied on the asset.
If the metadata schema is not on any assets, no information will appear on the screen. Once the metadata schema is in use on an asset, the information shown will appear:
The top-level assets which have the metadata schema applied appear. Child assets will be displayed in the table only when their schema options differ from their parents.
A section allows you to group metadata fields. You need to add a section before you can add a field to the metadata schema. Within the HTML source code of the page, a section will appear as a comment.
To add a section to a metadata schema, go to the Details screen of the schema. Enter the name of the new section into the section name field and save the screen. A new section will appear in the sections defined for this metadata schema section.
A metadata section asset will also appear under the metadata schema in the asset tree.
To edit a section, load the Details screen.
This section allows you to change the name of the section and add a description.
The following fields are available:
- Section name
The name of the section.
- Section description
A description of the section. This description will show on the Metadata screen of an asset. It can display information to your users about the purpose of this section.
This section allows you to decide whether to show the section, all of its fields, and its description in the HTML source code of the page.
The following fields are available:
- Show on frontend
Select whether to show the section on the frontend. By default, this value is
yes, meaning that the section and all of its fields will appear in the HTML source code on the frontend.
- Show description on frontend
Select whether to show the section description on the frontend.
Only metadata schema sections can have fields added. There are different types of fields you can use within a metadata schema. To read more about each field type, refer to the metadata fields section.
To add a field to a metadata schema:
Go to the Details screen of the schema.
Find the sections defined for this metadata schema and locate the section to which you want to add the new field.
Enter the name of the new field into the New field name box.
Select a type from the New field type list.
Save the screen to add the new field to the Fields list for that section.
You will find a Field asset will also appear under the section in the Asset tree.
There are two ways to edit a field within a metadata schema:
On the Details screen of the schema, click the Edit metadata field link for the field. This link will take you to the Details screen for that field.
Right-click on the field asset in the asset tree and select Details.
On a field’s Details screen, you can mark a field as required. When you mark a field as required, the assets with this metadata schema applied will not be able to go live until the required fields are complete. If an asset has Workflow applied, the approval process will not complete until you fill the required values.
Required fields are marked with an asterisk on the Metadata screen of an asset. They will display the message Currently empty if there is no metadata entered.
On the Details screen for a metadata field, you can use a keyword replacement in place of a value in a field.
For example, you can use a keyword replacement
%asset_name% in the default field.
For a full list of keyword replacements, click the View all available keyword replacements link located under the Details section heading on the screen.
When you click on this link, a pop up will appear showing the full list of available keyword replacements. You can then copy and paste the keyword replacement you want to use from the list into a field.
To delete a field from a metadata schema, go to the Details screen of the schema. In the sections defined for this metadata schema section, check the delete box for the field you want to delete and save the screen.
Deleted metadata fields will still appear on assets that already had that field populated until their metadata is regenerated.
Once you have built a metadata schema, you can apply it to various assets within your system. You can also apply multiple metadata schemas to an asset.
If, however, two or more schemas have the same field name, a warning message will appear. For example, if you apply two metadata schemas to an asset and both schemas have the field description, a warning will appear. For this reason, it is good practice to ensure metadata fields are uniquely named.
Any Matrix user can add or edit a metadata schema. However, only users with administrator privilege to an asset can apply a metadata schema to that asset.
You can apply a metadata schema to an asset on the Metadata schemas screen. Once a schema is applied, you can fill out the values on the Metadata screen. Read the Asset metadata screen documentation for more information on how to apply a metadata schema and fill out the values.
You will need to regenerate the metadata files to have an updated or changed metadata schema to apply to assets that have already had the previous version applied.
To do this, go to the Details screen of the metadata schema. Select the Regenerate metadata files box and click Save.
Metadata on an asset will also get regenerated on an asset every time you save the Metadata screen on an asset when editing it. This regeneration will update things like default metadata field values and remove any metadata deleted from a schema.
Furthermore, if you choose to cascade a metadata change applied to an asset, all child assets will also have their metadata regenerated.