What is a Workspace?

To create a Workspace:

  1. Select the Hub you wish to add a Workspace to in the Online Workspaces window

  2. Select a name for your Workspace, selection the version compatibility and confirm by clicking "Create Folder"

  3. Your new Workspace will appear as a child of the Hub

The version compatibility is going to help filter the content based on the Revit/Rhino/Civil3D version you're in!
For example, if a WorkSpace is set as compatible with Revit 2020 only, it's content won't be 
displayed inside other version of Revit in order to reduce run errors and compatibility issues.

To edit the Workspace settings:

  1. Select the Workspace in the "Online Workspaces" window

User settings

In the Workspace Settings, you can specify which user gets access to its content. The list of users and their level of access is diplayed here:

If someone has access to the parent Hub of the Workspace as a Hub Admin, they automatically have access to the Workspace as well.

You can easily manage the users through this window:

Add users to the Workspace

  1. Enter the email address of the user you wish to add (they need to have an Orkestra Online account) and specify their role.

A user will be able to use the definitions through the Orkestra Revit Addin and view its properties but won't be able to download / open the script or edit its properties. An admin will be able to edit all settings of the Workspace and will also be able to download, open and edit definitions and their properties.

Add multiple users to the Workspace from .csv file

  1. Select your .csv file. The format of the .csv must be as follow (UTF-8 Comma delimited) : first column is email, second column is access level.

Add Azure Active Directory Group

⚠️Note that it is essential that users ar on version 1.7.2 or higher for this to work. ⚠️

Ever since Orkestra 1.7.2 , companies using SSO in Orkestra can leverage their AAD groups. Granting access to a group is as simple as clicking the "Add multiple users" button, then picking the "Add Azure Group" button:

Delete users from the Workspace

  1. Select the user to be deleted in the list

Updating a user's role:

  1. Select a user in the list and use the dropdown menu to pick their new role

Package Settings

The Workspace settings also let you sync a set of packages to be used for definitions located inside that Workspace. This means that when a script is launched through the Orkestra Online Player Tab of the Orkestra Revit Addin, Orkestra switches the package environment automatically to match the parent Workspace's package settings. This lets you set the exact package versions that are required for your definitions, which makes deploying your content much easier and safer.

Once the toggle is switched on, the modifications are enabled for the Workspace:

Synchronizing a set of packages with your Workspace, you need to :

The content of that folder is the Dynamo package folders and must look something like this:

Once the sync if finished, you can see the list of packages and their versions displayed in the Orkestra Hub Settings window.

Adding a single package to the package settings

  1. Browse to to the package folder you wish to add

  2. Confirm

OR : simply drag and drop a package folder

Removing a single package to the WorkSpace settings

  1. Select the package you wish to remove

Software Compatibility Settings

Ever since Orkestra 1.1.0, you can specify the software compatibility of a Workspace:

This will have two consequences:

  • You'll be able to filter your content -based on this informations- while browsing

  • In all Orkestra integrations, the content will be automatically filtered based on the software version you're in. For example, if you're in Revit 2020, you'll only see the werspaces set as compatible with Revit 2020.

 A Workspace can contain sub folders, but there are no specific user or package settings at their level

Last updated