Work with interactive reports
This topic explains how to work with interactive reports. This type of report allows users to view the notebook output as a completed HTML page, interact with it, and edit the published notebook's copy collaboratively. Compared to static reports, interactive reports allow viewers to dynamically change data presentations (tables and charts) using interactive controls.
Before you open an interactive report
Refer to these topics to learn how to build, publish, and share a static report.
Build a report: describes the process of preparing the notebook as a report before publishing it.
Publish a report: describes the process of publishing the notebook as a report.
Invite report viewers: describes the process of inviting users to view a report with restricted access.
How you can open a report varies based on your access to the report. View the details in this topic.
Interact with the report
Interactive reports allow viewers to manipulate data presentations (tables and charts) using the provided controls and table interactivity.
Open the report and click the Recalculate button in the upper right corner to ensure report interactivity. In the image below, there is an interactive report containing a table and a chart.
Use one of the provided controls to change the respective data presentation. If the Reactive mode is on, the report will update automatically. If Reactive mode is off, click Recalculate in the upper right corner.
In the example below, the controls are:
A slider used to select a number of rows displayed in the table (changed from 5 to 8)
A dropdown used to select a column for the Y axis (changed from kernel_python 3.4 to kernel_python 3.6)
Manipulate with table content just as you would in the editor
To recalculate the whole report, click Recalculate in the upper right corner.
Reset an interactive report
Perform this procedure to reset the interactive report to its initial state.
Click the ellipsis in the upper right corner of the report. This will open a context menu.
Select Reset report. Now the report is displayed as you first opened it in this session.
View emails of report running users
The REPORT_RUNNER_EMAIL environment variable is populated with the emails of those viewers who run interactive reports (initiators). This information can help you, as a report owner, modify the content of your report based on which user is viewing or running it. For example, you can change the options available in the interactive controls used in the report, or hide certain categories from the tables provided in it.
Cases of when the REPORT_RUNNER_EMAIL environment variable is populated are different in the On-Premises and Cloud versions of Datalore.
On-Premises | Cloud plan | Cloud Free plan |
|---|---|---|
For all types of authorized users:
| For certain users:
| For one user type only:
|
To access the environment value, you can use the os module:
Related topics
Refer to these topics to learn about other actions with interactive reports.
Comment a report: describes how to comment interactive report cells and collaborate with other viewers.
Work with report code: describes how access the code of the notebook used for an interactive report to edit its copy or original version.
Save a report: describes how to save an interactive report.
Manage reports in workspaces: describes how to manage interactive reports in workspaces.