Het is mogelijk om klinimetrie gegevens op te halen met Ons Tags. Hiervoor zijn twee systeemtags aangemaakt, te weten:
- client/ehr/byArchetypeId
- client/ehr/byArchetypeIdAndPath
Met de systeemtag client/ehr/byArchetypeId worden alle composities van een cliënt voor het opgegeven archetype opgehaald (of geprint). De systeemtag client/ehr/byArchetypeIdAndPath kan worden gebruikt om de waarde van het opgegeven path van de meest recent ingevulde compositie van een cliënt op te halen (of te printen).
De systeemtag client/ehr/byArchetypeId is eigenlijk puur een tool voor de inrichter om te zien met welke data je werkt en om het benodigde queryPath te achterhalen. De systeemtag client/ehr/byArchetypeIdAndPath is de tag die in een briefsjabloon gebruikt kan worden, of welke als basis gebruikt kan worden voor het inrichten van custom tags. Er worden hierboven verschillende concepten van OpenEHR benoemt, die zullen we nog even kort toelichten:
- Archetype: een blauwdruk (vergelijkbaar met een vragenlijst)
- Compositie: een invulling van een archetype (bijv. de resultaten van een ’10 Meter Looptest’)
- Path: Een pad (broodkruimelspoor) naar een specifieke vraag of antwoord van een compositie
In onderstaand voorbeeld zien we dat testcliënt ‘Django Aardbei’ twee composities (metingen) heeft van het archetype (vragenlijst) 10 Meter Looptest.
Om het archetypeId te achterhalen, kan je bij de betreffende klinimetrie op ‘Bekijk alles’ klikken, en vervolgens doorklikken op ‘Nieuwe meting’. In de URL is het archetypeId zichtbaar. Het archetypeId begint na ' new/ ’. In het voorbeeld van de 10 Meter Looptest is het archetypeId dus openEHR-EHR-COMPOSITION.ten_mtr_walking_test_report.v1.0.0. Zie ook hiervoor weer onderstaande afbeelding.
Je beschikt nu over de benodigde gegevens om de tagcollectie client/ehr/byArchetypeId te gebruiken.
Het clientId is het nummer van de cliënt in de URL zoals getoond in Ons Administratie en Ons Dossier. Het nummer dat in de URL is te zien in Klinimetrie wijkt af van dit nummer en kan niet worden gebruikt in Ons Tags.
In Ons Tags kan de systeemtag client/ehr/byArchetypeId nu dus worden getest om alle composities van een cliënt voor het opgegeven archetype op te halen. Dit kan er dus als volgt uit zien:
Hierin zie je drie termen terugkomen:
- originalPath: Het originele pad uit de compositie
- queryPath: Het pad hierboven zonder komma-getallen, deze wordt aangeraden voor het inrichten van tags. De getallen achter de komma kunnen namelijk afwijken tussen verschillende composities afhankelijk van de gekozen waarden
- waarde: de (printbare) waarde
Vervolgens kan ook de systeemtag client/ehr/byArchetypeIdAndPath worden getest om de waarde van het opgegeven path van de meest recent ingevulde compositie van een cliënt op te halen. Hierbij wordt er naast het clientId en archetypeId ook om een path gevraagd. Dit path kan dus gevonden worden bij de uitkomsten van de systeemtag client/ehr/byArchetypeId. In het voorbeeld hierboven zou het path dus /content[id0.0.100.1]/data[id2]/origin/value zijn. Door deze gegevens in de systeemtag client/ehr/byArchetypeIdAndPath in te voeren, haal je – in dit geval – de datum en tijd van de gebeurtenis op.
Deze systeemtags kunnen dan worden gebruikt op de manier zoals je in de afbeelding hieronder ziet. Dit zorgt echter wel voor erg lange tags.
Een oplossing hiervoor kan zijn om je eigen tags in te richten. Zie het voorbeeld van _client/ehr/looptest/tijdstip hieronder.
Voor de composition wrapper-API, waar het archetypeId als filter gebruikt wordt, geldt dat het meegegeven deel van de versie overeen moet komen. Zie hieronder een aantal voorbeelden rondom deze filtering: Als je filtert op openEHR-EHR-COMPOSITION.ten_mtr_walking_test_report, dan worden composities van dat archetype ongeacht de versie teruggegeven. Indien je filtert op openEHR-EHR-COMPOSITION.ten_mtr_walking_test_report.v1, dan worden composities met versie v1.0.0, v1.0.2 en v1.3.4 teruggegeven (maar niet v2.0.0). Als je filtert op openEHR-EHR-COMPOSITION.ten_mtr_walking_test_report.v1.0, dan worden composities met versie v1.0.0 en v1.0.2 teruggegeven (maar niet v1.3.4 en v2.0.0). Als je filter op openEHR-EHR-COMPOSITION.ten_mtr_walking_test_report.v1.0.0, dan worden alleen composities met versie v1.0.0 teruggegeven. * Een patch-versie update (bijvoorbeeld van v.1.0.0 naar v.1.0.1) bevat alleen tekstuele wijzigingen of wijzigingen in de metadata die geen invloed hebben op de betekenis (bijvoorbeeld typefouten). Een minor-versie update (bijvoorbeeld van v1.0.0 naar v1.1.0) bevat backwards compatible wijzigingen. Dit kunnen nieuwe paden, uitbreidingen van keuzelijsten of uitbreidingen van multipliciteiten zijn. 'Backwards compatible' betekent hier dat data die geldig is in versie v1.0.0 ook geldig moeten zijn in versie v.1.1.0. Bestaande paden en codes mogen dus niet van betekenis wijzigen of worden verwijderd. Bij een major update (v.1.0.0 naar v2.0.0) zijn alle wijzigingen toegestaan.
