SOP: Onboarding new HL7v2 Device
Last updated
Was this helpful?
Last updated
Was this helpful?
This procedure follows the correct procedures to follow when onboarding a new HL7v2 device on the SanteDB iCDR. The example here uses the procedures to setup a copy of OpenMRS 1.9.x running the in HL7v2 mode (note: this procedure will be different based on the client software being configured)
Ensure device name selected complies with the device naming conventions in the operational architecture documentation developed.
Ensure that a most responsible person and/or facility has been documented for the device
Ensure the users of the OpenMRS instance have received proper instructions on care and use of the device:
Reviewed and completed the Privacy Policy
Reviewed and completed the Acceptable Use Policy
Reviewed and completed the Data Sharing Process Documents
Create the Device in the SanteDB administrative panel
Access the SanteDB Administrative Portal byLogging In
Access the Security Administration menu item
Name of the device in HL7v2 format : COMRS192|NAME_OF_FACILITY_DEVICE_ID
(note: COMRS192
is the application registration for OpenMRS 1.9.2 and NAME_OF_FACILITY_DEVICE_ID
should be the name of the facility in the standardized device format)
Enter the Model Name of the server hardware (example: Lenovo ThinkCenter ST40)
Enter the Operating System Name (example: Ubuntu Linux 20.04)
Enter the MRP and/or facility where the device resides
Press Save
Setup the OpenMRS instance at the clinic
Ensure that the MPI or SanteDB server is available from the clinic site (i.e. connected to internet)
Install the OpenMRS MPI Client Module into the OpenMRS instance
Click on the Admin
page and then Advanced Settings
in the OpenMRS instance
Scroll to the relevant settings and use the following parameters:
mpi-client.endpoint.pdq.addr : mpi.example.com
mpi-client.endpoint.pdq.port : 2400
mpi-client.endpoint.pix.addr : mpi.example.com
mpi-client.endpoint.pix.port : 2400
mpi-client.endpoint.ar.addr : auditing.example.com
mpi-client.endpoint.ar.transport : audit-tls
mpi-client.endpoint.ar.port : 11515
mpi-client.security.authtoken : VALUE FROM STEP 1.6 ABOVE
+OMRS393_#948
mpi-client.msg.sendingApplication : OMRS192
mpi-client.msg.sendingFacility : NAME_OF_FACILITY_DEVICE_ID
(from 1.4.1 above)
mpi-client.msg.remoteApplication : EXAMPLE_COM_MPI
mpi-client.msg.remoteFacility : DC_CENTRAL
mpi-client.pid.exportIdentifierType : Patient ID=LOCAL_ID,National ID=NAT_HEALTH_ID
mpi-client.pid.defaultCountry : ELBONIA
mpi-client.pid.enterprise : MPI_KEY_UUID
mpi-client.pid.local : NAME_OF_FACILITY_DEVICE_ID
mpi-client.pid.nhid : NAT_HEALTH_ID
mpi-client.pid.updateIdTypes : false
Press the Save
button
Visit the Search MPI Patient
link in the header and enter the search query TEST_VALIDATE
- a single patient result should be returned
Review the OpenMRS business processes developed as part of the deployment of the MPI
Document the deployment (or close opened tickets for installation)
Current Status: Example Reviewed By: SanteSuite Team
Justin Fyfe (SanteSuite)
2022-03-15
Initial Version
Access the by clicking on the Devices
link
Press the Create
button and enter the necessary details as documented in
Generate a unique secret for the device by pressing Reset
(see: )