1. Open the offline app (online version does not work, due to security constraints in the web browser)
2. Navigate to Settings (cogwheel icon up and to the right) > Clinic > X-ray integration
3. Click on the plus sign and select the "Dentalmind" X-ray software. The integration is created. Select the integration that was just added
4. To the right in the page, click on "Select Program"
5. Select the program named "XVAssistant.exe" (usually located in C:\Apteryx\Apteryx Imaging\). Dentalmind should now show up in the navigation menu. When clicked, a command is executed on the computer.
Some examples:
- C:\Apteryx\Apteryx Imaging\XVAssistant.exe -p"Rask, Niels::810811-1496"
- C:\Apteryx\Apteryx Imaging\XVAssistant.exe -p"Rask, Niels::810811-1496::810811-1496"
- C:\Apteryx\Apteryx Imaging\XVAssistant.exe -p"Rask, Niels::::810811-1496"
6. Ensure the parameters are correctly set up so Dentalmind "finds" the patient. For testing, the commands executed can be viewed in the console, e.g. in the Console tab in Chrome.
OVERVIEW: Command Line Parameters
The XVa3™ application supports multiple command line options for opening patients from the standard application command line. The XrayVision Assistant executable filename is “XVAssistant.exe”.
Example: XVAssistant.exe –n”Doe, John”
Command Line Flags
Command line flags are preceded by either a ‘-‘ or a ‘/’ and indicate that the specified type of data is to follow the flag.
Example: XVAssistant.exe –n ”name”
Example: XVAssistant.exe /n ”name”
Example: XVAssistant.exe /i”id _number”
Opening Files
Command line arguments that are not preceded by a command line flag are interpreted as filenames. Any files specified on the command line will automatically be opened by the application.
Example: XVAssistant.exe c:\temp\filename.ext
Multiple Command Line Parameters
The XVa3 application can handle more than one set of command line parameters at a time.
Example: XVAssistant.exe c:\temp\filename.ext –n”Doe, John” –i 11223344
Spaces Between Flags And Values
Spaces may appear between the flag and the value.
Example: XVAssistant.exe /n”name”
Example: XVAssistant.exe /n ”name”
Flags Specifying Multiple Sets of Data
Flags such as the ‘P’ flag require the specification of multiple sets of data. Usually, this data is separated by one or more delimiters (e.g. “::”). Flags that contain multiple sets of data should be placed within double quotes.
Example: XVAssistant.exe /p”name::ss_number::id_number”
Example: XVAssistant.exe /p”name::::id_number”
Command Line Flags
n –or– N (Patient Name)
The patient name can be in any of the following forms and should be surrounded by quotations (but they are not necessary). Note that patient names are not case sensitive.
“lastname, firstname” (This is the recommended format)
“firstname lastname”
“firstnamelastname” (This type of name specification is not recommended due to the fact that more than one patient may match the string.)
“lastnamefirstname” (This type of name specification is not recommended due to the fact that more than one patient may match the string.)
i –or– I (Patient ID Number)
The patient id number that should be surrounded by quotations (but they are not necessary).
s –or– S (Patient SS Number)
The patient social security, CERT, CID, etc. number that should be surrounded by quotations (but they are not necessary).
x –or– X (Patient Unformatted SS Number)
The patient unformatted social security, CERT, CID, etc. number that should be surrounded by quotations (but they are not necessary). The unformatted number does not have dashes, dots, etc..
p –or– P (Patient Specification)
An entire patient specification. Each item in the patient specification is separated by a set of double colons “::”. The format of the specification is “patient_name::ss_number::id_number”. The patient name is required, but the ss_number or id_number can be left blank (e.g. “patient_name::::id_number”, “patient_name::ss_number::”).
f –or– F (Patient Specification File)
A file containing the patient specification. The format of the file is fist_name, last_name, ss_number, id_number where each item is separated by a new-line. Any of the patient items can be left blank.
b –or– B (Patient Image Bar)
This command is identical to the p command with the added functionality of automatically bringing up the image bar for the specified patient. Using this parameter does not bring the XVa3 application to the foreground (if the XVa3 application is not currently running it is started and immediately minimized). This command can be used to display the images for the specified patient without having to display the XVa3 application.
m –or– M (Start Minimized)
This option will start and immediately minimize the XVa3 application. If the XVa3 application is currently running, then this parameter has no effect.
y –or– Y (Remote Xray Activation)
This command is utilized by the XrayVisionLink.DLL to invoke an x-ray capture from another application and wait until the user cancels the operation or an image is acquired (this command can be used directly by another application however). The parameter has the following format: /y"patient_name::ss_number::id_number::date_of_birth;event_name;target_JPEG_filename". The patient identifying information is the same as the other parameters (i.e. /p). The event_name is a named event that is signaled when XrayVision is done with the image capture operation (whether successful or failed). The target_JPEG_filename is the file where the image will be stored if one was captured. Please note that only v3.5 b30 and higher support this command line parameter.
Command Line Grammar
XVAssisant { filename | (‘-‘|’/’)op[space]value }
op: n | N | i | I | s | S | x | X | p | P | f | F | y | Y
space: ‘ ‘
value: “string” | string 