An Islandora module that lets you get the UUID for an object if you know its PID, and get an object's PID if you know its UUID. Also lets you assign UUIDs to newly ingested objects.
Each object's UUID needs to be stored in a MODS <identifier type="uuid"> element.
The HTTP interface:
- given an Islandora object's PID, returns the corresponding UUID that exists in the configurable datastream location.
- given a UUID, returns the corresponding Islandora object's PID.
If neither the UUID or PID is found, the request returns a 404.
Take as an example an object with PID 'islandora:100' and <identifier type="uuid">9299d87d-752b-4a24-a2b8-816103418bb2</identifier> in its MODS datastream. curl "http://localhost:8000/islandora/idlookup/pid/islandora:100" will yield 9299d87d-752b-4a24-a2b8-816103418bb2, and curl "http://localhost:8000/islandora/idlookup/uuid/9299d87d-752b-4a24-a2b8-816103418bb2" will yield islandora:100.
Islandora lets you create PIDs that contain UUIDs. If you use UUID PIDs, you probably don't need this module.
But UUID PIDs make for ugly and long URLs. Also, if you have an Islandora repository that didn't start off with UUID PIDs, you may not want to change your PID pattern now. Plus, you may have been using UUIDs as unique identifiers in another repo platform that you migrated from, and you (wisely) included those UUIDs in your metadata when you migrated to Islandora.
The module also provides an option to add an <identifier type="uuid"> element to the MODS datastream of all new objects on ingest, if one is not already present. To do this, the module calls out to the server's uuidgen function (the filesystem path to the utility that generates UUIDs is configurable).
Note that this feature is enabled by default. If you don't want to add UUIDs to your objects' MODS datastreams, you will need to disable it immediately after enabling this module.
The module does not offer the ability to retroactively add UUIDs to existing MODS datastreams. That would be an awesome feature though.
Same as any Drupal module.
Go to admin/islandora/tools/idlookup to configure it.
- Provide options for storing the UUID somewhere other than in the MODS datastream.
- Provide a tool to add a UUID to existing objects.