DH-crud

The DARIAH-DE CRUD Service is the core storage service for the DARIAH-DE Repository. It talks to both the DARIAH-DE OwnStorage and PublicStorage. Two instances of the DH-crud are in use within the DARIAH-DE Repository: An only internally used instance that actually is creating and importing objects and an externally used instance (this one) that is delivering data and metadata to the users.

API Documentation

To retrieve data and metadata you would need an object’s PID, such as

11022/0000-0001-B739-1

#VERSION

To check the current productive TG-crud version simply try:

and you get the currently deployed version of the public DH-crud:

dhcrud-base-6.8.0-BETA.201701201820

#GET Data

GET: https://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/data

RESPONSE: A file object with appropriate Content-Type.

#GET Descriptive Metadata (DMD)

Descriptive metadata are in DC namespace and to be added by the user importing data into the repository. Only the dc:identifier tags holding the URL and the PID and the dc:format (in some cases) are added by the DH-crud service.

GET: https://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/metadata

RESPONSE: text/xml (RDF/XML)

<rdf:RDF
    xmlns:dcterms="http://purl.org/dc/terms/"
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:dc="http://purl.org/dc/elements/1.1/"
    xmlns:dariah="http://de.dariah.eu/rdf/dataobjects/terms/"
    xmlns:hdl="http://hdl.handle.net/" > 
  <rdf:Description rdf:about="hdl:11022/0000-0001-B739-1">
    <dc:identifier>http://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/index</dc:identifier>
    <dc:identifier>hdl:11022/0000-0001-B739-1</dc:identifier>
    <dc:title>Argliwargli</dc:title>
    <dc:rights>free</dc:rights>
    <rdf:type rdf:resource="http://de.dariah.eu/rdf/dataobjects/terms/Collection"/>
    <dc:format>text/tg.collection+tg.aggregation+xml</dc:format>
    <dc:creator>fu</dc:creator>
  </rdf:Description>
</rdf:RDF>

#GET Administrative Metadata (ADMMD)

Administrative metadata are in DCTERMS namespace and created by the DH-crud service itself at importing time.

GET: https://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/adm

RESPONSE: text/xml (RDF/XML)

<rdf:RDF
    xmlns:dcterms="http://purl.org/dc/terms/"
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:premis="http://www.loc.gov/premis/rdf/v1#" > 
  <rdf:Description rdf:about="hdl:11022/0000-0001-B739-1">
    <dcterms:extent>415</dcterms:extent>
    <dcterms:created>2017-02-10T15:50:20.174</dcterms:created>
    <dcterms:format>text/tg.collection+tg.aggregation+xml</dcterms:format>
    <dcterms:source>https://de.dariah.eu/storage/437352</dcterms:source>
    <dcterms:identifier>hdl:11022/0000-0001-B739-1</dcterms:identifier>
    <dcterms:creator>StefanFunk@dariah.eu</dcterms:creator>
    <dcterms:modified>2017-02-10T15:50:20.174</dcterms:modified>
  </rdf:Description>
</rdf:RDF>

#GET Technical Metadata (TECHMD)

Technical metadata is extracted from each single object (content file) at import. A File Information Tool Set (FITS) service is used by the DH-crud.

GET: https://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/tech

RESPONSE: text/xml (FITS XML)

<?xml version="1.0" encoding="UTF-8"?>
<fits xmlns="http://hul.harvard.edu/ois/xml/ns/fits/fits_output" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hul.harvard.edu/ois/xml/ns/fits/fits_output http://hul.harvard.edu/ois/xml/xsd/fits/fits_output.xsd" version="0.10.1" timestamp="2/10/17 3:50 PM">
  <identification>
    <identity format="Extensible Markup Language" mimetype="text/xml" toolname="FITS" toolversion="0.10.1">
      <tool toolname="Droid" toolversion="6.1.5" />
      <tool toolname="Jhove" toolversion="1.11" />
      <tool toolname="Exiftool" toolversion="10.00" />
      <tool toolname="ffident" toolversion="0.2" />
      <tool toolname="Tika" toolversion="1.10" />
      <version toolname="Droid" toolversion="6.1.5">1.0</version>
      <externalIdentifier toolname="Droid" toolversion="6.1.5" type="puid">fmt/101</externalIdentifier>
    </identity>
  </identification>
  <fileinfo>
    <size toolname="Jhove" toolversion="1.11">415</size>
    <lastmodified toolname="Exiftool" toolversion="10.00" status="SINGLE_RESULT">2017:02:10 15:50:20+01:00</lastmodified>
    <filepath toolname="OIS File Information" toolversion="0.2" status="SINGLE_RESULT">/tmp/tomcat-crud-tmp/data-2409037973877730698.rdf</filepath>
    <filename toolname="OIS File Information" toolversion="0.2" status="SINGLE_RESULT">data-2409037973877730698.rdf</filename>
    <md5checksum toolname="OIS File Information" toolversion="0.2" status="SINGLE_RESULT">3e04ed714d001829b82e21b5c7331fe2</md5checksum>
    <fslastmodified toolname="OIS File Information" toolversion="0.2" status="SINGLE_RESULT">1486738220000</fslastmodified>
  </fileinfo>
  <filestatus>
    <well-formed toolname="Jhove" toolversion="1.11" status="SINGLE_RESULT">true</well-formed>
    <valid toolname="Jhove" toolversion="1.11" status="SINGLE_RESULT">false</valid>
    <message toolname="Jhove" toolversion="1.11" status="SINGLE_RESULT">Not able to determine type of end of line</message>
    <message toolname="Jhove" toolversion="1.11" status="SINGLE_RESULT">cvc-elt.1: Cannot find the declaration of element 'rdf:RDF'. Line = 1, Column = 155</message>
  </filestatus>
  <metadata>
    <text>
      <charset toolname="Jhove" toolversion="1.11" status="SINGLE_RESULT">UTF-8</charset>
      <markupBasis toolname="Jhove" toolversion="1.11" status="CONFLICT">XML</markupBasis>
      <markupBasis toolname="Exiftool" toolversion="10.00" status="CONFLICT">XMP</markupBasis>
      <markupBasisVersion toolname="Jhove" toolversion="1.11" status="SINGLE_RESULT">1.0</markupBasisVersion>
      <standard>
        <textMD:textMD xmlns:textMD="info:lc/xmlns/textMD-v3">
          <textMD:character_info>
            <textMD:charset>UTF-8</textMD:charset>
          </textMD:character_info>
          <textMD:markup_basis version="1.0">XML</textMD:markup_basis>
        </textMD:textMD>
      </standard>
    </text>
  </metadata>
  <statistics fitsExecutionTime="114">
    <tool toolname="MediaInfo" toolversion="0.7.75" status="did not run" />
    <tool toolname="OIS Audio Information" toolversion="0.1" status="did not run" />
    <tool toolname="ADL Tool" toolversion="0.1" status="did not run" />
    <tool toolname="VTT Tool" toolversion="0.1" status="did not run" />
    <tool toolname="Droid" toolversion="6.1.5" executionTime="5" />
    <tool toolname="Jhove" toolversion="1.11" executionTime="39" />
    <tool toolname="file utility" toolversion="5.14" executionTime="66" />
    <tool toolname="Exiftool" toolversion="10.00" executionTime="110" />
    <tool toolname="NLNZ Metadata Extractor" toolversion="3.6GA" status="did not run" />
    <tool toolname="OIS File Information" toolversion="0.2" executionTime="0" />
    <tool toolname="OIS XML Metadata" toolversion="0.2" status="did not run" />
    <tool toolname="ffident" toolversion="0.2" executionTime="2" />
    <tool toolname="Tika" toolversion="1.10" executionTime="33" />
  </statistics>
</fits>

#GET Provenance Metadata (PROVMD)

The DARIAH-DE Repository is not yet using provenance mateadata yet.

GET: https://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/prov

RESPONSE: Not yet implemented!

#GET Object Index Page

GET: https://repository.de.dariah.eu/dhcrud/11022/0000-0001-B739-1/index

RESPONSE: text/html

../../../../../_images/indexPage.png

Sources

See dhcrud_sources

Bugtracking

See dhcrud_bugtracking

License

See LICENCE