A 18 Validering af dataleverancer ifm. Ældredokumentationsprojektet

Transkript

1 Danmarks Statistik, IT-Center 27. mar Jbb/Flj A 18 Validering af dataleverancer ifm. Ældredokumentationsprojektet Indhold: 1. Indledning Validering med XML-skemaer i udviklingsfasen Digitaliser.dk erstatter Infostrukturbasen Validering med skemaer på Digitaliser.dk Validering af XML-filer Download af skemaer fra Digitaliser.dk...7 k:\aeldreprojektet\ny dataleverance til ældredokumentation (eojaed2)\specialistdokumenter\a18 vejledning til eoj vedr. validering af xml-filer\a18 vejledning til eoj-leverandørerne.doc

2 1. Indledning Indledning Formål Indhold 1 On-line validering af XML-filer til kontrol af at EOJ-systemtilpasningen er sket korrekt 2 Download af de enkelte skemaer fra Digitaliser.dk kan være nyttigt 3 Den tidligere vejledning erstattes af denne vejledning Målgruppe Kommunerne bidrager med oplysninger, der indgår ved beregning af indikatorer vedr. ældredokumentation. Disse oplysninger dannes i de kommunale EOJ-systemer og overføres efterfølgende til Danmarks Statistik til videre bearbejdning og generering af indikatorer. Oplysningerne overføres som filer fra den enkelte kommune til Danmarks Statistik. Filoverførslen mellem kommunerne og Danmarks Statistik sker med KMD som dataoperatør. Den tekniske løsning er en transportkanal, hvor igennem, der overføres filer én gang i døgnet. Danmarks Statistik overfører kun oplysninger fra filer, der overholder de krav, som Danmarks Statistik har fastlagt efter høring fra bla. EOJ-leverandørerne. Overførsel af filer til Danmarks Statistik har været i drift siden udgangen af I efteråret 2008 har Velfærdsministeriet besluttet, at etablere yderligere en dataleverance. EOJ-leverandørerne skal således tilpasse deres systemet til også at kunne generere den nye leverance. Der er således to grunde til at udarbejde denne nye vejledning: Videnskabsministeriet har nedlagt Infostrukturbasen og erstattet den med Digitaliser.dk, hvilket har konsekvenser for måden, der skal valideres på Dataleverancen er ændret, såldes at der kan overføres 8 XML-filer i stedet for 7 og hermed er både antallet og indholdet af XML-skemaer ændret, ifm. den nye leverance skal opbygningen af alle øvrige XML-filer tilpasses Denne vejledning har tre formål. Der gives en kort introduktion til Digitaliser.dk i afsnit 3 og i afsnit 4 vises, hvordan EOJ-leverandørerne skal foretage on-line validering af XML-filerne. Afsnit 5 viser konkret eksempel på on-line validering af en konkret XML-fil med XML-SPY, både uden og med fejl i XML-filen. Afsnit 3-5 skal anvendes ifm. EOJ-leverandørernes kontrol af, at XML-filerne er valide og derfor overholder de definitioner, Danmarks Statistik har fastlagt ifm. filoverførsel til Danmarks Statistik. Afsnit 6 beskriver, hvordan de enkelte 39 XML-skemaer kan downloades fra digitaliser.dk. Det kan være meget nyttigt i tilpasningen af EOJ-systemet at gennemgå de enkelte skemaer. Danmarks Statistik har beskrevet kravene til dataleverancerne i notat A3 Beskrivelse af dataleverancer og dataudveksling af 6. juli 2007/opdateret 27. feb. 2009, der er fremsendt til EOJ-leverandørerne. I forbindelse med det oprindelige projekt udarbejdede Danmarks Statistik en veljledning til EOJ-leverandørerne, der skulle gøre det muligt at foretage validering af XML-filerne igennem udviklingsprocessen ( A 18 Vejledning vedrørende validering af XML-filer med XML-skemaer fra Infostrukturbasen af 23. okt. 2007). Denne vejledning er ikke længere gyldig. Målgruppen for dokumentet er udviklere hos EOJ-leverandørerne. Dokumentet kræver kendskab til XML og tilhørende teknologier. 2

3 2. Validering med XML-skemaer i udviklingsfasen XML-leverancer skal valideres Danmarks Statistik indlæser kun oplysninger fra filer, der er gyldige ift. de krav, som er defineret af Danmarks Statistik og derfor kan valideres ift. de gældende XML-skemaer, der vil være uploadet på Videnskabsministeriets Digitaliser.dk. pr. 1. april I forbindelse med tilpasning af EOJ-systemerne skal EOJ-leverandørerne anvende de gældende XML-skemaer til validering af de XML-filer, som EOJsystemerne genererer, se notat A3 Beskrivelse af dataleverancer og dataudveksling af 6. juli 2007/opdateret 27. feb Derved sikres, at XML-filerne overholder de gældende retningslinier og ikke bliver afvist af Danmarks Statistik. 3. Digitaliser.dk erstatter Infostrukturbasen Digitaliser.dk Digitaliser.dk erstatter Infostrukturbasen, der begge er oprettet som led i bestræbelser på standardisering af dataudveksling. Digitaliser.dk trådte i produktion 1. februar Digitaliser.dk består bl.a. af en fælles database, hvor primært offentlige myndigheder kan lægge grænsesnittet for XML-leverancer, som den pågældende myndighed modtager. Dette sker i form af resurser, hvor resurser typisk vil indeholde XML-skemaer, som definerer datatyper og andre krav til XML-filer. Grupper, resurser og tags På Digitaliser.dk er der oprettet en række grupper som afspejler de deltagende organisationer og myndigheder. Det er under gruppen Danmarks Statistik at Ældredokumentationsprojektets XML-skemaer er placeret. Til grupperne er der tilknyttet resurser. En resurse er identificeret ved et navn og en beskrivelse. Et eksempel kan være resursen AeldreLeveranceL1U1Struktur, som i Ældredokumentationsprojektet modsvarer XML-leverancen af samme navn. Til denne resurse er tilknyttet en XML-skemafil DST_AeldreLeveranceL1U1Struktur.xsd, som er den XMLskemafil, som definerer leverancen og dens datatyper. Til resursen kan endvidere tilknyttes et eller flere nøgleord (tags), som kan benyttes ved søgninger på resurser. Dette er nyttigt, da resurser under Digitaliser.dk ikke mere er placeret i en mappestruktur. Alle Ældredokumentationsprojektets XML-skemaer kan i stedet findes under gruppen Danmarks Statistik og tagget URL-placering XML-skemaer tilgås via deres URL. En URL (Uniform Resource Locator) angiver en fysisk placering på WWW. Disse URL er navngives på Digitaliser.dk efter følgende skabelon: hvor {d*} repræsenterer et fortløbende nummer, som tildeles af Digitaliser.dk ved oprettelse af resursen eller upload af XML-skemaet. {filnavn} er navnet på den tilhørende XML-skemafil. 3

4 4. Validering med skemaer på Digitaliser.dk Validering i forhold til skemaer i Digitaliser.dk xsi:schemalocation skal angives når der skal valideres fra Digitaliser.dk Når de dannede XML filer skal valideres online i forhold til XML-skemaer, placeret på Digitaliser.dk kræver det en Internetadgang, og at XML-filen refererer korrekt til XML-skemaerne. For at kunne validere XML-filer online skal man tilføje en xsi:schemalocation attribut til rodelementet på den XML-fil, som skal valideres. Denne attribut sættes lig med Ældredokumentationsprojektets namespace ( ) efterfulgt af mellemrum ( ) og URLen til XML-skemafilen. Dette er illustreret nedenfor for XML-leverancefilen AeldreLeveranceL1U1Struktur.xml: <AeldreLeveranceL1U1Struktur xmlns= xmlns:xsi=" xmlns:dst=" xsi:schemalocation= > De URLer til XML-skemaer, som skal benyttes i forbindelse med Ældredokumentationsprojektets XML-filer er listet nedenfor. Leverence URLer til XML-skemafiler L1.1 everancel1u1struktur.xsd/inline L1.2 verancel1u2struktur.xsd/inline L1.3 everancel1u3struktur.xsd/inline L2.1 verancel2u1struktur.xsd/inline L2.2 verancel2u2struktur.xsd/inline L3 L4 L5 verancel3struktur.xsd/inline everancel4struktur.xsd/inline verancel5struktur.xsd/inline Online validering Når XML-filernes schemalocation definition er angivet vil de ved hjælp af et valideringsværktøj kunne valideres op mod de centralt liggende skemaer i Digitaliser.dk på Internettet. Man skal altså ikke have skemafilerne placeret lokalt, der skal blot refereres til skemafilerne, som ovenfor anført og der skal være Internetadgang. 4

5 Et udbredt værktøj til validering er eksempelvis XMLSpy. Fra Visual Studio og.net platformen er der også indbygget valideringsværktøjer. Browsere som FireFox og Internet Explorer vil ikke validere men blot vise XML dokumentet, hvis det er velformet, og kan derfor ikke bruges til validering mod XML-skemaer. 5. Validering af XML-filer Validering v.hj.a. XMLSPY: Nedenfor er vist nogle eksempler på hvordan en validering kan foregå. I eksemplet er anvendt det kommercielle produkt XMLSPY, men dette tjener alene som eksempel og skal ikke forstås som en anbefaling af dette værktøj. Fra XMLSPY åbner man sin XML-fil og herefter vil programmet selv validere i henhold til den skemareference som dokumentet indeholder. De 8 XML-filer er placeret i en mappe som vist nedenfor: XMLSPY åbnes og fra Filer/Open hentes f.eks. AeldreLeveranceL1U1Struktur.xml dokumentet. Ved første åbning forbinder programmet sig til Digitaliser.dk og henter definitioner ned fra XMLskemafilerne, hvilket bevirker at første dokument kan tage lidt længere tid at åbne. Hvis der er referencer, som ikke er fundet vil XMLSPY meddele at 5

6 dokumentet ikke kan valideres. Hvis derimod alle referencer er fundet kan dokumentet valideres. Fra menuen vælges XML Validate og XMLSPY meddeler resultatet af valideringen: Her This file is valid. Nedenfor vises validering med fejl i dokumentet idet CvrNr indeholder mere en 8 tal. <HjemmehjaelpBesoegStruktur> <BrugerCPRidentifikator> </BrugerCPRidentifikator> <LeverandoerCVRidentifikator> </LeverandoerCVRidentifik ator> <BesoegStartDatoTid> T20:33:00</BesoegStartDatoTid> <BesoegSlutDatoTid> T21:03:00</BesoegSlutDatoTid> Valideres på ny fremkommer følgende fejlmeddelelse i XMLSPY: This file is not valid, jf. markeringen. 6

7 6. Download af skemaer fra Digitaliser.dk Ifm. tilpasning af EOJ-systemet kan det være hensigtsmæssigt at studere de XML-skemaer, der varetager valideringen af XML-filerne. En oversigt over alle XML-skemaer samt skemastrukturen kan ses i A3 Beskrivelse af dataleverancer og dataudveksling. Hvis man ønsker at hente XML-skemaer, som benyttes i Ældredokumentationsprojektet er det på Digitaliser.dk muligt at hente skemaerne ned enkeltvist. Nedenfor er XML-skemaet DST_AeldreLeveranceL1U2Struktur.xsd fundet via resursen AeldreLeveranceL1U2Struktur. Via downloadknappen nederst i billedet kan skemaet hentes ned. 7