home.md

@@ -27,15 +27,15 @@ info@istandaarden.nl\
 
 
  
-## Over de XSLT’s voor iStandaarden ##
-### XML als standaard ###
+## 1- Over de XSLT’s voor iStandaarden ##
+### 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 de Jeugdwet geldt dit per 12 juni 2017 en voor pgb sinds 1 september 2017.
 
 Binnen alle 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. Een overzicht van alle informatiemodellen – iWlz, iWmo, iJw en iPgb – vindt u onderaan op de homepage van [istandaarden.nl](https://istandaarden.nl/).
 
-### Validatie met XSLT’s ### 
+### 1.2 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, wordt gecontroleerd met een XML-schema. Hiermee is de XSLT-controle afhankelijk van de XML-schemacontrole. 
@@ -46,11 +46,11 @@ Een XSLT kan gebruikt worden om een controle uit te voeren. Het resultaat van de
 
 ![Validatie_met_XSLT_2](uploads/e82cdac995dee47a93fccda7d5e3bf80/Validatie_met_XSLT_2.PNG)
  
-## Structuur en gebruik van de XSLT’s ##
+## 2- Structuur en gebruik van de XSLT’s ##
 
 De XSLT’s die Zorginstituut Nederland beschikbaar stelt, zijn alleen bruikbaar voor de berichten die zijn opgenomen in het Informatiemodel iStandaarden. 
 
-### Structuur ###
+### 2.1 Structuur ###
 De XSLT’s voor iStandaarden zijn in het informatiemodel per release verpakt in een zip-bestand. Elk zip-bestand heeft deze structuur, dit voorbeeld is op basis van de Wmo-XSLT’s:
 
 ![Structuur](uploads/da03f115b38865dbd9381694f6986e3d/Structuur.png)
@@ -59,23 +59,32 @@ De XSLT’s voor iStandaarden zijn in het informatiemodel per release verpakt in
 * **Versie (xslt-validatie_x.x.x)**\Versies van de xslt zijn oplopend en uniek per domein, er wordt gebruik gemaakt van “semantic versioning”.
 * **Common\2_0** – XSLT-controles, zoals de 11-proef, die zowel van toepassing kunnen zijn op iWmo, iJw als iWlz.
 * **Schema\1_1** – Hierin zit het XML-schema waarin het resultaat van de XSLT-controle wordt vastgelegd: het foutenrapport.
-* **Wmo\3_0** – Deze map bevat de ‘all.xsl’ en de afzonderlijke XSLT’s per bericht.
+* **Wmo\3_0** – iStandaard en Releasenummer. Het gaat hier daarom om de xslt-set voor de iWmo Release 3.0.
+Deze map bevat de ‘all.xsl’, ‘all_merged.xsl’ en de afzonderlijke XSLT’s per bericht. De ‘all.xsl’ of ‘all_merged.xsl’ files zijn de bestanden waarmee de controles worden gebruikt. Zie hiervoor paragraaf 2.2
 * **Common** – Hierin zijn de omschrijvingen van alle controles opgenomen.
 * **Condities** – Bevat alle in XSLT uit te drukken condities.
 * **Constraints** - Bevat alle in XSLT uit te drukken constraints.
 * **Rules** – Bevat alle in XSLT uit te drukken technische regels.
  
-### Handmatig gebruik ###
+### 2.2 Gebruikmaken van de XSLT-set ###
+
+Om een xml-bericht inhoudelijk te valideren (parsen van het xml bericht) kan het beste gebruik gemaakt worden van de ‘all.xsl’ file of de ‘all_merged.xsl’ file. De ‘all.xsl’ of de ‘all_merged.xsl’ voeren beide alle controles uit die van toepassing zijn op het xml-bericht dat ter validatie is aangeboden. Het maakt dan niet uit welk iStandaard-bericht er gevalideerd moet worden. 
+Dus voor een AW33.xml of een ZK35 etc. kan de ‘all.xsl’ of  ‘all_merged.xsl’ gebruikt worden. De xsl-structuur bepaald dan om welk iStandaard bericht het gaat en zal vervolgens alleen die controles uitvoeren die van toepassing zijn op dat iStandaard bericht.
+Het verschil tussen de ‘all.xsl’ of de ‘all_merged.xsl’ is dat bij ‘all.xsl’ er verwijzingen zijn naar afzonderlijke bericht-controles, regels en foutmeldingen, terwijl die bij de ‘all_merged.xsl’ alles binnen hetzelfde bestand zit. 
+
+Voor het controleren van een specifieke regel binnen een bericht of een specifiek bericht zelf kan het afzonderlijke XSLT bestand gebruikt worden. 
+
+### 2.3 Handmatig gebruik ###
 De XSLT’s kunnen gebruikt worden in zowel een handmatig als een geautomatiseerd proces. In een handmatig proces gebeurt dat waarschijnlijk met een XML-tool waarbij een iStandaarden-bericht in XML en de bijbehorende XSLT worden geselecteerd om vervolgens de controle uit te voeren. 
 
 ![Handmatig_gebruik](uploads/92c412acf1a9823df0dcf4f9907708ee/Handmatig_gebruik.png)
  
-### Geautomatiseerd gebruik ### 
+### 2.4 Geautomatiseerd gebruik ### 
 In een geautomatiseerd proces maakt de XSLT-controle naar alle waarschijnlijkheid deel uit van een of meer processtappen om een iStandaarden-bericht in XML te valideren. De uitvoer is uiteindelijk een bijbehorend retourbericht.
 
 ![Geautomatiseerd_gebruik](uploads/2687ec0efeb1b3a311354208ba69f4be/Geautomatiseerd_gebruik.png)  
  
-### Validatie iStandaard-berichten ###
+### 2.5 Validatie iStandaard-berichten ###
 Softwareleveranciers kunnen de XSLT’s toepassen in hun producten. Voor iStandaard-berichten geldt dat ieder bericht gevalideerd wordt met het XSLT-bestand ‘all.xsl’. 
 
 Het resulterende XML-bericht na de XSLT-validatie van het iStandaarden-bericht heet ‘report.xml’. Dit is de grafische weergave van het report: 
@@ -88,5 +97,5 @@ Dit is een XML-rapport waarin fouten opgenomen zijn. Zie onderstaand voorbeeld.
 
 Op basis van dit document wordt het retourbericht opgesteld door de applicatie. 
 
-### Licentie ###
+### 2.6 Licentie ###
 Alle XSLT’s voor iStandaarden worden onder een MIT-licentie uitgebracht. Dit betekent dat de XSLT’s vrij zijn om toe te passen en te distribueren. Zie [mitlicense.org](https://mitlicense.org/) voor de voorwaarden.