Skip to end of metadata
Go to start of metadata

01 View Object Record in detail the Annotations tab

Description
The user reviews in detail the Annotations tab - Data layer, Annotation pane 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
  • the Data Layer 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 (annotation point) highlighted
    • displays the APs without-object in bold font
    • displays the 3 types of APs with-object in:
    • displays the action button Annotation indicator (pencil) during mouse-over a AP without-object
    • displays the action buttons Add to data basket 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:
    • 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 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 is in its collapsed state
  

Post conditions
Object record is displayed successfully and Annotations tab is displayed properly

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 and selects one of the sections in the drop-down list The Annotations tab is automatically scrolled down to display that particular Data Layer 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 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 (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
    • Reply counter button (balloon with a number of replies)
    • Action button Down Arrow 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.

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) 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 button - clicking on the version indicator highlights the Title, Referred, and Suggested values in red
    • Reply counter button - 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 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.

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 or thesauri objects. New values for compound objects (example Exhibitions) cannot be proposed.

№ Performed action Expected result Tester notes
1 The user selects an Annotation indicator (pencil) next to a literal AP from the data layer.
  • The Add annotation button in the Annotations pane 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 the user scrolls down to the end of the Data Layer (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):
  1. Edit the Title
  2. Choose a Referred value from the drop down box
  3. Choose an Object disposition Justify/Criticise/None (radio buttons next to the Referred value)
  4. Type a new Suggested value
  5. Type text describing what the post is about. # Add tags in the tags auto-complete edit box
 All necessary data is inputted:
  1. the Title is editable – free text can be inputted
  2. 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 
  3. The default Object disposition is None. Only one Object disposition option can be checked.
  4. the Suggested value box is editable – the user has inputted some value
  5. the description box is editable
  6. 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.
RS-1706
5.1 The user does not fill the creation form and click the Save button Empty annotation is not created  
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.

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 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: The Add annotation button in the Annotations pane 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.

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.

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 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 button is increased by 1. Reply is displayed in a separate box inside the annotation that shows:- 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

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

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: 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.

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.

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.

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

8 Comments

comments.show.hide

  1. Jan 16, 2012

    dominic.oldman

    These test cases will have to be amended in the light of the UI design which isn't based on Nuxeo tabbing.

    I'm not sure that these test really reflect the main principles of the component but in any event are quite hard to visualise. for example what does, 

    No. 1 The user selects a link (URI) to Annotation point (AP) from the data layer- actually mean?

    When the UI is uploaded you will see that the testing will be more like;

    Object View column

    1. By default the record displays the original owning institutions version or if the project has entered new versions the latest version of the project.

    2. The user can switch between the original version and the project version

    3.The user can navigate the object record by using the section navigator which allows the user to access different sections of the record, ot the field navigator which finds a specific field within a section.

    4. The section (or section containing the field) navigated to will be expanded.

    5. All sections can be manually expanded and collapsed. By default they are collapsed

    6. The annotation button next to each field can be clicked to start an annotation in the middle annotations column

    Annotation column

    1. When starting a annotation the user will be provided a choice of different annotations: general, value and link. The user can also select a previous annotation and initiate a new annotation from that.

    General Annotation

    2. The annotation widget should clearly indicate the field to wehich the annotation applies 

    3. The user selects the status - which is by default xxxxxxx

    4. The user write the annotation and posts it. The annotation appears in the annotation list. the user, or another user can create another general annotation of the selected annotation.

    5. The annotation can be found again by clicking on the field. The annotations related to it come into focus automatically.

    6. The user can find the annotation using the filters.

    7. The user can find the annotation using a text search

    Link Annotation

    etc etc

    1. Jan 18, 2012

      Vladimir Alexiev

      A UI design cannot add functionalities that are not there and not planned for an iteration.

      • "No. 1": means he searches for an object, then picks an AP from the data. If the spec doesn't describe this process, the spec needs to be fixed. The test cases shouldn't double as a spec, but only refer to the spec
      • There are no RS3.2 tasks planned to do UI changes to Data, nor is the Data mockup complete enough to enable task breakdown and estimation. Depending on the UI design, we may even have to throw away RForms, which is no mean feat
      • 2. "switch between the original version and the project version": Approval (and thus updating the Data layer) will come in the future, therefore such switching will also be in the future
      • 5. "clicking on the field... The annotations related to it come into focus automatically": I guess that means the Annotation frame has all annotations about the root MO, and clicking on the small button focuses on a particular annotation. I like this, but:
        • the UI mockup doesn't describe such behavior, and from the chat yesterday I understood that annotations are displayed per field only
        • Hollie pointed out the difficulty of aligning the two frames, i.e. focused Data item vs focused Annotation item (Data frame will often be long)

      The gist of my comment is: you wrote several nice things, but they should go to spec and UI design, not to test cases alone. I notified Hollie to take a look.

  2. Jan 18, 2012

    jana.parvanova

    We need to have the annotations GUI design clarified and freezed before we implement it or create test cases on it. I guess this would be done by the end of the week.

    1. Jan 18, 2012

      dominic.oldman

      Sure, just meant to be an example based on the current UI design.Its good if they are in a certain language to help Austin when he tests stuff.

      Thanks.

      Dominic

  3. May 02, 2012

    Anna Radeva

    Austin, maybe you have created your comments to Data annotation before resolving bug RS-625 https://jira.ontotext.com/browse/RS-625 . It is created and fixed today. Now you can check again scenarios you notated - should work now.

  4. May 03, 2012

    Anna Radeva

    Done. Button "Create" is renamed to "Save" in all cases, in which was included.

  5. Jul 04, 2012

    Anna Radeva

    Austin, I wrote a task after your notes from testing dated 04/07/2012.  See
    RS-866
    For your note about  filtering by category, I cannot reproduce your issue. Would you please describe in details the issue,  step by step and with what parameters are obtained.

  6. Mar 13, 2013

    austin.nevin

    At the moment on the BM server (http://test.researchspace.org:8080/nuxeo/view.html#)  no history is showing up in the Tools-Data Annotation/Search/Image annotation