Some object types allow you to define "variants". A variant is a more specific type of an existing object type which is defined by a user. For example Ooyala Flex supports the asset object type. This means that in Ooyala Flex you can create, update and search for assets. But what about if you want to create a new object type that is like an asset but more specific? What if you wish to assign different data fields to your more specific type? Let's say you want to create a type called "Video" that is simply a type of asset with more specific data felds. To do this you create a variant.
When you create a variant, you do the following:
• Select the Ooyala Flex object type you want to base your variant on (i.e. an asset)
• Create a name for your variant (i.e. film)
• Supply an optional metadata schema to help describe properties of your variant
Creating a Variant
To create a variant, follow these steps:
1) Click the Access tab, and then on the toolbar, select the Accounts option.
2) Select an account from the list.
3) In the Account Details section, select the Variants sub-tab.
4) Click the Edit option in the top-right corner of the Variants screen.
5) You will be taken to the Variant Creation / Editing section. Here you can create new variants, as well as delete existing ones.
6) You will see a blank set of fields. Here you can fill in the details for your new variant.
7) In the Object Type field, select an object type that you wish to base your variant on, for example Media Asset.
8) In the Variant field, enter a name for your variant. A variant is a user defined concept. It enables you to create your own category of the object type. So in our example we are creating our own category of the media asset object type called Film.
9) In the Metadata Definition field, select a metadata definition. You can assign your metadata schema to a variant you are creating.
10) If you select the Metadata Definition check box, every time a variant of type (in this case) Film is selected, the metadata definition (e.g. test-metadata-def1) will be linked by default.
11) You can add more variants and also remove them using the + and - icons found at the end of each row.
12) When you have finished creating your new variant, click Save.
13) By clicking Save, all the changes you have made will be saved. You will see a confirmation box to ensure that you are aware that deleting variants may result in a loss of data.
14) Click Continue to confirm.
15) Your Variant is now created.
Selecting a Variant when creating an Object.
Once your variant has been created, you can select it when you create new objects types that are linked with that variant.
To select your variant when creating new objects, follow these steps:
1) Create the object type associated with the variant. For example: if you have created a variant for a media asset, you can either create a placeholder media asset, or ingest a file.
2) In the Details section for the object, click the Variant drop down, and select the variant you've created. In our example it will be the Film variant.
3) The metadata associated with the variant is automatically selected, and those metadata fields will appear, ready for you to fill out.
4) Click Save to finalise.
5) When you save the object type, you will see all of the metadata fields, in the Object Details section.