Workspaces
Workspaces are the places where teams share content and work together. A Workspace is a security context and the team can manage access easily. Workspaces can contain documents, events and tasks.
In a Quaive site workspaces are the key areas for creating, organizing and sharing content. Workspaces represent projects or working units where the users that work on these projects are members of the workspace and collaborate by creating and editing content.
A very important aspect of workspaces is the security model that ensures that all content is only visible to those users who are supposed to see it.
In the most simple use-case, workspaces can be treated as folders for storing data that belongs to a specific project. But they provide many more powerful aspects, such as built-in events that will appear in the workspace calendar and the possibility to create and assigns tasks. All actions that happen in the workspace automatically appear in the social stream, where they can be commented on by the workspace members.
In this chapter of the manual we will take a closer look at Quaive’s workspaces and how you can use them. All sections of a workspace, content elements and subsystems will be treated here.
All workspaces in a Quaive site can be accessed in the Workspaces section. To get there please use the navigation link in the main menu called “Workspaces”.
This opens the workspaces overview page. Here you can get an overview over all workspaces currently existing in the Quaive site and you have the necessary permissions to see. The workspaces are displayed as coloured tiles with their title and - if existing - a short description of what they are about.
Read on to create your first workspace and discover all sections and content objects that make a workspace that powerful tool it is meant to be:
Overview
In this section of the manual you will create your first demo workspace. Then we will take a closer look at the different sections of this workspace.
Create a workspace
On the workspaces overview page that was shown on the Workspaces page of this manual, you can find a plus icon above the list of existing workspaces.
Note: If you cannot see the plus icon the user you are using does not have the necessary permissions to create workspaces within the Quaive portal. Please ask your site administrator to grant you the necessary permissions.
After clicking the plus icon, a form opens for creating the new workspace.
Fill in a title and —if wanted— a short description what this workspace is about. The pulldown below the description textarea is about the security settings of the workspace. For this first workspace we will use the default value for the security settings and so will create a self-managed, private workspace.
Note: You can see the different options when looking at the pulldown values and can get information about the different security policies and their effects on the workspace accessibility when selecting them. For more information on security policies please take a look here: Security
Then click “Create workspace” to finally create your first workspace.
When entering a workspace you can see a set of icons in the coloured vertical bar on the left of the page. This is the section navigation of the workspace and the icons represent the different sections of the workspace. Clicking them opens the sidebar, a vertical panel for the selected section.
The different sections of a workspace are the following.
- Home
- Settings
- Documents
- Events
- Tasks
Home
The first icon - the house icon - represents the home view of a workspace. When clicking on it the sidebar is closed and the main view of the workspace with the social stream is displayed.
Learn more about using the social stream here: Social Stream (Link: http://manual.quaive.net/social_stream.html#social-stream-label )
Settings
The gearwheel icon opens the settings section. Here all metadata of a workspace is stored and managed. Also the members of a workspace and the workspace security settings can be edited in this area.
Learn more about managing the workspace settings here: Settings (Link: http://manual.quaive.net/workspaces/workspace_settings/index.html#workspace-settings-label9 )
Documents
In the documents section all content stored in a workspace is managed.
Learn more about handling workspace content here: Create Content (Link:http://manual.quaive.net/workspaces/workspace_content/index.html#workspace-content-label)
Events
In Quaive every workspace has its own calendar where the events of this workspace are displayed and can be managed. There is also an option to have workspace events displayed in the site wide calendar app to be served to users outside the workspace.
Learn more about the workspace calendar and handling events here: Events
Tasks
In this section the tasks of this workspace are managed. New tasks can be created and you also can get an overview over tasks created and assigned to you by other workspace users. You can also see if a task is still open or already closed.
Learn more about tasks and their usage within a workspace here: Tasks (Link: http://manual.quaive.net/workspaces/workspace_tasks/index.html#workspace-tasks-label)
Home
The first icon - the house icon - represents the home view of a workspace. When clicking on it the sidebar is closed and the main view of the workspace with the social stream is displayed.
Learn more about using the social stream here: Social Stream.
Settings
This part of the manual is about how to change the different workspace settings.
The gearwheel icon opens the settings section. Here all metadata of a workspace is stored and managed. Also the members of a workspace and the workspaces security settings can be edited in this area.
When in settings section, you can see several tabs at the top of the sidebar. These tabs open the available subsections of the workspace settings:
- General (Link: http://manual.quaive.net/workspaces/workspace_settings/index.html#general)
- Members (Link: http://manual.quaive.net/workspaces/workspace_settings/index.html#members)
- Security (Link: http://manual.quaive.net/workspaces/workspace_settings/index.html#security)
- Advanced (Link: http://manual.quaive.net/workspaces/workspace_settings/index.html#advanced)
General
Here general metadata like title, description and the workspace’s hero image can be changed.
How to change title and description of a workspace
To change a workspace’s title and description just type a new title or description in the text field or area in the sidebar.
The metadata is immediately autosaved and a info popup tells you that some attributes have been changed.
After the page is reloaded you can see the new workspace title in the breadcrumbs and the workspace header.
How to change the hero image of a workspace
Each workspace can have a hero image to be displayed as a visual element in the workspace’s header section background. Changing this image can also be done in the general settings section.
To change the image click the “upload” button in the sidebar and select an image in the opening file browser of your computer.
The image will be changed immediately as the metadata again is autosaved.
Reloading the page will display the image in the header section of your workspace.
How to display the workspace events in the global calendar
There is a possibility to display the events of your workspace in the global calendar app. To enable this you have to check the checkbox “Workspace calendar visible in central calendar application”
Learn more about events and the workspace calendar here: Events Link: http://manual.quaive.net/workspaces/workspace_events/index.html#workspace-events-label)
Members
In the Members section you can see which users and groups are members of this workspace and which roles they have on it. Here you can add new members or groups, delete existing ones or change the specific role of a member or a group.
Security
On the security panel you can see the current security settings of the workspace. This is called the workspace policy. You can get information about the external visibilty, the join policy and the participant policy of a workspace. All these settings of a workspace can be changed for existing workspaces whenever needed. Short explanations offer information about the current and possible options for these settings to make sure what effects on the workspace and it’s content a change has.
Advanced
In the avanced settings section extended functionality on a workspace can be found such as setting up related workspaces, division support but also actions like archiving, freezing or deleting the workspace
Create Content
This part of the manual is about how to use and create content in an existing workspace.
The page icon opens the documents section. Here all content of a workspace is listed and managed. There are several content types available to store and manage data in a workspace:
The main content types for workspaces currenty existing in Quaive are:
- Document (Link: http://manual.quaive.net/workspaces/workspace_content/index.html#document)
- Folder (Link: http://manual.quaive.net/workspaces/workspace_content/index.html#folder)
- Image (Link: http://manual.quaive.net/workspaces/workspace_content/index.html#image)
- File (Link: http://manual.quaive.net/workspaces/workspace_content/index.html#file)
In this section, the works as a file browser where the existing content of a workspace is presented in a list as you know it from the file browser on your computer. There are several possibilities to group, filter or search for the elements in the sidebar to help you managing your content.
Learn more about using the sidebar for managing workspace content here: Manage Content (Link: http://manual.quaive.net/workspaces/workspace_manage_content/index.html#workspace-manage-content-label)
Document
The document is the basic content type in Quaive. Documents are used to store text and have basic formatting possibilities to display it.
How to create a document
To create a document a workspace, click the dots icon in the sidebar to open the more menue.
Select “Create document” from the list of actions.
A form opens where you can choose the object type to be added. As “Rich text” is already selected, you do not have to change it. Type in a title and if wanted a short description for your new document and click “Create”.
Your document is created and can be edited.
Type your text in the given text area of the open document. For formatting you can use the editor functions above the textarea which allow basic formatting as list elements, tables and also embedded images or links.
Folder
Folders in Quaive work much like they do on your computer. They can be used to structure and organize the content of your workspace. A folder has a title and a description and can store all other types of workspace content.
How to create a folder
To add a new folder, click the dots icon in the sidebar to open the more menue.
Select “Create folder” from the list of actions.
A form opens where you can type in title and a short description of your new folder.
After clicking the button “Create” the folder is added to your workspace and immediately opens in the sidebar. Now you can add content to your new folder.
You can change title and description of existing folders by clicking the pencil icon behind the title of the folder in the sidebar. To get one level up back to the workspace’s root folder click the link on the workspace title above the sidebar search field.
Image
An Image object in Quaive is used for uploading image files (JPG, GIF, PNG) so that you can insert them into Quaive documents or just have them stored in your workspace.
When uploading an image a preview is generated automatically to make it easy for you to find your images within the workspace.
How to upload an image
Images can either be created as described in the section “How to create a document” or - as files - simply uploaded. As the method to create an image object is almost the same as for documents we will take a closer look at the uploading method here.
When looking at the sidebar within a workspace or a folder in document section, you can find an upload area below the list of content.
This area is used to upload an image (or also a file). To do this you have two possibilities: You can either click the link within the drop area and select an image via the opening file browser
Or you can just add image(s) by dragging the image(s) you want to add from the file browser of your computer over the drop area
Both actions have the same effect, the image (or if more were selected images) is queued for upload below the upload area and you can watch the upload process of several objects easily.
After the upload process has finished, the image occurs in the list of object in the sidebar. To view the image, simply click on the list entry and the image is opened in the main content area.
File
A File in Quaive is one of the most powerful objects as it can hold any kind of binary file you wish to upload with the intent to be downloaded by your site visitors. Common examples are PDFs, Word Documents, Excel tables and spreadsheets. For the uploaded file a preview is generated automatically to give the user an idea of what the file is about.
There is also the possibility to have version management for files in Quaive. This is a powerful method to view and even restore older versions of a file and also get an overview over the versions in a table like version history view.
Read more about versioning here: [link to versioning.html]
How to upload a file
Uploading files works exactly the same way as uploading images - so for a how to please read “How to upload an image”
Manage Content
In the documents section of a workspace the sidebar presents the content of the current workspace in a similar way a file browser on your computer does. This enables you to get an overview over the content of your workspace.
To improve organization there are several display options to group, filter and hide content objects. A powerful search option also helps to find special objects in even large workspaces within a few seconds.
Besides display functionality the sidebar also offers a lot of batch actions and other functionality:
- Group by option (Link: http://manual.quaive.net/workspaces/workspace_manage_content/index.html#group-by-option)
- Sidebar search (Link: http://manual.quaive.net/workspaces/workspace_manage_content/index.html#sidebar-search)
- Display options (Link: http://manual.quaive.net/workspaces/workspace_manage_content/index.html#display-options)
- Batch actions (Link: http://manual.quaive.net/workspaces/workspace_manage_content/index.html#batch-actions)
Group by option
Sidebar search
Display options
- show archived files
- show archived tags
- show my documents only
Batch actions
- select mode
- cut/copy/paste
- send
- archive
- download
- delete
- re-tag
- rename
Versioning
Versioning for uploaded files can be enabled optionally. Please contact your site’s administrator for enabling it.
If versioning is enabled and you are uploading a new version of a file that already exists in Quiave, then the old version of the file is not simply replaced, but kept in the system. Although users will then see the new version of the file by default, they can still access previous versions of it.
The example below shows an Excel file that is present in a workspace. We can see the preview for this file:
If you click on the symbol with three dots, you can open the version history:
It shows only one entry, for the initial action:
We have detected a typo in the Excel file. Therefore we want to upload a new version of it. In the edit form, we tick the checkbox “Save a new version”, select the file to upload, and optionally provide a comment that explains the changes made. A click on the “Save” button uploads the file and creates a new version:
After a short while, the preview is re-generated, reflecting the updated state of the file:
If we look at the version history again, we can see a new entry about our change. We see who made the change, when the change was made and what the nature of the change was (“edited”). Also, we see the manually entered change note. By clicking on the “View” link next to a version, we can jump to the details page.
On the details page for a specific version, we see at the top again the list of all versions. At the lower part of the page, we see the details of the version we are currently viewing. Most importantly, we can use the “Download” button for downloading this version of the file.
In case a new version is not wanted, a click on “Revert to this revision”, next to one of the older versions in the table above, will restore the selected older version.
Locking
New in version 1.2.
Quaive provides locking support to prevent concurrent edits on the documents.
When the user starts to edit a document, the document goes in to a locked state.
This is transparent for the user editing the document, but other users that will visit the document will find a locked badge instead of the normal save button.
http://manual.quaive.net/_images/locking-locked-badge.png
Clicking on the locked badge will pop up a panel that tells the user what is going on and offers some actions:
- the user can start a chat through the messaging app with the user who started editing the document
- the user can force the document unlock
http://manual.quaive.net/_images/locking-locked-badge-clicked.png
Events
This part of the manual is about how to use and create events in an existing workspace.
Quaive has a powerful built-in system for managing and showing calendar events. Besides that, every workspace in Quaive can hold it’s own event which makes it possible to keep users informed on important dates concerning their workspaces.
There is also a calendar App existing in Quaive which allows you to get an overview over all events in all workspaces that are relevant for you. .. Learn more about the calendar App here:
To access the calendar of your workspace and see which events are scheduled please click the little calendar icon in the section navigation of your workspace.
In this part of the manual you will
- Create an event in a workspace
- Use the Calendar view
Create an event in a workspace
To create an event in a workspace, click the plus icon in the sidebar.
This opens the create event form.
We will take a closer look to the fields on the create events form. From the top they are:
- Event title (required): The title is displayed in all places where the event is listed - calendar, portlets, listings, …
- Notes: the description is also displayed in some overviews and should therefor be short
- Location: the location the event takes place (free text)
- Organiser (user picker field): the user organising the event
- All day event: when this is selected, the start and end time settings of the event are ignored
- From (required) (calendar field): the date and time the event starts
- To (required) (calendar field): the date and time the event ends
- Timezone: the timezone for the event’s start and end times
- Invitees (user picker field): the users that are invited to the event Only the title field and the start and end date and time are required. All other fields are optional and can also be left blank.
For date fields in Quaive a handy popup-calendar helps you selecting the date easily.
Quaive user picker field
For the user related fields Quaive offers a special user picker that helps you browsing the user database to find portal users and assign them:
Just enter two or more chars to search for a user within the whole Quaive portal
When selecting a user from the list of search results, the field is filled with the correct name and email address.
That’s how the form looks for our test event. To create the event just click the button “Create” at the bottom of the form.
Your event is now created and listed in the sidebar under “Upcoming events”.
There will be a section older events which holds events of this workspace with end dates in the past. You can see that in the next chapter of this manual when we take a closer look at the workspace’s Use the Calendar view (Link: http://manual.quaive.net/workspaces/workspace_events/index.html#calendar-view-label).
Use the Calendar view
Besides the list of events in the sidebar Quaive offers a calendar with several view options within the workspace to get a quick overview over all events scheduled for this workspace.
To open the calendar view please click the link “Workspace calendar” at the top of the sidebar.
The calendar shows up with a month overview for the current month. All upcoming events and events of the last few weeks are displayed with their start time, their title and the location they are supposed to take place in brackets.
In each workspace you have also the possibility to display all events you are allowed to see that reside in other workspaces. To show them up in your current workspace’s calendar view just tick the checkbox “All calendars” above the calendar grid.
This displays all events for the visible period of time. Events that do not belong to the workspace you are currently in are displayed in a transparent way to make it easy for you to see which events are from other workspaces.
In the Quaive workspace calendar view - same as in the Quaive calendar app - you can switch between the calendar month, week or day view. Here you can see the calendar week view:
And the calendar day view:
In all calendar views you can also create new events by simply clicking the tile for this day or time period. This will open a compact popup form to create your events in a quick and easy way.
There is also an option to view the events of you local workspace’s calendar in the central calendar app. To enable this you have to change the setting “Workspace calendar visible in central calendar application” in the workspace general settings section as described here: How to display the workspace events in the global calendar
Tasks
This part of the manual is about how to use and create tasks in an existing workspace.
In a workspace in Quaive you can use tasks to define small pieces of work and - if you want - assign this to another user. Tasks can be closed when the job is finished and reopened again if this seems necessary. A notification email is sent out to the different users when a task was edited or it’s status was changed.
To access the task section of your workspace and see existing tasks and their status click the little checkbox icon in the section navigation of your workspace.
Now you will learn how to
- Create a task in a workspace (Link: http://manual.quaive.net/workspaces/workspace_tasks/index.html#create-a-task-in-a-workspace)
- Change the status of a task (Link: http://manual.quaive.net/workspaces/workspace_tasks/index.html#change-the-status-of-a-task)
Create a task in a workspace
To create a task in a workspace, click the plus icon in the sidebar.
This opens the create task form.
We will take a closer look to the fields on the create task form. From the top they are:
- Task title (required): The title is displayed in all places where the task is listed - sidebar, portlets, listings, …
- Description: the description can be used to describe the task if necessary
- Initiator (user picker field): the user initiating the task (this field is prefilled by the user who created the task)
- Assignee (user picker field): the user the task is assigned to
- Due date (calendar field): the due date this task should be done
Only the title field is required. All other fields are optional and can also be left blank.
For date fields in Quaive a handy popup-calendar helps you selecting the date easily.
For the user related fields Quaive offers a special user picker that helps you browsing the user database to find portal users and assign them. More about the user picker field type you can read in the events section here Quaive user picker field (Link: http://manual.quaive.net/workspaces/workspace_events/index.html#quaive-user-picker-field-label)
That’s how the form looks for our test task. To create the task just click the button “Create” at the bottom of the form.
Your task is now created and listed in the sidebar under “General tasks”.
There will be a section older events which holds events of this workspace with end dates in the past. You can see that in the next chapter of this manual when we take a closer look at the workspace’s Use the Calendar view.(Link: http://manual.quaive.net/workspaces/workspace_events/index.html#calendar-view-label)
Change the status of a task
When you create a task in a workspace, the status of this task is open. This means, the work still has to be done, the job awaits doing.
Usually you assign a task to a specific user and then this user has the task in his task list on the dashboard to see action needs to be done. After this user - or also someone else - did the job, he may want to inform you about it and this can be done by closing the task. So a closed task tells you the work has been done.
Of course tasks can be reopened again if needed so the actions described now can also be performed to re-open a closed task. You can see the current status of all tasks in the sidebar by looking at the task’s checkbox. Checked means the task is done, unchecked means it’s still open.
To close our newly created task we click on the task title in the sidebar to open the task’s edit view. In the edit actions bar you can see the current status of the task. For our task, the status is “Open” - you can also see this in the sidebar.
To change the status of the task open the status pulldown and select “Done”.
A spinner shows that the status of the task is changed immediately and also the sidebar is updated automatically - the checkbox in front of the task is checked now. You can also use the sidebar checkboxes to close or re-open a task by simply checking or unchecking it’s checkbox.
Case Workspaces
Case workspaces are a special type of workspace which help teams to manage a shared work load with discreet milestones. You can configure a case workspace with a set of tasks and milestones and then re-use that configuration for new projects. You can also decide who is able to work on particular tasks during each milestone and notify workspace members when a particular milestone has been reached.
Let’s step through the process of creating and using a case workspace.
Select “Case Template” as the workspace type.
Note: Your Quaive site may have a selection of different pre-configured case workspaces available under the ‘Special workspace’ section.
Fill in the details and create the workspace.
On the case workspace you will see an overview of the tasks and milestones for this case workspace.
Please click on the tasks icon in the sidebar to configure additional tasks.
Let’s create a new task to add members to the case workspace. Please click the button to add a new task to the “New” milestone.
You can add an assignee and a due date.
You will also see the assignee and due date on the case workspace.
You can now add complete the task by adding a team member. This works in exactly the same way as a normal workspace, using the Members (Link: http://manual.quaive.net/workspaces/workspace_settings/index.html#workspace-settings-members-label) settings.
There are two ways to mark a task as complete.
You can now see that the task is complete.
Once all the tasks for a milestone are complete, you can close the milestone and move on to the next one.
You can now see that the milestone is closed, you can also reopen it from the task sidebar.