Working with Dublin Core Datastreams within Islandora

islandora_datastream_dc.md

Working with Dublin Core Datastreams within Islandora

First, retrieve the DC Document using cURL:

$ curl http://digital.stage.lafayette.edu/islandora/object/elc:10/datastream/DC/view

  <dc:title>Ledger 1</dc:title>
  <dc:identifier>elc:10</dc:identifier>
</oai_dc:dc>```

* Please note that the XML Document is missing the XML declaration
* This is because DC datastreams are managed as inline XML
* As such, they are embedded within FOXML Documents (with the XML already declared)

## Next, one prepares a DC Document for ingestion...

`$ cat fixture.dc.xml`

```<oai_dc:dc xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">
  <dc:title>Ledger 1</dc:title>
  <dc:identifier>elc:10</dc:identifier>
  <dc:description>This is a resource with an updated DC datastream</dc:description>
</oai_dc:dc>```

## ...and ingests this Document

``$ drush islandora-update-ds elc:10 DC 'Dublin Core Record for this object' `pwd`/fixture.dc.xml X``

* Note that this is a Drush task which I've implemented locally.  Freely refactor and use the code here:

dt('Update/Insert the a datastream for an Islandora Object'), 'arguments' => array('arg1' => dt('The Fedora Commons Object PID'), 'arg2' => dt('The Datastream ID'), 'arg3' => dt('The Datastream label'), 'arg4' => dt('The file path for the Datastream content'), 'arg5' => dt('The type of datastream being updated (e. g. managed, inline XML, redirect...)') ), 'examples' => array('Argument example' => 'drush islandora-update-dc islandora:object1 MODS "MODS Document" object1.mods.xml MODS', ), 'aliases' => array('ds-up')); //... function drush_islandora_dss_islandora_update_ds($obj_pid, $ds_id, $ds_label, $ds_content_file_path, $control_group='M') { // Get the connection $connection = islandora_get_tuque_connection(user_load(1), $url); // Load the object $object = islandora_object_load($obj_pid); // Create and ingest the Object if(empty($object[$ds_id])) { $datastream = $object->constructDatastream($ds_id, $control_group); $datastream->label = $ds_label; $object->ingestDatastream($datastream); $created = TRUE; } else { $datastream = $object[$ds_id]; } $datastream->setContentFromFile($ds_content_file_path); //... ?>

## Your DC datastream should now reflect these changes

`$ curl http://digital.stage.lafayette.edu/islandora/object/elc:10/datastream/DC/view`

```<oai_dc:dc xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:oai_dc="http://www.openarchives.org/OAI/2.0/oai_dc/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://www.openarchives.org/OAI/2.0/oai_dc.xsd">
  <dc:title>Ledger 1</dc:title>
  <dc:description>This is a resource with an updated DC datastream</dc:description>
  <dc:identifier>elc:10</dc:identifier>
</oai_dc:dc>```