Skip to end of metadata
Go to start of metadata

Data basket Use case diagram

The following UCs has been identified based on the provided user requirements specification for data basket (see https://confluence.ontotext.com/display/ResearchSpace/Data+Basket+Spec#DataBasketSpec-20120619Dominic)   and workshop in BM in 06.07.2012, where additional clarifications has been made.

Unable to render embedded object: File (Data Basket v2.png) not found.

Jana: Sort is missing. List is missing. DBUC12 - obsolete. DBUC11 - for 3.6

20.DBUC01: Add Item to Data Basket (RS3.5)

R1 The data basket is personal user store for selected data (bookmarks). Each user has its own data basket, which is empty in the beginning.
R3 Each item is kept in the data basket as link.
R4 The following items could be added to Data Basket
  • Image record
  • Image annotation 
  • Data object
  • Data field (  Relations as well?)
  • Data annotation
  • Search query (  Link to saved query as stated above or the query itself in serialized form?)
  • Forum 
  • Web link
  • Text 
    DO Notes: Technical we can probably described these in more generic terms. More tools will be added to researchspace and essentially we are talking about links. An image is essentially a link to an image that is resolved. When launching tools the tool should have a URL and allow parameters that load the particular item into it. We need to think how data as opposed to free text is represented and we need to think about how the databasket interacts with the tools so that it is not just a manual cut and paste tool. 
R5 Link to image record could be added to Data Basket from:
  • Search result (Future. We don't have search for images)
  • Image details
R6 Link to image annotation could be added to Data Basket from: 
  • Search result (Future. We don't have search for annotations)
  • Image annotation tool
  • Forum tab (RS3.6)
R7 Link to data object could be added to Data Basket from:
  • Search result - "Add to Data basket" button is active only from thumbnails view of the search result.
  • Object Details - "Add to data basket" button is active, next to buttons Export and Print
R8 Link to Data object literal could be added to Data Basket from:
  • Data annotation tool
  • from context menu. (  Where is this?)  DO - The context menu is the pull down. This MUST be next to each data item in the data annotation tool.
  • Lazily creates the Annotation Point (AP), creates its Title, uses its URI.
  • Invokes Databasket Item dialog, so the user can edit Tags and Note
R9 Link to Data annotation could be added to Data Basket from:
  • Search result (Future. We don't have search for annotations)
  • Data annotation tool
  • Forum tab (RS3.6) 
    DO Note - from the search screen would mean that when you selected a result you should be able to specify the contect in which you took the result link. Is it a serach, it is for data annotation... or another tool, or simply a reference to the image or artefact.
R10 Link to Search sentence could be added from:
  • Search tool  - "Add to data basket" button is active next to buttons Search, Export and Print
    D0 - There  is a save icon under the search sentence at the moment. Would this be used to save to the data basket - yes? MariaT: No, we will add  "Add to data basket" next to buttons Search, Export and Print.
R11 Link to forum discussion could be added from:
  • Forums tab (RS3.6)
R22 Link to Web link could be added from the Data basket/ "Add Web link" button.
When the user selects the button aDatabasket Item dialog is invoked,where the user could paste the web link, so the user can edit URL, Tags and Note. This is the only time URL is displayed in this dialog.When the URL is changed, *goes out to the web page to fetch the Title
  •     "Add Web Link" should be  exposed as a REST web link, so it can be made into a JS bookmark for the user to put in his browser
  • The title is editable
R12 Text could be pasted to Data Basket, after being copied from any source (forum/ discussion/ comment/ nuxeo documents/ external documents/ object records, etc.) or could be entered into the Notes field manually by user. Text is inserted into data basket from: Data basket/ "Add Text" button.
  • When the user selects the button a screen opens where he could paste or enter text into Notes field. The text is stored in rich text format.
  • If the user doesn't enter text in the Title field manually, then when he saves the data item, the Title field is created automatically and contains the first 40 chars from the Notes field. The title is in plain text format.
  • The title could be updated by the user
R13 When the user selects “Add to Data Basket” for each of the above items a default link name (title) to the item is created. The default link name could be changed by the user.
  • Only for search sentence and text items the title field is initially empty and the user should enter value in it (the system could not generate default title name automatically).
R14 When the user selects "Add to Data Basket" for any item a pop-up screen opens (Edit Details) with item's metadata as listed in R15. Only Notes, Tags and  default link name could be edited by the user.
  • If an item already exists in the data basket, and the user tries to add it for second time, then Edit Details pop-up screen opens and shows the existing item details, and the user could only edit Notes, Tags and Title. There is a message on the sreen -"This item already exists in your data basket'* For items of type web link, search sentence and text the system will not check for existence in the data basket and will always create new item.
.R15 The following metadata are kept for each item in the Data Basket, when created:
  • URL - see R16 below
  • Title - the link (title) to the original item. The item's title is used as a default value and copied to the bookmark title, but then the user can edit the bookmark title (an extra field in the data model!)
  • Type - the type of the original item (data object, image, data annotation, etc.) with specific icon
  • Notes - user notes to the data basket item (the field is empty with the creation of the bookmark, could be inserted free text by the user)
  • Tags - user defined tags (  For 3.6?)
  • Added by (Creator) – the person who created the item into the Data Basket 
  • Date (Creation date) – the date in which the item has been added to the Data basket
  • Data Author - The author of the original item. To be supported only for image annotations, data annotations and forums. Examine the item type, and fetch dcterms:creator and dcterms:created.
  • Data Date - the date in which the original item is created. To be supported only for image annotations, data annotations and forums.
  • Preview - preview is supported for data objects, images, data fields (Vlado to confirm?). For web links - can we use a web page preview server to fill out the image for Web Link? If we can the the preview should be supported for them also.
R16
 The following rules should be observed for URL field: 
  • For RS (internal) items, display fixed text "ResearchSpace item"
  • For Text, display nothing.
  • For Web Link, display its shortened URL. Shorten the Web Link using some URL shortening service (need an extra data field!). Show the short URL in the column, and the full URL in a tooltip (it usually includes useful info, eg a blog link is usually readable)
R17
For each item in the data basket, there will be provided different representation as link (icon, name, image) 
R18
When an item is added to the Data Basket is provided a possibility for the user to add notes and tags to the item. The fields are optional. 
R19
Notes field is free text field and the user could add any text explanation to the item he is creating. A rich text editor is used for notes field.
R20
As many tags as wanted could be added to an item   (  All tags-related stuff for 3.6?)
  • Tags should use all existing thesauri, plus a specific Tags thesaurus, which is shared per-project
  • Tags are shared per project - which means that there is provided auto completion functionality, and user could select any of the already existing tags in the project, or the create a new one
  • A new tag is always added to the  project Tags thesaurus
  • Per data basket item are visible only the tags which are assigned to this item, not all existing tags
R21
 When a new item is successfully added into the data basket, then the user stays on the same screen from which he invoked the action (Add to DataBasket) and the counter for the DataBakset Items on the screen is refreshed.

20.DBUC02: Insert Item (RS3.5)

R1 Each data basket item (link or text) could be inserted into text editor (TinyMCE), which means into:
  • Image annotation
  • Data annotation
  • Forum discussion
  • Wiki page  
  • Notes to other databasket items
  • Others
    DO Note: Again more generic - as this list will simply increase With regard to Forums: Item's can be placed in forum posts and this will be part of the forum specification. Embedding links into the forum should be done such that a report an indifiy them and pull them out. This is part of the
    this is part of the reporting element of researchspace and structured information should reportable on such that decisions regarding content for publishing can be made. (This may require some sort of underlying tagging system (rdfa perhaps)
R2 The name of the inserted link is the title of the selected data basket item. The other metadata like notes, creator, creation date, etc are just for personal information for the user in the data basket.
R5 The text is inserted just as text. No other metadata from the data basket are associated with it.
R6 To insert a data basket item for collaboration, the user must perform the following steps: 
  • select the button "Insert link from Data Basket" into the text editor, which opens the user personal Data Basket
  • search/ browse for item in the basket
  • double-click the item for insertion
R7 The link inserted in any collaboration environment, when selected should open the item into the tool it was created in (see R1/ DBUC03) 
R8
Information from the forum can be placed in the basket and deposited in other areas (ie. annotation panels)

20.DBUC03: Open link from Data Basket (RS3.5)

R1 When the user clicks on a link to data basket item, the item is opened into the tool it was created in, and is ready for working. 
  • Link to image annotation brings to the image annotation tool, with the respective annotation in focus
  • Link to data annotation brings to the data annotation tool, with the respective annotation in focus
  • Link to image brings to image details screen
  • Link to data object brings to data object details screen
  • Link to data field brings to data object details screen with the respective data field in focus
  • Link to general discussion brings to the forum tab with the respective discussion in focus (RS3.6)
  • Link to search opens search sentence tab, with search result listed
  • Link to web link opens the respective web page into a new window
R2 If changes are made into an item, which is kept as link in the data basket, the link in the data basket always opens the latest version of the item.

20.DBUC04: Edit notes/ tags (RS3.5)

R1 The user should be able to edit title, notes and tags to each item in his data basket, which means to delete existing notes and tags, or to update title, notes and add new tags.
R2 No other metadata of an item could be edited. 

20.DBUC06: Delete item from Data basket (RS3.5)

R1 Each data basket item could be deleted by the user
R2 The user selects button Delete from arrow button next to an item.
R3 When item is deleted from a Data basket, it is deleted with all its metadata and no history is kept for it.
R4 If an item is deleted from a data basket, it is not deleted from the collaboration tools it has been used in. There remains a valid link.

20.DBUC07: Empty Data basket (RS3.5)

R1 
The user could select "Delete all" button in the data basket 
R2 If the user selects “Delete all” then all items from the data basket are deleted. The system shows confirmation message “Are you sure you want to permanently delete all items in the Data Basket?” Yes/ No.
R3
The user should be able to select muliple items and bulk delete those or just delete one. (DO addition)

20.DBUC08: Filter items in data basket (RS3.5)

R1 All items in the Data basket are automatically sorted by date of creation.
R2 The user could filter items in data basket by the following criteria:
  • Type – this is the type of the item, the system provides a list with all available item types: Data Annotation, Image annotation, Search, Forums, Object Records, Images, Text, web link
  • Date of creation – this is the date of creation of the item in the data basket – the filter should provide Date from and Date to
  • Keywords – this is free text search, that provides the user the possibility to search in item Notes field
  • Tags – this is a list of all tags used in the data basket, and the user is able to select from them. There is tags panel in the data basket, where the user at any time could filter items, by clicking on one or more of the existing tags. Tags in the tags panel are sorted alphabetically.
R3 After user enters the filtering criteria, the system displays only the items in the data basket, which satisfy the criteria
R4 The user should be able to clear the filtering criteria, if he wants to browse all data basket items again.

20.DBUC13: Sort Items in Data Basket

20.DBUC14: List Items in Data Basket

 Pagination?

Search - The user should be able to search the data basket using meta data

 MariaT: Dominic, "DBUC08: Filter items in data basket" contains both keyword search and filtering by item type, tags.dates. It is created based on the functionality already developed for search/ filter data and image annotations, as proposed from BVA.  Please, advice search by what other metadata you expect in DataBasket?

For future iterations

20.DBUC11: Export data from Data Basket (RS?)

R1 The Data Basket items could be exported in any standard file formats - to pdf, to zotero.
R2 The user selects data basket items (all or some of them) and presses button Export. Then he selects the file format he wants to export them in and the location he wants to keep the exported data.
R3 The system generates a file with all exported data basket items, in the selected format and saves it in the selected location

Sort tags in the tags panel by popularity not for 3.5. TO be decided for which iteration?

  • Additional filed for each data basket item - Number of replies. The number could be next to the Type icon, for specific items:
    • object: number of Replies to all annotations about the object
    • field: number of Replies to annotations about that object field
    • data/image annotation: number of Replies to that annotation
    • image: ?
    • forum:?

Annotate - Should be able to annotate a databasket item from inside the data basket

This should have the same effect as if annotating from a tool and use the same OAC standard. I also think that you hsould be able to link two databasket items again using the OAC technique.

MariaT: Dominic, on the session that we had in London, we discussed that the user should be able to start discussion on one or group of data basket items. The discussion we be started as general discussion in the Forums tab. This is described in the "20.DBUC12.Start Discussion on Data basket item". Is this Annoatate functionality the same as the one in 20.DBUC12, or it is different?

External data - Should include external data resources and RDF

Note: Internally a basket item will link to the item with the appropriate tool. Externally the tool will launch within the web context or web site that the data was sourced. (see Korba tool for behaviour)

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

1 Comment

comments.show.hide

  1. Oct 15, 2012

    dominic.oldman

    A few questions and clarifications.

    1. Maria hasn’t filled in the sort functionality. Do we need to discuss this tomorrow?
    2. What is the technical approach to the data basket. How and where will it be saved and what is the schema? I think this is important that this is clarified and I have asked for this before.
    3. The data basket needs to operate between the tools and the forum, Can you confirm that we will be able to take items and place them between any tool or forum that has an appropriate editing area. (e.g. take an annotation and place it in another annotation).
    4. Please note the future requirements for reporting from the forum. Structured links need to be identifiable from the forum when reporting through them. I have a requirements that allows both unstructured text and structured text to be separated and reported on. This means that we should probably embed information about an item. For example, if you take an annotation into the databasket and then place it in a forum post the original creator and the data (ie. the metadata about the annotation should go with it). (I have noted Vladimir’s suggestion of using rdfa in future.
    5. Note that the context menu (the pull down with items that apply to the context) should be on the data items as per Hollie’s latest data annotation designs.
    6. Please keep in placeholders for items that won’t be implemented at this stage

    I have added some more information to the spec page and will copy this also.