Skip to end of metadata
Go to start of metadata

Requirements

04.SOCIALNET.R1 RS3.4 Social networking (or Collaboration) tools are applications within the CMS system.
04.SOCIALNET.R2 RS3.4 The following social networking tools will be supported during RS Stage 3:
-          Wikis
-          Blogs
-          Discussions
04.SOCIALNET.R3 RS3.4 When posts (contributions) are made within a social networking tool, the information should be stored in the RDF store if that information enriches the store of cultural heritage data and information stored there.
04.SOCIALNET.R4 RS3.4 During RS Stage 3 when scholars are contributing to a general discussion, they should have the opportunity of saving the whole blog, discussion or wiki as an annotation with the appropriate associations or relationships in the RDF store
04.SOCIALNET.R5 RS3.4 The social networking tools will be integrated with the Search engine and each team member will be able to search in all blogs, wikis and discussion forums
04.SOCIALNET.R6 RS3.4 The social networking tools will be integrated with the ResearchSpace toolbar  - providing navigation application launch capability
04.SOCIALNET.R7 RS3.4 The social networking tools will be integrated with the RS Data Basket – a mechanism for managing data to and from the social networking tools.
04.SOCIALNET.R8 RS3.4 The social networking tools will be integrated with the Research Tools – which are launched from the CMS environment and which interface with the CMS environment through the data basket.

Use Cases not developed in RS3.2

04.SNUC04: Edit Comment

Preconditions:

  04.SNUC04.R1 There is an existing comment, which to be edited.

 

Constraints:

  04.SNUC04.R2 Only the user who created the comment could edit it.

 

Initiating operation/ button: Edit

GUI:

  • Forum/ Topic/ Comment/ Edit

Description:

  04.SNUC04.R3 When the user selects Edit button the comment becomes editable and the user could edit the text and links into the comment.
  04.SNUC04.R4 If a link to data object or data object statement is deleted, and the discussion is from type AP discussion then the information on Linked Records Tab should be updated (See [UC View Linked Records|../../../../../../../../../../display/ResearchSpace/Annotation+Spec#AnnotationSpec-06.DAUC07%3AViewLinkedRecords||\||])
  04.SNUC04.R5 After the user finishes editing the comment, he has to save changes.

Post-Conditions

  04.SSUC04.R6 The comment is saved

04.SNUC05: Delete Comment

Preconditions:

  04.SNUC05.R1 There is an existing comment, which to be deleted.

 

Constraints:

  04.SNUC05.R2 Only the user who created the comment, or the project administrator,  could delete it.
  04.SNUC05.R3
Only a comment to which there are no replies could be deleted.

 

Initiating operation/ button: Delete

GUI:

Description:

  04.SNUC04.R4 When the user selects Delete button the comment is permanently deleted from the discussion.
  04.SNUC04.R5 If a link to data object or data object statement is deleted and the discussion is from type AP discussion, then should be updated the information in Linked Records tab, for the respective records (see [Linked Records|../../../../../../../../../../display/ResearchSpace/Annotation+Spec#AnnotationSpec-06.DAUC07%3AViewLinkedRecords||\||])

Post-Conditions

04.SNUC12: Add Disposition

Preconditions:

  04.SNUC12.R1 This UC extends use case 04.SSUC03: Reply Comment and could not be executed without it to be started.

 

Constraints:

Initiating operation/ button: Add Disposition

GUI:

Description:

  04.SNUC12.R2 With Add Disposition functionality, the user flags his comment/reply as:
(C) - Comment
(?) - Question
(A) - Advice
(Y) - Agree (or icon for thumb up)
(N) - Disagree (or icon for thumb down)
  04.SNUC12.R3 When the user selects Add Disposition button, a list with values opens where the user could select his agreement, disagreement, etc. with the comment he is replying to.
  04.SNUC12.R4
If no disposition is explicitly selected then the reply is flagged by default as Comment. 
  04.SNUC12.R5 The disposition flags are displayed in front of each comment.

Post-Conditions

  04.SNUC12.R6 A disposition is successfully inserted into the comment.

04.SNUC13: View/ Sort Discussions

Preconditions:

Constraints:

  04.SNUC13.R1 A user could view only general discussions to which he has access.
  04.SNUC13.R2
The access rights on item discussions could not be managed separately and inherit the access rights on the object records

Initiating operation/ button:

GUI:

  • For general discussions*:* Project Dashboard/ Forum/ Discussions
  • For item discussions: Object Record Details/tab Discussions
  • For document discussions: Document Details/ tab Discussions

Description:

  04.SNUC13.R3 For each discussion will be displayed the following items in the list with discussions:
  • Discussion name - the column will display the Link to the discussion - If the link to discussion is selected then the discussion is opened with all its posts.
  • Annotation point - the column will display the Link to the Annotation point (URI) for which the discussion is started – If the link is selected then the user is positioned to selected node on the Object Record area. This field could be empty for general discussions.
  • Researcher – the name of the user who has started the discussion,
  • Date: Time/ Researcher – the date and time of the last post in the discussion and the name of the researcher who last commented on the discussion
  • Number posts per each discussion |
      04.SNUC13.R4 In Project Dashboard/ Forum/ Discussions are displayed all general discussions plus the promoted item discussions. (TBD: See UC: Promote Discussion - where the administrator could promote an item discussion as general - then it becomes visible in the list with general discussions). The item discussions are displayed with different icon than the general discussions.
      04.SNUC12.R5
    In Object Record Details/ tab Discussions are displayed all discussions started for the selected annotation point.
  • If the user selects the root then will be visible all discussions started for the object record and all its annotation points
  • If the user selects an annotation point then he would be able to see all discussions started only for this annotation point. |
      04.SNUC12.R6 By default discussions are sorted by Date: Time of last post, thus the recent discussions are always on the top.
      04.SNUC12.R7 The discussions could be sorted in ascending/ descending order by different criteria by clicking on the respective column name.

    For example if the user selects once the column Researcher - the discussions will be sorted alphabetically in ascending order by researcher name. If the user selects the same column twice the discussions will be sorted alphabetically in descending order by researcher name.

Use Cases RS3.5

The use case diagram below represents the functionality that should be developed in RS in place of the existing functionality for discussions in Nuxeo. In iteration RS3.2, when social networking was planned for development, it was supposed that for general discussions will be reused the existing Nuxeo functionality. After RS UI redesign in RS3.4 this functionality has been decided to be redeveloped.

04.SNUC14: Start New Discussion

R1 Each user could start a new general discussion from Forum tab
R2 When the user clicks on Start new discussion, a window opens where the user enters:
  • Discussion title – the field is empty and it is mandatory the user to fill in the title of the discussion
  • Comment - the user fills in his comments on the discussion topic. In the comments field the user except formatting functionality, has also the possibility to insert links to Annotation points, to external web pages, to documents and images, etc. The field is optional.
  • Categories – this is predefined list with categories, from which the user could select and assign to the new discussion
R3 For each discussion, when created is kept additional information about:
  • Date of creation – date and time when discussion is started
  • User who created it – user name of the user who started the discussion
  • Discussion type - Each new discussion started from the Forum tab is flagged as general discussion (different from discussions started in image annotation or data annotation tools).
  • Last modified date – the date and time when the last comment on discussion has been made
  • Last Contributor – user name of the person who last commented on the discussion
  • Number of replies to the discussion


04.SNUC15: Open Discussion

R1 In the Forum tab are visible all discussions started in the RS – the discussions started from all possible tools - image annotation tool, data annotation tool and general discussions
R2 The discussions from different tools are flagged differently, so the users could recognize them visually
R3 The discussions are organized in pages, with the latest modified discussions on the top.
R4 For each discussion in the Forum tab is visible:
  • Discussion title
  • Last modified date
  • Last Contributor
  • Number of replies
R5 If a user clicks on the discussion name the discussion is opened in the Forum tab with all its comments and the user could review it.
R6 For each discussion generated from data annotation or image annotation tools, when opened is provided link to the discussion in the respective tool. The user could select the link and open the discussion together with the object it is annotating in the tool for more detailed review.

04. SNUC16: Reply

R1 When the user opens a discussion he could post his reply to it.
R2 Only one level of replies is supported – this means that user could reply only to the top level comment, and cannot reply to other users replies.
R3 When user saves his reply on a discussion, then the Last modified date and Last contributor metadata are updated. Also the replies counter is increased with 1.

04. SNUC17: Sort/ Filter discussions

R1 The discussions in the Forum tab are sorted by default by Last Modified date
R2 The user could sort discussions by each one of the following criteria, both ascending and descending:
  • Discussion title
  • Last Modified date
  • Last Contributor
  • Number of replies
R3 The user could filter discussions in the Forum tab, using the following criteria:
  • Tool – the tool of creation of the discussion (image annotation, data annotation, forum)
  • Author – the author of the discussion
  • Date from: Date to – beginning and end period of date of creation of discussion
  • Keywords – search by free text in discussions
  • Categories – filter by categories
R4 After user enters the filtering criteria, the system displays only the items in the data basket, which satisfy the criteria
R5 The user could filter by more than one criteria at the same time and to sort the result.
R6 The user should be able to clear the filtering criteria, if he wants to browse all discussions again.
Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.