Handleiding XSLT s 18 augustus 2016

Transcriptie

1 Handleiding XSLT s 18 augustus 2016 Handleiding XSLT s 17 augustus / 12

2 Inhoud Inleiding 3 1 Introductie XML als standaard Validatie met XSLT s 4 2 XSLT s voor istandaarden Structuur 2.2 Gebruik 2.3 Licentie 8 3 XSLT voor iwlz Berichten 3.2 Controles 4 XSLT voor iwmo Berichten 4.2 Controles 5 XSLT voor ijw Berichten 5.2 Controles Handleiding XSLT s 17 augustus / 12

3 Inleiding Met de introductie van XML als het standaardberichtformaat voor alle istandaarden iwlz, iwmo en ijw is het mogelijk om XSLT s (Extensible Styles Language Transformations) toe te passen voor een beperkte vorm van validatie. De XSLT s zijn vooral bedoeld voor softwareleveranciers die werken aan software voor de istandaarden-releases van 2017: iwlz 1.2, iwmo 2.1 en ijw 2.1. De XSLT s komen van pas bij het correct opstellen van berichten door de verzender en het uitvoeren van controles door de ontvanger. XSLT s maken elementoverstijgende controles mogelijk voor de XSD s. Het gebruik van de XSLT s is niet verplicht. Zorginstituut Nederland stelt de XSLT s beschikbaar zodat softwareleveranciers ze kunnen gebruiken voor hun producten. Deze handleiding is bedoeld als ondersteuning bij het toepassen van de XSLT s. Hebt u na het lezen van deze handleiding nog vragen? Dan kunt u contact opnemen met het Beheerteam istandaarden van Zorginstituut Nederland: [email protected] of (020) Handleiding XSLT s 17 augustus / 12

4 1 Introductie 1.1 XML als standaard Vanaf 1 januari 2016 zijn ketenpartijen voor de uitvoering van de Wlz verplicht om in het iwlz-berichtenverkeer gebruik te maken van de XML-standaard. Voor de Wmo en Jeugdwet is dit per 1 april Binnen alle drie de zorgdomeinen worden XML-schemadefinities (XSD s) gebruikt om berichten te definiëren. In de informatiemodellen van Zorginstituut Nederland zijn alle berichten per istandaard weergegeven, inclusief de berichtdefinities en de verzameling regels en afspraken. Informatiemodel voor iwlz 1.2, Informatiemodel voor iwmo 2.1 Informatiemodel voor ijw Validatie met XSLT s Met XSLT s kunnen XML-berichten omgezet worden in andere XML-berichten of in een ander berichtformaat, zoals een CSV-bericht (Comma Separated Values). XSLT is een internationale standaard die beheerd wordt door het World Wide Web Consortium (W3C). Het uitgangspunt voor de XSLT-controle is een correct gestructureerd XML-bericht. Of een XML-bericht correct is gestructureerd, kan worden gecontroleerd met een XML-schema. Hiermee is de XSLT-controle afhankelijk van de XML-schemacontrole. Een XSLT kan gebruikt worden om een controle uit te voeren. Het resultaat van de controle is een foutenrapport in XML-formaat. Een in XSLT geïmplementeerde controle is typisch een elementoverstijgende controle die niet met een XML-schema kan worden gedefinieerd. Handleiding XSLT s 17 augustus / 12

5 In de hoofdstukken 3, 4 en 5 worden de XML-berichten en -controles uiteengezet die met XSLT s kunnen worden uitgevoerd. Handleiding XSLT s 17 augustus / 12

6 2 XSLT s voor istandaarden De XSLT s die Zorginstituut Nederland beschikbaar stelt, zijn alleen bruikbaar voor de berichten die zijn opgenomen in de informatiemodellen. Voor de declaratieberichten heeft Vektis zelf XSLT s ter beschikking gesteld. 2.1 Structuur De XSLT s voor istandaarden zijn, per informatiemodel, verpakt in een zip-bestand. Voor iwlz, iwmo en ijw bestaan dus aparte bestanden. Elk zip-bestand heeft deze structuur: commons Dit zijn herbruikbare XSLT s die gebruikt kunnen worden voor elk type controle van elk type bericht. schema Hierin zit het XML-schema voor het resultaat van de XSLT-controle, het foutenrapport in XML. wmo/jw/wlz De mapnaam varieert per informatiemodel. De map bevat de XSLT waarmee een specifiek bericht gecontroleerd wordt. Voor de WMO301 van iwmo 2.1 bijvoorbeeld, heet dit bestand WMO301.xsl. 2.2 Gebruik Softwareleveranciers kunnen de XSLT s toepassen in hun producten. Ze kunnen echter ook worden gebruikt voor een handmatige controle met behulp van XML-tools. De XSLT-controle levert een rapport op, een lijst van fouten met per fout een code en de elementen waar de fout betrekking op heeft. Een voorbeeld: Handleiding XSLT s 17 augustus / 12

7 De XSLT s kunnen gebruikt worden in zowel een handmatig als een geautomatiseerd proces. In een handmatig proces zal er een XML-tool gebruikt worden waarbij een istandaarden-bericht in XML en de bijbehorende XSLT worden geselecteerd om vervolgens de controle uit te voeren. De uitvoer heeft de vorm van het rapport op pagina 6. In een geautomatiseerd proces zal de XSLT controle een onderdeel vormen van een of meer processtappen om een istandaarden-bericht in XML te valideren. De uitvoer is uiteindelijk een bijbehorend retourbericht. Handleiding XSLT s 17 augustus / 12

8 2.3 Licentie De XSLT wordt onder een MIT-licentie uitgebracht. Dit betekent dat de XSLT s vrij zijn om toe te passen en te distribueren. Zie mitlicense.org voor de voorwaarden. Het is toegestaan om de broncode van de XSLT s aan te passen, maar Zorginstituut Nederland kan geen ondersteuning bieden op aangepaste XSLT s. Handleiding XSLT s 17 augustus / 12

9 3 XSLT voor iwlz Dit hoofdstuk beschrijft de XML-berichten en -controles die met de XSLT s voor iwlz kunnen worden uitgevoerd. 3.1 Berichten Deze berichten worden gevalideerd: Bericht AW317 AW33 AW35 AW39 CA317 CA319 IO31 ZK33 ZK35 ZK39 Beschrijving Wachtlijstbericht Toewijzing zorg Aanvang zorg Mutatie zorg Aanvang zorg CAK Mutatie zorg CAK Indicatiebesluit Toewijzing zorg ZK-ZK Aanvang zorg ZK-ZK Mutatie zorg ZK-ZK 3.2 Controles Deze controles worden uitgevoerd: Controle Type Code CS003 Constraint S003 CS023 Constraint S023 CS035 Constraint S035 CS049 Constraint S049 CS050 Constraint S050 CS057 Constraint S057 CS058 Constraint S058 CS062 Constraint S062 CS065 Constraint S065 CS067 Constraint S067 CS069 Constraint S069 CS071 Constraint S071 CS072 Constraint S072 CS073 Constraint S073 CS074 Constraint S074 CS086 Constraint S086 CS088 Constraint S088 CS089 Constraint S089 CS092 Constraint S092 Handleiding XSLT s 17 augustus / 12

10 CS093 Constraint S093 CS107 Constraint S107 CS108 Constraint S108 CS113 Constraint S113 CS114 Constraint S114 CS115 Constraint S115 CS118 Constraint S118 CS119 Constraint S119 CS120 Constraint S120 CS121 Constraint S121 CS122 Constraint S122 CS123 Constraint S123 CS318 Constraint S318 CD004 Conditie D004 CD005 Conditie D005 CD007 Conditie D007 CD009 Conditie D009 CD016 Conditie D016 CD017 Conditie D017 CD018 Conditie D018 CD020 Conditie D020 CD022 Conditie D022 CD023 Conditie D023 CD025 Conditie D025 CD029 Conditie D029 CD034 Conditie D034 CD036 Conditie D036 CD040 Conditie D040 CD047 Conditie D047 CD048 Conditie D048 Handleiding XSLT s 17 augustus / 12

11 4 XSLT voor iwmo Dit hoofdstuk beschrijft de XML-berichten en -controles die met de XSLT s voor iwmo kunnen worden uitgevoerd. 4.1 Berichten Deze berichten worden gevalideerd: Bericht WMO301 WMO305 WMO307 WMO315 Beschrijving Toewijzing Wmo-ondersteuning Start Wmo-ondersteuning Stop Wmo-ondersteuning Verzoek om toewijzing Wmo-ondersteuning 4.2 Controles Deze controles worden uitgevoerd: Controle Type Code CS002 Constraint S002 CS003 Constraint S003 CS023 Constraint S023 CS050 Constraint S050 CS057 Constraint S057 CS058 Constraint S058 CS089 Constraint S089 CS317 Constraint S317 CS318 Constraint S318 CD005 Conditie D005 CD007 Conditie D007 CD009 Conditie D009 CD025 Conditie D025 CD034 Conditie D034 CD041 Conditie D041 CD043 Conditie D043 CD044 Conditie D044 CD045 Conditie D045 CD046 Conditie D046 Handleiding XSLT s 17 augustus / 12

12 5 XSLT voor ijw Dit hoofdstuk beschrijft de XML-berichten en -controles die met de XSLT s voor ijw kunnen worden uitgevoerd. 5.1 Berichten Deze berichten worden gevalideerd: Bericht JW301 JW305 JW307 JW315 Beschrijving Toewijzing Jeugdhulp Start Jeugdhulp Stop Jeugdhulp Verzoek om toewijzing Jeugdhulp 5.2 Controles Deze controles worden uitgevoerd: Controle Type Code CS002 Constraint S002 CS003 Constraint S003 CS023 Constraint S023 CS050 Constraint S050 CS057 Constraint S057 CS058 Constraint S058 CS089 Constraint S089 CS317 Constraint S317 CS318 Constraint S318 CD005 Conditie D005 CD007 Conditie D007 CD009 Conditie D009 CD025 Conditie D025 CD034 Conditie D034 CD041 Conditie D041 CD043 Conditie D043 CD044 Conditie D044 CD045 Conditie D045 CD046 Conditie D046 Handleiding XSLT s 17 augustus / 12