Difference between revisions of "Development/Functional testing/Actor object tests"

From AtoM wiki
(Create relationships: Adding mention of new reciprocal relationships functionality)
 
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Main Page]] > [[Development]] > [[Development/Functional testing]] > Actor object tests
+
{{#pagetitle: Authority record tests }}
 +
[[Main Page]] > [[Development]] > [[Development/Functional testing]] > Development/Functional testing/Authority record tests
  
  
 
== Create ==
 
== Create ==
Users should be able to create and save an actor object
+
Users should be able to create and save an authority record
*Clicking '''Add > Persons/organizations''' opens blank actor object edit screen
+
*Clicking '''Add > Authority record''' opens blank authority record edit screen
*Clicking on Add new in actor object show screen opens blank actor object edit screen
 
 
*Can enter data in all fields
 
*Can enter data in all fields
 
*Can enter multiple values in all multi-value fields
 
*Can enter multiple values in all multi-value fields
Line 12: Line 12:
  
 
== Update ==
 
== Update ==
User should be able to edit and save changes to an information object
+
User should be able to edit and save changes to an authority record
 
*Clicking Edit opens edit screen
 
*Clicking Edit opens edit screen
*Clicking title bar opens edit screen issue 2336
 
 
*Can edit data in all fields
 
*Can edit data in all fields
 
*Can delete values from multi-value fields and enter new values
 
*Can delete values from multi-value fields and enter new values
 
*Can delete values from auto-complete fields and select new values
 
*Can delete values from auto-complete fields and select new values
 
*Clicking Save closes edit screen and opens show screen
 
*Clicking Save closes edit screen and opens show screen
*All changes to saved information object are visible on show screen
+
*All changes to saved authority records are visible on show screen
 
*Clicking Cancel aborts the update and returns the user to the show screen
 
*Clicking Cancel aborts the update and returns the user to the show screen
*Related information objects show changed name and dates
+
* Any information objects related to this authority record now show any changed name and dates
*Related information objects show changed administrative history if the actor object is the creator (ISAD, DACS, and RAD only)
+
* Any information objects related to this authority record now show changed administrative history, if the authority record is the creator (ISAD, DACS, and RAD only)
  
 
== Relationships ==
 
== Relationships ==
  
 
=== Create relationships ===
 
=== Create relationships ===
User should be able to create relationships to other actors and to information objects
+
User should be able to create relationships to other authority records and to information objects
  
 
*Clicking "Add new" opens a dialog for creating a new relationship
 
*Clicking "Add new" opens a dialog for creating a new relationship
Line 34: Line 33:
 
*Can select a value from the autocomplete list
 
*Can select a value from the autocomplete list
 
*Can enter data in all dialogue fields
 
*Can enter data in all dialogue fields
*Bi-directional reciprocal relationships can be added - e.g. adding a familial relationship where Actor A has "Is the child of" added, will appear as "Is the parent of" in Actor B's record when saved (as of AtoM 2.1)
+
*Bi-directional reciprocal relationships can be added - e.g. adding a familial relationship where Person A has "Is the child of" added, will appear as "Is the parent of" in Person B's record when saved (as of AtoM 2.1)
 
*Clicking Submit closes the dialogue, and adds a new row to the appropriate relationship table
 
*Clicking Submit closes the dialogue, and adds a new row to the appropriate relationship table
 
*Clicking Cancel closes the dialogue without saving the dialog data
 
*Clicking Cancel closes the dialogue without saving the dialog data
*Clicking Save for the actor object saves all new relationships
+
*Clicking Save for the authority record saves all new relationships
*Clicking Cancel for the actor object discards any new relationships
+
*Clicking Cancel for the authority record discards any new relationships
  
 
=== View relationships ===
 
=== View relationships ===
 
User should be able to see all relationships and navigate to related objects
 
User should be able to see all relationships and navigate to related objects
  
*For related actor objects, Record shows the following:
+
*For related authority records, Record shows the following:
 
**Related entity authorized form of name as link
 
**Related entity authorized form of name as link
**Dates of existence of the related actor
+
**Dates of existence of the related authority record
**Identifier of the related actor (if it has an identifier)
+
**Identifier of the related authority record (if it has an identifier)
 
**Category of the relationship
 
**Category of the relationship
 
**Dates of the relationship
 
**Dates of the relationship
 
**Description of the relationship
 
**Description of the relationship
*Clicking on the related entity name name opens show screen for the related actor object
+
*Clicking on the related entity name name opens show screen for the related authority record
*Related actor object show screen shows the following
+
*Related authority record show screen shows the following
 
**Related entity authorized form of name as link
 
**Related entity authorized form of name as link
**Dates of existence of the related actor
+
**Dates of existence of the related authority record
**Identifier of the related actor (if it has an identifier)
+
**Identifier of the related authority record (if it has an identifier)
 
**Category of the relationship
 
**Category of the relationship
 
**Dates of the relationship
 
**Dates of the relationship
Line 63: Line 62:
 
**ISAD/DACS: In the related information object show screen, the authorized form of name, the dates of the relationship and the nature of the relationship appear in the Date(s) field of the information object; the authorized form of name is a link
 
**ISAD/DACS: In the related information object show screen, the authorized form of name, the dates of the relationship and the nature of the relationship appear in the Date(s) field of the information object; the authorized form of name is a link
 
**RAD/MODS/DC: In the related information object show screen, the authorized form of name, the dates, type and the place of the event appear in the Date(s) field of the information object
 
**RAD/MODS/DC: In the related information object show screen, the authorized form of name, the dates, type and the place of the event appear in the Date(s) field of the information object
*If actor is the creator of the related information object:
+
*If authority record is the creator of the related information object:
 
**ISAD/RAD/DACS: The authorized form of name, the dates of existence and the administrative history appear in the Name of creator field of the information object; the authorized form of name is a link
 
**ISAD/RAD/DACS: The authorized form of name, the dates of existence and the administrative history appear in the Name of creator field of the information object; the authorized form of name is a link
**The authorized form of name of the actor appears under "creators" in the information object's context menu box
+
**The authorized form of name of the authority record appears under "creators" in the information object's context menu box
 
*ISAD/DACS/RAD/MODS: In related information object, the authorized form of name appears as a name access point
 
*ISAD/DACS/RAD/MODS: In related information object, the authorized form of name appears as a name access point
*In related information object, clicking on the authorized form of name of the related actor opens the actor show screen
+
*In related information object, clicking on the authorized form of name of the related authority record opens the authority record show screen
 
 
'''Expected elements to be included (and position) is shown in the screenshots below:'''
 
 
 
[[Image:isad-creator-link.png|700px|center|thumb|ISAD template showing links to related actors. DACS will appear largely the same]]
 
 
 
[[Image:RAD-creator-link.png|700px|center|thumb|RAD template showing links to related actors]]
 
 
 
[[Image:DC-creator-link.png|700px|center|thumb|DC template showing links to related actors]]
 
 
 
[[Image:mods-creator-link.png|700px|center|thumb|MODS template showing links to related actors]]
 
  
 
=== Edit relationships ===
 
=== Edit relationships ===
Line 88: Line 77:
 
*Clicking Submit closes the dialog and updates the appropriate row in the relationship table
 
*Clicking Submit closes the dialog and updates the appropriate row in the relationship table
 
*Clicking Cancel closes the dialog and ignores any changes
 
*Clicking Cancel closes the dialog and ignores any changes
*Clicking Save for the actor object saves all changed relationships
+
*Clicking Save for the authority record saves all changed relationships
*Clicking Cancel for the actor object discards any changes to the relationships
+
*Clicking Cancel for the authority record discards any changes to the relationships
*Related information objects and actor objects show changed information
+
*Related information objects and authority records show changed information
  
 
== Translate ==
 
== Translate ==
User should be able to translate actor object from source language to another language
+
User should be able to translate authority record from source language to another language
*When editing an actor object in a language different from the source language, the original language values should appear above the appropriate fields
+
*When editing an authority record in a language different from the source language, the original language values should appear above the appropriate fields
 
*The following drop-down values should appear in the current language: entity type, category of the relationship, status of description, level of detail, language(s), script(s)
 
*The following drop-down values should appear in the current language: entity type, category of the relationship, status of description, level of detail, language(s), script(s)
 
*The saved record should show all translations
 
*The saved record should show all translations
  
 
== Delete ==
 
== Delete ==
Users should be able to delete data from actor objects and delete actor objects
+
Users should be able to delete data from authority records and delete authority records
 
*Can delete data from all fields
 
*Can delete data from all fields
 
*Saving record opens show screen with deleted data removed
 
*Saving record opens show screen with deleted data removed
 
*Clicking delete results in warning
 
*Clicking delete results in warning
 
*Clicking cancel aborts the delete process and returns the user to the show screen
 
*Clicking cancel aborts the delete process and returns the user to the show screen
*Clicking Confirm deletes the record and returns the user to the actor object list screen
+
*Clicking Confirm deletes the record and returns the user to the authority record list screen
*Associated actor records and information objects are not deleted
+
*Associated authority record and information objects are not deleted
 +
 
 +
== Access points ==
 +
 
 +
[https://www.accesstomemory.org/en/docs/2.5/user-manual/add-edit-content/authority-records/#add-access-points-to-your-authority-record authority record access points]
 +
 
 +
== Digital object upload ==
 +
 
 +
[https://www.accesstomemory.org/en/docs/2.5/user-manual/import-export/upload-digital-object/#link-to-authority authority record digital object upload]
  
 
[[Category:Development documentation]]
 
[[Category:Development documentation]]
  
 
__NOTOC__
 
__NOTOC__

Latest revision as of 17:08, 16 April 2019

Main Page > Development > Development/Functional testing > Development/Functional testing/Authority record tests

Create

Users should be able to create and save an authority record

  • Clicking Add > Authority record opens blank authority record edit screen
  • Can enter data in all fields
  • Can enter multiple values in all multi-value fields
  • Clicking Create closes edit screen and opens show screen
  • All changes to created record are visible on show screen

Update

User should be able to edit and save changes to an authority record

  • Clicking Edit opens edit screen
  • Can edit data in all fields
  • Can delete values from multi-value fields and enter new values
  • Can delete values from auto-complete fields and select new values
  • Clicking Save closes edit screen and opens show screen
  • All changes to saved authority records are visible on show screen
  • Clicking Cancel aborts the update and returns the user to the show screen
  • Any information objects related to this authority record now show any changed name and dates
  • Any information objects related to this authority record now show changed administrative history, if the authority record is the creator (ISAD, DACS, and RAD only)

Relationships

Create relationships

User should be able to create relationships to other authority records and to information objects

  • Clicking "Add new" opens a dialog for creating a new relationship
  • Dialogue opens with focus on first field ("Name of related entity" or "Title of related resource"), and an auto-complete list appears
  • Typing text in the autocomplete field narrows the options available to select
  • Can select a value from the autocomplete list
  • Can enter data in all dialogue fields
  • Bi-directional reciprocal relationships can be added - e.g. adding a familial relationship where Person A has "Is the child of" added, will appear as "Is the parent of" in Person B's record when saved (as of AtoM 2.1)
  • Clicking Submit closes the dialogue, and adds a new row to the appropriate relationship table
  • Clicking Cancel closes the dialogue without saving the dialog data
  • Clicking Save for the authority record saves all new relationships
  • Clicking Cancel for the authority record discards any new relationships

View relationships

User should be able to see all relationships and navigate to related objects

  • For related authority records, Record shows the following:
    • Related entity authorized form of name as link
    • Dates of existence of the related authority record
    • Identifier of the related authority record (if it has an identifier)
    • Category of the relationship
    • Dates of the relationship
    • Description of the relationship
  • Clicking on the related entity name name opens show screen for the related authority record
  • Related authority record show screen shows the following
    • Related entity authorized form of name as link
    • Dates of existence of the related authority record
    • Identifier of the related authority record (if it has an identifier)
    • Category of the relationship
    • Dates of the relationship
    • Description of the relationship
  • For related information objects, record shows title of related information object in context menu box (i.e. upper left-hand sidebar)
  • For related information objects, record shows type of relationship in context menu box (e.g. "Creator of")
  • Clicking on the related information object title opens show screen for the related information object
    • ISAD/DACS: In the related information object show screen, the authorized form of name, the dates of the relationship and the nature of the relationship appear in the Date(s) field of the information object; the authorized form of name is a link
    • RAD/MODS/DC: In the related information object show screen, the authorized form of name, the dates, type and the place of the event appear in the Date(s) field of the information object
  • If authority record is the creator of the related information object:
    • ISAD/RAD/DACS: The authorized form of name, the dates of existence and the administrative history appear in the Name of creator field of the information object; the authorized form of name is a link
    • The authorized form of name of the authority record appears under "creators" in the information object's context menu box
  • ISAD/DACS/RAD/MODS: In related information object, the authorized form of name appears as a name access point
  • In related information object, clicking on the authorized form of name of the related authority record opens the authority record show screen

Edit relationships

User should be able to edit existing relationships

  • Clicking the "pencil" icon in the relationship table opens a dialog populated with the appropriate relationship data
  • Focus should not automatically be given to the first field in the dialog (i.e. the autocomplete field of the "Title of related resource" should not pop down when the dialog is opened until the user places the cursor in the field)
  • Can select a new autocomplete values
  • Can edit all other fields in the dialog
  • Clicking Submit closes the dialog and updates the appropriate row in the relationship table
  • Clicking Cancel closes the dialog and ignores any changes
  • Clicking Save for the authority record saves all changed relationships
  • Clicking Cancel for the authority record discards any changes to the relationships
  • Related information objects and authority records show changed information

Translate

User should be able to translate authority record from source language to another language

  • When editing an authority record in a language different from the source language, the original language values should appear above the appropriate fields
  • The following drop-down values should appear in the current language: entity type, category of the relationship, status of description, level of detail, language(s), script(s)
  • The saved record should show all translations

Delete

Users should be able to delete data from authority records and delete authority records

  • Can delete data from all fields
  • Saving record opens show screen with deleted data removed
  • Clicking delete results in warning
  • Clicking cancel aborts the delete process and returns the user to the show screen
  • Clicking Confirm deletes the record and returns the user to the authority record list screen
  • Associated authority record and information objects are not deleted

Access points

authority record access points

Digital object upload

authority record digital object upload