Question
How is the connection working technically between myQA iON and Delta4 software?
Answer
Opening the Delta4 software from myQA iON
Conversely to myQA iON, Delta4 is a desktop application, which is not installed on a central server in the clinic, but instead on the local machine or laptop of each physicist.
To circumvent these issues, the agreed upon mechanism for starting Delta4 will rely on Windows URI schemes (see also StackOverflow). In summary, in myQA iON has a button with a link that has the form
scandidos.delta4:<payload>
where <payload> is an arbitrary string for the moment:
The URI schema scandidos.delta4 will cause the browser (in which myQA iON is running) to not open the link inside the browser, but instead to consult the Windows operating system for how to handle such a link.
Windows in turn checks the Registry to see if any handlers for the scandidos.delta4 schema have been registered and will then open the Delta4 software. No separate configuration is needed on the myQA iON side.
Transferring data from Delta4 to myQA iON
There are two options to get the data/reports from Delta4 to myQA iON:
Option "Send to Server"
Delta4 will post the report directly to an http endpoint of the myQA iON backend.
For authorization, the <payload> includes both an authorization_schema (a string) and authorization_parameters (a list of strings), which Delta4 passes in the authorization header of the http post authorization
Authorization: <authorization_schema> [<authorization_parameters>]
where authorization_parameters is formatted as a comma-separated list.
Example with <payload> encrypted:
scandidos.delta4:CAEa0AIKOnR5cGUuZ29vZ2xlYXBpcy5jb20vc2NhbmRpZG9zLmRlbHRhNC52MS5NZWFzdXJlbWVudFJlcXVlc3QSkQIKIjIuMTYuODQwLjEuMTE0MzM3LjEuMS4xNjI5ODkyNTc1LjASB0ExOTAwMDgaC1Rlc3QsIEJyYWluIghURVNUTE9HUyoiMi4xNi44NDAuMS4xMTQzMzcuMS4xLjE2Mjk4OTI1NzUuMDIjaHR0cDovL3NjaGlvbm1tcDE6ODA4MC9hcGkvZGVsdGE0LzI6BkJlYXJlckJ6ZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKa05DSTZJaklpZlEub29ZbzV1SEc0YlFRaklWVlJvc0VMUWo5Z3ZnUEZ0NkQ3S1ZmSEY1RnJGcktWd1VuMm82OXR3SE8zbDRjeUdMbWdDTDBweUd4UkU1WUkteGpPSjFSaWc=
Each request is only valid for one single request.
Option "Save to File":
The user can save the data also in file format *.bin or *.res.
These file can simply be imported via the myQA iON web frontend: