Workspace Sharing Modes

When a user creates a workspace only the enabled sharing modes will be available. By default all sharing modes are enabled. Note: individual (per-user) sharing modes can be configured by an administrator (using the web client). docs page

In DMX, which user can use items (requires read permission) or edit items (requires write permission) is determined by the Sharing Mode of the Workspace the item resides in. Therefore, each topic and association is related to exactly one Workspace at a time.

This makes Workspaces the core concept for sharing items and the key to fine-grained configuration of access control. To make this easier for users, DMX comes with five sharing modes and users are able to move items in between workspaces. The rule therefore is, each Workspace is of exaxctly one Sharing Mode. The creator of a workspace can change the Sharing Mode of a workspace at any time.

Note

If you have read accesss to an item, you can reveal and use it in any Topicmap of any Workspace.

DMX provides five Sharing Modes to choose from when creating a Workspace.

  • Private: In a Private Workspace just the owner of the Workspace can read and write its items.
  • Confidential: In a Confidential Workspace only the owner can read and write items. Workspace members can read, but not edit contents.
  • Collaborative: A Collaborative Workspace can be read and edited by the owner and by all Workspace members only.
  • Public: A Public Workspace is world-readable and, when your DMX is connected to the internet, is the same as publishing information on a website. All items in it can be read by the public, but only edited by the owner of the workspace and all its members. The default “DMX” Workspace is an example of a public Workspace.
  • Common: In Common Workspaces, even non-logged in users can write contents. You can decide whether you want to allow reading and/or writing for non-logged in users. If configured accordingly, a Common Workspace on a DMX instance connected to the internet can be readable and writable to everyone on the internet. See our Admin Documentation for more details.

If you explicitly do not want or need any of the five sharing modes, you can disable them via configuration.

_images/workspace-selector.png

Moving objects in between Workspaces

As any item can only reside in one workspace at a time, it is possible to assign items to a different Workspace. For this, you must have write permission on both the selected object and the target Workspace.

An example use case: You have a contact, a “Person” object, in your private Workspace that you want to share with some other user.

Select the object and open the “Meta” tab in the Detail Panel. Hover over the Workspace field with your mouse pointer and click the edit button. You can now select the target Workspace from the drop-down menu and hit “Save”.

_images/assign-to-different-ws.png

Note

This only works for individual selected objects. Bulk operations are not yet supported.

Read-only Sessions

When you are logged in you can access the different Workspaces via the Workspace selector in the upper left corner. Once you log out DMX you will only be able to read contents from workspaces with sharing mode Public or Common. Items that are publicly readable stay visible in a topicmap, the rest disappears. In a public Workspace you are no longer able to edit when logged out, but you can still control the viewport of the Topicmap. This is to support a so called “kiosk mode” in which users can search, explore and navigate along all world-readable items in your knowledge base.