Difference between revisions of "Workspace"

From Gcube Wiki
Jump to: navigation, search
(Workspace Overview (DRAFT))
(Workspace Overview (DRAFT))
Line 8: Line 8:
 
The modality a workspace is populated range from the dragging of D4Science documents (or part of them) to the upload of files from its desktop and the exchange of workspace objects among users.   
 
The modality a workspace is populated range from the dragging of D4Science documents (or part of them) to the upload of files from its desktop and the exchange of workspace objects among users.   
  
[[Image:workspace_interface.png|frame|The user workspace is organized in three areas: filtering (2), explorer (1) and view (3)]]
+
[[Image:workspace_interface.png|frame| [F1] The user workspace is organized in three areas: filtering (2), explorer (1) and view (3)]]
  
The workspace user interface is organized in three main areas:
+
The workspace user interface is organized in three main areas [F1]:
  
 
* on the top, there is the '''filtering area''' (2). It's contains:
 
* on the top, there is the '''filtering area''' (2). It's contains:
Line 24: Line 24:
 
* on the center, there is the '''view area''' (3). It's organized in two panels ('''items panel''' and '''messages panel''').
 
* on the center, there is the '''view area''' (3). It's organized in two panels ('''items panel''' and '''messages panel''').
 
** The items panel show a toolbar with the possibles operations (i.e. "Rename", "Delete", etc.) on worspace items and the grouped list (of "currents"  items) which show the content of a single folder or the result of a search (on items).
 
** The items panel show a toolbar with the possibles operations (i.e. "Rename", "Delete", etc.) on worspace items and the grouped list (of "currents"  items) which show the content of a single folder or the result of a search (on items).
** The messages panel (4) show a toolbar with the possible operations (i.e. "Open", "Forward", etc.) on messages and the list of messages (sent or received) or the result of a search (on messages).
+
** The messages panel (4) show a toolbar with the possible operations (i.e. "Open", "Forward", etc.) on messages and the list of messages (sent or received) or the result of a search (on messages) (see [F2]).
  
[[Image:Worskpace_messages.png|thumb|Workspace messages area]]
+
[[Image:Worskpace_messages.png|thumb| [F2] Workspace messages area]]
  
 
Through this interface, the following elements can be easily identified and managed:  
 
Through this interface, the following elements can be easily identified and managed:  

Revision as of 14:31, 14 May 2012

This is the help documentation for Workspace Portlet

Workspace Overview (DRAFT)

A workspace represents a collaborative area in which users can exchange and organize information objects (items) according to their specific needs. Because of this, every user of any Virtual Research Environment is provided with this area. Such an area is further organized in workspaces and baskets as to resemble a classic folder-based file system. The information objects that can be managed via the workspace range from files to D4Science documents, i.e. compound objects comprising metadata, alternative representations and multiple parts. The modality a workspace is populated range from the dragging of D4Science documents (or part of them) to the upload of files from its desktop and the exchange of workspace objects among users.

[F1] The user workspace is organized in three areas: filtering (2), explorer (1) and view (3)

The workspace user interface is organized in three main areas [F1]:

  • on the top, there is the filtering area (2). It's contains:
    • navigation bar which shows you the current location and it can be used to navigate workspace item;
    • view space to select the workspace to show;
    • search combo to research item in the workspace.
  • on the left, there is the explorer area (1). It's contains:
    • workspace tree which displays the workspace structure in a tree view;
    • smart folder which displays the "virtual folders". These folders let you save a search to reuse in the future;
    • messages which displays the messages tree, with received and sent messages buttons.
  • on the center, there is the view area (3). It's organized in two panels (items panel and messages panel).
    • The items panel show a toolbar with the possibles operations (i.e. "Rename", "Delete", etc.) on worspace items and the grouped list (of "currents" items) which show the content of a single folder or the result of a search (on items).
    • The messages panel (4) show a toolbar with the possible operations (i.e. "Open", "Forward", etc.) on messages and the list of messages (sent or received) or the result of a search (on messages) (see [F2]).
[F2] Workspace messages area

Through this interface, the following elements can be easily identified and managed:

  • workspace area, i.e. the overall workspace supporting the user activities;
  • item, i.e. a constituent of a workspace area.
    • An item can be a workspace, a basket or a basket item;
    • Every item has a name comprising any char but slash (/);
    • An items container (workspace or basket) prevent to have two items with the same name;
  • workspace Workspace.png, i.e. an item supporting the organisation of the items as to form a hierarchy. Each workspace might contain workspaces and baskets;
  • basket item, i.e. any item belonging to a basket. These items are of various nature. The currently supported basket items are:
    • External File External file.png, i.e. a generic file uploaded from the user Desktop;
    • External PDF External pdf.gif, i.e. a PDF file uploaded from the user Desktop;
    • External Image External image.gif, i.e. an image file uploaded from the user Desktop;
    • External URL External url.png, i.e. an URL created by the user;
    • Query Query.png, i.e. a specification of a search criteria;
    • Report Report.png, i.e. a D4Science Report;
    • Report Template Report template.png, i.e. a D4Science Report Template;
    • Metadata Metadata.png, i.e. a D4Science Metadata Object;
    • Document Document.png, i.e. a D4Science compound object comprising all its metadata, the alternative representations and all its the parts;
    • PDF Document Pdf document.png, i.e. a PDF file belonging to a D4Science document;
    • Image Document Image document.png, i.e. an Image belonging to a D4Science document;
    • URL Document Url document.png, i.e. an URL object belonging to a D4Science document.

Workspace Operations

To perform operations on the Workspace Portlet, users should be familiar with the right-click mouse button (on Mac use ctrl and mouse click). In fact a mouse right click on any item in the portlet shows the context menu.

Workspace context menu

The available actions depends on the selected item.

Common actions

  • Rename an item: Selecting Rename the user can insert the new item name.

If the name inserted is invalid a signal is showed like the one in figure.

Workspace invalid name

An item can be also renamed using the details panel. Using the details panel the user can also change the item description.

  • Deleting an item: By selecting Delete a confirm message is shown and, if the user confirms, the item is deleted.
  • Cloning an item: By selecting Clone the user can insert the cloned item name. If the name is invalid a message is shown like if you would rename an item.
  • Download an item: By selecting Download the browser asks for the location where to save the content. The content file type is based on the item type, specifically:
    • Single items, such as external file (pdf and images) are proposed as simple files;
    • Complex items, such as gcube documents are proposed as a zipped folder with related metadata (each one of them in a xml file).
    • Folders: are proposed as zip folders.
  • Send an item: By selecting Send to the user can send a workspace item to another user in the same VRE. The workspace portlet show a window where to select the item addresses, then clicking on send button the item is sent.

Specific actions

  • Create a new workspace/basket: On the workspace tree right click on the parent folder and select Add new Workspace or Add new Basket action. Insert the item name and then press enter. A new folder is created.
  • Upload a file into a basket: on basket context menu select upload file. The browser asks for a file to upload from your local file system. A the end of operation a confirm message is shown.
  • Upload an archive into a workspace: on workspace context menu select upload archive. The browser asks for a file to upload from your local file system. A the end of upload operation a confirm message is shown. The zip file is processed following this rules:
    • the zip file is considered a folder.
    • if a folder contains a list of files this one is transformed into a basket and the files inserted inside.
    • if a folder contains files and subfolder this one is transformed in a workspace; the files are inserted into a new basket created into the workspace. The subfolder are processed following the rules.
  • Create an external url: on basket context menu select add url. The workspace portlet show a windows where insert the url data: name, description and url value.
  • Open a Report : on the report context menu select Open in Report Generator. The portal will switch to the Report generator portlet opening the selected report.
  • Open a Report Template: on the report template context menu select Open in Template Editor. The portal will switch to the Template Editor portlet opening the selected report template.

Drag and Drop Actions

The workspace tree and the list view support drag and drop actions. In the list below you can find the supported operations:

  • d&d of basket item between two baskets in the tree, from a basket in the tree and a basket in the list view and viceversa.
  • d&d of folder between two folders in the tree, from a folder in the tree and a folder in the list view and viceversa, and between folders in the list view.