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 asinterval=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.
- track-type track-number -
Return metadata for specified track. Example of track is
- 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.
- language-tag -
Return metadata for specific language, e.g.
- 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.
Additionally, if set to
type
the type definition of the field will be retrieved. - defaultValue –
true
- For unset fields, return default values.false
(default) - Do not return default values.
- includeConstraintValue –
Optional comma separated value, specifying a list of fields whose “display value” should be retrieved from the metadata dataset. (New in 4.13.)
all
(default) - Return the “display value” of all fileds.none
- No “display value” will be returned. The fields will only haveid
set.- comma separated field names - Return the “display value” of the specified fields.
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>