Vejledning og feltværdier Den Gode VANSEnvelope - Bilag MedCom
Vejledning og feltværdier: Den Gode VANSEnvelope - Bilag Jacob Glasdam, MedCom udgivelsesdato 10. marts 2011 Revisionshistorie Revision 1.1 10. marts 2011 Jacob Glasdam MedCom Delt op, så Integration til Emessage er i sit eget bilag. Tilføjet navneområder for servicetags. Revision 1.0 27. januar 2011 Jacob Glasdam MedCom Samling af bilagsdokumenter til VANSEnvelope.
Indholdsfortegnelse 1. Indledning... 1 Parter... 1 2. FejlTyper... 2 Værdier for XX, hvor fejl er teknisk... 2 Værdier for XX, hvor fejl er rutning... 2 Værdier for XX, hvor fejl er bearbejdning... 3 Værdier for XX, hvor fejl er anden... 3 3. VANS negativ kvittering... 4 Årsager... 4 Undtagelse... 4 Beskrivelse og løsning... 4 Invalid kuvert... 4 Ukendt modtager... 4 Forkert afsender... 4 Fejl i processering... 5 4. Gensendelse af kuvert... 6 Anbefaling... 6 Identifikation af gensendelser.... 6 5. Identifikation... 7 Oversigt... 7 Begrundelse... 7 Almindelig forsendelse... 7 Kvittering... 7 Gensendelse... 7 Processering... 7 Transformering... 7 6. Meddelelsesnavn... 8 Navneområder på Document/Name... 8 MCM - MedCom... 8 OPS - Operativsystem... 8 Navneområder på Servicetag/@name... 9 MCM - MedCom... 9 iii
Kapitel 1. Indledning Parter Dette dokument beskriver de hoved scenarier der kan identificeres i transporten af en kuvert, forskellige problematikker ved overgang og implementation af VANSEnvelope. Der beskrives ikke detaljer for hvordan de enkelte parter opbygger, håndterer og sender kuverter, kvittering og evt. gensendelser. I den efterfølgende tekst nævnes VANSEnvelope som kuverten. Kuverten definerer en række elementer, disse anvendes som metadata for den medsendte meddelelse. Der kan føres statistik over afsendte meddelelser og modtagersystemet kan let vurdere meddelelsens relevans. Det programmel som producere og modtager meddelelser, er navngivet applikationen. I udvekslingen af kuverter er fire parter, hvis navn og rolle er som følger: Afsender Modtager Klient VANS Processeringsudbyder Afsender af en kuvert med data, kan modtage kvitteringer for denne kuvert, men vil i teksten bibeholde navnet afsender. Modtager af en kuvert med data, kan afsende kvitteringer for denne kuvert, men vil i teksten bibeholde navnet modtager. Dækker over modtager og afsender af kuverter, set fra VANS. Formidler kuverter af typen data, positive og negative kvitteringer, kan afsende negative vanskvitteringer. Tilbyder en service vha. VANS til datakuverter, dette sker i samarbejde med den enkelte VANS leverandør. 1
Kapitel 2. FejlTyper For at kunne adskilde de forskellige fejltyper systematisk er følgende klassifikation anbefalet at bruge for værdier i /VansEnvelope/NegativeReceipt/Error/Code. Koden er på fire cifre som er opdelt på formen: XXYY XX er fastsat til at være en af de her listede værdier, mens YY er en specifikation inden for XX klassifikation. YY værdien er op til afsender af kvitteringen. Værdier for XX, hvor fejl er teknisk 10 Syntax fejl i data format, det er ikke muligt at indlæse det fremsendte. (Kuverten eller indhold) kunne ikke læses. Fejl i linje [X] tegn [Y] 1 11 Valideringsfejl, formatet kunne læses, men indholdet overholder ikke det for meddelelsen specificeret. (Kuverten eller indhold) kunne ikke valideres. Fejl i linje [X] tegn [Y] 2 12 Identifikation af kuvert og/eller meddelelse er ikke unik. (Kuverten eller indhold) har samme id som tidligere modtaget. Værdier for XX, hvor fejl er rutning 20 Modtageren er ukendt. Modtageren i (kuverten eller meddelelsen) findes ikke i systemet. 21 Afsender er ukendt. Afsender identifikation svare ikke til det, der er registreret. 22 Flyttet til andet lokationsnummer. Modtageren er flyttet. Nyt lokationsnummer [EAN] 3 23 Modtager midlertidig lukket. Modtageren kan ikke modtage meddelelser før d. [DATE] 4 1 X: Linje nummer hvor til parsningen gik godt (Valgfri). Y: Tegn inde på linjen hvor til parsningen gik godt (Valgfri). 2 X: Linje nummer hvor til valideringen gik godt (Valgfri). Y: Tegn inde på linjen hvor til valideringen gik godt (Valgfri). 3 EAN: Nyt lokationsnummer for modtager. 4 DATE: Dato for fremtidig modtagelse af meddelelser. 2
FejlTyper Værdier for XX, hvor fejl er bearbejdning 30 Processeringen af meddelelse ved den part som er angivet i /VANSEnvelope/Message/ Processing fejlede. Den ønskede processering fejlede med følgende begrundelse: [ERROR] 5 31 Transformering af meddelelse fejlede. Indholdet af kuverten kunne ikke transformeres til andet format. Begrundelse: [ERROR] 6 32 Ukendt meddelelsestype. Meddelelsestypen er ikke kendt af modtagersystem. 33 Ukendt meddelelsesversion. Meddelelsesversionen er ikke kendt af modtagersystem. 34 Ukendt meddelelsesformat. Formatet for meddelelsen, kan ikke håndteres af modtager. Værdier for XX, hvor fejl er anden 90 Intern system fejl. Der opstod en system fejl i forbindelse med modtagelsen af kuverten. 99 Uspecificeret. Af ukendte årsager kunne kuverten ikke håndteres. 5 ERROR: fejlbeskrivelse fra processeringen. 6 ERROR: fejlbeskrivelse fra transformeringen. 3
Kapitel 3. VANS negativ kvittering Årsager Den eneste kuvert type som VANS genererer er negativ vanskvittering. VANS afsender en negativ vanskvittering i følgende tilfælde. Invalid kuvert Ukendt modtager Forkert afsender Fejl i processering Undtagelse Der er forsøgt sendt en kuvert som ikke overholder standarden. Oplysninger på kuvertmodtager findes ikke. Oplysninger på afsenderen, svarer ikke til det som er registreret hos VANS. Processeringsudbyderen melder fejl til VANS. Der er dog en undtagelse, som tillader VANS at sende en negativ kvittering på vegne af modtager. Det sker når en modtager får leveret en transformering af meddelelsen i en kuvert, hvis denne transformering fejler så sender VANS en negativ kvittering som var de modtageren. Beskrivelse og løsning Beskrivelserne her dækker over mange afarter, men skulle overordnet dække over alle typer af fejlmeldinger fra VANS. Løsningsbeskrivelserne er hvad der hyppigst vil være gældende, men dette er fiktion, og skal tages som sådan. Invalid kuvert Løsning Ved invalid kuvert er kuverten fejlbehæftet syntaks mæssigt. Den kan være så fejlbehæftet, at det ikke er muligt, at læse id på kuverten, i det tilfælde sættes kuvert id til 00000000-0000-0000-0000-000000000000 (8 nuller - 4 nuller - 4 nuller - 4 nuller - 12 nuller). I fejlbeskrivelsen udfyldes information som kan bruges til at identificere kuverten. Hvilken information det er afhænger af den måde klient og VANS udveksler kuverter på. Klient systemet er fejlbehæftet, og skal rettes. Ukendt modtager Løsning VANS kan kun route kuverter hvor modtager eksisterer i deres kartotek, ellers kvitteres der med en negativ kvittering. Adresse oplysningerne i klient systemet er utidssvarende eller brugeren har indtastet forkert. Orientering til brugeren, som så kan indsætte korrekte værdier. Forkert afsender VANS skal forhindre at en klient sender en kuvert med et andet afsender id end det som er registreret hos VANS. Ellers vil det have utilsigtede konsekvenser for kvitteringer og manglende troværdighed. 4
VANS negativ kvittering Løsning Klient systemet er fejlbehæftet, og skal rettes. Fejl i processering Løsning Da man kan sende alle former for data i kuverten, vil der på et tidspunkt blive sendt noget til en processeringsudbyder, som går i fejl. Processeringen foregår i samarbejde med VANS og processeringsudbyderen er ikke den endelige modtager af kuverten, derfor kan processeringsudbyderen ikke sende en negativ kvittering. I stedet sender VANS en negativ vanskvittering. Klient systemet kan have fejlen, i så fald skal det rettes. Det kan også skyldes fejl hos processeringsudbyderen, i det tilfælde skal processeringsudbyderen rette til. Hvis processeringen ikke ændrer data i kuverten, så kan kuverten sendes uden processerings angivelse. 5
Kapitel 4. Gensendelse af kuvert Standarden for den gode vansenvelope giver mulighed for at gensende en kuvert op til 3 gange ved manglende kvittering. For ikke at gensende alt for mange kuverter er der en anbefaling for hvornår man kan anvende gensendelse. Anbefaling Hvis information er af en art som modtager skal have inden for en fastsat tidsperiode, kan gensendelse anvendes. Tidsperioden skal så deles op så der kan nå at blive sendt op til 3 kuverter afsted, og tages andre kommunikationsveje i brug, hvis det ikke lykkes at få sendt en kuvert igennem. Identifikation af gensendelser. Ved gensendelser gælder følgende for id'er i kuverten. Meddelelses id Kuvert id Den må ikke ændres, det skal modtager bruge til at identificere at det er den samme meddelelse der er sendt. Skal ændres for hver afsendt kuvert. Ved modtagelse af en kvittering på en af de afsendte kuverter, stoppes evt. fremtidige gensendelser, også selvom det ikke er den senest gensendelse der kvitteres på. 6
Kapitel 5. Identifikation Oversigt I den gode VANSEnvelope, er der beskrevet 2 id'er i kuverten. Kuvert id, som er identifikation af en kuvert, og meddelelses id som er identifikation af en meddelelse. Der gælder forskellige regler for hvornår disse id'er skal ændres i de forskellige scenarier. Almindelig forsendelse Kvittering Gensendelse Processering Et nyt unikt id på kuvert og meddelelse. Nyt unikt id på kuvert, oprindeligt id på meddelelse. Et unikt id på kuvert, samme id på meddelelserne. Samme id på kuvert og meddelelse. Transformering Begrundelse Almindelig forsendelse Kvittering Samme id på kuvert og meddelelse. Ved almindelig forsendelse af en kuvert er det vigtigt at den kan unikt identificeres, både på kuvert niveau og meddelelses niveau. Ellers vil kvitteringsmekanismen fejle. Kvitteringen bruges af modtager til at identificere hvilken kuvert, og hvilken meddelelse der kvitteres for. Gensendelse Kuverterne skal kunne identificeres individuelt, men meddelelsen er den sammen og skal kunne genkendes på tværs af kuverter. Derfor skal hver gensendt kuvert have et nyt id, mens meddelelsens id er det samme. Processering Proccesseringen af indholdet i en kuvert er en service, som er en del af leverancen, og for at modtager kan sende en kvittering til afsender, skal processeringen ikke ændre kuvert eller meddelelses id. Transformering Transformering er en ydelse som VANS leverer. Som ved processering, skal afsender kunne kvittere til modtager, så kuvert og meddelelses id skal bibeholdes. 7
Kapitel 6. Meddelelsesnavn For at undgå konflikter i navnet på medddelelsen, er der indført et format for hvordan det skrives i / VANSEnvelope/Message/MetaInformation/Document/Name. Løsningen er at lave et namespace på værdien, så at det skal overholde syntaksen, [A-Z]{3}:+ De tre tegn før kolon angiver hvilket namespace navnet er i, mens de efterfølgende tegn er selve navnet på meddelelsen. Det samme gør sig gældende for attributten name, på Servicetag, de er listet i sektionen Navneområder på Servicetag/@name. Navneområder på Document/Name MCM - MedCom Tabel 6.1. Navneområde, MedCom Navn Version Beskrivelse MCM:XDIS21 Plejeforløbsplan. Anvendes af sygehuspersonalet til at informere hjemmeplejen om, at der er behov for revurdering af de ydelser som borgeren modtager, en kort orientering om indlæggelsesforløb, samt mulighed for at oplyse om der er behov yderligere koordinering i forhold til udskrivelse. MCM:XDIS21 XD2131C 2011-02-10 MCM:XDIS19 Melding om færdigbehandling. Funger som en notifikation om, at en borger med ydelser i hjemmeplejen er blevet registeret færdigbehandlet på sygehuset. MCM:XDIS19 XD1931C 2011-01-02 MCM:XDIS18 Udskrivningsrapport. Anvendes af sygehuspersonalet i forbindelse med udskrivelse af en patient, med et behov for pleje eller tilsyn fra dennes hjemkommune. MCM:XDIS18 XD1831C 2011-02-10 MCM:XDIS16 Indlæggelsesrapport. Sendes fra kommunen, når en borger indlægges på et sygehus, da sygehuspersonalet har brug for en række sundhedsfaglige oplysninger fra kommunen for at kunne iværksætte den bedst mulige behandling af patienten og for at kvalificere dialogen mellem sygehus og kommune. MCM:XDIS16 XD1631C 2011-02-10 OPS - Operativsystem Tabel 6.2. Navneområde, Operativsystem Navn Version Beskrivelse OPS:IMAGE Billedeformater OPS:IMAGE JPEG Den mest almindelige version. OPS:IMAGE JPEG2000 Version fra Joint Photographic Experts Group OPS:IMAGE PNG Tabsfrit, bitmapped OPS:IMAGE BMP Tabsfrit, bitmapped OPS:IMAGE GIF Tabsfrit, max 256 farver OPS:IMAGE SVG Scalable Vector Graphics OPS:DOC Dokumenter indholdende tekst og billeder. OPS:DOC PDF Portable Document Format, garanti for layout. OPS:DOC ODT Open Document Format for Office Applications. Der er ingen garanti for layout. 8
Meddelelsesnavn Navn Version Beskrivelse OPS:DOC WORD Version 97, 2000, 2002 og 2003 af Microsoft Word. Der er ingen garanti for layout. OPS:DOC WORDX Version 2008 og 2010 af Microsoft Word. Der er ingen garanti for layout. OPS:TEXT Tekst dokumenter, ingen billeder eller formatering. OPS:TEXT ASCII Tekst dokument med ASCII tegnsæt. OPS:TEXT UTF8 Tekst dokument med UFT-8 tegnsæt. OPS:TEXT LATIN1 Tekst dokument med latin-1 eller iso8859-1 tegnsæt. OPS:EXE Program til afvikling på modtagers computer. Navneområder på Servicetag/@name MCM - MedCom Tabel 6.3. Navneområde, MedCom Navn MCM:ABSTRACT Beskrivelse Kort tekst omkring indhold. MCM:LANG Sprog i meddelelsen, kodet efter ISO 639-1. MCM:MIME MCM:COMPRESSED MCM:TIMEOUT MCM:ID MCM:TIMES Internet media type, beskrivelse af meddelelsensindhold, se liste her: http://www.iana.org/ assignments/media-types/index.html Meddelelsen er pakket, og algoritmen er angivet som værdi. Antal minutter efter afsendelsestidspunktet, at en kvittering ønskes modtaget. Identifikation på meddelelse inde i selve kuverten. Hvor mange gange er denne meddelelse sendt (max 3 ved 3. gensendelse). 9