Stream: finnish PHR
Topic: info Sandbox
Anssi Hämäläinen (Oct 01 2019 at 10:52):
The new version will be updated to Kanta PHR Sandbox environment on the 3rd of October from 7am to 8am. The new versio includes the following changes/features:
-
Added support for searching Observation-type resources with multiple codes
(Support is added for OR-type searches, AND-type searches are not supported) -
Request parameters with null or empty values are no longer allowed in token and authorize endpoints
- Updated HAPI to version 3.8.0
- Fixed minor bugs and errors
Anssi Hämäläinen (Oct 14 2019 at 10:45):
The new version of Kanta PHR will be updated to Kanta PHR Sandbox environment on the 17th of October from 8am to 9am.
The new version includes support for searching MedicationAdministration with multiple codes.
Juha Paasolainen (Jan 29 2020 at 10:12):
Hi,
we will do some technical maintenance work in Sandbox environment starting 4.2.2020 18:00. There might be momentary short breaks in the service until the next morning.
Best regards,
Juha Paasolainen
IT service manager, Kanta PHR
Anssi Hämäläinen (Mar 23 2020 at 13:00):
There will be a maintenance break in Kanta PHR sandbox environments on the 25th of March 2020 from 8:00 am to 9:00 am. During this time, Kanta PHR sandbox environments are disabled. We apologize for the inconvenience.
Anssi Hämäläinen (Apr 29 2020 at 10:58):
On 6 May 2020, there will be a maintenance break from 7 am to 9 am in Kanta PHR sandbox environments. A new version of Kanta PHR sanbox will be installed and the test data of the unauthorized side will be lost. We apologize for the inconvenience.
Anssi Hämäläinen (Jun 25 2020 at 07:48):
Next week on July 2, 2020, a new version is scheduled to be installed in the Kanta PHR Sandbox environment, that includes some changes that affect the functions of Kanta PHR integration. We are going to upgrade HAPI FHIR on Kanta PHR platform to version 5.0.2. The biggest changes with the upgrade are related to the validation of resources, that has been improved in the latest versions of HAPI. Here are same concrete highlights of the upcoming changes:
• In the future, HAPI and the platform validate that in the beginning of resource’s .identifier.value there has to be ”urn:uuid:”, if ”urn:ietf:rfc:3986” is given as the identifier.system. If this is not given, the resource cannot be saved.
• Much of the text of the error messages returned from validation have changed.
• Contained resources: In the future, reference to a profile will also be mandatory from the contained resource.
• The validation of extensions has improved. For example, they can no longer be placed in types of resources that are not defined in the .context section of the extension.
• In the future, HAPI will instruct to add “xml:lang=\"fi\"” to the narrative as well. If that is missing, a warning will be given.
Please report to us any issues or problematic changes the you come across with the new version.
Anssi Hämäläinen (Aug 26 2020 at 06:36):
Tomorrow on August 27, 2020, a new version is scheduled to be installed in the Kanta PHR Sandbox environment that includes mainly accessibility changes.
Anssi Hämäläinen (Sep 07 2020 at 07:37):
Tomorrow, September 8, 2020 at 10:30 am, small bug fixes related to accessibility will be installed in the Kanta PHR Sandbox environment.
Anssi Hämäläinen (Sep 24 2020 at 10:33):
Tomorrow, September 25, 2020 at 8:30 am, a new version containing small bug fixes will be installed in the Kanta PHR Sandbox environment.
Anssi Hämäläinen (Sep 29 2020 at 07:06):
On October 1, 2020, there will be a maintenance break from 10 am to 11 am in Kanta PHR sandbox environments. We apologize for the inconvenience.
Anssi Hämäläinen (Jan 29 2021 at 12:59):
The new version (TK2.4) will be updated to Kanta PHR Sandbox environment on February 2nd on 2021 from 14pm to 16pm. The new version includes the following changes:
- HAPI FHIR upgrade to version 5.2.0
- FHIR R4 support for SelfCarePlan and Insulin Dosing profiles
- Improvements to production functionality and data security of the service
Sami Ukkonen (Feb 22 2021 at 06:11):
Hei, Onko insuliinien yksikkönä käytetty U:ta vai IU:ta?
Mikael Rinnetmäki (Feb 22 2021 at 21:33):
Tästähän oli keskustelua ja asia muuttuikin muutamaan otteeseen. Käsittääkseni viimeksi tultiin tulokseen, että sekä koodi että teksti olisivat IU.
Aleksi Aho (Feb 23 2021 at 13:46):
Moi. Tosiaan syksyllä keskusteltiin aiheesta, ja päädyttiin tuohon IU-muotoon, kuten Mikael tuossa muisteli.
Sami Ukkonen (Feb 24 2021 at 12:19):
Hei, Tuo IU tiedon vienti ei toimi ollenkaan vaan tuo U:n vienti , mutta jos laittaan tuon IU:n muotoon [IU], niin sen vienti toimii. Tämän tiedon löysin täältä https://ucum.nlm.nih.gov/ucum-lhc/demo.html. Eli pitäisikö tuo IU saada vietyä ihan noin vai onko hakasulkeet pakolliset?
Aleksi Aho (Mar 02 2021 at 13:05):
Moi. Esimerkkiresurssi, jossa käytetään tuota IU-muotoa löytyy täältä: https://simplifier.net/FinnishPHRR4/InsulinDosage-example-optional/~json
Mikael Rinnetmäki (Mar 03 2021 at 08:53):
Moi,
Kokeilin tuota juuri hiekkalaatikossa. Muodossa:
{
"resourceType": "MedicationAdministration",
"meta": {
"versionId": "1",
"lastUpdated": "2019-05-27T13:04:55.345+03:00",
"profile": [
"http://phr.kanta.fi/StructureDefinition/fiphr-sd-insulindosing-r4"
]
},
"language": "en",
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">\r\n Name of the medication: Actrapid <br/>\r\n VNRCode: Glucose In Blood (15074-8) <br/>\r\n Type of insulin: Fast-acting insulin (ins-short-fast) <br/>\r\n Time: 18.5.2019 15:05 \r\n </div>"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:2bc59f2d-5e28-4d1b-a403-bf3a27b1610a"
}
],
"status": "completed",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://phr.kanta.fi/CodeSystem/fiphr-cs-insulincode",
"code": "ins-short-fast",
"display": "Fast-acting insulin"
},
{
"system": "http://ownSystem.fi/CodeSystem/cs-insulincode",
"code": "1234",
"display": "Fast insulin"
}
],
"text": "A code for short and fast acting insulins, for example insulins that could be included in the group A10AB of the ATC Code System."
},
"subject": {
"reference": "Patient/daf8ca40-b46c-4c6b-99d5-d3a1b77074ad"
},
"effectiveDateTime": "2020-10-05",
"performer": [
{
"actor": {
"reference": "Patient/daf8ca40-b46c-4c6b-99d5-d3a1b77074ad"
}
}
],
"note": [
{
"authorString": "AuhtorString",
"time": "2019-05-27",
"text": "Note Text is Mandatory Field"
}
],
"dosage": {
"text": "Dosage Text",
"dose": {
"code": "IU",
"unit": "IU",
"value": 3,
"system": "http://unitsofmeasure.org"
},
"rateQuantity": {
"value": 5,
"unit": "g/min",
"system": "http://unitsofmeasure.org",
"code": "g/min"
}
}
}
Vastauksena tulee
Error: HTTP 422 Undefined: Reference to a wrong FHIR-version, url: http://phr.kanta.fi/StructureDefinition/fiphr-sd-insulindosing-r4
{
"resourceType": "OperationOutcome",
"issue": [ {
"severity": "error",
"code": "processing",
"details": {
"coding": [ {
"system": "http://phr.kanta.fi/fiphr-cs-errorcodes",
"code": "504320"
} ],
"text": "Reference to a wrong FHIR-version"
},
"diagnostics": "Reference to a wrong FHIR-version, url: http://phr.kanta.fi/StructureDefinition/fiphr-sd-insulindosing-r4"
} ]
}
Mikael Rinnetmäki (Mar 03 2021 at 08:54):
Eli pitäisikö r4 olla tuettuna hiekkalaatikossa?
Mikael Rinnetmäki (Mar 03 2021 at 09:44):
Simplifierin muissa esimerkeissä taitaa olla koodina U.
Mikael Rinnetmäki (Mar 03 2021 at 09:45):
Ja tuollainen resurssi ei mene Omatietovarannon hiekkalaatikkoon:
{
"resourceType": "MedicationAdministration",
"meta": {
"profile": [
"http://phr.kanta.fi/StructureDefinition/fiphr-sd-insulindosing-stu3"
]
},
"language": "fi",
"text": {
"status": "generated",
"div": "<div lang=\"fi\" xml:lang=\"fi\" xmlns=\"http://www.w3.org/1999/xhtml\">Koodi: Pitkävaikutteinen insuliini (ins-intermediate-long)<br />Aika: 26.8.2020 18:00:00<br />Annos: 8 IU<br />Laite: AbbottFreeStyleLibre4E950D12-275E-49E3-96F3-6F0D6FB8F28C (via Sensotrend Connect)</div>"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:a317a702-5912-58a2-8102-dcd6c4e7dd97"
}
],
"status": "completed",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://phr.kanta.fi/CodeSystem/fiphr-cs-insulincode",
"code": "ins-intermediate-long",
"display": "Pitkävaikutteinen insuliini"
}
],
"text": "Pitkävaikutteinen insuliini"
},
"subject": {
"reference": "Patient/a940a99e-a214-488c-9fb7-f2e35d76f1a0"
},
"effectiveDateTime": "2020-08-26T18:00:00.000+02:00",
"performer": [
{
"actor": {
"reference": "Patient/a940a99e-a214-488c-9fb7-f2e35d76f1a0"
}
}
],
"dosage": {
"text": "Pitkävaikutteinen insuliini, 8 yksikköä",
"dose": {
"value": 8,
"unit": "IU",
"system": "http://unitsofmeasure.org",
"code": "IU"
}
}
}```
Mikael Rinnetmäki (Mar 03 2021 at 09:47):
Mutta jos muuttaa dosage.dose.coden arvoon U, niin menee:
{
"resourceType": "MedicationAdministration",
"meta": {
"profile": [
"http://phr.kanta.fi/StructureDefinition/fiphr-sd-insulindosing-stu3"
]
},
"language": "fi",
"text": {
"status": "generated",
"div": "<div lang=\"fi\" xml:lang=\"fi\" xmlns=\"http://www.w3.org/1999/xhtml\">Koodi: Pitkävaikutteinen insuliini (ins-intermediate-long)<br />Aika: 26.8.2020 18:00:00<br />Annos: 8 IU<br />Laite: AbbottFreeStyleLibre4E950D12-275E-49E3-96F3-6F0D6FB8F28C (via Sensotrend Connect)</div>"
},
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:uuid:a317a702-5912-58a2-8102-dcd6c4e7dd97"
}
],
"status": "completed",
"medicationCodeableConcept": {
"coding": [
{
"system": "http://phr.kanta.fi/CodeSystem/fiphr-cs-insulincode",
"code": "ins-intermediate-long",
"display": "Pitkävaikutteinen insuliini"
}
],
"text": "Pitkävaikutteinen insuliini"
},
"subject": {
"reference": "Patient/a940a99e-a214-488c-9fb7-f2e35d76f1a0"
},
"effectiveDateTime": "2020-08-26T18:00:00.000+02:00",
"performer": [
{
"actor": {
"reference": "Patient/a940a99e-a214-488c-9fb7-f2e35d76f1a0"
}
}
],
"dosage": {
"text": "Pitkävaikutteinen insuliini, 8 yksikköä",
"dose": {
"value": 8,
"unit": "IU",
"system": "http://unitsofmeasure.org",
"code": "U"
}
}
}
Mikael Rinnetmäki (Mar 03 2021 at 09:48):
@Aleksi Aho oliko R4-hiekkalaatikko jossain eri osoitteessa, vai millä tavoin R4-resursseja voi tällä hetkellä testata?
Aleksi Aho (Mar 03 2021 at 10:06):
Moi. Tuo hiekkalaatikon käyttöliittymä ei näytä olevan ajantasalla tällä hetkellä, korjaamme sen! R4-tukea pääsee tällähetkellä kokeilemaan suoraan rajapintaa vasten osoitteessa http://fhirsandbox.kanta.fi/phr-resourceserver/baseR4.
Aleksi Aho (Mar 03 2021 at 10:15):
Simplifierin esimerkkeihin näyttää jääneen epähuomiossa vääriä koodeja, korjaamme ne myös pikimmiten. Selvittelen myös tuota U ja IU -asiaa. Kiitos tiedoista!
Aleksi Aho (Mar 03 2021 at 13:41):
Mikael Rinnetmäki said:
Aleksi Aho oliko R4-hiekkalaatikko jossain eri osoitteessa, vai millä tavoin R4-resursseja voi tällä hetkellä testata?
Nyt pitäisi hiekkalaatikon käyttöliittymässä toimia myös R4-endpoint. Endpointin saa valittua oikeasta yläkulmasta Server-alasvetovalikon kautta.
Sami Ukkonen (Mar 10 2021 at 06:40):
Hei,
Tälläinen vastaus tulee kantapalvelusta, kun hakee tietoja:
{"resourceType":"OperationOutcome","issue":[{"severity":"error","code":"processing","details":{"coding":[{"system":"http://phr.kanta.fi/fiphr-cs-errorcodes","code":"501440"}],"text":"Data is invalid"},"diagnostics":"Data is invalid"}]}
Onko jossain tietoa noista virhekoodeista? Tämä "http://phr.kanta.fi/fiphr-cs-errorcodes" sivu ei ainakaan aukea, jossa kooditietoja ilmeisesti olisi.
Aleksi Aho (Mar 10 2021 at 07:47):
Hei,
kiitos tiedosta. Tutkimme asiaa. Virhekoodit löytyvät Simplifier-palvelusta: https://simplifier.net/finnishphr/fiphr-cs-errorcodes. Tuo URL, joka palautuu virheviestissä on virhekoodiston canonical-url -osoite. Canonical-urleista voi lukea lisää täältä: https://www.hl7.org/fhir/references.html#canonical
Eeva Turkka (Mar 11 2021 at 09:59):
Korjasimme sb-ympäristön konffia, eikä virhettä pitäisi enää esiintyä. Pahoittelemme!
Sami Ukkonen (Mar 30 2021 at 12:38):
Hei,
Pitäisikö omatietovarannossa toimia Observation resurssityypeissä tälläinen, kuin dataAbsentReason? Laitoin arvolla unknown sitä, niin ei ainakaan hiekkalaatikkoympäristö ota vastaan tuota tietoa. Tarkoituksena on siis kertoa, että tiedolle ei löydy arvoa, mutta sellainen tieto on kuitenkin olemassa ilman arvoa.
Aleksi Aho (Mar 30 2021 at 13:03):
Moi. Mitä tietoa yrität tallentaa? DataAbsentReason-elementti ei ole käytössä kaikissa PHR:n profiileissa.
Sami Ukkonen (Mar 31 2021 at 07:27):
Hei, Tallennamme hiilihydraattien määrää Observation resourceTypeen. Joskus on sellaisia tietoja tuolla hiilihydraateissa, että on merkattu, mutta ei ole syötetty arvoa hiilihydraateille. Joten tälläisessä tapauksessa pitäisi saada vietyä Observaatioon tieto, että hiilihydraatit on viety, mutta arvolla tuntematon. Tässä on esimerkki mitä yritän lähettää (VScode:n kautta kopioitu. Ei näytä ihan kaikkia tietoja):
'{"resourceType":"Observation","meta":{"profile":["http://phr.kanta.fi/StructureDefinition/fiphr-sd-macronutrientintake-stu3"]},"language":"fi","text":{"status":"generated","div":"<div lang=\\"fi\\" xml:lang=\\"fi\\" xmlns=\\"http://www.w3.org/1999/xhtml\\">Koodi: Arvioitu hiilihydraattimäärä (LOINC 9059-7)<br />Aika: 24.5.2020 20:21:00<br />Arvioitu hiilihydraattimäärä: Unknown g<br />Laite: FreeStyle Libre sensori JTMZ116-K0296 (via Sensotrend Connect)</div>"},"identifier":[{"system":"urn:ietf:rfc…"coding":[{"system":"http://phr.kanta.fi/CodeSystem/fiphr-cs-observationcategory","code":"nutrition","display":"Ravitsemus"}]}],"code":{"coding":[{"system":"http://loinc.org","code":"9059-7","display":"Arvioitu hiilihydraattimäärä"}]},"subject":{"reference":"Patient/xxxxxxxxxxxxxxxxxxxx"},"effectiveDateTime":"2020-05-24T20:21:00.000+03:00","issued":"2021-03-31T07:15:14.551Z","performer":[{"reference":"Patient/xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}],"dataAbsentReason":"unknown"}'
Aleksi Aho (Apr 07 2021 at 09:59):
Moi, käyttämässänne macronutrientIntakeSTU3-profiilissa ei ole käytössä DataAbsentReason-elementtiä, joten sen käyttö ei onnistu. Olemme valmistelemassa Omatietovarannossa FHIR R4-tukea, ja tuo elementti voidaan ottaa mukaan R4-profiilissa, kun sen käyttö tulee mahdolliseksi.
Anssi Hämäläinen (Mar 10 2022 at 09:24):
Hei, tiedoksi, että hiekkalaatikkoympäristössä tulisi jatkossa käyttää https:ää. (Hi, in the future, https should be used in the sandbox environment of Kanta PHR.)
Last updated: Apr 12 2022 at 19:14 UTC
