[IT-dienstenleveranciers] input ter voorbereiding van het extra technisch overleg van dinsdag 10/03/2020

Vr Mrt 6 13:59:47 CET 2020

Aan de deelnemers van het technisch overleg van dinsdag 10/03/2020

Ter voorbereiding voor het extra technisch overleg bezorgen we jullie de xsd van de diensten die zullen wijzigen nav zoekgebeurtenis V3.

Daarnaast willen we dinsdag ook het alternatief voor datablokdiensten verder verfijnen.

Impact wijzigingen zoekGebeurtenis :

In release 2.72 wordt een nieuw concept van bestemmelingen gedefinieerd: primaire en niet primaire (secundaire) bestemmelingen.

Primaire bestemmelingen zijn bestemmelingen die op de hoogte moeten zijn van de gebeurtenis. Bv. een AVI verleend advies, dan is de VVO een primaire bestemmeling van dat advies.

De secundaire bestemmelingen zijn bestemmelingen die de gebeurtenis als informatie krijgen. Bv. de andere AVI's worden op de hoogte gebracht van het advies dat een andere AVI uitgebracht heeft.

In Gebeurtenis V1 is het niet mogelijk om bij een bestemmeling aan te geven of het een primaire dan wel secundaire bestemmeling is.

Daarom werd Gebeurtenis V2 uitgewerkt. Het enige verschil tussen V1 & V2 zijn de bestemmelingen. In Gebeurtenis V1 is dat een HoedanigheidRef.

In Gebeurtenis V2 is de Bestemmeling een eigen complex type. Het is een extensie van HoedanigheidRef met een extra attribuut: primair (boolean default true).

In release 2.70 werd startGebeurtenis V3 opgeleverd. Deze zal in release 2.72 echter aangepast worden.

Er zal nu een gebeurtenis V2 meegegeven moeten worden in het verzoek in plaats van een Gebeurtenis V1.

Daarnaast werd ook een geefGebeurtenis V2 ontwikkeld waarmee het mogelijk is een Gebeurtenis V2 op te halen.

Of een bestemmeling primair dan wel secundair is wordt door het uitwisselingsplatform bepaald. De waarde die in het verzoek meegeven wordt is dus van geen belang.

Alle bestemmelingen die in het startGebeurtenisVerzoek zitten zullen als primair beschouwd worden.

Als er volgens de parameters nog bestemmelingen nodig zijn die niet in het verzoek zitten zullen deze door het uitwisselingsplatform als secundaire bestemmeling toegevoegd worden.

In release 2.72 zal ook zoekGebeurtenis V3 opgeleverd worden. Er zijn een aantal verschillen t.o.v. ZoekGebeurtenis V2.

Een van de belangrijkste verschillen is dat het verplicht wordt om een interval mee te geven. Dit interval mag ook niet te groot zijn, in eerste instantie gaan we dit op 7 dagen zetten, maar dit kan later nog wijzigen.

Daarnaast wordt een nieuwe filter toegevoegd: primaireBestemmeling. Dit is een boolean veld dat toelaat om enkel te zoeken op gebeurtenissen waarvan je primaire bestemmeling bent. De werking van de filter is als volgende:

  *   Indien true worden enkel de gebeurtenissen teruggegeven waarvan de aanroeper van de webservice primaire bestemmeling is.
  *   Indien false worden enkel de gebeurtenissen teruggegeven waarvan de aanroeper van de webservice geen primaire bestemmeling is.
  *   Indien leeg worden zowel de gebeurtenissen voor de primaire en secundaire bestemmeling meegegeven.

De laatste wijziging aan het verzoek is de filter 'alle'. Deze is verwijderd in zoekGebeurtenis V3.

Deze filter liet in V1 & V2 van de webservice toe dat een afnemer alle gebeurtenissen kon zoeken die hij nog niet afgehaald had via geefGebeurtenis.

Dit is echter niet performant. Indien deze filter op 'true' gezet werd wil dat zeggen dat er naar alle gebeurtenissen van de afnemer gezocht moest worden want zeer tijdrovend was.

Daarnaast is het ook niet de taak van het uitwisselingsplatform om bij te houden wie welke gebeurtenissen afgehaald heeft.

Het is de taak van de afnemer zelf om bij te houden welke gebeurtenissen/projecten hij al binnengehaald heeft en aan de hand daarvan te synchroniseren.

Tot slot is er ook een wijziging aan de repliek van ZoekGebeurtenis V3 t.o.v. V2.

Sinds de introductie van beroepschriften als case kunnen gebeurtenissen op 2 plaatsten uitgevoerd worden: op een projectFase of op een dossier.

Het is in de repliek van V1 & V2 niet duidelijk af te leiden waarop de gebeurtenis uitgevoerd is. In ZoekGebeurtenis V3 zal het duidelijk zijn waarop de gebeurtenis uitgevoerd is.

Dit doen we door het GebeurtenisResultaat abstract te maken. Het gebeurtenis resultaat bevat zelf nog slechts 2 referenties: die naar de gebeurtenis en die naar het project.

Van het GebeurtenisResultaat zijn 2 extensies gemaakt: GebeurtenisResultaatProjectFase welke een referentie heeft naar de projectFase & GebeurtenisResultaatDossier welke een referentie heeft naar het dossier.

Op deze manier kan er geen verwarring meer ontstaan.

Alternatief datablokdiensten.

Er waren 2 voorstellen weerhouden : het datablok meegeven als JSON string of het datablok meegeven als XML met een CDATA tag.

Na verder intern overleg zijn we meer voorstander van het datablok mee te geven als XML met een CDATA string.

De reden is eenvoudig dat al onze SOAP services XML zijn en geen SOAP. Als we het datablok dan als XML meegeven met CDATA blijft alles XML en moet er niet nog omgezet worden naar SOAP e.d.

Een voorbeeld van de bewaarDatablokRepliek vind je in bijlage

Met vriendelijke groeten

Team Omgevingsloket

DEPARTEMENT OMGEVING

https://www.omgevingsloket.be/main <https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.omgevingsloket.be%2Fmain&data=02%7C01%7Cpieter.lamote%40vlaanderen.be%7C529fa5a478a64b35a7b208d6cf97652b%7C0c0338a695614ee8b8d64e89cbd520a0%7C0%7C0%7C636924646482720816&sdata=pb3lvMMuvmb8Fh9zlkU2aeQqE47P4YSHiqfnqJOIcXo%3D&reserved=0>

------------- volgend deel ------------
Een HTML-bijlage is gescrubt...
URL: <http://list.milieuinfo.be/pipermail/oml_it/attachments/20200306/c93da164/attachment-0001.html>
------------- volgend deel ------------
Een niet-tekst bijlage is gescrubt...
Naam: AbstractDatablok.xsd
Type: text/xml
Grootte: 2405 bytes
Omschrijving: AbstractDatablok.xsd
URL : <http://list.milieuinfo.be/pipermail/oml_it/attachments/20200306/c93da164/attachment-0005.xml>
------------- volgend deel ------------
Een niet-tekst bijlage is gescrubt...
Naam: BewaarDatablokRepliek.xml
Type: text/xml
Grootte: 2440 bytes
Omschrijving: BewaarDatablokRepliek.xml
URL : <http://list.milieuinfo.be/pipermail/oml_it/attachments/20200306/c93da164/attachment-0006.xml>
------------- volgend deel ------------
Een niet-tekst bijlage is gescrubt...
Naam: GebeurtenisV2.xsd
Type: text/xml
Grootte: 6899 bytes
Omschrijving: GebeurtenisV2.xsd
URL : <http://list.milieuinfo.be/pipermail/oml_it/attachments/20200306/c93da164/attachment-0007.xml>
------------- volgend deel ------------
Een niet-tekst bijlage is gescrubt...
Naam: ZoekGebeurtenisRepliek.xsd
Type: text/xml
Grootte: 3475 bytes
Omschrijving: ZoekGebeurtenisRepliek.xsd
URL : <http://list.milieuinfo.be/pipermail/oml_it/attachments/20200306/c93da164/attachment-0008.xml>
------------- volgend deel ------------
Een niet-tekst bijlage is gescrubt...
Naam: ZoekGebeurtenisVerzoek.xsd
Type: text/xml
Grootte: 5383 bytes
Omschrijving: ZoekGebeurtenisVerzoek.xsd
URL : <http://list.milieuinfo.be/pipermail/oml_it/attachments/20200306/c93da164/attachment-0009.xml>