[IT-dienstenleveranciers] nieuwe webservice StartGebeurtenisDienst V2

[Omgevingsloket, communicatie]

Beste webservice-afnemer,


Voor de nieuwe lay-out hebben we nood aan een nieuwe dienst: StartGebeurtenisDienst V2. De wijzigingen zijn minimaal.
In V1 geef je de gebeurtenis mee die je wil starten en de uuid van het project waarin je de gebeurtenis wil uitvoeren.
In V2 van de webservice geef je dezelfde gebeurtenis mee met de uuid van de projectfase waarin je de gebeurtenis wil uitvoeren.

Eigenlijk werkt het systeem achterliggend al met de projectfase.
Als je bv. geefProject doet zie je ook dat de gebeurtenissen gekoppeld zijn aan een projectfase en niet rechtstreeks aan het project.

Reden dat we deze nieuwe webservice nodig hebben:
1) Zoals hierboven vermeld is het logischer dat je de fase meegeeft waarin je de gebeurtenis wil uitvoeren aangezien de gebeurtenis daar toch aan gekoppeld wordt
2) In de nieuwe lay-out moeten acties uitgevoerd worden op het dossieronderdeel van de fase. Met V2 van de webservice kan gewoon de fase uuid doorgegeven worden i.p.v. dat eerst het project opgehaald moet worden.
3) Waarschijnlijk de belangrijkste reden voor de nieuwe webservice.
   Als een actie uitgevoerd kan worden in twee fases op hetzelfde moment kan het systeem via de V1 webservice niet bepalen in welke fase de gebruiker de actie wou uitvoeren en wordt een fout gegooid.
   Dit is bv. een probleem bij het melden van de aanplakking van een beslissing.

Het opzetten van deze nieuwe webservice is opgenomen in sprint 43 onder https://www.milieuinfo.be/jira/browse/OMGVN-3968. Dit gaat met release 2.44 dus naar oefen(8/2/19) en productie(25/2/2019).


Belangrijk:
De V1 dienst voor "StartGebeurtenisDienst" zullen we blijven ondersteunen tot de major release die gepland staat op 23 april 2019.
Zij die al wensen over te schakelen naar V2 kunnen dit doen vanaf 25 februari (release 2.44.00 op productie).
Bovenstaande is ook van toepassing voor alle andere V1 diensten die vervangen worden door V2 diensten.
We raden echter aan om zo vlug mogelijk over te schakelen.

Nieuwe locatie releasenotes:
De releasenotes zijn terug te vinden op volgende locatie: https://www.milieuinfo.be/confluence/display/DOCUOMG/Release+Notes
Daar is ook een document "https://www.milieuinfo.be/confluence/display/DOCUOMG/Evolutie+Webservices" terug te vinden waar de aangepaste en/of nieuwe webservices vermeld worden.



Met vriendelijke groeten
Team Omgevingsloket

DEPARTEMENT OMGEVING
https://www.omgevingsloket.be/main
------------- volgend deel ------------
Een HTML-bijlage is gescrubt...
URL: <http://list.milieuinfo.be/pipermail/oml_it/attachments/20190108/73af381a/attachment.html>