Workspaces

Arcadia Enterprise provides URL access to ArcViz server object, workspaces.

In addition to the standard public workspace that is shared by all users, and the single private workspace that each user has, Arcadia Enterprise enables users who have the Create Workspace privilege to create custom workspaces. These workspaces may be shared by specific users and user groups to develop and view dashboards that are inherently useful to their line of business. Within each of these workspaces, each user has a defined access level: View Only, Edit, or Manage. For more information on workspaces, see Working with Workspaces.

JSON Fields for Workspace Data Type
Field Detail Only Updatable Description
id No No Workspace ID
name No Yes Workspace name
desc No Yes Workspace description
editable Yes No Permission to update only a non system-managed workspace (Custom worksapce). The system managed workspaces are Public and Private workspaces.
private_user_id Yes No ID of the user for private workspaces
acl Yes Yes Access Control List 9ACL) for a workspace

Access Control List in Workspaces

The workspace ACL is a list of privilege entries. Each entry contains three items. The following acl syntax shows two entries:
"acl": [[entry_type, access_level, group_name],[entry_type, access_level, user_name]]
Entry Encoding
entry_type 1 = User, 2 = Group
access_level 1 = View, 2 = Edit, 3 = Manage
user_name/group_name User or group name of the entry_type

Creating Workspaces

The following code creates a new workspace Test workspace and provides View access to a special group Everyone and Manage access to user admin.

The example in this article use an APIKey obtained through the Manage API Keys interface, on the host:port/arc/apps/apikeys browser page of the ArcViz installation (see Creating New API Keys). The actual APIKey and the method of retrieving the key depends on the user system.

curl -s \
 -X POST \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: apikey 1rhmSlVO4U6nOdiQBmBIFgqj3XlUC3M5k1cs7pAHwmyew3ol" \
 -d 'data=[{
      "name": "Test workspace",
      "desc": "Workspace created via admin api",
      "acl": [[2, 1, "Everyone"], [1, 3, "admin"]]
   }]' \
 127.0.0.1:7999/arc/adminapi/workspaces

When viewing this workspace through the ArcViz GUI, it appears on the workspace edit modal window like this:

Creating a workspace