K I T H INFORMASJONSTEKNOLOGI FOR HELSE OG VELFERD.. Ebrev Elektronisk utsending av brev VERSJON 1.0 Status: Til utprøving 1.2.2010 KITH-rapport 1020:2010
KITH-rapport TITTEL Ebrev Elektronisk utsending av brev Versjon 1.0 Status: Til utprøving Postadresse Sukkerhuset N-7489 Trondheim Besøksadresse Sverresgt 15 Telefon +47-73 59 86 00 Forfatter(e): Espen Stranger Seland Oppdragsgiver(e): Nav Drift og Utvikling Telefaks +47-73 59 86 11 e-post firmapost@kith.no Foretaksnummer 959 925 496 ISBN Dato Antall sider Kvalitetssikret av Gradering Godkjent av: 1.2.2010 9 Åpen Tom Christensen Rapportnr: 1020:2010 Sammendrag Dokumentet beskriver hvordan brev i form av PDF skal sendes elektronisk ved bruk av hodemeldingen. Metoden er egnet for å erstatte vanlige brev som tradisjonelt blir sendt som papir som post. Dokumentet inneholder noen uavklarte punkter som vil bli satt fast under utprøving mellom Nav og leverandører.
3 Ebrev Innhold 1 Dokumenthistorie... 4 2 Innledning... 5 2.1 Bruksområder... 5 2.2 Om dette dokumentet... 5 3 Teknisk beskrivelse... 6 3.1 Hodemelding... 6 3.2 PDF... 7 3.3 Bruk av base64-koding i hodemeldingen... 7 4 Referanser... 9
4 Ebrev 1 Dokumenthistorie Dato 14.12.2009 Dokument versjon 0.1 opprettet Detaljer 1.2.2010 Dokument versjon 1.0 opprettet
5 Ebrev 2 Innledning Dette kapitlet gir en kort beskrivelse av dokumentet og dokumentets bruksområder. 2.1 Bruksområder Dokumentet beskriver hvordan brev i form av PDF skal sendes elektronisk ved bruk av hodemeldingen. Metoden er egnet for å erstatte vanlige brev som tradisjonelt blir sendt som papir som post. 2.2 Om dette dokumentet Dokumentet er myntet på leverandører og it-personell som skal implementere meldingen. Dokumentet inneholder mye tekniske detaljer som kun er relevant for de som skal implementere meldingen.
6 Ebrev 3 Teknisk beskrivelse 3.1 Hodemelding Spesifikasjonen av hodemeldingen må leses og forstås av de som skal implementere de meldingene som er spesifisert i dette dokumentet. Dette kapittelet spesifiserer hvilke felter som skal plasseres i hodemeldingen og hvor disse skal plasseres. I tillegg til elementene nevnt under må alle obligatoriske klasser og dataelementer spesifisert i hodemeldingen (2), være med i meldingsinstansene. Meldingsinformasjon fylles ut som beskrevet i Standard for hodemelding. Meldingstype skal være EBREV fra kodeverk 8279 Meldingens funksjon. Kodeverk finnes i metadatakatalogen Volven. Eksempel: <Type V="EBREV" DN="Elektronisk brev" /> Avsender fylles ut som beskrevet i Standard for hodemelding. Minimumskravet for avsenderinformasjon i hodemeldingen er: MsgHead/MsgInfo/Sender/Organisation/OrganisationName MsgHead/MsgInfo/Sender/Organisation/Ident Tilsvarende krav for Mottaker: MsgHead/MsgInfo/Receiver/Organisation/OrganisationName MsgHead/MsgInfo/Receiver/Organisation/Ident Informasjon om Pasient fylles ut som beskrevet i Standard for hodemeldingen hvis sendingen gjelder en spesiell pasient. Hvis det er informasjon som ikke er knyttet til pasient, skal ikke informasjon om pasienten fylles ut. Minimumskravet for utfylling er: Navn Navn Element MsgHead/MsgInfo/Patient/FamilyName MsgHead/MsgInfo/Patient/MiddleName (etter behov) MsgHead/MsgInfo/Patient/GivenName Dokument skal inneholde innholdsbeskrivelse (ContentDescription), som beskriver hva brevet er. Eksempelvis Vedtaksbrev, Informasjonssak fra Nav etc. Innholdskategori (ContentCategory) skal benytte følgende kodeverdier: I F B Til informasjon Brevet kan f.eks lagres pasientjournal automatisk uten at legen behøver gjøre noe. Forespørsel Det forventes svar fra mottaker. Brev Det forventes at brevet skal behandles av mottager, men kan ikke avgjøre om det er en direkte forespørsel.
7 Ebrev Dersom innholdskategori ikke er utfylt forventes at brevet leses av mottager (Brev) For utfylling av Referanse, se under. Signatur skal ikke benyttes. 3.2 PDF PDF (Portable Document Format) er et åpent format som egner seg spesielt for distribusjon av tekstdokumenter for publisering. Følgende PDF-versjoner kan benyttes: PDF 1.4 1.6, PDF 1.7 (ISO 32000-1) eller PDF/A (ISO 19005-1) ved utveksling av dokumenter beregnet for lesing (1). Følgende elementer Referanse i hodemeldingen skal benyttes: type dokument (Document/RefDoc/MsgType): Kodeverket Type dokumentreferanse (OID=8114). Verdi skal alltid være V som er Vedlegg. Mimetype (Document/RefDoc/MimeType): Bruk korrekt type for det binære vedlegget, eksempelvis application/pdf, image/jpeg, video/mp4 osv. Den enkelte meldingstype vil bestemme hvilke typer binære vedlegg som er lovlige. For Ebrev er det kun application/pdf som er lovlig. Betegnelse (Document/RefDoc/Description): Kort beskrivelse av innholdet, eksempelvis Brev. Eksempel: <Document> <RefDoc> <MsgType V="A" DN="Vedlegg"/> <MimeType>application/pdf</MimeType> <Description>Svar på individuell søknad</description> <Content> <Base64Container xsi:schemalocation="http://www.kith.no/xmlstds/base64container kith-base64.xsd" xmlns="http://www.kith.no/xmlstds/base64container" xmlns:xsi="http://www.w3.org/2001/xmlschemainstance">pd94bwwgdmvyc2lvbj0ims4wiiblbmnvzgluzz0ivvrgltgipz4ncjxnc2dizwfkihhtbg5zpsjo (...) dhrwoi8vd3d3lmtpdggubm8veg1sc3rkcy9tc2dozwfklziwmdytmdutmjqiihhtbg5zomrzpsjo c2thbcb25njlig1lzcatlt4ncjwvtxnnsgvhzd4ncg==</base64container> </Content> </RefDoc> </Document> For innhold (Content), se under. 3.3 Bruk av base64-koding i hodemeldingen Vedlegg (PDF) skal ligge inline i hodemeldingen i elementet Content. Beskrivelsen er hentet fra notatet Bruk av base64-koding i hodemeldingen (3) Content-elementet i hodemeldingen er beregnet på XML som er strict, noe som betyr at innholdet må valideres korrekt mot en oppgitt XSD. For å løse dette er det laget en XSD som i prinsippet en konteiner for base64-kodet innhold. <?xml version="1.0" encoding="utf-8"?> <!-- Base64Container v1.0 2009-06-16 KITH http://www.kith.no/ Skjema for å benytte base64-kodet innhold i Document/Content-elementet i Hodemeldingen.
8 Ebrev --> <xs:schema xmlns="http://www.kith.no/xmlstds/base64container" xmlns:xs="http://www.w3.org/2001/xmlschema" targetnamespace="http://www.kith.no/xmlstds/base64container" elementformdefault="qualified" attributeformdefault="unqualified"> <xs:element name="base64container"> <xs:complextype> <xs:simplecontent> <xs:extension base="xs:base64binary"/> </xs:simplecontent> </xs:complextype> </xs:element> </xs:schema> 3.4 XML-eksempel <?xml version="1.0" encoding="utf-8"?> <MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsd="http://www.w3.org/2001/xmlschema.xsd" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xsi:schemalocation="http://www.kith.no/xmlstds/msghead/2006-05-24 MsgHead-v1_2.xsd"> <MsgInfo> <Type V="EBREV" DN="Elektronisk brev"/> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2009-12-14T19:21:12</GenDate> <MsgId>3c549940-e97b-11de-8a39-0800200c9a66</MsgId> <Sender> <Organisation> <OrganisationName>Nav Drift og Utvikling</OrganisationName> <Ident> <Id>990983291</Id> <TypeId S="2.16.578.1.12.4.1.1.9051" V="ENH" DN="Organisasjonsnummeret i Enhetsregister"/> </Ident> </Organisation> </Sender> <Receiver> <Organisation> <OrganisationName>Kattskinnet legesenter</organisationname> <Ident> <Id>971318864</Id> <TypeId S="2.16.578.1.12.4.1.1.9051" V="ENH" DN="Organisasjonsnummeret i Enhetsregister"/> </Ident> <HealthcareProfessional> <FamilyName>Koman</FamilyName> <GivenName>Magnar</GivenName> <Ident> <Id>9144889</Id> <TypeId S="2.16.578.1.12.4.1.1.8116" V="HPR" DN="HPR-nummer"/> </Ident> </HealthcareProfessional> </Organisation> </Receiver> </MsgInfo> <Document> <ContentDescription>Informasjonsbrev fra Nav</ContentDescription> <RefDoc> <MsgType V="A" DN="Vedlegg"/> <MimeType>application/pdf</MimeType> <Description>Brev</Description> <Content> <Base64Container xsi:schemalocation="http://www.kith.no/xmlstds/base64container kith-base64.xsd" xmlns="http://www.kith.no/xmlstds/base64container" xmlns:xsi="http://www.w3.org/2001/xmlschemainstance">pd94bwwgdmvyc2lvbj0ims4wiiblbmnvzgluzz0ivvrgltgipz4ncjxnc2dizwfkihhtbg5zpsjo dhrwoi8vd3d3lmtpdggubm8veg1sc3rkcy9tc2dozwfklziwmdytmdutmjqiihhtbg5zomrzpsjo awrkzww+dqojcqkjctxpchbkyxrlcnrgzxn0pjiwmdgtmdktmtdumtm6mji6mde8l09wcgrhdgvy dezlc3q+dqojcqkjpc9szxnlchq+dqojcqk8l0nvbnrlbnq+dqojctwvumvmrg9jpg0kctwvrg9j dw1lbnq+dqojpcetlsa8zhm6u2lnbmf0dxjlpiblcib1dgvsyxr0igkgzwtzzw1wbgv0lcbtzw4g c2thbcb25njlig1lzcatlt4ncjwvtxnnsgvhzd4ncg==</base64container> </Content> </RefDoc> </Document> </MsgHead>
9 Ebrev 4 Referanser 1. FAD. Referansekatalogen versjon 2, kap 1.1.3 Utveksling av dokumenter som vedlegg til e-post fra statlige virksomheter til innbyggere/næringsliv. 2. KITH. R01/06 Standard for hodemelding, versjon 1.2. s.l. : KITH, 2006. ISBN 82-7846-277-1. 3. Seland, Espen Stranger. Bruk av base64-koding i hodemeldingen. s.l. : KITH, 2009. 4. Volven. [Internett] KITH. http://www.volven.no.