Orkestra Online
  • Introduction
  • What is free and what needs a subscription?
  • Orkestra Desktop App
    • LogIn
    • Navigating the content
    • What is a Hub?
    • What is a Workspace?
    • Package Syncing
    • Uploading Definitions to the Orkestra Online Platform
    • Definition MetaData and Documentation
    • Versioning
    • Analytics
    • Run Inspector
    • Orkestra Account Settings
  • WEB APP
    • Introduction
    • Login to Web App
    • Search and filters
    • Version history and Run Inspector
    • Workspaces
      • Overview
      • Hub/Workspace Settings
      • Upload, Move, and Copy definitions
    • QuickAccess
      • Overview
      • Workspaces
    • Analytics
    • DevOps (in development)
    • Management console
    • Wiki
      • Documentation contents
      • Editor mode
    • Personal Settings
  • Orkestra Revit Addin
    • Introduction
    • LogIn
    • Orkestra Local Player Tab
    • Local QuickAccesses
    • Orkestra Online Player Tab
    • Online QuickAccesses
    • PlayLists
  • Orkestra Dynamo View Extension
    • Introduction
    • LogIn
    • Orkestra View Extension Local Tab
    • Orkestra View Extension Online Tab
    • OrkestraGIT
    • Auto UI Form
    • Node Snippets
    • Code Snippets
    • Error Filtering
  • ORKESTRA CIVIL 3D ADDIN
    • Introduction
    • LogIn
    • Orkestra Local Player Tab
    • Local QuickAccesses
    • Orkestra Online Player Tab
    • Online QuickAccesses
    • PlayLists
  • ORKESTRA RHINO PLUGIN
    • Introduction
    • LogIn
    • Grasshopper Plugin Deployment
    • Orkestra Rhino Local Tab
    • Local QuickAccesses
    • Orkestra Rhino Online Tab
    • Online QuickAccesses
    • Auto UI Form
  • Orkestra WEB API
    • Connecting Analytics to PowerBI
    • Content Metrics
  • Orkestra Dynamo Package
    • LogIn
    • Nodes
  • Orkestra SSO
    • Azure Active Directory
      • App Registration
      • Granting Accesses Through AAD
      • Logging in as a User
      • Enable SSO for WebApp
  • FAQ - Known Issues
    • SSO login issue in Revit / Rhino - endless spinning
    • SSO Login - credential error
    • Packages downloading at every login
    • 1.8.3 upgrade from previous version
    • Blank Orkestra Online Workspaces Screen
    • No dockable pane has been registered with this identifier
Powered by GitBook
On this page
  • To create a Workspace:
  • To edit the Workspace settings:
  • User settings
  • Add users to the Workspace
  • Add multiple users to the Workspace from .csv file
  • Add Azure Active Directory Group
  • Delete users from the Workspace
  • Updating a user's role:
  • Package Settings
  • Synchronizing a set of packages with your Workspace, you need to :
  • Adding a single package to the package settings
  • Removing a single package to the WorkSpace settings
  • Software Compatibility Settings

Was this helpful?

  1. Orkestra Desktop App

What is a Workspace?

PreviousWhat is a Hub?NextPackage Syncing

Last updated 1 year ago

Was this helpful?

Workspaces are the first level of subfolders inside a Hub. A Workspace is a storage space where you can load and organize your Dynamo definitions. It is represented by a " " in the "Online Workspaces" window. If you are the owner/ an administrator of the Workspace, you can view and edit its settings. If you are the owner/ an administrator of a Hub, you can add new Workspaces to it.

To create a Workspace:

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

  2. Press

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

  4. 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

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

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

Click on . This button will only be enabled if your are the owner/ an administrator of the Workspace.

Click on

Click on ​​

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

Click on

Click on to update the user role information in the platform

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 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.

By default, the Hub settings are inherited. The list of packages is greyed out and the sync button is disabled. If you wish to set specific package settings for a Workspace, you first need to Override the Hub settings by switching on the toggle and confirm that you want to override the settings.

1. Press the button on the bottom right of the Hub settings window 2. Browse to a folder containing the packages you wish to sync with the Hub

Press the button

Click the button

⚠️
⚠️
Orkestra Online Player Tab of the Orkestra Revit Addin
version compatibility
new workspace
WorkSpace creation interface
Setting the software compatibility for a Workspace
settings
add
folder
delUser
delUser
syncpackage
override
syncpackage
syncpackage