Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can share with an individual user or with every user in a role. The roles you can share with are determined by your Scuba role definition. To learn about roles and capabilities in Scuba, see /wiki/spaces/ADMIN/pages/1302496595.

Info

Copying a property or board's URL and sending it to your recipient, instead of using the share button as described here, might not allow your recipient to view your results.

To share a board:

  1. In the Scuba UI, navigate to the board you want to share.

  2. Click the Share Board icon:

    Image Modified
  3. Click the plus sign to add a new row to the share list.

  4. Click the three dots to view a list of users and roles available for you to share with. Scroll down to see the roles.

  5. Select a user or role to share with.

  6. Select readquery, or write access.

    • To share the board but not have it populate the other user's board lists, grant query access. 

    • To allow the other user to share the board with additional users, grant read or write access.

  7. Click Save. Your board is now visible to the user or users you shared it with.

To share a property, flow, or measure:

  1. Using the left menu, navigate to the object you want to share.
    For example, to share an actor property, click Data, then Actor properties, and then in the list click the name of the property.

  2. In the left pane, click the Share tab.

  3. Click the plus sign to select a role or individual user to share with.

  4. Select readquery, or full write access.

    • To share the object but not have it populate the other user's board lists, grant query access. 

    • To allow the other user to share the object with additional users, grant read or write access.

  5. Click Save. Your object is now visible to the user or users you shared it with.

...

How access to an object is inherited

...

For security reasons, when you share a query from Explore or an app using the URL (in contrast to the Share button that you can use for an property or board), the user does not automatically get permissions to the query, unless the recipient has permissions on each of the top-level objects referenced in the query. This can be accomplished by any of the following:

  • The cluster admin configuring all users to have query permission on all new objects. See /wiki/spaces/ADMIN/pages/1302496595 in the Admin GuideContact the Scuba Customer Success team to learn more.

  • When you share a query, you would have to grant permission for every top-level object in the query before sharing the query. See Share a board or user-created object above.

Without one of these, the recipient sees an error message.

...

To inspect the permissions on an object:

  1. On the left hand menu, click Data, then click the tab for the type of property you wish to inspect.

  2. In the list of properties, find your property and click its row.

  3. In the left panel, click the Share tab.

  4. A list displays of the users and roles with read, write, or query permission on this object. You can view or modify permissions on this pane.

...

About naming objects

One user cannot create two objects with the same name, but two users can give their objects the same name.

...

The user with which you want to share a query must have an account on your Scuba instance, access to your dataset, and permission to view all of the objects used in your query. In addition, your admin can hide the query share button. To ensure that sharing is successful, pin your query to a board and follow the steps in Share a board or user-created object above.

To share a query without pinning it to a board, do the following: 

  1. From Explore or an app, click Share in the top right corner of the window.

  2. From the URL dialog, click Copy. The URL is copied to the clipboard.

  3. Share this URL with your recipient by pasting it into an email or other communication channel. 

Info

The query from a shared URL reflects data from when query was originally run. To view updated data, your recipient can click GO to re-run the query.

...

Problem

Diagnosis

I can't see someone else's object. I get an error that the property does not exist, or a similar message.

Ask them to share the object with you or with your role.

I can't see someone else's query.

Ask them to share the top-level dependent objects with your or your role, or ask them to pin the query to a board and share the board.

I see a blank panel on a shared board.

The panel might contain data from a dataset that you do not have access to.

My object doesn't look right.

Check the owner column in the explorer table. Is it yours, or is it someone else's with the same name?

I can't share an object.

Verify that your role can share with the role you want to share to. Your Scuba admin can check this in the definition for your role. See /wiki/spaces/ADMIN/pages/1302496595.

What's Next

After you create and share properties, you might want to tidy up the Scuba workspace. Learn how in the following topics:

...