stappenplan voor de webportal - Landelijk Asbestvolgsysteem

Stappenplan aansluiten op Portal webservice
Landelijk Asbestvolgsysteem (LAVS)
Doel van dit document
Dit document is bedoeld voor inventarisatiebedrijven die de eigen bedrijfssysteem wilt
koppelen aan het Landelijk Asbestvolgsysteem (L.A.V.S.).
Dit document beschrijft eerst het doel en vervolgens de werkwijze.
Het doel van de inventariseerders-koppeling
De inventariseerders-koppeling is een faciliteit waar inventarisatiebedrijven gebruik van
kunnen maken. Het voordeel van het gebruik van de inventariseerders-koppeling is dat het
dubbele invoer overbodig maakt en dat er de garantie is dat gegevens in L.A.V.S. en het
gekoppelde bedrijfssysteem met elkaar overeenkomen.
De koppeling bevat de volgende operaties (SOAP-berichten):
- toevoegenMelding : Middels deze operatie kan de inventariseerder een melding doen of
een melding annuleren
-
bijwerkenInventarisatieZaak : Middels deze operatie kan de inventariseerder een gehele
inventarisering in één keer opvoeren. De bijbehorende bijlagen kunnen middels de operatie
toevoegenBijlage worden toegevoegd
-
toevoegenBijlage : Middels deze functie kan de inventariseerder bijlagen aan een
inventarisatie voegen. Een bijlage kan gekoppeld zijn aan een inventarisatie of aan een bron.
Bijlagen worden middels MTOM verstuurd
-
statusOpvraging : Middels deze operatie kan de status van een eerder ingeschoten bericht
worden opgehaald. Hiervoor is een unieke Bericht Identificatie nodig. Deze bericht identificatie
is te vinden in het veld reference van de response berichten.
-
opdrachtActie : Middels deze operatie kan de inventariseerder de aan hem verstrekte
opdracht AANNEMEN, VOORWAARDELIJK AANNEMEN of AFWIJZEN, of een door hem
aangenomen opdracht OPLEVEREN.
De werkwijze voor het gebruik van bovenvermelde operaties is als volgt:
1. De projecteigenaar voert via LAVS-Website een locatie op.
2. De projecteigenaar of de coördinator maakt via LAVS-WEB een inventarisatieopdracht aan
en geeft daarbij een Inventariseerder en contactpersoon van de inventariseerder aan. LAVS
genereert een uniek inventarisatienummer voor deze inventarisatieopdracht.
3. De projecteigenaar of de coördinator communiceert het inventarisatienummer naar de
inventariseerder. Dit nummer heeft de inventariseerder nodig in alle communicatie met
betrekking tot deze zaak.
4. De inventariseerder voert de operatie opdrachtActie uit, om:
a. de opdracht aan te nemen, OF
b. de opdracht voorwaardelijk aan te nemen, OF
c. opdracht af te wijzen (hiermee stopt het inventarisatieproces).
5. De inventariseerder voert de operatie toevoegenMelding uit, om een melding te doen.
Deze operatie geeft een MeldingId en een Reference (berichtId) terug.
6. De inventariseerder kan de operatie bijwerkenInventarisatieZaak initiëren, indien de
opdracht is aangenomen en er een melding aan de gemeente heeft plaatsgevonden. Hierbij
geeft hij alle informatie in één keer mee, exclusief de bijlagen. Deze operatie geeft een
reference (berichtId) terug.
7. De inventariseerder initieert zo nodig de operatie bijlageToevoegen. Hij doet dit
herhaaldelijk voor alle bijlagen. Een bijlage kan daarbij aan de inventarisatiezaak in het
algemeen of aan een bron in het bijzonder gekoppeld worden.
-1-
8. De inventariseerder roept de operatie statusOpvraging aan om de status van zijn
verzonden berichten te achterhalen.
-2-
Werkwijze om bedrijfssysteem te koppelen aan L.A.V.S.
De inventariseerders-koppeling wordt aangeboden op het ‘L.A.V.S. Portal webservice’
Hieronder staan de te volgen stappen om de netwerkverbinding tot stand te brengen.
De beveiliging van de berichtuitwisseling vindt plaats m.b.v. een tweezijdige SSL verbinding.
Voor deze verbinding is het noodzakelijk dat het publieke deel van het certificaat van de
inventariseerder op de LAVS-server wordt geïnstalleerd.
Het publieke deel van het certificaat van LAVS moet ook op het bedrijfssysteem van de
inventariseerder geïnstalleerd te worden.
Een inventarisatiebedrijf dient de koppeling van zijn bedrijfssysteem met L.A.V.S. eerst te
realiseren met de ‘inregel-omgeving’ van L.A.V.S. (De inregelomgeving is een testomgeving
van L.A.V.S.)
Nadat de koppeling in de inregelomgeving zowel technisch als functioneel is getest, wordt de
koppeling gerealiseerd met de productie - omgeving van L.A.V.S.
De inregelomgeving en de productie - omgeving zijn functioneel gezien hetzelfde. De
zogenaamde “endpoints” van beide omgevingen zijn echter anders.
Hierdoor zijn twee certificaten nodig: één voor de inregel-omgeving en één voor de productieomgeving.
Alle stappen om de koppeling te maken staan hieronder genoemd. :
Stappen
1. Schaf een PKI overheidscertificaat aan bij een marktpartij. Vergeet niet een
bijbehorend testcertificaat aan te vragen met dezelfde structuur (maar ander endpoint in het certificaat);
2. U haalt de volgende gegevens van de koppeling.
a. Het publieke certificaat van de LAVS Portal webservice. De certificaten
sluiten aan bij de omgevingen:
Productieomgeving: broker.asbestvolgsysteem.nl.
Testomgeving: broker-inr.asbestvolgsysteem.nl.
b. de WSDL van de webservice en schema's met documentatie van de
berichten;
c. Een testbericht statusOpvraging bericht om te controleren of uw server met
de server van LAVS kan communiceren.
3. Gebruik volgende URL's als endpoint:
Voor de Testomgeving:
https://brokerinr.asbestvolgsysteem.nl:8443/wsx/services/PortalControllerService_WSP_LAVS_portal
Voor de Productieomgeving:
https://broker.asbestvolgsysteem.nl:8443/wsx/services/PortalControllerService_WSP_LAV
S_portal
-3-
4. Installeer uw PKI certificaat op uw server(s);
5. Stuur het publieke deel van uw PKI certificaat in crt formaat naar de helpdesk
zodat L.A.V.S. het kan installeren. Hiermee kan L.A.V.S. uw berichten ontvangen
en de afzender vertrouwen;
6. Installeer het publieke deel van het LAVS certificaat in de truststores op uw
servers, zodat u het certificaat van L.A.V.S. vertrouwd en berichten hiermee kunt
ontvangen;
7. Overleg met Functioneel Beheer van LAVS wanneer een goed moment is om de
test te beginnen.
8. Bouw de twee-zijdig SSL verbinding op en verzend het testbericht. (Dit XMLbericht leest alleen en wijzigt L.A.V.S. niet.) Als de test is geslaagd ontvangt u
een bericht dat sterk lijkt op:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:StatusOpvragingResponse xmlns:ns1="http://www.egem.nl/StUF/StUF0301"
xmlns:ns2="http://www.interaccess.nl/ienm/lavs/portal/1_1">
<ns2:status>SUCCESVOLVERWERKT</ns2:status>
</ns2:StatusOpvragingResponse>
</soap:Body>
</soap:Envelope>
9. Voer nu inhoudelijke/functionele testen uit op de testomgeving met uw systeem
om de correcte werking van de koppeling aan te tonen;
10. Als de testen goed zijn verlopen kan in overleg met Functioneel beheer L.A.V.S
over gegaan worden naar productie.
-4-

Download Report