Skip to content

Reports and Dashboards ​

Introduction ​

Beside the the browsing options available in the OpenStudyBuilder application, the system also supports NeoDash reports and dashboards. NeoDash provides interactive, read-only views over the OpenStudyBuilder graph database — for browsing biomedical concepts, comparing studies, inspecting the audit trail, and more.

This section explains how to open NeoDash, how to pick a report, and documents each available report. Every report page follows the same structure: Purpose, Concept & definitions, and When to use set the scene; Report tabs lists what each tab is for; each tab then has a Quick Guide with steps and screenshots; and Solution Architecture, Common errors, and Related topics round it off.

NOTE

These NeoDash reports complement the OpenStudyBuilder application but have some user-interface limitations (for example limited interactivity, filtering and formatting compared to native application features). Over time, the functionality they provide is intended to be moved into the OpenStudyBuilder application step by step, as native features become available.

Open NeoDash ​

To open NeoDash reports:

  1. Click on the Reports button placed on the main OpenStudyBuilder page
    Reports button
  2. The NeoDash login page should be displayed
    Study Builder
  3. Select to use 'SSO' and then click the 'Sign in' button.

IMPORTANT

Select the database in which the NeoDash report is stored. Typically a sponsor-provided name and not neo4j.

  1. If requested to select a browser account, select your Microsoft identity account you use for the application.
  2. The NeoDash report should open

NOTE

The URL to access the NeoDash report will follow this pattern, where text in '[ ]' is optional and italic text is replaced by environment specific values: [open]studybuilder[.environment].domain/neodash/

NeoDash interface elements ​

The report guides in this section refer to parts of the NeoDash interface by consistent names. The figure below labels every element you see when you open a report as a reader. Click the image to open it at full size.

NeoDash interface elements

ElementWhat it is
Database connectionThe Neo4j database the reports read from. Read-only — you do not change it.
Light / dark theme toggleSwitches NeoDash between light and dark appearance.
Help buttonOpens NeoDash help.
Log out buttonEnds your NeoDash session.
Report navigation panelThe left-hand drawer listing every available report. (NeoDash calls each report a dashboard.)
Report search boxFilters the report list by name.
Reports landing pageThe Reports Landing Page entry at the top of the list. Explains how to access the other reports (the expand/collapse menu)
Selected reportThe report currently open, highlighted in the list.
New / Load / Refresh dashboardButtons above the list to create, load, or refresh a dashboard (mainly used by editors).
Report action menuThe per-report menu (⋮) with actions for that report.
Collapse panel buttonHides or re-expands the navigation panel.
Report titleThe name of the report you have open.
Page tabsThe tabs across the top — each tab is a different view of the report. The first tab is always a short ReadMe.
Report settingsOpens settings for the current report.
Report cardA content box inside a tab that shows one query result (a table, chart, map, or text). Some guides also call this a panel.
Maximize buttonExpands a report card to fill the screen.
Refresh buttonRe-runs the report card's query.

General features ​

A few controls behave the same way in every report, whichever one you open.

Rows per page — tables show 5 rows by default. Use the Rows per page dropdown below a table to show more (5, 10, 25, 50, or 100), and the arrows to move between pages. Unfortunately, it is not possible to change the default in the Report Settings.

Rows per page control

Sort, filter & manage columns — open a table column's menu (the ⋮ in the column header) to Sort by ASC / DESC, Filter the rows, Hide column, or Manage columns.

Column menu buttonColumn menu options

Download a table — click the download icon (a cloud with a down-arrow) on a table card to export its rows to a CSV file.

Download table icon

Maximize & Refresh — any report card can be expanded to full screen with the Maximize button and re-run with the Refresh button (see NeoDash interface elements above).

Inspect graph node properties — in a graph-view card, click a node to open a modal with a Property / Value table of everything stored on it.

Node property inspection modal

Right-click a node instead to open a context menu with Inspect (same property table) and Expand... (follow a relationship type from that node).

Graph node right-click context menu

Download a graph as an image — maximise a graph-view card, then click the camera icon (Download as Image) next to Refresh to save the current graph layout as a PNG.

Download as Image icon on a maximised graph card

Select a report ​

In the lower left corner of the neodash window you will find the Expand Expand and Collapse Collapse icons for the Report navigation panel. Upon expanding the Report navigation panel, available neodash reports can be opened and reviewed.

Side panel selection

The first tab of each report holds a short ReadMe instruction as well.

Available reports ​

ReportPurposeWhere to find it
Activity Library DashboardBrowse and understand biomedical concepts (activities and activity instances) in the OSB Library from multiple perspectives.Report navigation panel → Activity Library Dashboard
Activity Metadata CheckCheck activity instances for missing items and valid groupings.Report navigation panel → Activity Metadata Check
Audit Trail ReportBrowse audit-trail history of changes to library elements and studies.Report navigation panel → Audit Trail Report
CRF Impact AnalysisSee which Forms, ItemGroups, and Collections would be affected by changing an Item, ItemGroup, or Form.Report navigation panel → CRF Impact Analysis
CRF Library VersionsCompare versions of CRF collections, CRFs, Groups, and Items.Report navigation panel → CRF Library Versions
Data Exchange Data ModelsBrowse CDISC and sponsor data-exchange data models.Report navigation panel → Data Exchange Data Models
Laboratory Data SpecificationBuild a Laboratory Data Specification for a supplier.Report navigation panel → Laboratory Data Specification
Study Metadata ComparisonCompare metadata between two studies or two versions of a study.Report navigation panel → Study Metadata Comparison
Syntax Template DashboardBrowse syntax templates, parameters, instantiations, and study usage.Report navigation panel → Syntax Template Dashboard