Reporting Platform
What is the Reporting Platform?
The SNOMED CT Reporting Platform (RP) is a gateway to reports which can run a range of queries against content created or updated in the active authoring cycle for SNOMED CT.
Queries are structured into categories for ease of definition, navigation and retrieval, such as Ad-Hoc Queries, Release Validation and Quality Improvement.
The results of these queries can support pre-release validation of issues not supported by the Authoring Platform (for instance MRCM rules such as attribute cardinality).
They can also be used to analyze the structural quality of SNOMED CT, to identify potential issues (for instance attribute usage for a given sub-hierarchy) which can then be addressed via content change projects in the Authoring Platform.
For the content team it enables iterative work to define complex QA rules that are eventually used for the Release Validation Framework (RVF) assertions (such as case significance).
As a content release planning and tracking tool it can show the number and types of changes made during a SNOMED CT release cycle, and from one release to the next.
Why should I use the Reporting Platform?
It can reveal trends and particular faceted searches of SNOMED CT content created through the SNOMED CT Authoring Platform that are not easily obtainable via other tools and services.
it can assist with quality assurance review of promoted content prior to publication in the next SNOMED CT release.
It can help to quickly modify and adapt rules which can enable more rapid SNOMED CT content updates via Authoring Platform authoring projects/tasks.
It helps focus on potential content issues that may or may not be a problem, so can assist impact assessment, prioritisation and planning.
For quality checks that are not currently supported in the Authoring Platform by Drools Rules (concept save validation) or Release Validation Framework assertions (task and project validation against an entire release), for instance string handling.
When should I use the Reporting Platform?
Anytime you need to query the content within the current authoring cycle for SNOMED CT.
In particular, many of the reports are designed to assist content quality assurance reviews prior to creating the alpha-release version for each SNOMED CT release cycle.
RP queries run against the content which has been promoted to the mainline branch of the Authoring Platform (ie promoted project content), so some coordination with project content team leaders may be advisable if your report is influenced by or needs to include specific project content for analysis.
Where do I find the Reporting Platform?
The Reporting Platform is linked from the SNOMED CT Authoring Platform (AP) header drop-down menu (available on all pages within the Authoring Platform).
The International AP can be bookmarked and opened with: https://authoring.ihtsdotools.org/
The RP can also be bookmarked and opened directly with: https://authoring.ihtsdotools.org/reporting/
Login required
These links will redirect you to the login page if you’re not already logged in within your current browser session. Once your login completes, your browser will be redirected on to the AP Dashboard and RP main page respectively. If already logged in, these pages will load without the login redirect.
Who can benefit from using the Reporting Platform?
Anyone who has a use for the results of queries run against content updates for the current authoring cycle through the SNOMED CT Authoring Platform, such as (but by no means limited to):
Content authors
Content project managers
Content team leaders
Consultant terminologists
Clinicians
SNOMED CT release teams
Technical specialists
How to…
(from the Reporting Platform entry page)
… find an existing report
Steps | Reference |
|---|---|
Determine which report category is applicable to your query. |  |
If there are many categories, and yours is not visible in the main content area, press a category heading in the left-hand sidebar Categories menu to only show that category’s reports. Pressing the heading again restores the full Categories view. Each press toggles between the only the selected category and showing all categories. | |
Press the header label for your category to show the reports listed under that heading. The screenshot shows the available Semantic Tag Hierarchy reports after pressing its heading. Pressing the header label again will collapse the reports listing. Each press of the report heading toggles the expansion/collapsing of the reports listing. | |
With your category expanded, find the report in the list of those available. If a particular report that you need cannot be seen, you can run a new query for that report. | |
… read an existing report
Steps | Reference |
|---|---|
Find the report to read as described in … find an existing report. |
|
Reports for queries that have been run and already available are listed with status Complete. This status links to the completed report which is stored as a Google Sheet in a Google Drive shared folder - press the label or the icon to open the Google Sheet report. |
|
If you are not already signed in to your Google account in an existing browser session, you’ll be prompted for your Google credentials. Enter these to proceed and view the report sheet. | |
An example report is shown in the screenshot for The sheet name contains the report title followed by the run date-time (in YYYYMMDD_HHMMSS format), a platform identifier (prod), and finally the account name of the originator (ie the account login under which the report query was run). | |
Since the report itself is a Google Sheet, all the options and services associated with a shared Google Sheet are available for further processing and analysis as needed, such as copying to a personal sheet for further analysis/manipulation, download as a file in various formats for offline review and processing, including exporting to other tools and services. |