Global metadata¶
Global metadata is metadata that is not associated with any item or collection. It can primarily be used as a reference, for example holding a field that is referenced from many items.
Retrieving the global metadata¶
- GET /metadata¶
Retrieves the global metadata.
Matrix Parameters: - interval –
Comma-separated list
- time-span - Filter out metadata, return only metadata for specified time span.
- generic - Return all non-timed metadata.
- all (default) - Return all metadata, same as interval=generic,-INF-+INF
- field –
Comma-separated list.
- field-name - Return specified field.
- field-name ”:” new-name - Return specified field, renamed to a new name in return value.
- “-” field-name - Exclude specified field.
- (default) - Return all fields.
- group –
Comma-separated list.
- group-name - Return specified group.
- group-name + -
Return specified group and subgroups.
New in version 4.1.
- group-name : new-name - Return specified group, renamed to a new name in return value.
- - group-name - Exclude specified group.
- (default) - Return all groups.
- track –
Comma separated list.
- track-type track-number - Return metadata for specified track. Example of track is A2.
- track-type t1 - t2 - Return metadata for specified track interval, e.g. A2-4.
- track-type * - Return metadata for all tracks of specified type, e.g. A*.
- generic - Return all non-tracked metadata.
- all (default) - All metadata, with or without track specification, are returned.
- language –
Comma separated list.
- language-tag - Return metadata for specific language, e.g. en_US. Wildcards may be used, e.g. *_CA for both Canadian French and Canadian English.
- none - Return all metadata without language specification.
- all (default) - Return all metadata, with or without language specification.
- samplerate – Convert all outgoing time instants to specified rate. NB! Time codes which cannot be expressed in an integer number of samples will be returned as a decimal number, with risk of losing precision.
- conflict –
- yes (default) - Include all metadata conflicts, unresolved.
- no - Return conflicts resolved according to field rules.
- include – A list of keys. Includes additional field specific data. See Field metadata. Additionally, if set to type the type definition of the field will be retrieved.
- defaultValue –
- true - For unset fields, return default values. See Default values.
- false (default) - Do not return default values.
Produces: - application/xml, application/json – MetadataDocument
Role: _metadata_global_read
- interval –
Modifying the global metadata¶
- PUT /metadata¶
Modifies the global metadata. This resource shares the same query and matrix parameters as the item metadata resource.
Query Parameters: - revision – The known revision. If not specified, the change set will attempt to override existing change sets.
- skipForbidden – Skip fields or groups that the user doesn’t have write access to.
Accepts: - application/xml, application/json – MetadataDocument
Produces: - application/xml, application/json – MetadataDocument
Retrieving metadata by UUID¶
- GET /metadata/(uuid)¶
Retrieves the metadata entry that matches the UUID.
Produces: - application/xml, application/json – MetadataEntryDocument
Role: _metadata_global_read
Example¶
GET /metadata/c3dc7918-9316-4fef-b4fc-ff2b0149e854
<MetadataEntryDocument xmlns="http://xml.vidispine.com/schema/vidispine">
<field uuid="c3dc7918-9316-4fef-b4fc-ff2b0149e854" user="system" timestamp="2011-01-10T10:00:54.845+01:00" change="VX-7">
<name>originalVideoCodec</name>
<value uuid="199255d8-59ec-421e-9c7b-757c46c92b14" user="system" timestamp="2011-01-10T10:00:54.845+01:00" change="VX-7">h264</value>
</field>
</MetadataEntryDocument>
GET /metadata/199255d8-59ec-421e-9c7b-757c46c92b14
<MetadataEntryDocument xmlns="http://xml.vidispine.com/schema/vidispine">
<value uuid="199255d8-59ec-421e-9c7b-757c46c92b14" user="system" timestamp="2011-01-10T10:00:54.845+01:00" change="VX-7">h264</value>
</MetadataEntryDocument>