Sharing

Prev Next

Sharing allows query, report, or dashboards to be shared between groups and individuals. Once shared, reports and queries appear in the user's Saved list found on the reports screens.



Create Queries and Reports

The query or report must be created before it can be shared. Use the Query Builder to complete your report.


sharing-homeClick on image to zoom

Navigate the Sharing Screen

The Sharing screen displays the report name, ID, and the owner. Choose either the Reports tab for compound reports, the Queries tab to view single queries, or the Dashboards tab to view and share the created dashboards.

Search

Use the search feature to locate the correct report or query. The search feature finds the report if the entered letter combination appears anywhere in the report name, owner, or report ID.

View Report

Click View Report to review the report script.

Edit Access

Click edit Edit Access to open the edit screen.


 

Share Reports

Report sharing allows users to edit the permissions of current users or share the report with new users or groups.

Make sure you trust the report you are sharing. Reports, if written incorrectly, can open the server to malicious actions such as phishing and cross-site scripting attacks. To avoid this, do the following:

  1. Carefully review the report for such problems.
  2. Copy the report so you are the owner. This prevents the original writer from modifying the shared report and opening the system to malicious actions.
  3. Share the report as Execute or Read/Execute only.

sharing-add-accessClick on image to zoom

Add Users and Groups

To share a report, follow the steps below:

  1. In the Admin navigation menu, select Sharing.
  2. Locate and click on the report, then click edit Edit Access.
  3. In the Add Access section, do the following:
    1. Select the permissions level under Add as.
    2. In the From drop-down list, select Groups and Users, Groups only, or Users only.
    3. Begin typing the user name or group name. A drop-down list appears; you must click on the user or group from the list. Multiple users or groups can be added at the same time if they all have the same permissions.
    4. Click Add.
  4. Click Update to save the changes and return to the Sharing home screen.

 

Edit Access

Clicking on the query or report opens a detail panel. The access section displays the users or groups that currently have access to the report. Locate and click edit Edit Access on the report you'd like to edit. The owner of the report cannot have his or her permissions changed, but all other users and groups can.


sharing-access(1)Click on image to zoom
sharing-access-editClick on image to zoom

Change Permissions

Clicking Full, Read/Execute, or Execute determines what each user or group can do with the report. Click on the heading of each column to change all users and groups to that permission or click radio_button_checked to choose the permissions individually.

  • Full allows those with access to edit, read, and execute the report.
  • Read/Execute allows those with access to both view and run the report.
  • Execute allows the user to run the report only. Select this option if the report is needed in other IMAT tools (such as VHR), but the user should not be able to view or edit the report in Report Builder.

A blue line to the left of the row indicates that the permissions have changed but have not yet been saved.

Click Update to save the changes and return to the Sharing home screen.

Note:
If a user is part of a group, the user's permissions match whichever is greater. If a group has Full permissions but a user, who is part of that group, is only set to Execute, the user would still have Full access. 

sharing-remove(1)Click on image to zoom
sharing-cancel-removeClick on image to zoom 

Revoke Access

To revoke access to the report, click remove next to the name that should no longer have access to the report. The line is highlighted in red, and the user is removed once Update is clicked.

Clicking clear restores the user to the original permissions.


sharing-dashboard

Click on image to zoom

Share with Dashboards

To make a report or query available for a dashboard, you must do the following:

  1. Share a report with the same recipients who you want to see the dashboard. They will need a minimum of execute permissions.
  2. Toggle Available in dashboards to on.

When a report is successfully shared with the Dashboards app, you will see dashboard Dashboards in the Current Access list.


Share Dashboard

After a dashboard has been created, you can share the dashboard with others.

  1. Go to the Dashboards tab.
  2. Click the dashboard you want to share.
  3. Click edit Edit Access.
  4. In the Add Access section, select the following:
    1. Add as: Allow the new users to either view or view and edit the dashboard.
    2. From: Select to choose from groups or users.
    3. Username/Group name: Select from the dropdown that appears when you click on it. Start typing the name for a shorter list.
  5. Click Add.
  6. Verify your changes in the Access
  7. Click Update.


Edit Dashboard Access

Clicking on the dashboard name opens a detail panel. The access section displays the users or groups that currently have access to the dashboard. Locate and click edit Edit Access on the dashboard you'd like to edit. The owner of the dashboard cannot have his or her permissions changed, but all other users and groups can.


sharing-dashboards-permissionsClick on image to zoom

Change Permissions

Clicking the radio button under Edit or View determines what each user or group can do with the dashboard. Click on the heading of each column to change all users and groups to that permission or click radio_button_checked to choose the permissions individually.

A blue line to the left of the row indicates that the permissions have changed but have not yet been saved.

Click Update to save the changes and return to the Sharing home screen.


sharing-dashboards-revoke-1Click on image to zoom
sharing-dashboards-revoke-2 Click on image to zoom

Revoke Access

To revoke access to the dashboard, click remove next to the name that should no longer have access to the report. The line is highlighted in red, and the user is removed once Update is clicked.

Clicking clear restores the user to the original permissions.