View Source

{toc}


h2. {anchor:01} 01 View Object Record in detail the Annotations tab

*Description*
The user reviews in detail the Annotations tab - [Data layer|RS Glossary#Data Annotation terms], [Annotation pane|RS Glossary#Data Annotation terms] and Related Content.

*Preconditions*
The user is logged in the Nuxeo DM system. Semantic Search [Test 05 Search#04] or Full Text Search [Test 05 Search#02] has been performed, an object record is successfully found and selected for review - from a Data Annotation (in Tools tab), Data Basket, Forum, just browsing object records, etc. Annotations tab is opened and the annotations page is displayed for review.

*Constraints*
Only MO will be displayed for review and annotation.
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user scrolls into the page and visually inspects the [Annotations sub-tab|RS Glossary#Data Annotation terms] | - the [Data Layer|RS Glossary#Data Annotation terms] of the MO:
-- displays all the nodes of the object in their default collapsed state
-- the user is able to manually collapse/expand nodes
-- does not have any [AP|RS Glossary#Data Annotation terms] (annotation point) highlighted
-- displays the [APs without-object|RS Glossary#Data Annotation terms] in bold font
-- displays the 3 types of APs with-object in:
--- the [thesauri APs|RS Glossary#Data Annotation terms] (e.g. "coin", "gold" ) - highlighted
--- the [literal APs|RS Glossary#Data Annotation terms] \- not highlighted
--- the [compound-object APs|RS Glossary#Data Annotation terms] (e.g. "Height: 32 cm" ) - not highlighted
-- displays the action button [Annotation indicator (pencil)|RS Glossary#Data Annotation terms] during mouse-over a AP without-object
-- displays the action buttons [Add to data basket|RS Glossary#Data Annotation terms] and Annotation indicator (pencil) during mouse-over an AP with-object
-- if there are any annotations created for a particular AP the annotation indicator (red symbol A) is displayed next to:
--- the AP
--- the AP without-object that contains this AP
--- [the root BM Object|RS Glossary#Data Annotation terms]
-- if A is displayed next to an AP without-object it means either one of three things:
--- only an AP with-object contained in the AP without-object has an annotation
--- only the AP without-object has an annotation
--- both APs has annotations
- the [Annotation pane|RS Glossary#Data Annotation terms] displays:
-- collapsible Filter option
-- collapsible Sort option
-- button "Add annotation"
-- a list of all the existing annotations for this object record
-- a button "Go to data field" is NOT displayed
- the "Related Content" field (to the right in Annotations tab) is enabled to easily select the most popular images and documents
- the [Navigation pane|RS Glossary#Data Annotation terms] is in its collapsed state | |
*Post conditions*
Object record is displayed successfully and Annotations tab is displayed properly


h2. {anchor:02} 02 View annotations on Museum object on root level

*Description*
The user reviews all annotations for all APs.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#01] has been performed, and a red 'A' is displayed next to each AP that has annotations (in order to create an annotation see [Test 06 Data Annotation#04] and [Test 06 Data Annotation#05]).

*Constraints*
The user must have at least "Write" rights to add comments on a annotation (not in scope for this iteration). Versions of APs with status "Deleted" from the current project are visible only for the RS and Project Administrators (not in scope for this iteration).
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user expands the [Navigation pane|RS Glossary#Data Annotation terms] and selects one of the sections in the drop-down list | The [Annotations tab|RS Glossary#Data Annotation terms] is automatically scrolled down to display that particular [Data Layer|RS Glossary#Data Annotation terms] section at the top of the browser | |
| e.g.1 | The user expands the Navigation pane and selects the section "Material" in the drop-down list (if present for the chosen MO) | The Annotations tab is automatically scrolled and displays the section "Material" at the top of the browser | |
| 2 | The user reviews in details the [Annotation pane|RS Glossary#Data Annotation terms] in Annotations tab. | - In the Annotation pane all available annotations for all APs of the object record are listed.
- The button Add annotation is active - pressing it allows for creating an annotation on [root level|RS Glossary#Data Annotation terms] (not associated with any particular AP, but with the entire object)
- For each annotation the following is visualized:
-- Title of annotation
-- Creator
-- Date and Time
-- Reffered value
-- Suggested value - only if suggested value was given during creation of the annotation
-- Description of annotation - free text provided by the user during creation of the annotation
-- Tags
-- [Version (V) or Comment (C) indicator|RS Glossary#Data Annotation terms]
-- [Reply counter|RS Glossary#Data Annotation terms] button (balloon with a number of replies)
-- [Action button Down Arrow|RS Glossary#Data Annotation terms] to expand to the following options:
--- Reply
--- Post to forum
--- Add to data basket
--- Copy link (not in scope for this iteration) | |
*Post conditions*
All existing annotations for all APs are displayed.
The Reply counter button inside any of the annotations is enabled.
An annotation for a data field could be reviewed or a new one started.

h2. {anchor:03} 03 View annotations on AP

*Description*
The user reviews all annotations for one AP.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#01] has been performed, and a red 'A' is displayed next to each AP that has annotations (in order to create an annotation see [Test 06 Data Annotation#04] and [Test 06 Data Annotation#04]).

*Constraints*
The user must have at least "Write" rights to add comments on a annotation (not in scope for this iteration). Versions of APs with status "Deleted" from the current project are visible only for the RS and Project Administrators (not in scope for this iteration).
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user performs a mouse-over an "AP with-object" (could be thesauri, literal, or compound-object AP) that has annotations (has the symbol A) and selects the appearing [Annotation indicator (pencil)|RS Glossary#Data Annotation terms] next to the AP | - Only the annotations for this AP are listed in the Annotations pane.
- The button "Go to data field" is displayed
- The AP is highlighted
- For each annotation the following is visualized:
-- Title of annotation
-- Creator
-- Date and Time
-- Reffered value
-- Suggested value - only if suggested value was given during creation of the annotation
-- Description of annotation - free text provided by the user during creation of the annotation
-- Tags
-- [Version (V) or Comment (C) indicator|RS Glossary#Data Annotation terms] button - clicking on the version indicator highlights the Title, Referred, and Suggested values in red
-- [Reply counter button|RS Glossary#Data Annotation terms] \- displays 0 for annotations that have no replies and the correct number of replies for an annotation that has replies
-- The default state of the reply panel is collapsed -- the reply boxes are not displayed
-- [Action button Down Arrow|RS Glossary#Data Annotation terms] to expand to the following options
--- Reply
--- Post to forum
--- Add to data basket
--- Copy link (not in scope for this iteration)
- The user can read and reply to any of the existing AP annotations or can start a new one (by clicking the button "Add annotation") | |
| 2 | The user performs a mouse-over an "AP without-object" that has annotations (has the symbol A) and selects the appearing annotation indicator (pencil) next to the AP | - The Annotations pane should list all the annotations created specifically for that AP without-object and all the annotations created for all the APs with-object that belong to that AP without-object .
- The user can read and reply to any of the existing AP annotations or can start a new one (by clicking the button "Add annotation"). | |
*Post conditions*
All annotations linked to an AP are accessible from the Annotations tab
A new annotation for the AP could be started using the "Add annotation" button.


h2. {anchor:04} 04 Create new annotation for literal AP with proposing new suggested value

*Description*
The user proposes a new suggested value for a version.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#03] been performed - the "Annotations" tab is opened.
e.g. MO CEM312643 with a literal AP=”The British Museum” that belongs to the AP without-object = “Current keeper”

*Constraints*
New values could be proposed only for [literal|RS Glossary#Data Annotation terms] or [thesauri objects|RS Glossary#Data Annotation terms]. New values for compound objects (example Exhibitions) cannot be proposed.
| *№* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user selects an [Annotation indicator (pencil)|RS Glossary#Data Annotation terms] next to a literal AP from the data layer. | - The Add annotation button in the [Annotations pane|RS Glossary#Data Annotation terms] is activated.
- The AP is highlighted - the background of the AP is grey. | |
| e.g.1 | The user selects a annotation indicator (pencil) next to a literal AP “The British Museum” from the data layer. | - The Add annotation button in the Annotations pane is activated.
- The AP "The British Museum" is highlighted | |
| 2 | In the [Annotations tab|RS Glossary#Data Annotation terms] the user scrolls down to the end of the [Data Layer|RS Glossary#Data Annotation terms] (so that the highlighted AP goes off screen) and click the "Go to data field" button in the Annotations pane | The highlighted AP is in focus | |
| 3 | The user clicks the Add annotation button | The "New annotation" pop-up creation form is opened | |
| 4.1 | The user fills in the creation form (from top to bottom):
# Edit the Title
# Choose a Referred value from the drop down box
# Choose an Object disposition Justify/Criticise/None (radio buttons next to the Referred value)
# Type a new Suggested value
# Type text describing what the post is about. # Add tags in the tags auto-complete edit box | All necessary data is inputted:
# the Title is editable -- free text can be inputted
# the Referred value can be selected from the drop down list of values. The drop down list contains the original AP value and the values that have been proposed in previous annotations for that AP 
# The default Object disposition is None. Only one Object disposition option can be checked.
# the Suggested value box is editable -- the user has inputted some value
# the description box is editable
# a Tag can be selected from the drop-down suggestions or a new free text tag can be added (see [Test 04 Tags#01], [Test 04 Tags#02], [Test 04 Tags#03]) | |
| 4.2\\ | The user clicks the Save button. | The created annoatation is displayed. \\
The AP displays the symbol A next to it. \\
The button version indicator displays the symbol V. | Annotation displayed correctly on the data page, but not updated in the Tools/Data Annotation/History Tab. Instead the annotation appears correctly on the Dashboard history.\\
{jira:RS-1706} \\ |
| {color:#000000}5.1{color} | {color:#000000}The user does not fill the creation form and click the Save button{color} | {color:#000000}Empty annotation is not created{color} | |
| 5.2 | The user does not save the new proposed value and cancels the entry. | The created annoattion form is automatically deleted. | |
*Post conditions*
An annotation is created and is displayed in the Annotations pane.
The new suggested value is successfully saved and additional metadata is associated.
The AP displays the symbol A next to it.
The button version indicator displays the symbol V.


h2. {anchor:05} 05 Create new annotation without proposing new suggested value

*Description*
The user comment the AP.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#03] been performed - the [Annotations tab|RS Glossary#Data Annotation terms] is opened and displays all existing AP annotations.

*Constraints*
None
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user selects an annotation indicator (pencil) next to:
- an [AP without-object|RS Glossary#Data Annotation terms]
- an AP with-object
-- a [literal AP|RS Glossary#Data Annotation terms]
-- a [thesauri AP|RS Glossary#Data Annotation terms]
-- a [compound-object AP|RS Glossary#Data Annotation terms] | The Add annotation button in the [Annotations pane|RS Glossary#Data Annotation terms] is activated. \\
The AP is highlighted - the background of the AP is grey. | |
| 2 | The user clicks the Add annotation button | The "New annotation" pop-up creation form is opened | |
| 3.1 | The user inspects the pop-up for:
- AP without-object
- thesauri AP
- compound-object AP | - the Title is editable - free text can be inputted
- the Referred value box is locked - nothing can be inputted
- the Suggested value box is locked - nothing can be inputted
- The default Object disposition is None. Only one Object disposition option can be checked.
- the description box is editable
- a tag can be selected from the drop-down suggestions or a new free text tag can be added (see [Test 04 Tags#01], [Test 04 Tags#02], [Test 04 Tags#03]) | |
| 3.2 | The user inspects the pop-up for the literal AP and does not input new suggested value | - Visual inspection:
-- the Title is editable - free text can be inputted
-- the Referred value can be chosen from a drop-down with suggestions
-- the Suggested value box is editable - free text can be inputted
-- The default Object disposition is None. Only one Object disposition option can be checked.
-- the description box is editable
-- a tag can be selected from the drop-down suggestions or a new free text tag can be added (see [Test 04 Tags#01], [Test 04 Tags#02], [Test 04 Tags#03])
- A new reffered and suggested values are not inputted | |
| 4.1 | The user inputs some decription and clicks the Save button. | The created annoatation is displayed. \\
The AP displays the symbol A next to it. \\
The button version indicator displays the symbol C. | |
| 4.2 | The user does not fill the creation form and clicks the Save button | Empty annotation is not created | |
*Post conditions*
An annotation is created and is displayed in the Annotations pane.
The AP displays the symbol A next to it.
The button version indicator displays the symbol C.


h2. {anchor:06} 06 Reply to existing annotations

*Description*
The user proposes a new value for an existing annotation.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#04] or [Test 06 Data Annotation#05] have been performed -- an annotation is created and displayed in the [Annotation pane|RS Glossary#Data Annotation terms].

*Constraints*
The user must have at least "Write" rights to add comments on a annotation.
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | In the displayed annotation the user selects the [Action button Down Arrow|RS Glossary#Data Annotation terms] and selects the Reply option | The reply form is displayed with a mandatory field - annotation description. | |
| 2 | The user fills in the reply form - types text | All necessary data is inputted. | |
| 3 | The user clicks the Save button. | The value in [Reply counter|RS Glossary#Data Annotation terms] button is increased by 1. {color:#000000}Reply is displayed in a separate box inside the annotation that shows:{color}\- Date and Time
- Creator
- Description | |
| 4 | The user clicks the Reply counter button | The reply box is collapsed - not visible | |
*Post conditions*
A new reply is created successfully


h2. {anchor:07} 07 Sort annotations

*Description*
The user reviews annoatations and sorts them.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#02] \- a list of all the annotations for the object is displayed.
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user clicks the Sort button in the [Annotation pane|RS Glossary#Data Annotation terms] | The sort screen opens. | |
| 3 | The user selects to sort in ascending/descending order by creation date or last post date by clicking on the respective radio button. | The sorting by date is selected. | |
| 4.1 | The user clicks the Sort button. | The annotations are sorted based on the selected criteria. | |
| 4.2 | The user clicks the Cancel Button. | The sort screen closes. | |
*Post conditions*
The annotations are sorted correctly, based on the selected criteria.


h2. {anchor:08} 08 Filter annotations

*Description*
The user reviews annoatations and filters them.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#02] \- a list of all the annotations for the object is displayed.
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user clicks the Filter button in the Annotation pane. | The filter screen opens. | |
| 3 | The user selects and inputs several (one or more) filtering criteria:
- author
- date (from and/or to)
- keyword
- tags (see [Test 04 Tags#07]) | Filtering by different criteria is selected. | |
| 4.1 | The user clicks the Filter button. | The annotations are filtered based on the selected criteria. | |
| 4.2 | The user clicks the Reset Filters button | Filter form is empty. | |
| 4.3 | The user clicks the Cancel Button. | The filter screen closes. | |
*Post conditions*
All annotations that correspond to the filtering criteria are found, combined, and displayed.


h2. {anchor:09} 09 View Relations

*Description*
The user reviews existing relations (thumbnails) and adds a new relation.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#01] has been performed and an object record is successfully displayed.

*Constraints*
None
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user navigates to and opens the Relations tab. | In Relations tab all existing thumbnails relations to all images, documents linked to the object record are displayed. | |
| 2 | The user adds a new relation by clicking the "Add New Relation" button on the Relations tab and filling in the necessary data, and saves. | The new relation is added and the Relations tab is open to review (not in scope for this iteration). | |
*Post conditions*
Thumbnails (for an images) and liks to all (associated to the object record) content are displayed in the Relations tab.


h2. {anchor:10} 10 View Object Details

*Description*
The user reviews the Object Details.

*Preconditions*
The user is logged in the Nuxeo DM system.
[Test 06 Data Annotation#01] has been performed and an object record is successfully displayed.

*Constraints*
None
| *N* | *Performed action* | *Expected result* | *Tester notes* |
| 1 | The user navigates to and opens the Object Details tab. | The Object Details tab displays:
- The object image
- a section "Related Annotations and Forum Posts" that lists the annotations that contain links to that MO. If there are no annotations or posts it is indicated by an appropriate text.
- the following detail headers (if any of the headers are empty they are not displayed):
-- Data Set
-- Title
-- Type
-- Material
-- Creator
-- Rembrandt
-- Place - Created
-- Place - Found
-- Date - Created
-- Date - Found | |
*Post conditions*
All images and object details are displayed.