Cursus StUF Maarten van den Broek messagedesign

Transcriptie

1 Cursus StUF Maarten van den Broek messagedesign

2 Inhoud Schets problematiek Positionering Principes StUF Introductie XML Contentmodel Interactiepatronen

3 Programma 'Andere overheid' Een overheid die: die niet naar de bekende weg vraagt klantgericht is zich niet voor de gek laat houden weet waar ze het over heeft haar zaken op orde heeft niet meer uitgeeft dan nodig is Basisregistraties Transparantie voortgang processen Automatisering

4 Landelijke ambities en randvoorwaarden Aansluiten op landelijke basisvoorzieningen Overheids Service Bus (OSB) met service register Landelijke Voorzieningen Basisregistraties GOB: Gemeenschappelijke Ontsluiting Basisregistraties TMF: TerugMeld Faciliteit Digitale dienstverlening Landelijke voorziening Omgevingsvergunning Persoonlijke Internet Pagina Bedrijvenloket...

5 Wat betekent dit Invoeren / aanpassen basisregistraties (BAG!) Verplicht gebruik basisgegevens Afstemmen/opschonen systemen Afhandelen elektronische aanvragen Ontvangen digitale aanvragen Doorsluizen naar afhandelende systemen Status terugmelding burger Inzage in eigen gegevens burger

6 Architectuur (concept Gemma)

7 Aansluiten op basisregistraties Afstemmen Matchen Verschillen analyseren en wegwerken Koppelen met bestanden Volgen met berichten opvragen toestand Basisregistratie plaatsen afnemerindicatie leveren object doorgeven wijziging terugmelding verwijderen afnemerindicatie Afnemend systeem

8 Routeren, Synchroniseren en Ontsluiten (binnengemeentelijke verhuizing) 1. Prefill en controle 2. Aanvraag Burgerzaken 3. Afhandelen Zakenmagazijn EF Middelen burger 4. Opvragen info EF BG ZKN Routering ZKN BG ZKN BG ZKN Synchronisatie BG BG BG BG Gebouwen & Adressen Belasting & Kadaster Vergunningen & Handhaven Werk, inkomen, zorg Partners Overige Gegevensmagazijn

9 Inhoud Schets problematiek Positionering Principes StUF Historie en beheer Introductie XML Contentmodel Interactiepatronen

10 Service georiënteerde architectuur verzoek Service gebruiker webservice Service aanbieder dienstenbus respons Kenmerken Berichtgebaseerd Functie ipv gegevens georiënteerd Werkt over platformen heen Aanbieder definieert het contract Keuze voor gebruiker tussen aanbieders Nieuwe systeemarchitectuur Los gekoppelde componenten ipv hecht geintegreerde systemen Verbonden via dienstenbus Diensten gepubliceerd op bus Centralisatie functies --> Berichtstandaardisatie gewenst

11 SGA en gegevensverwerking SGA: Splits en hergebruik Klassiek: database bindt businesslogica dienstenbus Maar, eenmalige opslag problematisch Performance (batchruns, management info) Niet alle gewenste gegevens beschikbaar Verschillen in definities/waarden Impact op bestaande systemen

12 SGA: meer dan web services Contract dat business toegevoegde waarde biedt Business functie Afsluiten telefoonabonnement Implementatie contract door uitvoering elementaire functies Werkstroom Contract voor uitvoering taak Geen interactie met andere elementaire functies in werkstroom Elementaire functie Domeinmodel Factureren Opsturen SIM-kaart Registreren abonnement etc. StUF richt zich op elementaire ICT functies StUF heeft geen kennis van werkstromen

13 Relatie met andere standaarden StUF bouwt voort op W3C Web services stack XML XSD SOAP en http WSDL en WS-I BP Taal voor zelfbeschrijvende berichten Taal voor specificeren structuur en inhoud XML-berichten Protocollen voor berichtverpakking en -transport Taal voor specificeren web services BETEKENIS? StUF berichtinhoud sturing + adressering interactiepatronen of functies UITBREIDBAARHEID? eenvoudig uitbreidbaar met nieuwe functionaliteit voor transport en logistiek

14 Inhoud Schets problematiek Positionering Principes StUF Introductie XML Contentmodel Interactiepatronen

15 Werkelijkheid, model en database verleent betekenis aan PRS VBO ADR PRS VBO ADR Model Werkelijkheid wordt gedefinieerd in definieert PRS ADR wordt afgebeeld in VBO Werkelijkheid Database

16 Modellering PRSPRSHUW PRS Fundamentele objecttypen: PRS, ADR hebben voorkomens in de werkelijkheid PRS: Maarten van den Broek ADR: Vallestap 88, 5672BJ Nuenen hebben veranderende eigenschappen burgerlijke staat, verblijfstitel, verblijfsadres verblijft op ADR correspondeert via Relatie objectttypen: PRSPRSHUW, PRSADRVBL, PRSADRCOR leggen relatie tussen twee fundamentele objecten hebben begin- en einddatum kunnen ook andere eigenschappen hebben GEM BRT Tabel objecttypen: GEM, BRT hoeven niet voor te komen in werkelijkheid (bijvoorbeeld definitie waardebereik) hebben onveranderlijke eigenschappen

17 Model Berichtdefinitie PRSPRSHUW PRS PRS PRSADRVBL PRSADRCOR ADR ADR PRSPRSHUW PRS PRSADRVBL ADR ADR ADR GEM BRT ADRPRSVBL PRS GEM BRT

18 Typering domein Meerdere objecten van één type met in de tijd veranderende eigenschappen met relaties naar andere objecten Afbeelding in registratie is relevant Meeste events hebben betrekking op onderkende objecten

19 Bericht en software ontwerp vormt basis voor PRS PRS ADR PRSADRVBL ADR VBO PRSVBO VBO Model Werkelijkheid wordt gedefinieerd in PRSPRSHUW PRS Berichtontwerp definieert vormt basis voor òf PRS VBO ADR gaat over Jansen software Werkelijkheid Systeem verwerkt

20 Interactiepatronen of functies Kennisgevingen Vraag/antwoord Synchronisatie Vrij Het doorgeven van wijzigingen in de werkelijkheid of een database Het opvragen van gegevens in een database Het synchroniseren van gegevens tussen databases Door service ontwerper zelf te definiëren interactiepatroon. StUF schrijft wel structuur bericht voor.

21 Ontwerpen en bouwen met StUF domein beschrijving GFO Zaken RSGB domeinbeschrijving Software Berichtverwerking Berichtontwerper design tooling StUF standaard generieke specificatie berichtsyntax aanvullende specificatie Software ontwikkelaar Zaken BG Sectormodel Specificatie definitie betekenis StUFberichten

22 StUF 0301 Familie Verticale sectormodellen woz0310 ef0310 lvo Horizontale sectormodellen bg0310 (RSGB) zkn0310 (RGBZ) Onderlaag StUF-standaard 0301 Protocolbindingen (WUS, OSB ebms, OSB WUS, OSB WUS lite)

23 Huidige configuratie LVO Verticaal sectormodel lvo0302 Horizontale sectormodellen Onderlaag bg0300 (GFO BG 1998) zkn0300 (GFO Zaken 2004) StUF-standaard 0300 Protocolbinding OSB ebms

24 Toekomstige configuratie LVO Verticaal sectormodel lvo0310 Horizontale sectormodellen bg0310 (RSGB) zkn0310 (RGBZ) Onderlaag StUF-standaard 0301 Protocolbinding OSB ebms

25 Structuur LVO schema's stuflvo0302.xsd StUF- Basisschema stuf0300.xsd lvo0302.bevoegdgezag.wsdl lvo0302.msg.xsd lvo0302.ent.xsd bglvo0302.ent.xsd bg0300.ent.xsd lvo0302.landelijke- Voorziening.wsdl Servicedefinitie = Interactiepatronen Berichtdefinitie LVO entiteittypen OMV, INR = contentmodel zknlvo0302.ent.xsd zkn0300.ent.xsd restrictions Horizontale entiteittypen

26 StUF configuraties StUF0105 met sectormodel bg0105 Operationeel in markt voor uitwisseling tussen systemen van verschillende leveranciers StUF0204 met sectormodellen bg0204, zkn0204 en ef0200 Operationeel in markt voor uitwisseling tussen systemen van verschillende leveranciers StUF0205 en sectormodel BAG Operationeel voor communicatie met LV BAG StUF0300 en sectormodellen gebaseerd op GFO1998 Operationeel voor LVO en WOZ-TIOX Niet aanbevolen door EGEM StUF0301 en sectormodellen gebaseerd op RSGB (WOZ)

27 StUF = design tooling Business functie Werkstroom ICT functie Semantiek + syntax voor elementaire ICT functies In termen van: state gedefinieerd als afbeelding wereld berichten voor input en output Modelgedreven: gebaseerd op domeinmodel Functiegeneriek èn voorgedefinieerde functies Protocol onafhankelijk Voorschriften voor logistiek en foutafhandeling Veel aandacht voor hergebruik Bericht State Domeinmodel Gebruik wat je nodig hebt

28 Inhoud Schets problematiek Positionering Principes StUF Introductie XML Contentmodel Interactiepatronen

29 Adreswijziging: Brief Geachte mevrouw/heer, Bij deze wil ik U mededelen dat ik per 1 april 2007 verhuisd ben van de Donk 12A, 5612XC in Eindhoven naar Vallestap 88, 5672BJ in Nuenen. Mijn telefoonnummer is veranderd in Ik wil u vriendelijk verzoeken mijn nieuwe adres in uw administratie door te voeren. Hoogachtend, M. van den Broek

30 Adreswijziging: Brief Geachte mevrouw/heer, Bij deze wil ik U mededelen dat ik per 1 april 2007 verhuisd ben van de Donk 12A, 5612XC in Eindhoven naar Vallestap 88, 5672BJ in Nuenen. Mijn telefoonnummer is veranderd in Ik wil u vriendelijk verzoeken mijn nieuwe adres in uw administratie door te voeren. Hoogachtend, M. van den Broek

31 Adreswijziging: formulier Geslachtsnaam: Broek Voorvoegsels: van den Voorletters: M.H.L.M. Geboortedatum: BSN: Adres Oud Nieuw Straatnaam: Donk Vallestap Huisnummer: Huisletter: A Huisnummertoevoeging: Postcode/Woonplaats: 5612XC Eindhoven 5672BJ Nuenen Telefoonnummer: Ingangsdatum:

32 Formulier --> XML Label Geslachtsnaam: Waarde Broek Set waarden Adres Oud Straatnaam: Donk Huisnummer: 12 Huisletter: A Huisnummertoevoeging: Postcode: 5612XC Woonplaats: Eindhoven --> --> simpel element --> <geslachtsnaam> --> elementinhoud --> <geslachtsnaam>broek</geslachtsnaam> --> complex element <oudadres> <straatnaam>donk</straatnaam> <huisnummer>12</huisnummer> <huisletter>a</huisletter> <huisnummertoevoeging/> <postcode>5612xc</postcode> <woonplaats>eindhoven</woonplaats> </oudadres>

33 Adreswijziging: XML <adreswijziging> <persoon> <geslachtsnaam>broek</geslachtsnaam> <voorvoegsels>van den</voorvoegsels> <voorletters>m.h.l.m.</voorletters> <geboortedatum> </geboortedatum> <bsn> </bsn> </persoon> <oudadres> <straatnaam>donk</straatnaam> <huisnummer>12</huisnummer> <huisletter>a</huisletter> <huisnummertoevoeging/> <postcode>5612xc</postcode> <woonplaats>eindhoven</woonplaats> </oudadres> <nieuwadres> <straatnaam>vallestap</straatnaam> <huisnummer>88</huisnummer> <huisletter/> <huisnummertoevoeging/> <postcode>5672bj</postcode> <woonplaats>nuenen</woonplaats> </nieuwadres> <oudtelefoonnnummer> </oudtelefoonnnummer> <nieuwtelefoonnummer> </nieuwtelefoonnummer> <ingangsdatum> </ingangsdatum> </adreswijziging> complex element complex element simpele elementen afsluiting persoon complex element simpele elementen afsluiting oud adres complex element simpele elementen afsluiting nieuw adres simpele elementen afsluiting formulier

34 Adreswijziging: Schema <schema...> <element name="adreswijziging"> attribute met waarde <complextype> <sequence> <element name="persoon" type="persoon"/> <element name="oudadres" type="adres"/> <element name="nieuwadres" type="adres"/> <element name="oudtelefoonnummer" type="telefoonnummer"/> <element name="nieuwtelefoonnummer" type="telefoonnummer"/> <element name="ingangsdatum" type="datum"/> </sequence> </complextype> </element>... </schema>

35 Definitie types <schema...>... <complextype name="adres"> <sequence> <element name="straatnaam" type="straatnaam"/> <element name="huisnummer" type="huisnummer"/> <element name="huisletter" type="huisletter" minoccurs= 0 /> <element name="huisnummertoevoeging" type="huisnummertoevoeging" minoccurs= 0 /> <element name="postcode" type="postcode"/> <element name="woonplaats" type="woonplaats"/> </sequence> </complextype>... <simpletype name="huisnummer"> <restriction base="positiveinteger > <pattern maxlength="5"/> </restriction> </simpletype> </schema>

36 Berichtuitwisseling: SOAP en http Inhoud Verpakking XML: <adreswijziging>... </adreswijziging> SOAP: <soap:envelope> <soap:header>... </soap:header> <soap:body> <adreswijziging>... </adreswijziging> </soap:body> </soap:envelope> Simple Object Access Protocol XML gebaseerd faciliteiten sturing verwerking faciliteiten foutafhandeling Adressering + sturing Berichtinhoud Transport HTTP over internet Verzoek en respons over zelfde verbinding

37 Specificeren services: WSDL WSDL (Web Services Description Language) =??? dienstenbus Taal voor XML documenten, die web services specificeren machine leesbaar importeerbaar in ontwikkeltools Een WSDL document specificeert: In- en uitgaande XML-berichten Interactiepatroon + foutafhandeling Protocol (in de praktijk SOAP over http) Locatie ( Per systeem een wsdl nodig: Locatie Niet alle services uit standaard worden ondersteund Services kunnen kleiner zijn dan standaard voorschrijft

38 Inhoud Schets problematiek Positionering Principes StUF Introductie XML Contentmodel Interactiepatronen

39 Model Berichtdefinitie NPSNPSHUW NPS NPS NPSADRVBL NPSADRCOR ADR ADR NPSNPSHUW NPS NPSADRVBL ADR ADR ADR GEM BRT ADRNPSVBL NPS GEM BRT

40 De waarde van een element of relatie Element of relatie niet ondersteund ondersteund niet geautoriseerd (a) niet ondersteund, verplicht: Element leeg, StUF:noValue= nietondersteund (b) niet ondersteund, niet verplicht: Element niet opnemen (b) niet geautoriseerd, niet verplicht: Element niet opnemen geautoriseerd (d) niet geautoriseerd, verplicht: Element leeg, StUF:noValue= nietgeautoriseerd verplicht niet verplicht (e) waarde onbekend, verplicht: Element leeg, StUF:noValue= waardeonbekend (f) geen waarde: Element leeg, StUF:noValue= geenwaarde (g) waarde bekend: Element opnemen met waarde als inhoud (h) waarde onbekend: Element niet opnemen

41 Speciale waarden Attribute StUF:noValue geenwaarde: het element heeft geen waarde (bijv. overlijdensdatum) onbekend: de zender weet niet wat de waarde is vastgesteldonbekend: de waarde van het element is niet meer vast te stellen nietondersteund: de zender ondersteunt het element niet nietgeautoriseerd: de ontvanger is niet geautoriseerd voor het element Attribute StUF:indOnvolledigeDatum V: De datum is volledig D: De dag is onbekend (GBA: ) M: De maand is onbekend (GBA: ) J: Het jaar is onbekend (GBA: )

42 Identificatie Jansen Systeem =? Jansen Verplichte kerngegevens Persoon: A-nummer, BSN, voorletters, voornamen, voorvoegsels, geslachtsnaam, geslacht, geboortedatum, verblijfsadres Adres: Postcode, straat, huisnummer etc, locatieomschrijving, woonplaats Sleutels Zender Ontvanger Gegevensbeheer

43 Voorbeeld identificatie <object entiteittype= NPS sleutelverzendend="1234" sleutelgegevensbeheer="5678"> <a-nummer xsi:nil="true" StUF:noValue="waardeOnbekend"/> <bsn-nummer> </bsn-nummer> <voornamen xsi:nil="true" StUF:noValue="waardeOnbekend"/> <voorletters>l</voorletters> <voorvoegselgeslachtsnaam xsi:nil="true" StUF:noValue="geenWaarde"/> <geslachtsnaam>witteveen</geslachtsnaam> <geboortedatum StUF:onvolledigeDatum= M > </geboortedatum> <geslachtsaanduiding>v</geslachtsaanduiding>... <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr" sleutelontvangend="456"/> </verblijftop> </object> Sleutel ontvangend in bericht --> kerngegevens niet nodig

44 Historie Gegevens en structuur Tijdvak geldigheid: periode waarin gegevens in werkelijkheid geldig zijn (fundamentelen en relaties) Tijdvak relatie: periode waarin relatie in werkelijkheid bestond TijdstipRegistratie: tijdstip waarop gegevens zijn vastgelegd Opnemen historie in entiteiten Functionaliteit Opbouwen en corrigeren materiële en formele historie in database Opvragen materiële en formele historie Opvragen op peiltijdstipmaterieel en peiltijdstipformeel

45 Materiële historie in antwoord Heden : Huwelijk : Naamswijziging : Geboorte <object entiteittype= NPS > <geslachtsnaam>bergmans</geslachtsnaam> <voorletters>k</voorletters> <geboortedatum> </geboortedatum> <burgerlijkestaat>gehuwd</burgerlijkestaat> <tijdvakgeldigheid> <begindatumgeldigheid> </begindatumgeldigheid> <einddatumgeldigheid xsi:nil="true" StUF:noValue="geenWaarde"/> </tijdvakgeldigheid> <historiematerieel> <burgerlijkestaat>ongehuwd</burgerlijkestaat> <tijdvakgeldigheid> <begindatumgeldigheid> </begindatumgeldigheid> <einddatumgeldigheid> </einddatumgeldigheid> </tijdvakgeldigheid> </historiematerieel> <historiematerieel> <geslachtsnaam>heuvelmans</geslachtsnaam> <tijdvakgeldigheid> <begindatumgeldigheid> </begindatumgeldigheid> <einddatumgeldigheid> </einddatumgeldigheid> </tijdvakgeldigheid> </historiematerieel> </object>

46 Materiële historie relatie <object entiteittype= NPS >... <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr">... </gerelateerde> <tijdvakrelatie> <begindatumrelatie> </begindatumrelatie> <einddatumrelatie xsi:nil="true" StUF:noValue="geenWaarde"> </tijdvakrelatie> </verblijftop> <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr">... Historische gerelateerde bevat actuele gegevens </gerelateerde> <tijdvakrelatie> <begindatumrelatie> </begindatumrelatie> <einddatumrelatie> </einddatumrelatie> </tijdvakrelatie> </verblijftop> </object>

47 Is 2e huwelijk actueel of historisch? <object entiteittype= NPS >... <isgehuwdmet entiteittype= NPSNPSHUW > <gerelateerde entiteittype= NPS >... </gerelateerde> <datumsluiting> </datumsluiting>... </isgehuwdmet> <isgehuwdmet entiteittype= NPSNPSHUW > <gerelateerde entiteittype= NPS >... </gerelateerde> <datumsluiting> </datumsluiting>... <datumontbinding> </datumontbinding> </isgehuwdmet> </object>

48 Uitbreiden sectormodel: extraelementen <object entiteittype= NPS >... <extraelementen> <extraelement naam="inonderzoek">j</extraelement> <extraelement naam="aanduidingkiesrecht" StUF:noValue="waardeOnbekend"/> </extraelementen> </object> Kunnen in bericht worden opgenomen zonder aanpassing sectormodel StUF specificeert niets over de verwerking Sectormodel specificeert niets over formaat

49 Aandachtspunten extraelementen Hoe krijg je aanpassing in standaard? Wat zijn consequenties voor verzendend systeem? Wat zijn consequenties voor ontvangend systeem?

50 Inhoud Schets problematiek Positionering Principes StUF Introductie XML Contentmodel Interactiepatronen

51 Interactiepatronen: Functioneel en technisch Functioneel: geen respons Notificatie Technisch: bevestiging- of foutbericht over zelfde verbinding zender ontvanger zender ontvanger Functioneel: verzoeker werkt door los van antwoord verzoeker Asynchroon verzoek/respons verzoeker Synchroon verzoek/respons Functioneel: verzoeker werkt pas door na ontvangst antwoord verzoeker Technisch: per bericht bevestiging- of foutbericht over zelfde verbinding serviceverlener serviceverlener serviceverlener

52 Sturing berichtverwerking Zender en ontvanger Organisatie Applicatie Administratie Gebruiker Identificatie en volgorde Referentienummer Crossreferentienummer Tijdstip bericht Type bericht Berichtcode Entiteittype Functie In synchrone berichten is alleen berichtcode verplicht In asynchrone berichten zijn berichtcode zender, ontvanger, referentienummer en tijdstipbericht verplicht. In asynchrone responsberichten is ook crossreferentienummer verplicht

53 Quality of Service Gegarandeerde ontvangst Bevestigings- of foutbericht als respons Geen dubbele berichten Uniek referentienummer per zender Volgorde Tijdstip bericht

54 Kennisgeving Kenmerken heeft betrekking op patroon voorbeeld 1 object (enkelvoudig); M objecten (samengesteld) Notificatie (synchroon of asynchroon) verhuizing persoon Mutatiesoort 'T' object relevant geworden voor zender 1 voorkomen 'W' object gewijzigd in werkelijkheid oud + nieuw voorkomen 'F' object gecorrigeerd in database zender oud + nieuw voorkomen Bouw formele historie op 'C' object gecorrigeerd in database zender oud + nieuw voorkomen Geen formele historie 'V' object niet meer relevant voor zender 1 voorkomen Indicator overname 'I' Informatief Afnemer hoeft bericht niet te verwerken 'V' Verplicht over te nemen Afnemer wordt geacht kennisgeving te verwerken

55 Kennisgevingbericht <npslk01 xmlns:stuf=" xmlns=" <StUF:stuurgegevens> <StUF:berichtcode>Lk01</StUF:berichtsoort> <StUF:zender> <StUF:applicatie>zender</StUF:applicatie> </StUF:zender> <StUF:ontvanger> <StUF:applicatie>ontvanger</StUF:applicatie> </StUF:ontvanger> <StUF:referentienummer>1</StUF:referentienummer> <StUF:tijdstipBericht> </StUF:tijdstipBericht> <StUF:entiteittype>NPS</StUF:entiteittype> </StUF:stuurgegevens> <StUF:parameters> <StUF:mutatiesoort>T</StUF:mutatiesoort> <StUF:indicatorOvername>V</StUF:indicatorOvername> </StUF:parameters> <object>... </object> </npslk01>

56 Verwerkingssoort De verwerkingssoort geeft aan wat met een entiteit in een kennisgeving gebeurt T (Toevoegen): W (Wijzigen): V (Verwijderen): I (Identificatie): S (Sleutelwijziging): O (Ontdubbeling): E (Beëindigen): R (Vervangen): Voeg de fundamenteel toe OF voeg relatie toe bij entiteit Wijzig entiteit Verwijder entiteit Doe niets met entiteit Wijzig een sleutel bij entiteit Ontdubbel twee entiteiten Beëindig een relatie bij entiteit Vervang een relatie bij entiteit

57 Persoon in toevoegkennisgeving <object entiteittype= NPS sleutelverzendend="1234" verwerkingssoort="t"> <a-nummer xsi:nil="true" StUF:noValue="waardeOnbekend"/> <bsn-nummer> </bsn-nummer> <voornamen xsi:nil="true" StUF:noValue="waardeOnbekend"/> <voorletters>l</voorletters> <voorvoegselgeslachtsnaam xsi:nil="true" StUF:noValue="geenWaarde"/>... <tijdvakgeldigheid> <begindatumtijdvakgeldigheid> </begindatumtijdvakgeldigheid> <einddatumtijdvakgeldigheid xsi:nil="true" StUF:noValue="geenWaarde"/> </tijdvakgeldigheid> <verblijftop entiteittype="npsadrvbl" verwerkingssoort="t"> <gerelateerde entiteittype="adr" sleutelverzendend="456" verwerkingssoort="i"> <postcode>5523jg</postcode> <woonplaatsnaam>waalre</woonplaatsnaam>... </gerelateerde> <tijdvakrelatie> <begindatumrelatie> </begindatumrelatie> <einddatumrelatie xsi:nil="true" StUF:noValue="geenWaarde"/> </tijdvakrelatie> </verblijftop> </object>

58 Body wijzigkennisgeving <object entiteittype= NPS StUF:verwerkingssoort="W">... <burgerlijkestaat>ongehuwd</burgerlijkestaat> <tijdvakgeldigheid> <begindatumtijdvakgeldigheid> </begindatumtijdvakgeldigheid> <einddatumtijdvakgeldigheid> </einddatumtijdvakgeldigheid> </tijdvakgeldigheid> <verblijftop entiteittype="npsadrvbl" StUF:verwerkingssoort="I"> Verplicht, want... kerngegeven </verblijftop> </object> <object entiteittype= NPS StUF:verwerkingssoort="W">... <burgerlijkestaat>gehuwd</burgerlijkestaat> <BG:tijdvakGeldigheid> <begindatumtijdvakgeldigheid> </begindatumtijdvakgeldigheid> <einddatumtijdvakgeldigheid xsi:nil="true" StUF:noValue="geenWaarde"/> </BG:tijdvakGeldigheid> <verblijftop entiteittype="npsadrvbl" StUF:verwerkingssoort="I">... </verblijftop> </object>

59 Toevoegen relatie <object entiteittype= NPS sleutelverzendend="1234" verwerkingssoort="i">... <verblijftop entiteittype="npsadrvbl" verwerkingssoort="t" xsi:nil="true" StUF:noValue="geenWaarde"/> </object> <object entiteittype= NPS sleutelverzendend="1234" verwerkingssoort="i">... <verblijftop entiteittype="npsadrvbl" verwerkingssoort="t"> <tijdvakrelatie> <begindatumrelatie> </begindatumrelatie> <einddatumrelatie xsi:nil="true" StUF:noValue="geenWaarde"/> </tijdvakrelatie> <gerelateerde entiteittype="adr" sleutelverzendend="456" verwerkingssoort="t"> <postcode>5672gb</postcode> <woonplaatsnaam>nuenen</woonplaatsnaam>... </gerelateerde> </verblijftop> </object> NPS gegevens wijzigen niet Toe te voegen verblijfsadres Adres toe te voegen

60 Vervangen relatie <object entiteittype= NPS sleutelverzendend="1234" verwerkingssoort="w">... <verblijftop entiteittype="npsadrvbl" verwerkingssoort="r"> Te vervangen relatie <gerelateerde entiteittype="adr" verwerkingssoort="i">... </gerelateerde> <tijdvakrelatie> <begindatumrelatie> </begindatumrelatie> <einddatumrelatie> </einddatumrelatie> </tijdvakrelatie> Ook gegevens NPS wijzigen </verblijftop> </object> <object entiteittype= NPS sleutelverzendend="1234" verwerkingssoort="w">... <verblijftop entiteittype="npsadrvbl" verwerkingssoort="r"> Nieuwe relatie <gerelateerde entiteittype="adr" verwerkingssoort="t">... </gerelateerde> <tijdvakrelatie> <begindatumrelatie> </begindatumrelatie> <einddatumrelatie xsi:nil="true" StUF:noValue="geenWaarde"/> </tijdvakrelatie> </verblijftop> </object>

61 Vraag/antwoord Kenmerken heeft betrekking op patroon voorbeeld meerdere objecten synchroon of asynchroon verzoek/respons opvragen adressen voor lijst of opvragen details adres Parameters vraagbericht sortering volgorde objecten (gedefinieerd in sectormodel, default 0) maximumaantal maximum aantal terug te geven objecten (default 15) indicatoraantal geef aantal voorkomens terug dat voldoet aan selectie indicatorafnemerindicatie plaats J/N afnemerindicatie voor geselecteerde objecten (default N) indicatorvervolgvraag het gaat J/N om een vervolgvraag (default N) peiltijdstipmaterieel het tijdstip in de werkelijkheid waarvoor de vraag gesteld wordt peiltijdstipmaterieel het tijdstip registratie waarvoor de vraag gesteld wordt Parameters antwoordbericht indicatorvervolgvraag alle gevraagde objecten zijn teruggegeven J/N (default N) indicatorafnemerindicatie er is J/N afnemerindicatie geplaatst (default N) aantalvoorkomens het aantal objecten dat aan de selectie voldoet peiltijdstipmaterieel het tijdstip in de werkelijkheid waarvoor de gegevens geldig zijn peiltijdstipmaterieel het tijdstip registratie waarvoor de gegevens geldig zijn sequencenummer Volgnummer in verzameling asynchrone antwoordberichten indicatorlaatstebericht Indicator die aangeeft dat dit het laatste asynchr. antwoord is

62 Body vraagbericht <gelijk entiteittype= NPS > <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr"> <postcode StUF:exact="false">5672</postcode> </gerelateerde> </verblijftop> </gelijk> <vanaf entiteittype= NPS > <geboortedatum xsi:nil="true"> </geboortedatum> </vanaf> Tot en met selectiecriteria <totenmet entiteittype= NPS > <geboortedatum xsi:nil="true" StUF:noValue="geenWaarde"/> </totenmet> <scope entiteittype= NPS > <bsn-nummer xsi:nil="true"/>... </scope> Alle personen die verblijven op postcodes beginnend met 5672 voldoen Vanaf selectiecriteria: Personen geboren na voldoen Gevraagde elementen Geen bovengrens voor de geboortedatum

63 Body vraagbericht <gelijk entiteittype= NPS > <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr"> <postcode StUF:exact="false">5672</postcode> </gerelateerde> </verblijftop> </gelijk> <vanaf entiteittype= NPS > <geboortedatum xsi:nil="true"> </geboortedatum> </vanaf> <totenmet entiteittype= NPS > <geboortedatum xsi:nil="true" StUF:noValue="geenWaarde"/> </totenmet> <scope entiteittype= NPS > <bsn-nummer xsi:nil="true"/>... </scope> <start entiteittype= NPS > Start vervolgvraag: het laatste object in het antwoordbericht... </start>

64 Body antwoordbericht De gevraagde gegevens voor de gevraagde objecten Synchroon: maximumaantal objecten in het antwoordbericht Asynchroon: per object een bericht

65 Vrij bericht Kenmerken heeft betrekking op patroon voorbeeld 0 - N objecten notificatie of synchroon/asynchroon verzoek/respons bepalen waarde WOZ-object Berichtontwerper definieert zelf de betekenis/functie van verzoek respons

66 Body vrij bericht Elementen met objecten conform contentmodel Gegevens uit contentmodel mogen niet los worden opgenomen òf Gereserveerde elementen <parameters> gegevens die geen onderdeel zijn van een object <update> met als inhoud een kennisgeving zonder stuurgegevens <vraag> met als inhoud vrijwel een vraagbericht zonder stuurgegevens <zaakinfo> met als inhoud zaak informatie gedefinieerd in sectormodel Zaken

67 Samenhang StUF componenten StUF-functie gebruikt gebruikt 1..2 heeft Functiespecifiek kennisgeving synchronisatie vraag/antwoord trigger StUF-bericht Functiegeneriek vrij in vrij uit heeft heeft heeft * heeft * heeft StUF foutafhandeling bevestigings bericht fout bericht Verplicht Optioneel StUF Stuurgegevens entiteit model functie model StUF-contentmodel structuur vrij bericht

68 Modelgedreven Losse gegevens <buitenlander>true</buitenlander> <geboortedatumtotenmet> </geboortedatumtotenmet> <postcode>5672bj</postcode> StUF contentmodel Legenda StUF <parameters> Sectormodel BG <buitenlander>true</buitenlander> Eigen definitie </parameters> Gegevens <vraag> <gelijk entiteittype="nps"> <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr"> <postcode>5672bj</postcode> </gerelateerde> </verblijftop> </gelijk> <totenmet entiteittype="nps"> <geboortedatum> </geboortedatum> </totenmet> </vraag>

69 Modelgedreven Losse gegevens <buitenlander>true</buitenlander> <geboortedatumtotenmet> </geboortedatumtotenmet> <postcode>5672bj</postcode> StUF contentmodel Legenda StUF <parameters> Sectormodel BG <buitenlander>true</buitenlander> Eigen definitie </parameters> Gegevens <vraag> <gelijk entiteittype="nps"> <verblijftop entiteittype="npsadrvbl"> <gerelateerde entiteittype="adr"> <postcode>5672bj</postcode> </gerelateerde> </verblijfsop> </gelijk> <totenmet entiteittype="nps"> <geboortedatum> </geboortedatum> </totenmet> </vraag> --> Geen losse gegevens, maar onderdeel entiteittype en/of StUF-structuur

70 Kenmerken StUF Template berichtdefinitie met semantiek voor: contentmodel gebaseerd op ERD-objecten sturing berichtverwerking diverse functies ter ondersteuning van: gegevensuitwisseling functiegerichte web services met verschillende protocolbindingen: W3C: soap over http OSB: ebms, WUS en WUS lite Bestand