... | ... | @@ -8,23 +8,26 @@ TiS biedt een online-simulatieomgeving waar softwareleveranciers hun producten k |
|
|
|
|
|
TiS is ontwikkeld samen met softwareleveranciers die actief zijn in de verschillende iStandaarden-domeinen. De service wordt voortdurend voorzien van nieuwe testscenario’s. Zo wordt TiS een volwaardig product dat softwareleveranciers structureel ondersteunt bij de bouw van hun software.
|
|
|
|
|
|
<hr/>
|
|
|
<div align=center>
|
|
|
---
|
|
|
|
|
|
<div>
|
|
|
|
|
|
Heeft u vragen over het gebruik van de Testvoorziening iStandaarden? Neemt u dan contact op met:
|
|
|
|
|
|
Zorginstituut Nederland\
|
|
|
Team Informatiestandaarden\
|
|
|
(020) 797 89 48\
|
|
|
[info@istandaarden.nl](mailto:info@istandaarden.nl)\
|
|
|
info@istandaarden.nl\
|
|
|
[www.istandaarden.nl](https://istandaarden.nl/)
|
|
|
</div>
|
|
|
<hr/>
|
|
|
|
|
|
</div>---
|
|
|
|
|
|
## Installatie van Testvoorziening iStandaarden (TiS)
|
|
|
|
|
|
In dit hoofstuk leest u hoe u TiS kunt installeren, wat de bedoeling is van de testvoorziening en waar u de WSDL vindt.
|
|
|
|
|
|
### Werking
|
|
|
|
|
|
TiS is bedoeld voor de ondersteuning bij de implementatie van de nieuwe releases van de iStandaarden. In aanloop naar nieuwe releases volgen nieuwe publicaties.
|
|
|
|
|
|
U biedt testberichten aan, waarop de testvoorziening een functionele reactie geeft zoals beschreven in de scenario’s. De scenario’s worden in een apart document beschreven. Voorbeelden van contextberichten zijn ook op de website te vinden. Om met TiS te kunnen communiceren zijn er ook vraag- en antwoordberichten nodig. Deze worden verderop in de handleiding besproken. Voorbeelden van deze berichten worden op de website geplaatst.
|
... | ... | @@ -32,37 +35,42 @@ U biedt testberichten aan, waarop de testvoorziening een functionele reactie gee |
|
|
### Huidige ondersteunde berichtstandaard
|
|
|
|
|
|
Hieronder een overzicht van de versie van de ondersteunde berichtstandaard:
|
|
|
|
|
|
| Standaard | Versie | Opmerking |
|
|
|
|-----------|--------|-----------|
|
|
|
| iWmo | 3.0 | |
|
|
|
| iWmo | 3.1 | |
|
|
|
| iJw | 3.0 | |
|
|
|
| iJw| 3.1 | |
|
|
|
| iJw | 3.1 | |
|
|
|
| iWlz | 2.2 | |
|
|
|
| iWlz | 2.3 | |
|
|
|
| iWlz | 2.4 | |
|
|
|
|
|
|
|
|
|
### Installatie van TiS (lokaal)
|
|
|
|
|
|
TiS wordt geleverd in de vorm van een Docker-container. Dit is een relatief nieuwe manier om software te distribueren. Docker-containers zijn platformonafhankelijk, elk besturingssysteem waar Docker op kan draaien is geschikt. TiS kan zodoende dus draaien op Linux, MacOS en Windows. Voor het installeren van TiS moet Docker worden geïnstalleerd. Meer informatie over het installerer van Docker is te vinden op [https://www.docker.com/](https://www.docker.com/).
|
|
|
TiS wordt geleverd in de vorm van een Docker-container. Dit is een relatief nieuwe manier om software te distribueren. Docker-containers zijn platformonafhankelijk, elk besturingssysteem waar Docker op kan draaien is geschikt. TiS kan zodoende dus draaien op Linux, MacOS en Windows. Voor het installeren van TiS moet Docker worden geïnstalleerd. Meer informatie over het installerer van Docker is te vinden op https://www.docker.com/.
|
|
|
|
|
|
Voor de validatie van inkomende berichten is TiS afhankelijk van de Decentrale Validatie Service (DVS). Deze draait ook in een Docker-container. Informatie over het installeren van de DVS is te vinden [hier](https://repository.istandaarden.nl/modules/dvs/-/wikis/Handleiding-Decentrale-Validatie-Service)
|
|
|
|
|
|
**Let op:**
|
|
|
**Let op:**
|
|
|
|
|
|
- TiS maakt standaard gebruik van de DVS via host.docker.internal.
|
|
|
|
|
|
Om een extern IP-adres in te stellen gebruik dan de Environment variabele DVS_HOST. In deze handleiding nemen we x.x.x.x .
|
|
|
|
|
|
- TiS maakt standaard gebruik van de DVS op poort 8080.
|
|
|
- TiS maakt standaard gebruik van de DVS op poort 8080.
|
|
|
|
|
|
Om een andere poort in te stellen gebruik dan de Environment variabele DVS_PORT. In deze handleiding nemen we poort 8680.
|
|
|
|
|
|
|
|
|
Het starten van de DVS gaat dan met dit commando:
|
|
|
|
|
|
```
|
|
|
docker run -d -itp 8680:8080 --name dvs registry.istandaarden.nl/modules/dvs
|
|
|
```
|
|
|
|
|
|
Het het starten van TiS (ACC) kan vervolgens met dit commando:
|
|
|
|
|
|
```
|
|
|
docker run -d -itp 8080:8080 -e DVS_PORT=8680 -e DVS_HOST=x.x.x.x --name tis registry.istandaarden.nl/modules/tis:TiS-3.0.6
|
|
|
```
|
... | ... | @@ -135,7 +143,7 @@ Bericht wordt gevalideerd op: |
|
|
|
|
|
Omdat TiS de mogelijkheid heeft om ingezonden berichten binnen dezelfde sessie met elkaar te vergelijken zijn er ook bericht overstijgende controles mogelijk.
|
|
|
|
|
|
Alle bericht overstijgende regels zijn per domein terug te vinden op [https://informatiemodel.istandaarden.nl/](https://informatiemodel.istandaarden.nl/) onder “Technische Regels”.
|
|
|
Alle bericht overstijgende regels zijn per domein terug te vinden op https://informatiemodel.istandaarden.nl/ onder “Technische Regels”.
|
|
|
|
|
|
|
|
|
|
... | ... | @@ -147,7 +155,7 @@ TiS maakt gebruik van het SOAP-protocol. Aanroepen van de webservice dienen aan |
|
|
|
|
|
Bij de webservice van TiS horen een aantal bestanden: de WSDL (Web Service Description Language) en een aantal voorbeeld bestanden. Beide .zip-bestanden zijn te vinden op:
|
|
|
|
|
|
[https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis](https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis).
|
|
|
https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis.
|
|
|
|
|
|
Daar vindt u ook de handleiding en de releasenotes bij TiS.
|
|
|
|
... | ... | @@ -164,16 +172,18 @@ Voor de communicatie met TiS zijn 3 SOAP-berichttypen gemaakt. Er is een bericht |
|
|
Het onderdeel StartScenarioRequest is specifiek voor het aanbieden van het contextbericht en dient om een (nieuwe) testsessie te starten.
|
|
|
|
|
|
De body van het request bevat deze parameters:
|
|
|
|
|
|
| Element | Formaat | Verplicht | Beschrijving |
|
|
|
|---------|---------|-----------|--------------|
|
|
|
| ScenarioId | String | Ja | Beschrijving van de testcase. De waarde bepaalt welke rol TiS heeft en om welke wet het gaat. De waarde moet exact worden overgenomen uit de documentatie. |
|
|
|
| Context | String | Ja | Neem hier het contextbericht op. |
|
|
|
|
|
|
Een voorbeeld request is te vinden op [https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis](https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis).
|
|
|
Een voorbeeld request is te vinden op https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis.
|
|
|
|
|
|
TiS stuurt als respons op de StartScenarioRequest een StartScenarioResponse.
|
|
|
|
|
|
De respons bevat deze waarden:
|
|
|
|
|
|
| Element | Formaat | Verplicht | Beschrijving |
|
|
|
|---------|---------|-----------|--------------|
|
|
|
| SessionId | String | Ja | SessionId bevat in de respons de sessionUUID . Deze waarde blijft gedurende het hele scenario gelijk totdat er weer opnieuw een contextbericht is aangeboden. De waarde koppelt de berichten in het vervolg van de sessie aan elkaar. |
|
... | ... | @@ -184,15 +194,17 @@ De respons bevat deze waarden: |
|
|
Het onderdeel OfferFileRequest is voor het aanbieden van een bericht aan de testvoorziening.
|
|
|
|
|
|
De body van het request bevat deze parameters:
|
|
|
|
|
|
| Element | Formaat | Verplicht | Beschrijving |
|
|
|
|---------|---------|-----------|--------------|
|
|
|
| SessionId | String | Ja | De unieke sleutel voor een (test-)sessie. In de respons van StartScenarioRequest staat in SessionId de waarde die hier moet worden meegegeven om berichten aan elkaar te relateren aan de zelfde testsessie en berichtoverstijgende controles te kunnen uitvoeren |
|
|
|
| ScenarioId | String | Ja | ID van het scenario dat doorlopen gaat worden. De waarde bepaald welke rol TiS heeft en om welk scenario het gaat. De waarde moet exact worden overgenomen uit de documentatie. |
|
|
|
| Message | String | Ja | Neem hier het bericht op dat ingestuurd moet worden aan TiS. |
|
|
|
|
|
|
Een voorbeeld van een request is te vinden op [https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis](https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis) .
|
|
|
Een voorbeeld van een request is te vinden op https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis .
|
|
|
|
|
|
Als er geen fouten zijn gecontstateerd door TiS antwoordt TiS met een OfferFileResponse. De respons bevat deze waarden:
|
|
|
|
|
|
| Element | Formaat | Verplicht | Beschrijving |
|
|
|
|---------|---------|-----------|--------------|
|
|
|
| SessionId | String | Ja | SessionId bevat in de respons de sessionUUID . Deze waarde blijft gedurende het hele scenario gelijk totdat er weer opnieuw een contextbericht is aangeboden. De waarde koppelt de berichten in het vervolg van de sessie aan elkaar. |
|
... | ... | @@ -212,7 +224,8 @@ In sommige situaties ontstaan foutmeldingen, die u geretourneerd krijgt als ‘S |
|
|
|
|
|
Het SOAP-berichte RequestFileRequest is bedoeld om de berichten die TiS heeft aangemaakt (conform het scenario) op te halen.
|
|
|
|
|
|
Een voorbeeld van het request is te vinden op [https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis](https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis) . De body van het request bevat deze parameters:
|
|
|
Een voorbeeld van het request is te vinden op https://www.istandaarden.nl/modules/testvoorziening-istandaarden-tis . De body van het request bevat deze parameters:
|
|
|
|
|
|
| Element | Formaat | Verplicht | Beschrijving |
|
|
|
|---------|---------|-----------|--------------|
|
|
|
| SessionId | String | ja | Vul hier de sessionUUID in van de huidige sessie. |
|
... | ... | |