|
|
|
# **Handleiding Validatiemodule** #
|
|
|
|
## Over de Validatiemodule ##
|
|
|
|
# **Handleiding Validatiemodule**
|
|
|
|
|
|
|
|
## Over de Validatiemodule
|
|
|
|
|
|
|
|
De Validatiemodule biedt softwareleveranciers en gebruikers van het iStandaarden-berichtenverkeer de mogelijkheid testberichten die zij gebruiken te valideren.
|
|
|
|
|
| ... | ... | @@ -7,40 +8,45 @@ De Validatiemodule werkt met alle berichten (heen en retour) die gespecificeerd |
|
|
|
|
|
|
|
De declaratieberichten AW319 en AW320 (iWlz) kunt u valideren met het Portaal voor testbestanden Externe-Integratiestandaarden (PORTES) van Vektis.
|
|
|
|
|
|
|
|
### Controle StUF-envelop ###
|
|
|
|
### Controle StUF-envelop
|
|
|
|
|
|
|
|
Bij gebruik van een StUF-envelop voor iWmo- of iJw-berichten voert de Validatiemodule een afzonderlijke controle uit van de envelop. De validatie houdt in dat de geldigheid ten opzichte van de actuele schemadefinitie nagegaan wordt. Als die in orde is, dan voert de module een inhoudelijke controle uit van het iStandaard-bericht.
|
|
|
|
|
|
|
|
### Controle door de Validatiemodule ###
|
|
|
|
### Controle door de Validatiemodule
|
|
|
|
|
|
|
|
De Validatiemodule stelt het type iStandaard-bericht vast en controleert de berichten inhoudelijk op structuur, vulling en alle gespecificeerde technische regels, condities en constraints. De module controleert geen berichtoverstijgende regels.
|
|
|
|
|
|
|
|
### Veilig op de eigen computer ###
|
|
|
|
### Veilig op de eigen computer
|
|
|
|
|
|
|
|
De Validatiemodule draait in de browser van de gebruiker, bij de validatie worden er geen bestanden naar een externe server gestuurd. Dus alle data blijft veilig op de computer waar de Validatiemodule wordt gebruikt.
|
|
|
|
|
|
|
|
Deze handleiding beschrijft alle functionaliteit van de Validatiemodule.
|
|
|
|
|
|
|
|
**Let op!
|
|
|
|
De Validatiemodule is een hulpmiddel bij de ontwikkeling van iStandaarden in de software en bij bedrijfsprocessen.**
|
|
|
|
**Let op! De Validatiemodule is een hulpmiddel bij de ontwikkeling van iStandaarden in de software en bij bedrijfsprocessen.**
|
|
|
|
|
|
|
|
### Decentrale Validatieservice
|
|
|
|
|
|
|
|
### Decentrale Validatieservice ###
|
|
|
|
Softwareleveranciers en/of andere gebruikers van het iStandaarden-berichtenverkeer die het valideren willen uitvoeren in een interne (eigen) softwareomgeving of voor geavanceerd gebruik willen toepassen, kunnen gebruik maken van de Decentrale Validatieservice. Deze is beschikbaar op https://istandaarden.nl/modules. Voor deze Decentrale Validatieservice is het ook mogelijk om productiebestanden te valideren.
|
|
|
|
Softwareleveranciers en/of andere gebruikers van het iStandaarden-berichtenverkeer die het valideren willen uitvoeren in een interne (eigen) softwareomgeving of voor geavanceerd gebruik willen toepassen, kunnen gebruik maken van de Decentrale Validatieservice. Deze is beschikbaar op <https://istandaarden.nl/modules>. Voor deze Decentrale Validatieservice is het ook mogelijk om productiebestanden te valideren.
|
|
|
|
|
|
|
|
### Meer informatie
|
|
|
|
|
|
|
|
### Meer informatie ###
|
|
|
|
Heeft u vragen over het gebruik van de Validatiemodule? Neemt u dan contact op met:
|
|
|
|
|
|
|
|
Zorginstituut Nederland\
|
|
|
|
Team Informatiestandaarden\
|
|
|
|
(020) 797 89 48\
|
|
|
|
info@istandaarden.nl\
|
|
|
|
[info@istandaarden.nl](mailto:info@istandaarden.nl)\
|
|
|
|
[www.istandaarden.nl](https://istandaarden.nl/)
|
|
|
|
|
|
|
|
## Het gebruik ##
|
|
|
|
## Het gebruik
|
|
|
|
|
|
|
|
De Validatiemodule is te vinden op de modulepagina van iStandaarden. Aan de hand van voorbeelden beschrijven we hoe u met de Validatiemodule kunt werken om uw berichten te valideren.
|
|
|
|
|
|
|
|
### Een bericht valideren ###
|
|
|
|
### Een bericht valideren
|
|
|
|
|
|
|
|
Allereerst selecteert u het te valideren bericht in de Validatiemodule. Dit doet u door op ‘Bladeren’ te klikken.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Vervolgens selecteert u het bestand dat u wilt laten valideren en klikt u op ‘Open’. De bestandnaam van het te valideren bestand verschijnt nu in beeld.
|
|
|
|
|
| ... | ... | @@ -50,82 +56,69 @@ U kunt hierbij kiezen uit zowel datums die in het verleden liggen als in de toek |
|
|
|
|
|
|
|
Vervolgens klikt u op ‘Verstuur’ om het bericht te laten valideren.
|
|
|
|
|
|
|
|
### Een bericht valideren ###
|
|
|
|
### Een bericht valideren
|
|
|
|
|
|
|
|
Nadat u het bericht hebt verstuurd, krijgt u binnen enkele seconden de uitslag van de validatie gepresenteerd: het bericht is goedgekeurd of afgekeurd.
|
|
|
|
|
|
|
|
De validatiemodule doet ook controle op retourberichten. Op exact dezelfde manier zoals de “oude” validatiemodule dat deed. Als er een retourbericht wordt aangeboden, en er staat een niet-berichtoverstijgende foutcode in het bericht, dan wordt er ook gekeken of die fout daadwerkelijk in het bericht staat.
|
|
|
|
|
|
|
|
### Let op: ###
|
|
|
|
### Let op:
|
|
|
|
|
|
|
|
Versie 2.2.0 van Validatiemodule tot 8 mei 2021 werkt met XSLT 2.2.8 voor iWmo/iJw 3.0.3 en XSLT 2.2.7 voor iWmo/iJw 3.0.2.
|
|
|
|
|
|
|
|
Tijdens de validatieprocedure verschijnt een pop-up waarin u zelf kunt kiezen tussen de twee versies.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Voorbeeld van een goedgekeurd bericht ####
|
|
|
|
#### Voorbeeld van een goedgekeurd bericht
|
|
|
|
|
|
|
|
|
|
|
|
![]()U kunt vervolgens kiezen voor:
|
|
|
|
|
|
|
|
U kunt vervolgens kiezen voor:
|
|
|
|
* ‘Bericht bekijken’: de inhoud van het bericht wordt getoond;
|
|
|
|
* ‘Nog een bestand valideren’: u kunt een nieuw bericht selecteren om te valideren.
|
|
|
|
|
|
|
|
Als uw bericht is afgekeurd, dan krijgt u terugkoppeling over de fouten in het bericht. Afhankelijk van de fout kan de informatie verschillende vormen aannemen. We geven een voorbeeld van een technisch afgekeurd bericht en van een inhoudelijk afgekeurd bericht.
|
|
|
|
|
|
|
|
#### Voorbeeld van een technisch afgekeurd bericht
|
|
|
|
|
|
|
|
#### Voorbeeld van een technisch afgekeurd bericht ####
|
|
|
|
Onderstaand is een voorbeeld van een validatierapport met berichtfouten. De fouten worden getoond met een beschrijving, de regel en het element dat verantwoordelijk is voor de generatie van de foutmelding.
|
|
|
|
|
|
|
|
Onderstaand is een voorbeeld van een validatierapport met berichtfouten.
|
|
|
|
De fouten worden getoond met een beschrijving, de regel en het element dat verantwoordelijk is voor de generatie van de foutmelding.
|
|
|
|
Door te kiezen voor ‘Bericht bekijken’ kunt u de details van alle fouten inzien. De fouten worden met rood aangegeven en de regel die is geschonden wordt in de laatste kolom getoond. Afzonderlijke fouten zijn in te zien door voor ‘Alles uitklappen’ te kiezen. U kunt op ‘Nog een bestand valideren’ knop klikken om terug te gaan naar het startscherm.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Door te kiezen voor ‘Bericht bekijken’ kunt u de details van alle fouten inzien. De fouten worden met rood aangegeven en de regel die is geschonden wordt in de laatste kolom getoond. Afzonderlijke fouten zijn in te zien door voor ‘Alles uitklappen’ te kiezen.
|
|
|
|
U kunt op ‘Nog een bestand valideren’ knop klikken om terug te gaan naar het startscherm.
|
|
|
|
#### Voorbeeld van een foutmelding bij het valideren van een niet valide XML bericht
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Voorbeeld van een foutmelding bij het valideren van een niet valide XML bericht ####
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Voorbeeld van een StUF bericht dat wel een correct schema heeft maar functionele fouten bevat. ####
|
|
|
|
#### Voorbeeld van een StUF bericht dat wel een correct schema heeft maar functionele fouten bevat.
|
|
|
|
|
|
|
|
De melding is identiek aan die van een foutief bericht zoals omschreven in 2.2.2
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Voorbeeld van foutmelding van een bericht met valide XML maar dat niet voldoet aan het XML schema. ####
|
|
|
|
#### Voorbeeld van foutmelding van een bericht met valide XML maar dat niet voldoet aan het XML schema.
|
|
|
|
|
|
|
|
Dit komt bijvoorbeeld voor als het bericht een ondersteunde standaard gebuikt maar invalide is, een niet ondersteunde standaard gebruikt, een willekeurig maar valide XML bericht is of een invalide StUF envelop heeft.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Voorbeeld van het gebruik van een validatiedatum. ####
|
|
|
|
#### Voorbeeld van het gebruik van een validatiedatum.
|
|
|
|
|
|
|
|
Het is mogelijk om een validatiedatum op te geven voor het te valideren bericht. Indien dit ingevuld is, wordt de datum gebruikt voor de evaluatie van de dagtekening van het bericht. Normaal wordt voor de evaluatie tegen de dagtekening de huidige systeem datum gebruikt. Dit is bruikbaar als een bericht in het verleden of in de toekomst gevalideerd moet worden en er mogelijk andere regels golden of gaan gelden.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Een bericht bekijken ###
|
|
|
|
### Een bericht bekijken
|
|
|
|
|
|
|
|
Als u op de knop ‘Bericht bekijken’ klikt, verschijnt dit scherm:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
U kunt vervolgens kiezen voor: ‘Terug naar validatie’: u gaat hiermee naar het voorgaand overzichtsscherm; ‘Nog een bestand valideren’: u kunt een nieuw bericht selecteren om te valideren; ‘Alles uitklappen’: hiermee wordt het bericht dat standaard alleen het ‘root’ element laat zien, volledig getoond.
|
|
|
|
|
|
|
|
U kunt vervolgens kiezen voor:
|
|
|
|
‘Terug naar validatie’: u gaat hiermee naar het voorgaand overzichtsscherm;
|
|
|
|
‘Nog een bestand valideren’: u kunt een nieuw bericht selecteren om te valideren;
|
|
|
|
‘Alles uitklappen’: hiermee wordt het bericht dat standaard alleen het ‘root’ element laat zien, volledig getoond.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
<div>
|
|
|
|
|
|
|
|
<hr/>
|
|
|
|
<div align=center>
|
|
|
|
Hebt u vragen over Validatiemodule, neem dan contact op met:
|
|
|
|
|
|
|
|
Zorginstituut Nederland\
|
| ... | ... | @@ -133,4 +126,5 @@ Team Informatiestandaarden\ |
|
|
|
(020) 797 89 48\
|
|
|
|
[info@istandaarden.nl](mailto:info@istandaarden.nl)\
|
|
|
|
[www.istandaarden.nl](https://istandaarden.nl/)
|
|
|
|
|
|
|
|
</div> |
|
|
\ No newline at end of file |
