On larger projects, you may need to build reports or dashboards that contain results relevant to different groups of people. For example, your customer satisfaction report may have pages for each department of your client's business. In some cases, you might not want everybody to have access to all of the results, but only results that are relevant to their department. In this article, I will show you how to set up your account and document in order to control who gets to see each set of results.

If you don't need to control access to individual pages within your document, but just need to control access to each document, please read How to Control Who Can View your Documents in Displayr.

The basic process for controlling who can view pages in your documents is as follows:

  1. Create a User Group for each level of access (e.g. department).
  2. Assign the people to the relevant groups. This is done when you invite new people to join your account, and you may also change the settings for existing user accounts.
  3. Set up tab-based access in your document to choose which groups can see each page.
  4. Ensure your published document requires users to log in with a password.

In order to complete these steps you must be an account Administrator, and your account must be set up as a multi-user account (for more on this, see the Displayr wiki).

Part 1: Create user groups

The first step is to work out how you want to group the people who will be using your document, and then create groups to reflect that desired structure. In my example, I will create two user groups in my account.

To add a group:

  1. Log in to Displayr.
  2. Click on the cog icon in the top right and select Settings.
  3. Scroll down to the Groups section and select + New Group.
  4. Enter a Group name, and click Save.

I have added two new groups in my account, called Department A and Department B. My intention is to assign any viewers who should view results for Department A to that group, and similarly for people in Department B. The Groups section in my account settings now looks like this:

There are three default groups:

  • Administrators - these people can access all documents and settings in your account.
  • Edit Projects - by default, these people can edit and view all documents in your account.
  • View Projects - by default, these people can view but not edit all documents in your account.

If you are restricting access to users then do not add restricted users to any of these groups, as they will be able to access other documents and pages.

Part 2: Assign users to groups

Now that groups have been defined, new accounts can be assigned to those groups. When you invite someone to join your account you can specify which groups they are in. You can also change which groups someone is in at a later time.

You can invite a new user to your account by clicking the + New User button in the Users section of your Settings page. If you are inviting a new user to your account, you can choose the group(s) that the user belongs to at the time. For example, when inviting my first user, Chris A, I assign him to Department A and fill out the fields below before clicking Save (which will send the invitation).

If you need to assign or change which group(s) a person is in later on:

  1. On the Settings page, scroll down to the Users section.
  2. Click the person's name.
  3. Make selections in the Group membership section (just as in the screenshot above).
  4. Click Save.

Part 3: Choose which groups can view each page (tab-based access)

With users and groups defined, you can now choose who has access to each page of your document. This is known as the tab-based access settings. These steps should be included in the work-flow of anyone who is responsible for creating new documents in your company. They can only be done once you have created some pages in your project. Settings can be updated later on when needs change or when new pages are added.

As an example, I've created a super-basic dashboard with pages for my two different departments. When editing, it looks like this:

Next, I'll set the document settings so that only people assigned to the group for Department A can see the first page, and similarly for Department B.

  1. Click the cog in the top right of your browser window and select Documents.
  2. Hover next to the document you want to set up and click the Settings.
  3. Expand the Properties section.
  4. Click Set tab-based access to document.
  5. Next to the name of each of your pages, click into the box and select which User Groups should be allowed to view that page. You can make multiple selections by holding CTRL or SHIFT when clicking.
  6. Click Save.

Note that the settings page here will inform you of any user groups who already have access to the entire document. People whose viewing is to be restricted should not be given membership to these groups.

Part 4: Publishing your document

In order for these settings to apply, you need to ensure that your document requires a person to log in with their password to view it. This is a choice that you make the first time you publish your document with the Private Web Page option in the Export ribbon, but you can also change this later:

  1. Go to the document settings as above.
  2. Expand the Properties section.
  3. Ensure the option Allow viewing without a password is unticked.
  4. Click Save.

Now, when someone who is in the group Department A views the document, all they will see is the first page (of course you can make yours look prettier than mine!):

So remember, there are a few key steps to restricting access on a page-by-page basis. First, you need to create user groups which define the levels of access, just like my departments here. Second, you need to make sure that you create accounts for the people who will view the document, and that each person is assigned only to the group that relates to their access. Finally, you need to set tab-based access within the document to specify which groups of people can see each page.

We hope you found this helpful - check out "Using Displayr" for more articles with tips and tricks!