View Source


h1. Data basket Use case diagram

The following UCs has been identified based on the provided user requirements specification for data basket (see [|]   and workshop in BM in 06.07.2012, where additional clarifications has been made.

!Data Basket v2.png|border=1!

{color:#ff00ff}Jana: Sort is missing. List is missing. DBUC12 - obsolete. DBUC11 - for 3.6{color}

h3. 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. \\
* {color:#000000}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.{color}
* {color:#000000}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.{color}
* {color:#000000}The title could be updated by the user{color} |
| 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. \\
* {color:#0000ff}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).{color} |
| R14 | {color:#0000ff}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.{color} \\
* {color:#0000ff}If an item already exists in the data basket, and the user tries to add it for second time,{color} {color:#0000ff}then{color} {color:#0000ff}Edit Details{color} {color:#0000ff}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'{color}\* {color:#0000ff}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.{color} |
| .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.{color:#000000} 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\!){color}
* 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
* {color:#0000ff}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.{color}
* {color:#0000ff}Data Date - the date in which the original item is created. To be supported only for image annotations, data annotations and forums.{color}
* {color:#0000ff}Preview - preview is supported for data objects, images, data fields ({color}{color:#ff0000}Vlado to confirm?{color}{color:#0000ff}). For web links -{color} {color:#0000ff}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.{color} |
| {color:#0000ff}R16{color}\\ | {color:#0000ff}The following rules should be observed for URL field:{color}  \\
* {color:#0000ff}For RS (internal) items, display fixed text "ResearchSpace item"{color}
* {color:#0000ff}For Text, display nothing.{color}
* {color:#0000ff}For Web Link, display its shortened URL.{color} {color:#0000ff}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){color} |
| 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. {color:#0000ff}A rich text editor is used for notes field.{color} |
| R20 \\ | As many tags as wanted could be added to an item  {color:#0000ff} ({color}(?) {color:#0000ff} All tags-related stuff for 3.6?{color}{color:#0000ff}){color}\\
* {color:#0000ff}Tags should use all existing thesauri, plus a specific Tags thesaurus, which is shared per-project{color}
* 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
* {color:#0000ff}A new tag is always added to the  project Tags thesaurus{color}
* {color:#0000ff}Per data basket item are visible only the tags which are assigned to this item, not all existing tags{color} |
| {color:#0000ff}R21{color}\\ | {color:#0000ff}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.{color}\\ |

h3. 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 | {color:#0000ff}The name of the inserted link is the title of the selected data basket item.{color} 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) \\ |

h3. 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
* {color:#0000ff}Link to web link opens the respective web page into a new window{color} |
| 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. |

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

| R1 | The user should be able to edit {color:#0000ff}title{color}, 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.  \\ |

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

| R1 | Each data basket item could be deleted by the user |
| R2 | The user selects {color:#0000ff}button Delete from arrow button next to an item{color}. |
| 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. |

h3. 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) \\ |

h3. 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. T{color:#0000ff}here 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.{color} |
| 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. |

h3. 20.DBUC13: Sort Items in Data Basket

h3. 20.DBUC14: List Items in Data Basket

(?)  Pagination?

h1. *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?

h1. For future iterations

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

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

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

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

h3. *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)