Development/Functional testing/Digital object tests - Revision history

PeterVG at 01:35, 19 September 2020

2020-09-19T01:35:48Z

PeterVG at 01:28, 19 September 2020

2020-09-19T01:28:38Z

Crogers: /* Multi-page files */

2018-09-27T20:34:45Z

‎Multi-page files

Crogers: /* Audio files */

2018-09-27T20:27:52Z

‎Audio files

Crogers: /* Image files */

2018-09-27T20:26:51Z

‎Image files

Sallain at 01:00, 5 March 2016

2016-03-05T01:00:30Z

Dan: minor tweak to page title; breadcrumb

2014-08-12T23:52:35Z

minor tweak to page title; breadcrumb

Dan: migrating qubit content; adding edits and updates to make it relevant to 2x

2014-07-11T21:44:09Z

migrating qubit content; adding edits and updates to make it relevant to 2x

New page

[[Main Page]] > [[Development]] > [[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
*If master digital object is open, clicking the browser's back button returns the user to the information object show screen
*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
*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 two pages
*User can page through pages in reference display copy
*Clicking on reference display copy opens master digital object in separate program (e.g., Adobe pdf reader)

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

[[Category:Development documentation]]

__NOTOC__

← Older revision		Revision as of 01:35, 19 September 2020
Line 87:		Line 87:
	* 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 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.").		* 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)

← Older revision		Revision as of 23:52, 12 August 2014
Line 1:		Line 1:
−	[[Main Page]] > [[Development]] > [[Development/Functional testing]] > Digital object tests	+	{{#pagetitle: Digital object tests }}
		+	[[Main Page]] > [[Development]] > [[Development/Functional testing]] > Development/Functional testing/Digital object tests

@@ Line 72: / Line 72: @@
 *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
 [[Category:Development documentation]]
 __NOTOC__

@@ Line 41: / Line 41: @@
 *User can upload multi-page files
 *All pages in the multi-page file are uploaded
-*Reference display copy shows first two pages
+*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 separate program (e.g., Adobe pdf reader)
+*Clicking on reference display copy opens master digital object in a new window
 == Editing digital object ==

@@ Line 33: / Line 33: @@
 == Audio files ==
-*Clicking "play" in the reference display copy plays the audio file
+*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")

@@ Line 21: / Line 21: @@
 == 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

@@ Line 3: / Line 3: @@
-=== General behaviour ===
+== 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
@@ Line 14: / Line 14: @@
 *Digital objects can be located via digital object browse page
-=== Text files ===
+== 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 ===
+== 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
 *If master digital object is open, clicking the browser's back button returns the user to the information object show screen
@@ Line 25: / Line 25: @@
 *Unauthenticated users and users without view master permissions cannot open and download master digital object
-=== Video files ===
+== Video files ==
 *Clicking "play" in the reference display copy plays the video
 *Associated audio streams are also played
@@ Line 33: / Line 33: @@
 *Unauthenticated users and users without view master permissions cannot open and download master digital object
-=== Audio files ===
+== Audio files ==
 *Clicking "play" in the reference display copy plays the audio file
 *Left-clicking "download audio" opens up the master digital object (depends on browser support)
@@ Line 39: / Line 39: @@
 *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 ===
+== Multi-page files ==
 *User can upload multi-page files
 *All pages in the multi-page file are uploaded
@@ Line 46: / Line 46: @@
 *Clicking on reference display copy opens master digital object in separate program (e.g., Adobe pdf reader)
-=== Editing digital object ===
+== 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
@@ Line 57: / Line 57: @@
 **Clicking Confirm opens the information object show screen and digital object is deleted
-=== Multi-file upload ===
+== 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