Search

Managing Workspaces

  • Updated

After creating a workspace, you have the ability to duplicate, edit, share, and delete your workspace.

To duplicate your workspace

  1. Click “three blue dots stacked in a vertical line.”

    Each workspace displays as a tile in the Researcher Workbench. The tile includes a vertical ellipsis in the top left corner. The title of the workspace displays to the right of the vertical ellipsis. At the bottom of the workspace tile, a badge displays with your workspace collaboration status - either owner, writer, or reader. Below the badge is the last date and time the workspace was changed. When you click the vertical ellipsis, a menu appears with workspace options including duplicate, edit, share, and delete.

  2. Select “Duplicate.”

    Duplicate is the first option displayed on the menu. After you click duplicate, the workspace description page will appear on the screen. When a workspace is duplicated, all the information from the workspace description is copied from the original workspace.

  3. Make any necessary changes to the workspace name and description.

    At the bottom of the workspace description page, answer the last question about requesting review of the workspace by the Resource Access Board (RAB). If you are not changing the workspace and only using the workspace as a guide, you likely do not require RAB review. Below the question about RAB review, there will be a blue duplicate workspace button.

  4. Click “Duplicate Workspace.”

    You have successfully duplicated a workspace. The Researcher Workbench home screen will appear, and the duplicated workspace will display under your workspaces.

To edit your workspace

  1. Click “three blue dots stacked in a vertical line.”

    Each workspace displays as a tile in the Researcher Workbench. The tile includes a vertical ellipsis in the top left corner. The title of the workspace displays to the right of the vertical ellipsis. At the bottom of the workspace tile, a badge displays with your workspace collaboration status - either owner, writer, or reader. Below the badge is the last date and time the workspace was changed. When you click the vertical ellipsis, a menu appears with workspace options including duplicate, edit, share, and delete.

  2. Select “Edit.”

    Edit is the second option displayed on the menu. After you click edit, the workspace description page will appear on the screen.

  3. Make any necessary changes to the workspace name and description.

    At the bottom of the workspace description page, there will be a blue update workspace button.

  4. Click “Update Workspace.”

    You have successfully updated a workspace. The Researcher Workbench home screen will appear, and the duplicated workspace will display under your workspaces.

To share your workspace

You can share your workspace with other registered All of Us Researcher Workbench users to collaborate on projects.

Note: Researchers must have the same level of access, whether Registered Tier or Controlled Tier, as the workspace in order to access the workspace. If the researcher does not have the necessary access and tries to open the workspace, they will receive a prompt to complete additional requirements.

  1. Click “three blue dots stacked in a vertical line.”

    Each workspace displays as a tile in the Researcher Workbench. The tile includes a vertical ellipsis in the top left corner. The title of the workspace displays to the right of the vertical ellipsis. At the bottom of the workspace tile, a badge displays with your workspace collaboration status - either owner, writer, or reader. Below the badge is the last date and time the workspace was changed. When you click the vertical ellipsis, a menu appears with workspace options including duplicate, edit, share, and delete.

  2. Select “Share.”

    Share is the third option displayed on the menu. After you click share, a pop-up title Share (your Workspace title) will appear on the screen with a search field for registered Researcher Workbench users.

  3. Enter the name of the Researcher Workbench user that you would like to share your workspace with in the search bar.

    Based on your search, a list of registered Researcher Workbench users will appear in a dropdown. You will see the user's name and their @researchallofus.org credentials. To the right of each user, there is a light blue plus sign inside a light blue circle.

  4. Click “Blue line circle with blue plus sign centered in the circle.”

    Clicking the blue plus sign in the blue circle adds the user to your share screen. The user's name and their @researchallofus.org credentials will display under the search bar. Below their credentials, a dropdown with the user’s role will appear. User roles include reader, writer, and owner.

  5. Assign the user a role.
    • Readers can view, but not edit notebooks. Readers can't delete or share the workspace.
    • Writers can view and edit notebooks, as well as delete files in the workspace bucket. Writers can't delete or share the workspace.
    • Owners can view and edit notebooks, as well as delete files in the workspace bucket. Note: All owners can delete and share workspaces, so make sure you're only providing this level of access when necessary.

      In the bottom right of the share your workspace name pop-up, there is a blue save button.
  6. Click “Save.”

    You have successfully shared a workspace. The Researcher Workbench home screen will appear.

Note: Access to workspace analysis and data files by the Data and Research Center (DRC)

The All of Us Researcher Workbench operates under the governance of the All of Us Data and Research Center (DRC). Data analysis conducted within the Researcher Workbench is stored in the workspace bucket. The DRC may access workspace data if the research team requests technical troubleshooting via the Help Desk, during audits initiated by the All of Us Resource Access Board, in cases of suspected non-compliance with the Data User Code of Conduct, for security audits, or for required system performance and maintenance.

To delete your workspace

  1. Click “three blue dots stacked in a vertical line.”

    Each workspace displays as a tile in the Researcher Workbench. The tile includes a vertical ellipsis in the top left corner. The title of the workspace displays to the right of the vertical ellipsis. At the bottom of the workspace tile, a badge displays with your workspace collaboration status - either owner, writer, or reader. Below the badge is the last date and time the workspace was changed. When you click the vertical ellipsis, a menu appears with workspace options including duplicate, edit, share, and delete.

  2. Select “Delete.”

    Delete is the fourth option displayed on the menu. After you click delete, a pop-up titled Warning - All work in this workspace will be lost will appear on the screen with a text field at the bottom. Note: Deleting your workspace will immediately and permanently delete any items inside the workspace, such as notebooks and cohort definitions. This includes items created or used by other users with access to the workspace.

  3. Type “Delete."

    In the bottom right, a grayed out delete workspace button will turn blue after you type delete in the text field.

  4. Click “Delete Workspace.” to confirm you want to permanently delete your workspace.

    You have successfully deleted a workspace. The Researcher Workbench home screen will appear.

    Note: If you delete your workspace, all data tied to your workspace will be deleted and will not be recoverable. Your research purpose will remain publicly available on the Research Project Directory.

    Note: Deleting your workspace deletes the workspace for all users collaborating on the workspace.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.