Datalore 2023.6 Help

Share a notebook

You can share notebooks from your default Home workspace to work on them together with other users. Users with edit access can work directly on the shared version of the notebook. Users with view access can view the shared version of the notebook but must clone it to their file system to edit its content.

To access the shared notebooks, select Shared with you on the left-side menu of the Home page.

Access type comparison (Expand to view)

The table below shows how viewers and editors can work on a shared notebook.

Action

View access

Edit access

Share the notebook

No

Yes. When running the notebook, the owner's resources are consumed.

Clone and copy the notebooks

Yes

Yes

Download the shared notebook

Yes

Yes

Rename the shared notebook

No

Yes

View the notebook in the editor

Yes

Yes

Run or edit the notebook

The notebook must be cloned to the viewer's file system.

Yes

Download the notebooks

Yes

Yes

View the notebook attachments

Yes

Yes

Create and execute SQL cells for the notebook's connected databases

No

Yes

Sharing procedure

There are two ways you can share your notebooks:

  • Using the notebook link

  • Using email invitations

Follow this procedure to grant view or edit access to a notebook using its link.

  1. On the editor page, click the Share button in the upper right corner of the editor to open the Share [notebook_title] dialog shown in the picture below.

    Share notebook dialog
  2. Under Share notebook, expand the list and select the access type you want to grant using the link.

    Access type selection
  3. Click the icons next to the notebook link to open it in a new browser tab or copy the link.

    Open shared notebook icon
  4. (Optional) To disable the link, repeat steps 1 and 2, and select No access link.

Create and manage invitations

Follow this procedure to share notebooks by sending email invitations with selected access types.

  1. On the editor page, click the Share button in the upper right corner of the editor and click the Manage invitations button in the dialog.

  2. In the field under Share this notebook with someone by email, enter the email addresses of the users you want to invite. You can use the autocomplete option:

    • The list of autocomplete suggestions includes user emails and user names matching the typed-in text.

    • In the Enterprise version of Datalore all registered users and user groups are searchable.

    • In the cloud version of Datalore, users invited for the first time will be available through autocomplete after they accept their invitation.

  3. Select the access type you want to grant to the invited users.

  4. Click the Send invitation button.

Share workspace dialog

Sharing notebooks from shared workspaces

Sharing notebooks has the following limitations:

  • Notebooks from own workspaces can only be shared with workspace members (people the workspace is shared with). Therefore, after clicking the Share button, you can only add more workspace members and share the link to the notebook with them.

  • You cannot share a shared notebook with users who do not have access to the workspace the original notebook belongs to. Instead, you must clone the notebook to your Home workspace so that you can share the copy.

Clone a shared notebook with edit access

  1. Go Notebooks in the shared workspace.

  2. Right-click the notebook you want to share and select Clone to create a copy of the notebook to your Home workspace.

  3. Go to your Home workspace and share the created copy.

Clone a shared notebook with view access

  1. Go Notebooks in the shared workspace.

  2. Open the notebook you want to share in the editor.

  3. Open File from the main menu and select Clone notebook.

  4. Go to your Home workspace and share the created copy.

Real-time collaboration

When working on a shared notebook at the same time, you can see the avatars of the other collaborators in the upper right corner of the editor. To track another collaborator's work in real time, double-click the respective avatar. This will allow you to follow this particular collaborator as they make their changes.

To stop tracking a collaborator, double-click the respective avatar.

Real-time collaboration
Last modified: 02 January 2024