View source for Development/Functional testing/Digital object tests

{{#pagetitle: Digital object tests }}
[[Main Page]] > [[Development]] > [[Development/Functional testing]] > Development/Functional testing/Digital object tests


== General behaviour ==
*Clicking Link digital object in information object show screen opens Upload digital objects screen
*User can browse for a digital object to upload
*User can link to an external URL to upload a digital object
*Clicking Create opens the show screen for the information object with digital object displayed as reference display copy
*Digital object metadata are automatically added to the information object show screen, as follows: Filename (if object was uploaded from file system), URL (if object was uploaded from external link) Media type, Mimetype, Filesize, Uploaded
**NOTE: when testing, remember these elements can be hidden to public users via Visible elements module
*Digital objects appear in browse results in appropriate categories: audio, image, other, text, video
*Digital objects appear in carousel viewer at aggregate levels of description
*Digital objects can be located via digital object browse page

== Text files ==
*In the information object show screen, clicking on the reference display object opens the master digital object (if the user's permissions are set to allow it)
*Clicking on the reference display area allows user to open or download object
*Unauthenticated users and users without view master permissions cannot open and download master digital object

== Image files ==
*In the information object show screen, clicking on the reference display object opens the master digital object or allows the user to open or save the object
*Users can right-click or command-click the image representation and receive options: Open link in new tab; Open link in new window; Bookmark link; Save link as; Send link; Copy link location; View image; Copy image; Copy image location; Save image as; Send image; and View image info.
*Unauthenticated users and users without view master permissions cannot open and download master digital object

== Video files ==
*Clicking "play" in the reference display copy plays the video
*Associated audio streams are also played
*Left-clicking "download movie" opens up the master digital object (depends on browser support)
*Right-clicking "download movie" allows the user to save the save the file (eg "Save link as")
*Users can right-click or command-click "download movie" and receive options: Open link in new tab; Open link in new window; Bookmark link; Save link as; Send link; and Copy link location.
*Unauthenticated users and users without view master permissions cannot open and download master digital object

== Audio files ==
*Clicking "play" in the reference display copy plays the audio file, or prompts user to download the file, depending on the format
*Left-clicking "download audio" opens up the master digital object (depends on browser support)
*Right-clicking "download audio" allows the user to save the save the file (eg "Save link as")
*Users can right-click or command-click "download audio" and receive options: Open link in new tab; Open link in new window; Bookmark link; Save link as; Send link; and Copy link location.

== Multi-page files ==
*User can upload multi-page files
*All pages in the multi-page file are uploaded
*Reference display copy shows first page of a multi-page file unless a different page has been chosen for display (see Digital Object Derivatives in [[Development/Functional_testing/Admin_tests]])
*User can page through pages in reference display copy
*Clicking on reference display copy opens master digital object in a new window

== Editing digital object ==
*In information object view screen, clicking on "Edit digital object" button opens the edit digital object view screen
*User can change media type
*User can delete reference representation and substitute new representation
*User can delete thumbnail representation and substitute new representation
*Clicking Save opens information object show screen with all changes saved
*Substituted reference and thumbnail representations are correctly resized
*Clicking Delete results in confirmation message: "Are you sure you want to delete the digital object linked to....?"
**Clicking Cancel returns user to digital object edit screen and digital object is not deleted
**Clicking Confirm opens the information object show screen and digital object is deleted

== Multi-file upload ==
*In information object show screen, clicking Import digital objects opens Upload multiple digital objects screen
*User can edit title it Title field
*User can select level of description
*Clicking the "select files" link opens a file browser
*User can select multiple objects from the file browser
*Digital objects are previewed, along with Title, Filename, and Filesize
*Can edit Title for previewed objects
*Can delete previewed objects
*If filesize exceeds maximum allowed upload size, a warning message appears
*If digital object is a duplicate of another digital object in the same upload, a warning message appears
*User can select more files before importing
*Clicking Import opens information object show screen
*Carousel viewer is visible in in information object show screen
*Objects are displayed as children of the current record in the hierarchy treeview
*Child level show screens open digital object displayed as reference display copy; behaviour is same as described in General behaviour, above

== Enhanced digital object display ==

*'''When an AtoM user links a digital object to an archival description:'''
*Then the "Digital object metadata" section on the archival description view page will include an "Access Copies" subsection.
*And an unauthenticated user will not see a digital object and its "Access copies" metadata if the archival description it is attached to has a "draft" instead of "published" status.
*And Clicking on the "Access copies" subsection label link will collapse or expand the subsection.
*And the "Access Copies" subsection will include metadata about the "Master file", "Reference copy", and "Thumbnail copy" representations of the digital object. Specifically: filename, media type, mime-type, filesize, and uploaded.
*And an administrator user can toggle the display of specific "Digital object metadata" section fields on or off in the *Admin > Settings > Visible Elements* section. This only affects display for unauthenticated users. Any authenticated users will see all metadata elements in each section as long as those fields contain a value.
*And when the Reference representation or Thumbnail representation is deleted via the "Edit digital object" page, then the "Reference copy" and/or "Thumbnail copy" metadata is no longer displayed on the archival description view page. Additionally, the thumbnail is not show on Browse pages and the reference copy is not displayed on view pages.
*And filename for each representation is either shown as plain text or as a hyperlink. If it is a hyperlink, it indicates that this user has access to this representation. Clicking on the hyperlink will load this representation.
*And if the filename is in hyperlink format, the icon underneath the "Master file", "Reference copy", and "Thumbnail copy" label is coloured black. It is coloured grey if the user does not have access and the hyperlink is not shown.
* And access to the "Master file", "Reference copy", and "Thumbnail copy" can be configured per user group. The "Access master", "Access reference", and/or "Access thumbnail" permission can be set to "Grant" or "Deny" for any user group, including unauthenticated ("anonymous") users.
* And access to the "Master file", "Reference copy", and "Thumbnail copy" may be overridden by actionable PREMIS rights configured for individual archival descriptions and their digital object. If a PREMIS right is added to an archival description where the "Act" is "Disseminate" and the "Restriction" is "Disallow", then the hyperlinks in the Digital object metadata section are no longer active, all the document icons are coloured grey, and the reference copy of the digital object is no longer displayed on the archival description view page. Instead the customizable text of the "Disallow statement" is displayed at the top of the page as well as in a "Permissions" field for each Access copy representation (e.g. "Access to this record is restricted because it contains personal or confidential information. Please contact the Reference Archivist for more information on accessing this record.").
* And if the "Restriction" is changed to "Conditional" and the default permission settings are enabled then the "Reference copy" and "Thumbnail copy" become available again as hyperlinks and these representations are once again displayed on the AtoM templates. The customizable text for the "Condition Statement" is displayed in a "Permissions" field for the "Master file" representation (e.g. "This record has not yet been reviewed for personal or confidential information. Please contact the Reference Archivist to request access and initiate an access review.").

== Enhanced digital object display (Preservation copies) ==

*'''When a user of a preservation system (e.g. Archivematica) has sent a DIP upload to an archival description slug in AtoM:'''
*Then an authenticated user is able to see thumbnails of the digital objects from the DIP in the digital object carousel when navigating to this AtoM slug.
*And an unauthenticated user will not see a digital object and its metadata if the archival description it is attached to has a "draft" instead of "published" status.

*'''When selecting one of the digital objects included in the DIP upload:'''
*Then the "Digital object metadata" section on the archival description view page will include a "Preservation Copies" and "Access Copies" subsection.
*And clicking on either of these subsection label links will collapse or expand the subsection.
*And the "Preservation Copies" subsection will include metadata about the "Original file" and "Preservation copy" representations that are stored in the preservation system.
*And if the preservation system did not generate a preservation copy then only "Original file" metadata is shown.
*And the "Preservation copy" metadata elements include filename, filesize, and normalized.
*And if the preservation action system statement option is enabled then the user will also see a "Permissions" field with custom text that is populated by an Administrator (e.g. "Access only provided on research room computer.")
*And the "Original file" metadata may includes filename, file format name, file format version, format registry key, format registry name, filesize, and ingested.
*And if the preservation action system statement option is enabled, the user will also see a "Permissions" field with custom text that is populated by an Administrator (e.g. "Access only provided on research room computer.")
*And an administrator user can toggle the display of specific "Digital object metadata" section fields on or off in the *Admin > Settings > Visible elements* section. This only affects display for unauthenticted users. Any authenticated users will see all metadata elements in each section as long as those fields contain a value.
*And if the user is logged in and belongs to the "authenticated" group, then they will also see the File UUID and AIP UUID for the Original file.
*And if the preservation copies came from the Archivematica preservation system and AtoM has enabled the "arStorageServicePlugin" then authenticated users with Download AIP permissions will also see a "Download file" and "Download AIP" link next to each UUID. Clicking on them will fetch the file or the full AIP from the preservation system.
*And if the user has "Download file" and "Download AIP" permissions then the box icon under the "Original file" label will be coloured black. Otherwise it is coloured grey.
*And since access to the preservation copy is only available via the preservation system, the box icon under the "Preservation copy" label is always coloured grey.

*'''When the preservation system uploads a DIP with digital objects to AtoM:'''
* Then it will generate "Master file", "Reference copy", and "Thumbnail copy" representations with metadata displayed in the "Access copies" subsection (see "Enhanced digital object display" above)


[[Category:Development documentation]]

__NOTOC__