View Source

{toc}

h2. 20120619 Dominic

Tasha told me that you would like a head start on the data basket utility.
Please find an expansion from the functional requirements document which I have left as draft.
The user cases should give you an indication of what is needed but just fire off questions as they come to you.
I thought that it might be something like a cross between the Top Braid basket and Zotero. Please have a look at Zotero.

[Data Basket Spec - Old^Databasket specification.docx]






















{viewdoc:Databasket specification.docx}

h2. 20120711 Maria

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










!Data Basket v2.png|border=1!

{color:#ff00ff}Jana: Sort is missing. Share is missing. DBUC12 and DBUC11 - are these to be done? In which iteration?{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. |
| -R2- | -TBD: On project level (in the project dashboard) there will be supported shared data basket -- accessible from all project team members, where each user could share items from their personal data baskets.- |
| R3 | Each item is kept in the data basket as link. |
| R4 | The following items could be added to Data Basket
* Image
* Image annotation 
* Data object
* Data field 
* Data annotation
* Search
* Forum 
* -Document-
* 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 could be added to Data Basket from:
* Search result {color:#ff00ff}Jana: We don't have image search{color}
* Image details {color:#ff00ff}Jana: Need a button{color} |
| R6 | Link to image annotation could be added to Data Basket from: 
* Search result {color:#ff00ff}Jana: We don't have annotations search{color}
* Image annotation tool
* Forum tab (RS3.6) |
| R7 | Link to data object could be added to Data Basket from:
* Search result {color:#ff00ff}Jana: Need to add additional button in Exhibit screen{color}
* Object Details {color:#ff00ff}Jana: Need a button{color} |
| R8 | Link to Data object literal could be added to Data Basket from:
* Data annotation tool
* from context menu.
* 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 {color:#ff00ff}Jana: We don't have annotations search{color}
* 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 {color:#ff00ff}Jana: We don't have the UI?{color} |
| R11 | Link to forum discussion could be added from:
* Forums tab (RS3.6) |
| {color:#0000ff}R21{color} | {color:#0000ff}Link to Web link could be added from the Data basket/ "Add Web link" button.{color}\\
* {color:#0000ff}   {color} {color:#0000ff}When the user selects the button a{color} {color:#0000ff}Databasket 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,{color} {color:#0000ff}{*}goes out{*}{color} {color:#0000ff}to the web page to fetch the Title{color}
* {color:#0000ff}    "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{color}
* {color:#0000ff}The title is editable{color} |
| R12 | {color:#0000ff}Text could be pasted to Data Basket, after being copied from any source (forum/ discussion/ comment/ nuxeo documents/ external documents/ object records, etc.) Text is inserted into data basket from: Data basket/ "Add Text" button.{color}\\
* {color:#0000ff}When the user selects the button a screen opens where he could paste the text into Notes field. The text is stored in rich text format.{color}
* {color:#0000ff}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:#0000ff}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 {color:#ff0000}{-}not{-}{color} be changed by the user. |
| {color:#0000ff}{-}R14{-}{color} | {color:#0000ff}{-}When the user selects “Paste to Data Basket” a default link name to the pasted text is created. The link name could be changed by the user.-{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:#0000ff}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 {color:#ff00ff}Jana: No, they are hardcoded in the system. Possibly for 3.6{color}
* 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}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:#ff00ff}Jana: No, user cannot add a tag{color}
* {color:#0000ff}Per data basket item are visible only the tags which are assigned to this item, not all existing tags{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 \\
DO Note: Again more generic - as this list will simply increase \\ |
| R2 | The link is inserted as URI. 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
* select 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) \\ |
\\

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.

\\

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 {color:#0000ff}{-}or "Empty Selected"-{color} 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. |
| {color:#0000ff}{-}R3{-}{color} | {color:#0000ff}{-}If the user selects "Empty selected", then only the selected items are deleted from the data basket. “Are you sure you want to permanently delete the selected items from the Data Basket?” Yes/ No.-{color} |
\\

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

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

h1.





h3.


h2. 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. -20.DBUC12: Start Discussion on Data Basket Item (RS3.?)-

| -R1- | -The user could select one or more items from the data basket and start general discussion on them.- \\ |
| -R2- | -When a discussion is started the selected items are automatically added into the discussion and the user could comment on them- \\
-\- Copy the selected items into the body of a new comment.- \\
-\- Copy them in the form of links, one per line.- \\
-\- Leave the comment title empty.- \\
-\- Omit bookmark note, creator, created. - |
| -R3- \\ | -The discussion is saved as general discussion in the forum tab.- \\ |
* {color:#3366ff}Sort tags in the tags panel by popularity not for 3.5. TO be decided for which iteration?{color}

* {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}

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