Table access in projects

Overview

You can view any project that is public or shared with you, or that you are the owner of. However, your ability to view specific datasets, tables, and transforms within a project is determined based on your access to the relevant datasets. This ensures that dataset owners have full control over who can access their data, while giving project owners flexibility in defining who they collaborate with.

If you open a project and only have access to some of the datasets, you may see limited information depending on your access level.

Dataset access propagates to all derivative nodes in your projects

Project node access

All tables and transforms in your project are derived from one or more source datasets. When determining your access level to a particular node, Redivis computes the lowest access level across all source datasets. Your ability to interact with project nodes for different access levels is as follows:

  • None: The node will be black, and you will not be able to see any information about it, including its name.

  • Overview: The node will be black, and you will only be able to see its name and description.

  • Metadata: The node will be checkered. If a table, you will be able to see variable names and univariate statistics, but you will not be able to look at cells or download the data. If a transform, you can view its configuration and code, but cannot run it.

  • Data: The node will be grey, and you will be able to interact with it normally.

If your access level to a node is lower than "data", when you click on the node you will see a red button in the top right showing your current access level. Click on this button to see which datasets are contributing to your reduced access and to subsequently apply for access.

Assigning projects to a study

If a dataset's access is controlled by study requirements, your project must be assigned to an approved study while working with that dataset. Conceptually, approval of a study requirement gives you access to work with a dataset in the context of that study, and for this reason all queries in your project must be in the context of that study.

When creating a project, you will be given the option to choose the appropriate study for the project. You can also change the project's study at a later point by clicking on the study in the project name.

Assign projects to studies

If your project is not assigned to the appropriate study, you will not be able to run any transforms in the project. These transforms will display as having "Limited access" and cannot be run, similarly to when you don't have appropriate access to the source datasets. Click the Limited access button to get more information and assign your project to the appropriate study.

If a transform has limited access, it means your project isn't assigned to the appropriate study

Usage restrictions

If a table is derived from multiple datasets, the restrictions on that table will represent the intersection of the most constrained restrictions from each dataset. If you request export exceptions, and the table contains datasets with restrictions from multiple organizations, you will have to request an exception of each organization.

Learn more about usage restrictions.