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

From Archivematica
Jump to navigation Jump to search
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Main Page]] > [[Development]] > [[Requirements]] > Object-level PREMIS rights import
 
[[Main Page]] > [[Development]] > [[Requirements]] > Object-level PREMIS rights import
 +
 +
<div style="padding: 10px 10px; border: 1px solid black; background-color: #F79086;">This page is no longer being maintained and may contain inaccurate information. Please see the [https://www.archivematica.org/docs/latest/ Archivematica documentation] for up-to-date information.</div><p>
 +
 +
Page text is a work in progress.
 +
 +
[[Category:Feature requirements]]
  
 
== Background ==
 
== Background ==
Line 7: Line 13:
 
== Requirements ==
 
== Requirements ==
  
−
=== Objective ===
+
* Allow a user to include object-level PREMIS rights with an Archivematica transfer via a CSV file.
−
 
+
* Enable those rights to be passed to the appropriate ArchivesSpace resources.
−
Upload object-level PREMIS rights with an Archivematica transfer via a CSV file included in the transfer directory.
 
  
−
=== 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
 +
|copyrighted
 +
|2011-01-01
 +
|ca
 +
|2011-01-01
 +
|2013-12-31
 +
|Terms of copyright.
 +
|Citation of copyright.
 +
|Note about copyright.
 +
|disseminate
 +
|disallow
 +
|2011-01-01
 +
|2013-12-31
 +
|Grant note
 +
|Copyright documentation identifier type.
 +
|Copyright documentation identifier value.
 +
|Copyright documentation identifier role.
 +
|-
 +
|document.pdf
 +
|license
 +
|
 +
|
 +
|
 +
|2000-09-09
 +
|2010-09-08
 +
|Terms of license.
 +
|
 +
|Note about license.
 +
|migrate
 +
|allow
 +
|2000-09-08
 +
|
 +
|Grant note
 +
|License documentation identifier type.
 +
|License documentation identifier value.
 +
|License documentation identifier role.
 +
|}
  
 +
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)

Latest revision as of 16:27, 11 February 2020

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

This page is no longer being maintained and may contain inaccurate information. Please see the Archivematica documentation for up-to-date information.

Page text is a work in progress.

Background[edit]

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[edit]

  • Allow a user to include object-level PREMIS rights with an Archivematica transfer via a CSV file.
  • Enable those rights to be passed to the appropriate ArchivesSpace resources.

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[edit]

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 copyrighted 2011-01-01 ca 2011-01-01 2013-12-31 Terms of copyright. Citation of copyright. Note about copyright. disseminate disallow 2011-01-01 2013-12-31 Grant note Copyright documentation identifier type. Copyright documentation identifier value. Copyright documentation identifier role.
document.pdf license 2000-09-09 2010-09-08 Terms of license. Note about license. migrate allow 2000-09-08 Grant note License documentation identifier type. License documentation identifier value. License documentation identifier role.

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=13386"