NEF - Rekommendationer till hantering av UUID/GUID
Bilaga till handboken för vårdaktörer human och djur
1. Bakgrund
Dokumentet har tagits fram i ett nationellt samarbete med representanter från landstingen, Sveriges Apoteksförening och Apotekens Service. Förvaltningen av dokumentet ligger nu hos eHälsomyndigheten.
Detta dokument är en bilaga till handboken för vårdaktörer human och djur.
Dokumentet beskriver regler för hantering av UUID/GUID vid kommunikation gällande e-recept och makuleringar med tillhörande kvittenser.
Att använda unika id har olika syften:
- identifiering av receptmeddelande
- identifiering av makuleringsmeddelande
- hantering av tekniska dubbletter
- loggning för support
- referens till tjänster mot förskrivningsoriginal
2. Beskrivning
En central fråga vid diskussion om identiteter är att det är en gemensam referens mellan olika system och verksamheter. I detta sammanhang sker en utväxling av identiteter mellan olika parter för användning i en process från förskrivning till eventuell expediering. Då användande av UUID till viss del skiljer sig mellan e-recept och makulering är beskrivningen uppdelad som en generell del kompletterad med en del för e-recept och en del för makulering.
2.1 Generellt
UUID / GUID finns på två olika nivåer i ett utväxlat meddelande (övergripande bild se nedan):
- Meddelandehuvud (MessageRoutingAddress) som refererar till en överföring mellan tekniska system. På denna nivå används InterChangeRef som term för det unika id:t. InterchangeRef, kan om så önskas användas som identitet på själva överföringen. Om man inte har speciellt behov för denna identitet kan den sättas till samma som IdOfMessageBySender.
- IdOfMessageBySender skall användas för att unikt identifiera själva meddelandet, dvs e-recept- alternativt makuleringsmeddelandet .
- PrescriptionSetId är alltid receptsamlingens identitet oavsett meddelandetyp. Dvs för makulering den ursprungliga receptsamlingens id.
Matris över tillåtna värden i id
XML |
e-recept |
e-recept Aperak |
Makulering |
Makulering Aperak |
Kommentar |
InterchangeRef |
Unikt id |
Unikt id |
Unikt id |
Unikt id |
Används vid viss typ av felsökning och spårbarhet |
IdOfMessageBySender |
Receptmeddelandets id |
N/A |
Makulering
Meddelandets id |
Makulering
Meddelandets id |
För e-recept kan denna identitet vara samma som PrescriptionSetId |
PrescriptionSetId |
Receptsamlingsid |
Receptsamlingsid |
Receptsamlingsid |
Receptsamlingsid |
Används vid felsökning och spårbarhet, framför allt hos eHälsomyndigheten |
2.1.1 e-recept
Receptmeddelande (NewPrescriptionMessage) som refererar till en receptsamling som utfärdats vid ett visst tillfälle av en förskrivare till en patient som underlag för expedition på ett apotek.
På denna nivå finns det två unika identiteter: IdOfMessageBySender och PrescriptionSetId.
IdOfMessageBySender är en identitet på övergripande nivå för NewPrescriptionMessage och kan ha samma värde som PrescriptionSetId.
PrescriptionSetId är identiteten på receptsamlingen. Den skall användas som referens i vårdsystem och ReceptRegistret samt är den identiteten som refereras i Aperaken.
2.1.2 Makulering
Makuleringsmeddelande (PrescriptionCancellationMessage) refererar till ett förskrivningsoriginal som skall makuleras.
IdOfMessageBySender är identiteten på makuleringsbegäran och den identitet som returneras och identifierar svars Aperaken.
PrescriptionSetId är i detta fall tillsammans med radid identifikationen på det recept som skall makuleras.
3. Regelverk för tillämpning av UUID/GUID i NEF
Nedan följer regelverk för tillämpning av UUID/GUID i NEF med beaktande av de olika syftena för respektive id:nivå.
3.1 Verksamhetsnivå - referens till tjänster mot förskrivningsoriginal
Rekommendation:
- att minst logga PrescriptionSetId i samtliga inblandade system för support och spårbarhet.
- För makulering är det IdOfMessageBySender som används som referens till en makuleringsbegäran.
- Support
- Spårning
- Felsökning
3.2 Teknisk nivå - dubbletthantering och loggning för support
En dubblett på PrecriptionSetId för ett e-recept accepteras inte av mottagande system utan avvisas oavsett innehåll.
4. Unika id:n för XML-meddelanden (UUID/GUID)
För e-recept skall en unik identifikation på receptsamlingsnivå användas. Detta unika id får aldrig återanvändas vid t.ex. förnyelse, förlängning osv. då det identifierar en händelse i patientens journal.
Som ID är det beslutat att UUID / GUID skall användas enligt standard RFC 4122.
Standarden säger t.ex. att formatet ska vara hexadecimala gemener i formatet xxxxxxxx-xxxx- Mxxx-Nxxx-xxxxxxxxxxxx, där N måste vara 8, 9 a eller b och M anger vilken version av UUID som används och kan vara 1-5.
För spårbarhetens skull är det en stark rekommendation att använda version 1, dvs M=1, som anger att UUID baseras på tid och MAC-adress.
RFC4122 kan bland annat hämtas från:http://www.faqs.org/rfcs/rfc4122.html
För e-recept gäller att alla dessa IDn kan vara inbördes unika eller vara samma om det är ett 1:1:1 förhållande mellan MessageRoutingAddress, GeneralPrescriptionMessageInformation och PrescriptionSet.
5. Kommentar
InterchangeRef
När NEF skapades använde många ett EDI-liknande kommunikationssätt (X400). Nuvarande implementering är endast gjord med hjälp av webservices. Detta har gjort regelverket för användning av InterchangeRef överflödig varför vi tonat ner betydelsen av identiteten i detta dokument. Standarden sätter inte heller några regler till hur den identiteten skall användas.
Versionshistorik
Utgåva |
Datum |
Kommentar |
2.0 |
2011-05-16 |
Versionen godkänd av NEF förvaltningsgrupp 2011-05-20 |
2.1 |
2011-10-14 |
InterchangeRef och PrescriptionSetId : förtydliganden av tillåtna id och kommentarer i matrisen under punkt 2.1 |
3.0 |
2014-05-02 |
Dokumentet är inlagt i en ny mall.
Dokumentet riktar sig till vårdsystemleverantörer human och djur.
1, samverkansgruppen med representanter från landstingen, Sveriges Apoteksförening och Apotekens Service har upphört. eHälsomyndigheten uppdaterar och fastställer dokumentet.
Kapitel 4 har lagts till. |
