1. Vitalink Integration in Hector
14 Januari 2016

2. Overview What is Vitalink? Vitalink Concepts Authentication / STS
Vitalink in Hector
Authentication in Hector
Fetching Medication Schema
Modifying Medication Schema
Advantages when using Hector
Roadmap Hector
Additional Information
Q&A

3. What is Vitalink? Digital platform from the Flemish Government
Secure sharing of health and welfare information
Each caregiver that has a consent can access data
Circle of Trust
Developped by HealthConnect (PM: Jelle Gacoms) as a contract assigned by the VAZG.

4. Vitalink Concepts / basic principles
Medication Schema / Vaccination Schema / SUMEHR
Only Medication Schema is explained
The schema contains:
The Patient SSIN
MedicationNode
DataEntries
Each entry represents 1 medication
KMEHR
Vitalink-metadata.

5. MedicationSchema
<fetchMedicationEntriesResponse>
         <serverMessageID>123456</serverMessageID>
         <status>
            <code>200</code>
         </status>
         <patientSsin> </patientSsin>
         <lastUpdated> T09:12:02+01:00</lastUpdated>
         <version>1</version>
         <medicationNode>
            <name>medication-scheme</name>
            <version>1</version>
            <updatedBy>…</updatedBy>
            <dataEntry>
               <dataEntryUri>/subject/ /medication-scheme/90664/1</dataEntryUri>
               <businessData>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZG…</businessData>
               <metadata>
<key>availabilityStatus</key>
<value>active</value>
</metadata>
<metadata … />
<dataEntry/>
<dataEntry …/>
</fetchMedicationEntriesResponse>

6. Authentication / STS Organisations Individuals
Vitalink
Authentication / STS
Organisations
Certificates with CBE Number
Circle of Trust
Individuals
Certificates with a SSIN
Qualities with read only rights (See Vitalink)
Thuisverpleegkundigen (nurse)

7. Vitalink in Hector Hector is a simplified interface for Vitalink
STS
Paging
PDF Generation
Encryption Decryption
Only medication schemas
Hector will not provide support on KMEHR
Hector simplifies homologation

8. Authentication in Hector
Vitalink
Authentication in Hector

9. Authentication in Hector Part 2
Vitalink
Authentication in Hector Part 2

10. Fetch Medication Schema

11. Fetch Medication Schema
Vitalink
Fetch Medication Schema
Fetching will return the entire MedicationSchema.
Always perform this action before creating/updating/deleting
Vitalink returns only 10 DataEntries
Hector will assemble the entire MedicationSchema with every Entry
Break the glass option
Schema can be returned as PDF or KMEHR

12. Fetch Medication Schema Request
<fetchMedicationEntriesRequest> <securityToken>12DAD342RD</securityToken> <person> <ssin> </ssin> <firstName>Carl</firstName> <lastName>Molemans</lastName> </person> <patientSsin> </patientSsin> <returnType>PDF</returnType> <breakTheGlass> <confirmation>true</confirmation> <reason>Corilus - Test Hector Integratie</reason> </breakTheGlass> </fetchMedicationEntriesRequest>

13. Create MedicationSchema

14. Create MedicationEntry
Vitalink
Create MedicationEntry
Always first fetch the schema
This way we have the latest version known by Vitalink
A new dataentry can be added to the schema.
Vitalink will validate your new DataEntry
Hector will forward the success/errorcodes created by Vitalink
The full list of codes can be found in the Vitalink documentation

15. Create a new DataEntry StoreMedicationEntryRequest
<storeMedicationEntriesRequest>
<securityToken>12DAD342RD</securityToken>
<patientSsin> </patientSsin>
<dataEntry>
<dataEntryUri>/subject/ /medication-scheme/new</dataEntryUri>
<nodeVersion>15</nodeVersion>
<businessData>PGttZWhy…</businessData>
<metadata>
<key>availabilityStatus</key>
<value>active</value>
</metadata>
...
</dataEntry>
</storeMedicationEntriesRequest>

16. Update Medication Entry
Vitalink
Update Medication Entry
Always first fetch the MedicationSchema
To make sure you have the latest version
Modify the entry you want to update
Vitalink will validate your DataEntry

17. Update a DataEntry StoreMedicationEntryRequest
<storeMedicationEntriesRequest>
<securityToken>12DAD342RD</securityToken>
<patientSsin> </patientSsin>
<dataEntry>
<!– original dataentryurl /subject/ /medication-scheme/90664/1 -- >
<dataEntryUri>/subject/ /medication-scheme/90664/new/1</dataEntryUri>
<nodeVersion>16</nodeVersion>
<businessData>PGttZWhy…</businessData>
<metadata>
<key>availabilityStatus</key>
<value>active</value>
</metadata>
...
</dataEntry>
</storeMedicationEntriesRequest>

18. “Delete” Medication Entry
Vitalink
“Delete” Medication Entry
Always fetch the MedicationSchema
To make sure you have the latest version.
Mark the data entry as “ended”
The entry will NOT be deleted, but it will be markes as no longer active
Vitalink will validate the schema

19. End a DataEntry StoreMedicationEntryRequest
<storeMedicationEntriesRequest>
<securityToken>12DAD342RD</securityToken>
<patientSsin> </patientSsin>
<dataEntry>
<!– original dataentryurl /subject/ /medication-scheme/90664/2 -- >
<dataEntryUri>/subject/ /medication-scheme/90664/new/2</dataEntryUri>
<nodeVersion>17</nodeVersion>
<businessData>PGttZWhy…</businessData>
<metadata>
<key>availabilityStatus</key>
<value>ended</value>
</metadata>
...
</dataEntry>
</storeMedicationEntriesRequest>

20. Advantages when using Hector
Vitalink
Advantages when using Hector
Do not worry about:
Certificate authentication (Ehealth STS)
Encryption / Decryption
PDF Generation
Pagination
Only worry about:
Managing the Medication schema’s
= Core Vitalink functionalities
Less TODO = Less COSTS

21. Roadmap Hector Possible Vitalink extensions / improvements
Medication Schema: OK
Vaccination Schema: upon request
SUMEHR: upon request
ETEE Requestor
BelRAI Connector
Resident Assessment Instrument

22. Additional information
Vitalink
Additional information
Usefull links:
Cookbooks Vitalink
Cookbook Hector Plugin Vitalink
Cookbook Hector
Configure the certificate in Hector
Hector Silent Install
SPOC:
Technical:
Functional:

23. Vitalink
Q & A