Difference between revisions of "Object-level PREMIS rights import"

From Archivematica
Jump to navigation Jump to search
Line 9: Line 9:
 
=== Objective ===
 
=== Objective ===
  
−
Upload object-level PREMIS rights with an Archivematica transfer via a CSV file included in the transfer directory.
+
Allow a user to include object-level PREMIS rights with an Archivematica transfer via a CSV file.
  
−
=== Workflow ===
+
This work mirrors the method of passing object-level descriptive metadata to a transfer by including a CSV file
  
−
The below functionality will be documented in the Archivematica wiki and, once the feature is merged into a qa branch of the Archivematica project for public release, the official Archivematica documentation.
+
To further support RAC's Archivematica workflow, this feature also works with Archivematica's [https://www.archivematica.org/docs/archivematica-1.6/user-manual/access/access/#upload-as ArchivesSpace integration].
  
−
# User creates a CSV file containing PREMIS rights information for the desired digital objects.
+
== Workflow ==
−
*The user will be able to enter multiple acts for the same rights basis. Rows for the same object with the same rights basis will be treated as separate acts for the basis and merged. For example, the first two rows below will be merged, while the third row will be separate. (N.B. the below table is for illustrative purposes only and does not reflect how the CSV will eventually be structured.)
 
  
 +
Once the feature is merged into a QA branch of the Archivematica project for public release, this content will be moved to the official [https://www.archivematica.org/en/docs/ Archivematica documentation].
  
 +
1. '''Create PREMIS rights CSV file (rights.csv)'''
  
 +
User creates a CSV file containing PREMIS rights information for the desired digital objects. The user will be able to enter multiple acts for the same rights basis. Rows for the same object with the same rights basis will be treated as separate acts for the basis and merged. For example, the first two rows below will be merged, while the third row will be separate.
  
−
== User Stories ==
+
{|
 +
|file
 +
|basis
 +
|status
 +
|determination_date
 +
|jurisdiction
 +
|start_date
 +
|end_date
 +
|terms
 +
|citation
 +
|note
 +
|grant_act
 +
|grant_restriction
 +
|grant_start_date
 +
|grant_end_date
 +
|grant_note
 +
|doc_id_type
 +
|doc_id_value
 +
|doc_id_role
 +
|-
 +
|image1.tif
 +
|copyright
 +
|Currently under copyright.
 +
|2011-01-01
 +
|Canada
 +
|2011-01-01
 +
|2013-12-31
 +
|Terms of copyright.
 +
|Citation of copyright.
 +
|Note about copyright.
 +
|dissemination
 +
|disallow
 +
|2011-01-01
 +
|2013-12-31
 +
|Grant note
 +
|Copyright documentation identifier type.
 +
|Copyright documentation identifier value.
 +
|Copyright documentation identifier role.
 +
|-
 +
|document.pdf
 +
|}
  
 +
2. '''Add rights.csv to transfer directory'''
  
 +
The rights.csv file should be placed inside your transfer's metadata folder. Note that the sample folder structure below may not exactly reflect your directory structure, depending on your transfer requirements.
  
−
== Technical architecture ==
+
: /my-transfer
 +
:: image1.tif
 +
:: document.pdf
 +
:: /metadata
 +
::: rights.csv
 +
::: archivesspaceids.csv (optional)

Revision as of 19:58, 7 February 2017

Main Page > Development > Requirements > Object-level PREMIS rights import

Background

The Rockefeller Archives Centre is a heavy user of the PREMIS rights functionality in Archivematica and therefore sponsored the development of this foundational feature. This feature will allow users to apply PREMIS rights to individual objects by including a CSV file with the transfer, rather than having all of the objects in the transfer inherit rights applied to the SIP via the Add Rights form in the metadata module.

Requirements

Objective

Allow a user to include object-level PREMIS rights with an Archivematica transfer via a CSV file.

This work mirrors the method of passing object-level descriptive metadata to a transfer by including a CSV file

To further support RAC's Archivematica workflow, this feature also works with Archivematica's ArchivesSpace integration.

Workflow

Once the feature is merged into a QA branch of the Archivematica project for public release, this content will be moved to the official Archivematica documentation.

1. Create PREMIS rights CSV file (rights.csv)

User creates a CSV file containing PREMIS rights information for the desired digital objects. The user will be able to enter multiple acts for the same rights basis. Rows for the same object with the same rights basis will be treated as separate acts for the basis and merged. For example, the first two rows below will be merged, while the third row will be separate.

file basis status determination_date jurisdiction start_date end_date terms citation note grant_act grant_restriction grant_start_date grant_end_date grant_note doc_id_type doc_id_value doc_id_role
image1.tif copyright Currently under copyright. 2011-01-01 Canada 2011-01-01 2013-12-31 Terms of copyright. Citation of copyright. Note about copyright. dissemination disallow 2011-01-01 2013-12-31 Grant note Copyright documentation identifier type. Copyright documentation identifier value. Copyright documentation identifier role.
document.pdf

2. Add rights.csv to transfer directory

The rights.csv file should be placed inside your transfer's metadata folder. Note that the sample folder structure below may not exactly reflect your directory structure, depending on your transfer requirements.

/my-transfer
image1.tif
document.pdf
/metadata
rights.csv
archivesspaceids.csv (optional)
Retrieved from "https://wiki.archivematica.org/index.php?title=Object-level_PREMIS_rights_import&oldid=11584"