Single Patient Identifier
- Project: 179 MFT Single Patient Identifier
- Specification: v1.1
- Specification Date: 10-Dec-2018
The Aquila Substitution Program Module (SPM) is a Windows 32-bit application.
It provides functionality to import a mapping file; produce a legacy identifier report and perform identifier substitution.
You will need to be logged in to the website to access the download. A user profile will have been provided to you.
The SPM installation file is available here: evolutionhealthcaresystems.co.uk/download/spm/
Alternatively, follow the Downloads link on the top right of our website, and open the Miscellaneous folder.
You will need to enter the connection details of an existing AquilaCRS SQL Server database during the installation. This can be changed at runtime.
To upgrade, just install over-the-top of an existing SPM installation. Settings will be remembered.
During testing and in the event of a problem, the roll-back procedure is to use SQL Server tools to restore the database to a point in time prior to the start of the process.
Therefore please ensure you have backed up the database prior to running the substitution.
The SPM settings are stored in the logged in users "local app data" folder, under the sub-folder AquilaSPM.
The database connection information should be correct, but you can alter it here.
Add the output folders for the Summary Log and Execution Log. Both locations can be the same folder as the filenames are generated automatically. **
The creation of an execution log file is optional and can be turned off via the Output Execution Log option. (An execution log table is always created, so you have the option of outputting the execution log using SQL Server tools at a later point).
The "Extended execution log" setting allows you to turn off the production of process code 300 in the execution log that is output to disk. As the AquilaCRS patient index contains only 1.6% of the number of patients expected in the mapping file, the process code "300" (in mapping file, not in patient index) would account for 98.4% of the execution log file size. Therefore, you can choose to not write this portion of the log which will see proportionate gains in processing time.
Additional settings can be altered if necessary, i.e. CSV separator, system code & name.
Press Save Settings when done. If the database connection has changed, a new connection will be made at this point.
Import Mapping File
Switch to the Mapping File tab. Press the Import button and select the mapping file **
The progress of the import will be shown at the foot of the window, & messages will appear in the log window. (information is posted every 50k records imported).
You can press "Cancel" at any point, this will roll-back all changes and the database will be returned to the state prior to the Import button being activated.
Existing mapping file records are deleted prior to import.
A list of previous mapping file imports can be seen on this page also.
If time allows, it is recommended that the mapping file is imported prior to producing this report.
Switch to the Legacy IDs tab and press the Legacy IDs button.
Progress will be shown at the foot of the screen and in the log window.
A file will be produced in the Execution Log Folder ** called `LEGACY_systemcode_yyyy-mm-dd_hhnnss.csv` e.g. LEGACY_IBID_2019-08-19_143200.csv
Mapping File Usage
If a mapping file has been imported the Legacy ID report will attempt to verify if a non-RM2 number is in fact an RM2 number missing it's prefix by looking it up in the mapping file and comparing patient attributes.
If there is no mapping file imported, the legacy report will include identifiers that do not start with "RM2".
To initiate the identifier substitution, switch to the Identifier Substitution tab and press the ID Substitution button.
Once completed, the log files will be created in the folders** specified in the initial setup.
The execution log creation is conditional on that option being selected in the settings page.
A copy of the summary log will also be written to the on-screen log:
Will re-create the Summary and Execution Log of the identifier substitution. You can turn off the execution log for a decrease in identifier substitution and then output the logs any time afterwards (do not run "clean up" until you have the logs exported at least once).
This option removes all SPM related tables from the AquilaCRS database. To be used when the substitution has taken place and been verified and accepted by the burn unit.
SPM Version History
|0.10||21-Aug-2019||Deactivate/reactivate indexes on mapping table to improve import performance|
|1.0||02-Sep-2019||ID Substitution Implementation (beta)|
|1.5||10-Sep-2019|| Updates to reflect specification v1.5|
- new labels & data in Summary Log
- alteration of time element of filenames