Metadata Structure

A Metadata Schema defines the structure of a data model, including field types, field names, Access, Validation Rules, and hierarchy. This model does not comprise any values as the values vary depending on each Schema Instance.

A Schema Definition is a type of Ooyala Flex Object and can be created and edited. Metadata Schema adhere to the following rules:

  • Metadata Schema must be associated with an Ooyala Flex Object Type.
  • Whenever a new Ooyala Flex Object that supports metadata is instantiated, a new Metadata Instance is automatically created for the Object.
  • Metadata Schema must have at least one field.

Whenever a Metadata Schema is saved, a merge occurs to ensure that all the related Schema Instances are kept up to date with the new data model defined by the updated Schema. When you remove a field, this will result in data loss, so please consider your Actions carefully.

Metadata Instances (Instances of a Schema)

A Metadata Instance represents a single instance of a Metadata Schema. A Metadata Instance is created when an Ooyala Flex Object, which is associated with a Metadata Schema, is created. When a new Metadata Instance is created, all fields associated with the Schema are converted to field Instances within the Metadata Instance. field Instances reference the original field and also allow for the capture and storage of a Value.

At first it can be hard to grasp the difference between a Metadata Schema and a Metadata Instance. Think of a Metadata Schema as a template for a questionnaire. It comprises a range of questions with a range of field types (multi-select, true/false, description, etc). Although this template defines the structure and the properties of a questionnaire, it isn't a set of answers in itself. A single questionnaire template can be used to build a whole range of answers in the form of filled out questionnaires. Think of each filled out questionnaire created from the template as an “instance” and the original template as the "schema". Hence, a Metadata Schema defines how a Metadata Instance is structured but not what the values are. A Metadata Instance is a single instance of a Metadata Schema with a unique collection of values.

Below is a screen shot of a Metadata Instance, which is a single instance of the Metadata Schema shown in the screen shot above. You can see that there are fields that can be filled in with values, whereas the Schema above simply defines the data model.

Metadata fields

As mentioned, a Metadata Schema is a collection of related fields. Ooyala Flex supports a large range of field Types to assist with modelling your data in a meaningful fashion. A full list of Metadata field Types available is shown in the Metadata field Types section.

Metadata field types are pluggable and new types can be created using Ooyala Flex's API.

As mentioned previously, Metadata Schema comprise fields. This section provides an insight into how to create and configure new fields and what field Types and Options are available.

Field Types

Metadata field Types can be grouped into three main types.

  • Basic: Fields that are classed as structural or container-based (or composite types) and can carry additional fields.
  • Primitive: Represent common, "primitive" data types such as float, integer, and date. These types are basic building blocks for data.
  • Object: These field Types represent references to existing Ooyala Flex Objects.

Note: Perhaps the most interesting field type is the Object field type. This field enables you to reference other Objects in the Ooyala Flex system.

Basic field Configuration

The following options are available for most field types.

  • Name: A name is unique to the Metadata Schema.
  • Display Name: A display name can be used to specify how the name is displayed in a User interface. By default the Name is used.
  • Description: An optional description can be assigned.
  • Default Value: Some fields support a default value. This is used by Ooyala Flex to set the initial value when a field is first instantiated. An example of a field Type that supports this is the Integer.
  • Searchable: This option defines whether the field can be searched as part of a search form or via the API.
  • Editable: This option defines whether the field can be edited or is always read-only.

Form: The User interface form field to use when editing this field (example include date, text box, text area)

Please take note that the Name and Display Name fields have the following restrictions:

  • Both are mandatory
  • The field name and display name cannot be more than 50 characters in length
  • The field name can only comprise lower case letters, numbers and hyphens. For example, "a-field-name"
  • The field name must be unique within the current Metadata Definition. So you cannot have two fields with the same name.

Advanced field Configuration


Multiplicity allows for more than one instance of this field type to be created. By default, when a field is defined, it results in the creation of one field instance per Schema Instance. If multiplicity is set, then the number of instances that can be created per field can be controlled. Examples include:

1..* (one to many)

1 (Only one of that field)

0..1 (zero or one)

0..* (zero to many)

Interdependent fields

Another advanced feature of Ooyala Flex's metadata framework is support for interdependent fields. Without interdependent field support, all metadata fields operate in isolation and have no information about the state of other fields in the same Schema. Interdependent field support allows the creator of a Metadata Schema to link together events generated from one field to updates on other fields. This functionality effectively allows fields to change their state based on changes made to other fields in the same Metadata Schema. With this functionality it's possible to change the state of form fields and show / hide fields depending on User Actions carried out. It allows Forms to be more dynamic and intuitive.

Permissions Options

Ooyala Flex's metadata framework supports per-field access control. This means that you can specify which User Groups can view and edit a particular field in a Schema Instance. The options available are as follows:

  • Permissions: When this check box is selected, it implies permissions are applied to this field
  • Access: This means that the selected User Group has access to the field
  • Read: This means that the selected User Group has read access to the field (cannot edit)
  • Edit: This means that the selected User Group has edit access to the field (can also read)

Access control when applied to Metadata Schema, is hierarchical. This means that if access is blocked to a User from higher up the Metadata Model tree, then branches further down the hierarchy are not visible to the User either.

Allowing the application of access control to individual fields in a Metadata Schema may seem like overkill but it's actually incredibly powerful. Often the same Metadata Instance is presented to different User Groups in different parts of an organisation. It is likely that some fields may not apply to some User Groups, so hiding them helps to protect private information and also remove clutter from the User interface. The net result of applying access control to individual fields is that Users can only see or edit fields that are relevant to them.

Field Validation Options

Validation Options allow you to define how values entered into a field are validated.

The following fields apply:

  • Validation: When this checkbox is selected it implies validation rules are applied. The following fields are also available.
  • Required: This is the most simple rule and simply states the validation applies and only fields with values entered will be accepted.
  • Description: This option allows you to provide a description of the validation rule. This can be presented to a User when they are filling in the form field to ensure that they know what the validation rules are.
  • Max. Length: This is another simple rule that, if set, enforces a maximum text length for an entry type.
  • Script: This field allows you to validate a rule against some script. Please see the API Guide for more information on scripting.
  • Class Name: This is an advanced field that allows a developer to specify a class name to be used for the purposes of validating a field entry.

Form Types

When creating a new Metadata field, you will be offered the option to choose a Form Type. The Form Type defines what input field type will be presented to the User when they enter values into a Metadata field in the Ooyala Flex Console. The Form Types offered depend on the field type. For example for a field of type Text, the User will be offered a standard one-line text input field or a multi-line textarea field.

The supported Form Types are as follows:

Text: A single line of text

Textarea: Multiple lines of text

Password: A password entry box (values hidden from the User)

Radio: A type of graphical User interface element that allows the User to choose only one of a predefined set of options

Checkbox: A graphical User interface element that permits the User to make a binary choice, i.e. a choice between one of two possible mutually exclusive options

Select: A select box with one or more values to choose from. For single option types, a drop down is shown, for multi-option types a multi-select box is shown

Date: A date pop-up, supporting date selection only

Time: A time pop-up supporting date and time selection

Colour: A colour picker pop up

Typeahead: A field that supports typeahead - a list of matching values are offered as the User begins to type a word or phrase.

The typeahead Form Type is very useful when you have an option field type that has a large number of options.

Text Fields

Text fields represent strings of text.

Examples of Text field types are:

  • String: A single line of text
  • Password: A single line of text, with the value hidden from the User
  • Text: One or more lines of text

Number fields

The following options relate to Number field Types and further extend the capability of fields in the Ooyala Flex Metadata framework. Examples of Number field types are Integer and Float.

  • Units: For number field Types (integer, double) units are available. Examples include bitrate, bits, bytes.
  • Formatting: For number field types, formatting can be provided to control how a number is presented to Users.
  • Format Description: Is an optional field that allows for a User to provide descriptive information about the format rules specified.
  • Generated Value: If this option is selected, then the value is auto-generated when the field is initiated.
  • Value Generator: Option will be presented so that the User can select the means by which the value is auto-generated

Note: Unit Types are pluggable and new Types can be created using Ooyala Flex's API.

Examples of Number field types are:

  • Integer
  • Long
  • Boolean
  • Float
  • Double

Date fields

Date fields are used to capture time-based information. There are 2 main field types:

  • Date: Captures day, year and month
  • Time: Captures day, year, month, hour, minute and second

The Date field type also supports Formatting.

Complex fields

A Complex field is a special type of field that enables nesting of other fields to make hierarchical data structures. Hence, a Complex field acts as a container for other Metadata fields. By Adding Complex fields to existing Complex fields, you can nest fields several levels deep to make powerful, description data models. For example, you might create a Complex field called "film-details" which contains key fields which describe a film.

A complex field definition:

A complex field instance:

Colour field

There is a single Colour field. This field allows a User to specify a colour with a colour chooser pop-up. The Colour field can be surprisingly useful, particularly when capturing information about look and feel for example in the case of a Player Definition.

Script field

There is a single Script field. This field allows a User to specify some script. The Script field can be surprisingly useful, particularly when capturing information about configuration and runtime processing.

A Script field definition:

A Script field instance:

Option fields

Option fields allow you to select a value from a set list of options specified when the field is created. There are two types of Option fields:

  • Single Option fields: Single Option fields allow a User to select only one Option form a set list of Options.
  • Multiple Option fields: Multiple Option fields allow a User to select one or more Options form a set list of Options.

When defining an Option Type field, you can enter Option values. Each value comprises a Name and a Display Name. You can also select default values. These values are selected by default when a field of this type is first instantiated. The order of the individual option values can be set when the field is first defined. When creating a Multiple Option field, you can select more than one default value. For Single Option Types, only one default value can be created.

A Single Option field definition:

A Single Option field instance:

A Multi Option field definition:

A Multi Option field instance:

Backing Store fields

When creating an Option Type field, a User is often expected to enter a static list of Options, for example "red", "green", "yellow". However what if the list of Options is very large or changing regularly? What if the User does not know what the values are as they are stored in a different system? Backing Store field support is an advanced feature of Option field types which address these challenges by allowing a User to configure an Option Type field to dynamically load the Option Values from an external source. This functionality offers some significant advantages:

  • Data Integrity: If the values are stored in an external system (i.e. a Rights Management system) then by loading the options dynamically, the User can be sure that the data is always up to date.
  • Easier Integration: This approach avoids data migration between external systems and Ooyala Flex. By looking up data from the source as required, there is no need to migrate data and no need to rely on batch scripts and timed updates.

Intelligent Workflow: Often Workflow Decision Nodes are driven by values held within Metadata fields (i.e. if Content Type = "Movie", then deliver to iTunes). Therefore Workflow can be orchestrated by data contained in other systems without the need for data migration.

To configure an Option field to be Backing Store enabled, simply check the "Backing Store" checkbox. Next, select the Backing Store type:

  • File: The values are loaded from a flat file.
  • Database: The values are loaded from an external database.

Next enter the Identifier. The identifier is a text string query that maps to the underlying data store, using Hibernate Query Notation.

Note: Hibernate is a popular Object-Relational data mapping framework. This is beyond the scope of the User Guide. Please consult the API Guide for further information.

Object fields

An Object field is a field that allows a User to reference an existing Ooyala Flex Object. For example a User may create a field that references another Asset or another User. This concept is extremely powerful as it allows Metadata Schema to reference other Ooyala Flex Object Types in the System.

The two main types of Object field are:

  • Object: Allows a User to define a reference to a specific type of Ooyala Flex Object.
  • Asset: Allows a User to define a reference to a specific type of Ooyala Flex Asset.

When making Objects available in a Metadata Instance Object field, Ooyala Flex will only present Objects that the User has visibility of.

See below a User Object type defined in the Metadata Schema:

See below how this is displayed in the Metadata Instance:

Key-Value Variables

You can add key-value variables to your Metadata Schema, in the Metadata Designer. For example: if you had Metadata which is associated with an Asset, you could have a key-value field for actors-roles. You could have the name of the actor who appeared in the film, and the role they played as a pair in the same field.

A Key-Value definition:

A Key-Value field instance:

Internal Schema Types

By now readers will know that Ooyala Flex's Metadata Framework is very powerful and is in fact a data-modelling tool in its own right. It should therefore come as no surprise that elements of Ooyala Flex use the Metadata Framework internally to support advanced functionality. Some of the areas where it is used are:

  • Profiles:Transcode and Validation Profiles use Ooyala Flex's Metadata Framework to store information about Transcode rules and Media Validation Profiles respectively. Each profile has it's own internal Schema.
  • Actions: The configuration information for Ooyala Flex Actions is managed by Ooyala Flex's Metadata Framework. Each Action has it own internal Schema.
  • Resources: The configuration information for Ooyala Flex Resources is managed by Ooyala Flex's Metadata Framework. Each Resource Type has it own internal Schema.

Was this article helpful?