URL
You can modify the URL at any state of the app to get the desired result. Here are different part of the APP that you can modify:
WorkList​
The WorkList can be modified by adding the following query parameters:
PatientName​
The patient name can be modified by adding the PatientName
query parameter.
/?patientName=myQuery
MRN​
The MRN can be modified by adding the MRN
query parameter.
/?mrn=myQuery
Description​
The description can be modified by adding the Description
query parameter.
/?description=myQuery
Modality​
The modality can be modified by adding the modalities
query parameter.
/?modalities=MG
Accession Number​
The accession number can be modified by adding the accession
query parameter.
/?accession=myQuery
DataSources​
If you happen to have multiple data sources configured, you can filter the
WorkList by adding the dataSources
query parameter.
/?dataSourcename=orthanc
You can add sortBy
and sortDirection
query parameters to sort the WorkList
/?patientName=myquery&sortBy=studyDate&sortDirection=ascending
Viewer​
The Viewer can be modified by adding the following query parameters:
Mode​
As you have seen before, the Viewer can be configured to be in different modes.
Each mode registers their id
in the URL.
For instance
/viewer?StudyInstanceUIDs=1.3.6.1.4.1.14519.5.2.1.7009.2403.871108593056125491804754960339
will open the viewer in the basic (longitudinal) mode with the StudyInstanceUID 1.3.6.1.4.1.14519.5.2.1.7009.2403.871108593056125491804754960339.
And if configured, the same study can be opened in the tmtv
mode
/tmtv?StudyInstanceUIDs=1.3.6.1.4.1.14519.5.2.1.7009.2403.871108593056125491804754960339
StudyInstanceUIDs​
You can open more than one study in the Viewer by adding the StudyInstanceUIDs
/viewer?StudyInstanceUIDs=1.3.6.1.4.1.25403.345050719074.3824.20170125095722.1&StudyInstanceUIDs=1.3.6.1.4.1.25403.345050719074.3824.20170125095258.1
You can ues this feature to open a current and prior study in the Viewer. Read more in the Hanging Protocol Module section. You can also use commas to separate values.
SeriesInstanceUID and initialSeriesInstanceUID​
Sometimes you need to only retrieve a specific series in a study, you can do that by providing series level QIDO query parameters in the URL such as SeriesInstanceUID or SeriesNumber. This does NOT work with instance or study level parameters. For example:
http://localhost:3000/viewer?StudyInstanceUIDs=1.3.6.1.4.1.25403.345050719074.3824.20170125113417.1&SeriesInstanceUID=1.3.6.1.4.1.25403.345050719074.3824.20170125113545.4
This will only open the viewer with one series (one displaySet) loaded, and no queries made for any other series.
Alternatively, sometimes you want to just open the study on a specified series
and/or display a particular sop instance, which you can accomplish using:
initialSeriesInstanceUID
and/or initialSOPInstanceUID
to select the series to open on, but allowing other
series to be present in the study browser panel. This is the same behaviour
as in OHIF 2.0, albeit on different URL parameters. For example:
http://localhost:3000/viewer?StudyInstanceUIDs=1.3.6.1.4.1.25403.345050719074.3824.20170125113417.1&initialSeriesInstanceUID=1.3.6.1.4.1.25403.345050719074.3824.20170125113545.4
Note that you can combine these, if you want to load a specific set of series plus show an initial one as the first one selected, for example:
http://localhost:3000/viewer?StudyInstanceUIDs=1.3.6.1.4.1.25403.345050719074.3824.20170125113417.1&SeriesInstanceUID=1.3.6.1.4.1.25403.345050719074.3824.20170125113545.4&initialSopInstanceUID=1.3.6.1.4.1.25403.345050719074.3824.20170125113546.1
hangingProtocolId​
You can select the initial hanging protocol to apply by using the hangingProtocolId parameter. The selected parameter must be available in a hangingProtocolModule registration, but does not have to be active.