MediaPortal Bins
MediaPortal bins are collections of assets which optionally have in and out marks to refer to a specific time span of an asset. To model these concepts in VidiCore, collections are used. The metadata field V3_CollectionType
is set to PersistedBin
(see Collection Types).
The VidiCore collection contains one or multiple items in an ordered manner. Collections may also contain other collections.
In- and out-points and further metadata are stored as metadata on collection to entity relations with each item inside the collection using the standard VidiCore timecode notation. The key names follow the naming scheme used by VidiCore timespan
elements as defined in a VidiCore MetadataDocument
.
The key names changed in release 21.1 of VidiFlow to achieve consistent naming across all Vidispine products.
Please ensure to properly migrate existing data when upgrading to VidiFlow 21.1. A migration script will be available for this.
Key name | Meaning |
---|---|
| Zero-based relative in-point for the item, e.g. |
| Zero-base relative out-point for the item, e.g. |
| Optional plain-text description of the item. As it is not stored directly at the item, it may be different for the same item in different collections. |
|
This key name was used in VidiFlow prior to 21.1. Zero-based relative in-point for the item, e.g. |
|
This key name was used in VidiFlow prior to 21.1. Zero-based relative out-point for the item, e.g. |
|
This key name was used in VidiFlow prior to 21.1. Duration of marked segment, e.g. |
|
This key name was used in VidiFlow prior to 21.1. Optional plain-text description of the item. As it is not stored directly at the item, it may be different for the same item in different collections. |
It is not suitable to store these values directly on an item as these values may differ for the same item in different collections. The usage of metadata on collection to entity relations ensures that the referenced items are not changed when placing an item into a collection.
Please do not store the order of items on the entity relation – VidiCore collections are ordered by default. Please use VidiCore’s API to change the order, if required.
When looking at a VidiCore collection with two partial items this would look like this:
<CollectionDocument xmlns="http://xml.vidispine.com/schema/vidispine">
<id>COLLECTION-VX-3866</id>
<content>
<id>ITEM-VX-5480</id>
<type>item</type>
<metadata>
<field>
<key>V3_TcIn</key>
<value>10@PAL</value>
</field>
<field>
<key>V3_Duration</key>
<value>27@PAL</value>
</field>
</metadata>
</content>
<content>
<id>ITEM-VX-1810</id>
<type>item</type>
<metadata>
<field>
<key>V3_TcIn</key>
<value>3848@PAL</value>
</field>
<field>
<key>V3_Duration</key>
<value>4570@PAL</value>
</field>
</metadata>
</content>
</CollectionDocument>
The following section is for informational purposes only. Do not use any more.
VidiCore in versions <= 5.4 did not allow to store the same item in a collection multiple times. For an on-prem/hybrid/BYOC MAM solution this is essential, however. To achieve this, the following mechanism was used as an intermediate solution:
For each partial item create another “intermediate” item and put this intermediate item into the collection. V3_TcIn
(zero-based in-point in VidiCore timecode notation) and V3_Duration
(duration in VidiCore timecode notation) are used and are applied on the entity relation between the collection and the intermediate item. The intermediate item does not contain an asset and does not have metadata; instead it is marked as hidden (via V3_Hidden
) and points to the actual item via a directed item-to-item relation with type=subclip
.