Organization Workspaces builds upon the functionality of a User Workspace section and adds the ability to fine-tune the access level for any particular member, collaborator, or team. This is achieved by managing Participants in the Organization Workspaces.
A participant may be a member of the parent organization of that workspace or may be a collaborator only for that workspace within that organization.
Create a new workspace#
To create a new workspace within an organization:
- Go to the Workspaces tab of the organization menu.
- Select Create workspace.
- Enter the Name and Full name of the workspace.
- Optionally, add the Description of the workspace.
- Click on Open for the newly created workspace.
It is possible to change the values of the optional fields either using the Edit option on the workspace listing for an organization or using the Settings tab within the workspace page, provided that you are the Owner of the workspace.
Apart from the Participants tab, the organization workspace is similar to the user workspace. Therefore, the concepts of Runs, Pipeline Actions, Compute Environments and Credentials are applicable.
Add a new Participant#
To create a new Participant within an organization:
- Go to the Participants tab of the organization menu.
- Click on Add participant.
- Enter the Name of the new participant.
- Optionally, update the role associated with the participant of the organization members or collaborators. For more information on roles, please refer to the participant roles section.
A new workspace participant could be either an existing organization member, collaborator, team, or a new user.
Organization owners can assign a role-based access level within an organization workspace to any of the participants in the workspace.
It is also possible to group members and collaborators into teams and apply a role to that team.
There are five roles available for every workspace participant.
Owner: The participant has full permissions on any resources within the workspace, including the workspace settings.
Admin: The participant has full permissions on the resources associated with the workspace. Therefore they can create/modify/delete Pipelines, Compute environments, Actions and Credentials. They can add/remove users to the workspace, but cannot access the workspace settings.
Maintain: The participant can launch pipelines and modify pipeline executions (e.g. they can change the pipeline launch compute environments, parameters, pre/post-run scripts, and nextflow configuration) and create new pipelines in the Launchpad. The users cannot modify Compute Environments and Credentials.
Launch: The participant can launch pipelines and modify the pipeline input/output parameters in the Launchpad. They cannot modify the launch configuration or other resources.
View: The participant can view the team pipelines and runs in read-only mode.
Sharing monitoring with workspace#
To allow users executing pipelines from the command-line to share their runs with a given workspace, follow the instructions under Getting Started