Opening the viewer

VIEW can be integrated with a third-party system through URL-based integration, allowing the opening of one or more studies or patient’s history in a new browser tab or window(s) or within an iFrame.

Opening VIEW in a single monitor

Opening VIEW in a single monitor requires the use of a secure token, generated according to the two-step procedure described below:

Step 1: Get the secure token

The third-party system performs an HTTP GET request to the VIEW’s VIEW APIs | Access-Token-API passing all the necessary parameters related to the study(ies) or patient’s history to be opened (see the VIEW APIs | Access-Token-API-query-parameters section for more details).

The VIEW’s Access Token API responds with the secure token.

Step 2: Open VIEW using the secure token

The third-party system uses the provided token as a parameter in the URL that opens VIEW in a new browser tab, a browser window or within an iFrame. The token can be used only once and for a configurable period.

CODE

https://{VIEWhostname}/ngv?q={token}

Opening VIEW in two monitors

Opening VIEW in two monitors requires the use of secure tokens, generated according to the two-step procedure described below.

Step 1: Get secure tokens

The third-party system performs an HTTP GET request to the VIEW’s VIEW APIs | Multimonitor-API passing all the necessary parameters related to the study(ies) or patient’s history to be opened and the number of monitors to be used (see the VIEW APIs | Multimonitor-API-query-parameters section for more details).

VIEW’s Multimonitor API responds with two relative URLs containing the secure tokens.

The maximum number of monitors in which VIEW can be opened is 2.

Step 2: Open VIEW using the secure token

The third-party system uses the provided tokens as a parameter in the URL that opens VIEW in two new browser windows. The tokens can be used only once and for a configurable period.

CODE

https://{VIEWhostname}/ngv?q={token1}
https://{VIEWhostname}/ngv?q={token2}

Opening VIEW in two monitors with ZEEROmed chrome extension

The ZEEROmed chrome extension is an external component in the form of a browser extension capable of handling autonomously the VIEW’s windows' positioning, saving any integrating web-based third-party system the hassle of determining and storing them.

Please refer to the ZEEROmed Chrome Extension page for the specification.