(Quick Reference)

6 Dissemination information package - Reference Documentation

Authors: Lucien van Wouw

Version: 1.4

6 Dissemination information package

There are several dissemination services to deliver content. In all cases the access to the dissemination package these services give is determined by access policies.

6.1 HTTP 1.1 service

The HTTP dissemination service is probably the most familiar technique to distributing content to the human consumer or API client. Usually it is here persistent identifiers will need to resolve to. It offers:

Html page of the metadata

The archival package's preservation descriptive information is presented for the master and it's derivatives. The conventional dissemination url is:

http://disseminate.objectrepository.org/metadata/[persistent identifier]

Xml document of the metadata

Again the AIP rendered as a XML document. The conventional dissemination url is:

http://disseminate.objectrepository.org/metadata/[persistent identifier]?accept=xml

An example of the response could be:

<?xml version="1.0" encoding="utf-8"?>
<orfiles xmlns="http://objectrepository.org/orfiles/1.0/">
    <orfile>
        <pid>10622/30051002935671</pid>
        <resolverBaseUrl>http://hdl.handle.net/</resolverBaseUrl>
        <pidurl>http://hdl.handle.net/10622/30051002935671</pidurl>
        <filename>30051002935671.tif</filename>
        <label>2012-09-08 batch filer4</label>
        <access>restricted</access>
        <master>
            <pidurl>http://hdl.handle.net/10622/30051002935671?locatt=view:master</pidurl>
            <resolveUrl>http://disseminate.objectrepository.org/file/master/10622/30051002935671</resolveUrl>
            <contentType>image/tiff</contentType>
            <length>293909478</length>
            <content x-resolution="300.0" y-resolution="300.0" width="8066.0" height="12142.0"/>
            <md5>dc3fc60cf5ec720fbef6cbfaf04d7352</md5>
            <uploadDate>Tue Nov 29 13:21:00 CET 2011</uploadDate>
            <firstUploadDate>Sat Sep 08 22:32:58 CEST 2012</firstUploadDate>
            <lastUploadDate>Sat Sep 08 22:32:58 CEST 2012</lastUploadDate>
        </master>
        <level2>
            <pidurl>http://hdl.handle.net/10622/30051002935671?locatt=view:level2</pidurl>
            <resolveUrl>http://disseminate.objectrepository.org/file/level2/10622/30051002935671</resolveUrl>
            <contentType>image/jpeg</contentType>
            <length>102768</length>
            <md5>15471cf308f739ea548496530277425d</md5>
            <uploadDate>Sat Sep 08 22:34:06 CEST 2012</uploadDate>
            <firstUploadDate>Sat Sep 08 22:34:06 CEST 2012</firstUploadDate>
            <lastUploadDate>Sat Sep 08 22:34:06 CEST 2012</lastUploadDate>
        </level2>
        <level3>
            <pidurl>http://hdl.handle.net/10622/30051002935671?locatt=view:level3</pidurl>
            <resolveUrl>http://disseminate.objectrepository.org/file/level3/10622/30051002935671</resolveUrl>
            <contentType>image/jpeg</contentType>
            <length>21065</length>
            <content height="350" width="232" x-resolution="72 PixelsPerInch" y-resolution="72 PixelsPerInch"/>
            <md5>ba0682b465bf6d600d213eebb9b43388</md5>
            <uploadDate>Sat Sep 08 22:34:01 CEST 2012</uploadDate>
            <firstUploadDate>Sat Sep 08 22:34:01 CEST 2012</firstUploadDate>
            <lastUploadDate>Sat Sep 08 22:34:01 CEST 2012</lastUploadDate>
        </level3>
    </orfile>
</orfiles>

A file stream with mimetype

A http request for an openly accessible resource would return the corresponding file in the appropriate content type such as an image. The template URL would be:

http://disseminate.objectrepository.org/file/[derivative level]/[persistent identifier]

The returning filename can also be set by setting a contentType and filename parameter so:

http://disseminate.objectrepository.org/file/[derivative level]/[persistent identifier]?contentType=application/save&filename=myfile.tif

Streaming

De HTTP service handles the HTTP 206 protocol, which will enable the streaming of content to most common audio and video players. The Real Time Streaming Protocol is not supported.

6.2 FTP service

The content producer can download ingested files using ftp. The ftp home directory will look like this, showing the stored master and it's derivatives:
/master
/level1
/level2
/level3

From thereon the directory tree is similar to the way files are offered to the staging area when the dissemination package was assembled. Use your favorite ftp client to access the data. Use these settings:

  • connect to ftp.objectrepository.org
  • set the ftp client to support an implicit FTP over TLS connection
  • enable passive mode.
  • your account is the same account with which you administer your object repository.

6.3 PDF service

A compound object can be disseminated as a PDF document. This is possible when at least one of the derivative layers is of an image type. The dissemination URL of a pdf document is:

http://disseminate.objectrepository.org/pdf/[object-id]

The default level of files used for this is set with the pdfLevel element set in instruction. See pids.

However the consumer can force a level yourself by adding it to the url so:

http://disseminate.objectrepository.org/pdf/12345/my-object-id/derivative level@

If the level has a restrictive access or is not of a suitable mime type, the pdf will not render

6.4 METS service

The object repository can disseminate compound objects in a standardized way by exporting a by default profile level 3 Mets document. Mets is a metadata standard of the Library of Congres. As this is a standardized way of describing files, their content type and their structure it can be used by third party software to render content.

The dissemination URL of a mets document is: http://disseminate.objectrepository.org/mets/12345/my-object-id

And if the producer used a PID webservice, then the persistent identifier is http://hdl.handle.net/12345/my-object-id

As an example, the Mets disseminated would be similar to:

<?xml version="1.0" encoding="UTF-8"?>
      <mets xmlns="http://www.loc.gov/METS/" OBJID="10622/ARCH00483.511">
          <fileSec>
              <fileGrp ID="master" USE="archive image">
                  <file CHECKSUM="7ce13c6f87930f456a315ae2b8f4f599" CHECKSUMTYPE="MD5" CREATED="2013-03-24T20:09:14Z" ID="f1"
                        MIMETYPE="image/tiff" SIZE="112909902">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-a?locatt=view:master"
                              xlink:title="page_00001.tif" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="db4baeeaa72f9d70248dc86243ec67a6" CHECKSUMTYPE="MD5" CREATED="2013-03-24T16:10:37Z" ID="f2"
                        MIMETYPE="image/tiff" SIZE="34832744">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-b?locatt=view:master"
                              xlink:title="page_00002.tif" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="b94a379b69a22a06733c099fae756d5b" CHECKSUMTYPE="MD5" CREATED="2013-03-24T27:10:25Z" ID="f3"
                        MIMETYPE="image/tiff" SIZE="34609288">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/another-identifier-c?locatt=view:master"
                              xlink:title="page_00003.tif" xlink:type="simple"/>
                  </file>
              </fileGrp>
              <fileGrp ID="level1" USE="hires reference image">
                  <file CHECKSUM="372fc2b527e841c87ae1981203853ecb" CHECKSUMTYPE="MD5" CREATED="2013-03-27T12:01:34Z" ID="f40"
                        MIMETYPE="image/jpeg" SIZE="281588">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-a?locatt=view:level1"
                              xlink:title="page_00001.jpeg" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="5b6375afa835b2737ddc785de94c78df" CHECKSUMTYPE="MD5" CREATED="2013-03-27T12:01:35Z" ID="f41"
                        MIMETYPE="image/jpeg" SIZE="524663">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-b?locatt=view:level1"
                              xlink:title="page_00002.jpeg" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="a575e7376590a77451fa2c5d0cc6b388" CHECKSUMTYPE="MD5" CREATED="2013-03-27T12:01:36Z" ID="f42"
                        MIMETYPE="image/jpeg" SIZE="544376">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/another-identifier-c?locatt=view:level1"
                              xlink:title="page_00003.jpeg" xlink:type="simple"/>
                  </file>
              </fileGrp>
              <fileGrp ID="level2" USE="reference image">
                  <file CHECKSUM="1131b5eaabd7eb8266295dfa6e9deb15" CHECKSUMTYPE="MD5" CREATED="2013-03-27T49:03:54Z" ID="f79"
                        MIMETYPE="image/jpeg" SIZE="40477">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-a?locatt=view:level2"
                              xlink:title="page_00001.jpeg" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="29b93e7a719c6235f63822cbd31cf310" CHECKSUMTYPE="MD5" CREATED="2013-03-27T49:03:56Z" ID="f80"
                        MIMETYPE="image/jpeg" SIZE="74001">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-b?locatt=view:level2"
                              xlink:title="page_00002.jpeg" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="e237e2a6cbac9e12b92b870e7845f211" CHECKSUMTYPE="MD5" CREATED="2013-03-27T49:03:57Z" ID="f81"
                        MIMETYPE="image/jpeg" SIZE="82348">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/another-identifier-c?locatt=view:level2"
                              xlink:title="page_00003.jpeg" xlink:type="simple"/>
                  </file>
              </fileGrp>
              <fileGrp ID="level3" USE="thumbnail image">
                  <file CHECKSUM="51935fb67bbb50b2d2908401ba95119e" CHECKSUMTYPE="MD5" CREATED="2013-03-27T49:03:57Z"
                        ID="f118" MIMETYPE="image/jpeg" SIZE="2644">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-a?locatt=view:level3"
                              xlink:title="page_00001.jpeg" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="0f012b9052011cfa9791783895931505" CHECKSUMTYPE="MD5" CREATED="2013-03-27T49:03:58Z"
                        ID="f119" MIMETYPE="image/jpeg" SIZE="3864">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/my-identifier-b?locatt=view:level3"
                              xlink:title="page_00002.jpeg" xlink:type="simple"/>
                  </file>
                  <file CHECKSUM="844a307af425882c241d8f8256fc1698" CHECKSUMTYPE="MD5" CREATED="2013-03-27T50:03:00Z"
                        ID="f120" MIMETYPE="image/jpeg" SIZE="4676">
                      <FLocat LOCTYPE="HANDLE" xmlns:xlink="http://www.w3.org/1999/xlink"
                              xlink:href="http://hdl.handle.net/12345/another-identifier-c?locatt=view:level3"
                              xlink:title="page_00003.jpeg" xlink:type="simple"/>
                  </file>
              </fileGrp>
          </fileSec>
          <structMap TYPE="physical">
              <div>
                  <div ID="g0" LABEL="Page 1" ORDER="1" TYPE="page">
                      <fptr FILEID="f1"/>
                      <fptr FILEID="f40"/>
                      <fptr FILEID="f79"/>
                      <fptr FILEID="f118"/>
                  </div>
                  <div ID="g1" LABEL="Page 2" ORDER="2" TYPE="page">
                      <fptr FILEID="f2"/>
                      <fptr FILEID="f41"/>
                      <fptr FILEID="f80"/>
                      <fptr FILEID="f119"/>
                  </div>
                  <div ID="g2" LABEL="Page 3" ORDER="3" TYPE="page">
                      <fptr FILEID="f3"/>
                      <fptr FILEID="f42"/>
                      <fptr FILEID="f81"/>
                      <fptr FILEID="f120"/>
                  </div>
              </div>
          </structMap>
      </mets>