Metadata dataset reference [VC 21.3.1 GEN]

Metadata datasets can be linked to metadata fields to restrict the allowed values for that field.

Managing datasets

List all datasets

GET /metadata/dataset

Retrieves the list of metadata datasets.

Produces:	application/xml, application/json – MetadataDatasetListDocument
Role:	_metadata_dataset_read

Example

GET /metadata/dataset

NONE

<?xml version="1.0"?>
<MetadataDatasetListDocument>
  <dataset>
    <name>testmodel1</name>
    <uri>http://localhost:8080/API/metadata/dataset/testmodel1</uri>
  </dataset>
  <dataset>
    <name>testmodel2</name>
    <uri>http://localhost:8080/API/metadata/dataset/testmodel2</uri>
  </dataset>
</MetadataModelListDocument>

HTML/XML

Retrieve a dataset

GET /metadata/dataset/(name)

Retrieves the metadata dataset with the specified name. The returned serialization format of the RDF model is RDF/XML or TURTLE depending on the request header.

Produces:	application/rdf+xml, text/turtle, application/ld+json – The RDF model.
Role:	_metadata_dataset_read

Example

GET /metadata/dataset/testmodel1

Accept: text/turtle

NONE

@prefix rdf:   <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix skos:  <http://www.w3.org/2004/02/skos/core#> .
@prefix vidi:  <http://rdf.vidispine.com/id/#> .

vidi:gid2  skos:definition  "country" ;
        skos:member      vidi:gid3 ;
        skos:prefLabel   "United Kingdom" .

vidi:gid1  skos:definition  "city" ;
        skos:prefLabel   "London" .

vidi:gid0  skos:definition  "city" ;
        skos:prefLabel   "Manchester" .

vidi:gid3  a    rdf:Bag ;
        rdf:_1  vidi:gid1 ;
        rdf:_2  vidi:gid0 .

BASH

GET /metadata/dataset/testmodel1

Accept: application/rdf+xml

NONE

<rdf:RDF
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:skos="http://www.w3.org/2004/02/skos/core#"
    xmlns:vidi="http://rdf.vidispine.com/id/#">
  <rdf:Description rdf:about="http://rdf.vidispine.com/id/#gid2">
    <skos:prefLabel>United Kingdom</skos:prefLabel>
    <skos:member>
      <rdf:Bag rdf:about="http://rdf.vidispine.com/id/#gid3">
        <rdf:li>
          <rdf:Description rdf:about="http://rdf.vidispine.com/id/#gid1">
            <skos:prefLabel>London</skos:prefLabel>
            <skos:definition>city</skos:definition>
          </rdf:Description>
        </rdf:li>
        <rdf:li>
          <rdf:Description rdf:about="http://rdf.vidispine.com/id/#gid0">
            <skos:prefLabel>Manchester</skos:prefLabel>
            <skos:definition>city</skos:definition>
          </rdf:Description>
        </rdf:li>
      </rdf:Bag>
    </skos:member>
    <skos:definition>country</skos:definition>
  </rdf:Description>
</rdf:RDF>

HTML/XML

Update or create a dataset

PUT /metadata/dataset/(name)

Updates or creates the existing dataset with the specified name.

Query Parameters:	id-seed (string) – A property name in the RDF model. If the id of a subject is not provided in the model, the value of this property will be used to generate an id for this subject. If not set or the subject doesn’t have this property, a random id will be generated.
Accepts:	application/rdf+xml, text/turtle, application/ld+json – The RDF model.
Produces:	application/rdf+xml, text/turtle, application/ld+json – The RDF model.
Role:	_metadata_dataset_write

Example

PUT /metadata/dataset/testmodel1?id-seed=skos:prefLabel

NONE

<rdf:RDF
 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
 xmlns:skos="http://www.w3.org/2004/02/skos/core#">
   <rdf:Description>
     <skos:definition>country</skos:definition>
     <skos:member>
       <rdf:Bag>
         <rdf:li>
           <rdf:Description>
             <skos:definition>city</skos:definition>
             <skos:prefLabel>London</skos:prefLabel>
           </rdf:Description>
         </rdf:li>
         <rdf:li>
           <rdf:Description>
             <skos:definition>city</skos:definition>
             <skos:prefLabel>Manchester</skos:prefLabel>
           </rdf:Description>
         </rdf:li>
       </rdf:Bag>
     </skos:member>
     <skos:prefLabel>United Kingdom</skos:prefLabel>
   </rdf:Description>
 </rdf:RDF>

HTML/XML

Response:

<rdf:RDF
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:skos="http://www.w3.org/2004/02/skos/core#"
    xmlns:vidi="http://rdf.vidispine.com/id/#">
  <rdf:Description rdf:about="http://rdf.vidispine.com/id/#unitedkingdom">
    <skos:prefLabel>United Kingdom</skos:prefLabel>
    <skos:member>
      <rdf:Bag rdf:about="http://rdf.vidispine.com/id/#gid0">
        <rdf:li>
          <rdf:Description rdf:about="http://rdf.vidispine.com/id/#london">
            <skos:prefLabel>London</skos:prefLabel>
            <skos:definition>city</skos:definition>
          </rdf:Description>
        </rdf:li>
        <rdf:li>
          <rdf:Description rdf:about="http://rdf.vidispine.com/id/#manchester">
            <skos:prefLabel>Manchester</skos:prefLabel>
            <skos:definition>city</skos:definition>
          </rdf:Description>
        </rdf:li>
      </rdf:Bag>
    </skos:member>
    <skos:definition>country</skos:definition>
  </rdf:Description>
</rdf:RDF>

HTML/XML

Delete a dataset

DELETE /metadata/dataset/(name)

Removes the metadata dataset with the specified name.

Role:

_metadata_dataset_write