Foutafhandeling!synchrone)berichten&

Vergelijkbare documenten
Gebruikershandleiding Cataloguswebservice

Koppelvlakbeschrijving AuSP Service Bancaire Infrastructurele Voorzieningen

GAB Postcode (geheel)

Best Practices WUS Digikoppeling 2.0

Migratie PS API 40 naar 50

Standaard koppelvlak Digikoppeling adapter Servicebus. Datum: 18 augustus 2014 Versie: 0.3 Auteur: M. van den Broek

Bancaire Infrastructurele Voorziening Fout- en statusmeldingen

Technisch Interface Specificatie Webservice Koppelvlak Versie Datum Status Concept

Volledige Digikoppeling connectiviteit. Foutberichten en foutafhandeling

Koppelvlakbeschrijving mededelingenservice Bancaire Infrastructurele Voorzieningen. Het ophalen van mededelingen bij de BIV

Koppelvlakbeschrijving statusservice Bancaire Infrastructurele Voorzieningen. Het ophalen van statusinformatie bij de BIV

Overheidsservicebus met volledige Digikoppeling connectiviteit. Foutberichten en foutafhandeling

Testrapport MDC WUS. Testrapport MDC WUS

SuwiML berichtstandaard

Handleiding voor gegevensmakelaars. Aanlevering kwaliteitsgegevens bij Zorginstituut Nederland

Keteininformatiemodellering op basis van UML

Schema. Schema - Inleiding. <hoofdstuk> </hoofdstuk> DTD? Eenstapjeverder. Schema XML

Koppelvlakstandaard Grote Berichten Digikoppeling 2.0

FOUTAFHANDELINGEN TIJDENS HET AANLEVEREN VAN BESTANDEN VOOR KNOOPPUNTDIENSTEN WMO EN JW

Mogelijk onvolledige datum

Standaardisatie. XML Schema Definition. Architectuurprincipes. Versie document 1.0. Datum:

SMS Webservice Implementatie handleiding

Test rapport Yenlo The experts in integration

Standaardisatie. XML Schema Definition Architectuurprincipes. Versie document 1.3. Datum: v1.3

Koppelvlakbeschrijving aanleverservice Bancaire Infrastructurele Voorzieningen. Het aanleveren van kredietrapportages bij de BIV

Release Notes Wijziging Digimelding Koppelvlakspecificatie

Gebruikershandleiding e-invoicing/customerservice 01.00

Bancaire Infrastructurele Voorziening Aanleverservice. Implementatie conform koppelvlak WUS 2.0 Bedrijven

XSD 1.5 aanpassingen

Edukoppeling. Transactiestandaard. Versie 1.2 (concept Standaardisatieraad) Edustandaard. Datum: 22 juni Versie: 1.2

Technische documentatie APK AFS 6.2

Service API Specificatie. Key2Parkeren Koppelvlak Kentekenwijziging

Voorbeeldberichten KRI webserver

Handleiding Noodvoorziening ijw 2.2 en iwmo 2.2

Specificatie technisch formaat voor aanlevering meetgegevens Zorginhoudelijke Indicatoren

Inhoudsopgave. Hoofdstuk I Inleiding. Hoofdstuk II Administrator. Hoofdstuk III Code. Hoofdstuk IV Categorie. Hoofdstuk V Overzicht

IH Berichttransport. Datum: 15 November 2013 Publicatie: AORTA 2013 (V )

Rapport. Versiebeheer. Aan te sluiten overheidspartij Kamer van Koophandel Nederland

Zelftest XML Basis. Document: n1006test.fm 25/01/2017. ABIS Training & Consulting P.O. Box 220 B-3000 Leuven Belgium

Koppelvlakstandaard Grote Berichten voor Digikoppeling

SuwiML Transactiestandaard 4.0

PRIVACYSTATEMENT MODEL WORKOUT B.V.

Gebruikershandleiding Compliancevoorziening WUS

BEST PRACTICE WUS Digikoppeling

Koppelvlakspecificatie Digimelding

VERSIE HDN Helpdesk T: F: M: Copyright Communications Security Net B.V.

XML & XSLT voor DMO. Datamodellering Een XML datamodel. conceptueel model logisch / fysiek model: platform afhankelijk

Koppelvlakspecificatie Digimelding

Roadmap StUF familie Invalshoeken om te kijken naar standaardisatie

KvK-FRIS Eisen aan en toelichting op gebruik SBR rapportages (XBRL instances) voor het deponeren van jaarrekeningen gebaseerd op de NT 2011

Vernieuwing gegevens en berichtenstandaarden. Plan van aanpak vernieuwing standaarden - Project breakdown - Voorgestelde route 2017

GEBRUIKERSHANDLEIDING DOMEIN MOBILITEIT GEEFVOERTUIG 2.0. Versie /// 2.0 Publicatiedatum /// /// Gebruikershandleiding

GIM FOUTAFHANDELING. Versie SIVI

SQL en XML. XML schema s & DMO. Entiteitsklasse en attribuut. SQL en XML. Datamodellering Schema een ruim begrip (zie Møller, p.

Internetpublicatiemodel Decentrale Regelgeving

Handleiding Noodvoorziening XML ijw/iwmo 1 maart 2017

Handleiding Testvoorziening istandaarden

Voorstudie G80061-U1029-U024-A4-Z015 Studie Extlab Export-Import_nl.doc

IH Berichttransport. Datum: 15 mei 2017 Publicatie: AORTA 2017 (V )

BatchSOAP: Technical Service Specifications

Statussen per processtap

Detail Ontwerp 4317 Nieuwe StUF release Omgevingsloket online release 2.9

Gemeentelijke Duurzaamheidsindex GDI-2014 Data voor alle 12 provincies

Afsprakenstelsel eherkenning. Koppelvlak DV-HM. Versie 1.4

Gebruikershandleiding e-line DNB: het XML-importbestand

Elektronisch Journaliseren bij e-xperimenteren+

Organiseer uw verschillende SOAP services in één scenario

SuwiML. Transactiestandaard Versie 3.0

GEBRUIKERSHANDLEIDING DOMEIN EPROCUREMENT MERCURIUSSERVICE (SIMPL.EPRIOR) Versie /// 1.0 Publicatiedatum ///

XML & XSLT voor DMO. Een XML datamodel. Van ERD naar XML schema. XML en XSLT DMO Datamodellering 2008

Opvolging (Afdruk via Word)

Yenlo The experts in integration. Test rapport met Logius betreffende:

Omschrijving Prijs Eenheid

WMO315 (Verzoek om toewijzing Wmo-ondersteuning. Berichtspecificatie - WMO315 Verzoek om toewijzing Wmo-ondersteuning. 1 Klassenview.

Verklaring Cliënt. Laat je cliënt deze verklaring VOLLEDIG invullen en ondertekenen.

S1 Gebruiksaanwijzing Manual del Usuario

EUROPESE UNIE FRANKRIJK Adres waarheen het omgewisseld rijbewijs moet teruggestuurd worden:

TECHNISCHE HANDLEIDING MESSAGESERVICE WEBSERVICE

Best Practice Grote Berichten. voor Digikoppeling 2.0. Versie 1.0. Datum 4 oktober 2012 Status Definitief

De vernieuwde StUF familie The Next Step. Peter Klaver en Theo Peters Kwaliteitsinstituut Nederlandse Gemeenten (KING) 2 december 2015

Document Kostensheet marktscan Digikoppeling def 1.0 Versie definitief Datum Onderwerp Marktscan Digikoppeling 2017 Toelichting Deze

Document Kostensheet marktscan Digikoppeling def 1.0 Versie definitief Datum Onderwerp Marktscan Digikoppeling 2017 Toelichting Deze

Document Kostensheet marktscan Digikoppeling def 1.0 Versie definitief Datum Onderwerp Marktscan Digikoppeling 2017 Toelichting Deze

Ontwerprichtlijnen voor XML-schemadefinities (XSD s) 18 juli 2017

W09-18 v0.4 Aanscherping BSN regels

1. Milieuklacht Handleiding opladen XML in mkros Werken met Refertes... 5

JW315 (Verzoek om toewijzing Jeugdhulp) Berichtspecificatie - JW315 Verzoek om toewijzing Jeugdhulp. 1 Klassenview

Testen in SOA-omgevingen

Tweede Kamer der Staten-Generaal

0.1 KLIC B2B-aanvraag Technische Notitie

Aanvraagformulier voor ondersteuning vanuit Read to Grow.

Presentatie 49 e Jeugdtour 29 juli 3 augustus

ARAD 06 : Reglement Arbeidsveiligheid en Hygiene (RAVH) Onderhavige bijwerkingen heeft tot doel om :

Handleiding Testvoorziening istandaarden (TiS) 4 mei 2017

1 / 8. Schema RtnList. Inleiding

Technische afspraken Ketenregister

Tweede Kamer der Staten-Generaal

Aanvraagformulier voor ondersteuning vanuit Read to Grow.

Rapport. Versiebeheer. Aan te sluiten overheidspartij Kamer van Koophandel Nederland. Catalogus KvK Web services Overheid.

Transcriptie:

Foutafhandeling!synchrone)berichten 1 Inleiding) Ditvoorstelbeschrijftopwelkewijzetechnischefoutmeldingengestandaardiseerd kunnenworden.hetgaathierfoutafhandelingbijsoap#berichtenverkeerdie synchroonuitgewisseldworden.hetvoorstelheeftbetrekkingopdestandaardenen deuitwisselingenvanbasisregistratiesdiegeachtwordenzichteconformerenaande nationalestandaarddigikoppeling. Ditvoorstelisgebaseerdopeenanalysevandedonerendestandaarden Digikoppeling,StUFenSuwiML.Deanalyseistoegevoegdinbijlage2. 2 Voorstel) 2.1 Foutmeldingen)van)Digikoppeling) I. Gebruikdetechnischefoutmeldingenencategoriseringvolgensdelijst Digikoppeling(Document:Digikoppeling_Best_Practices_WUS_v_1_3). II. DelijstmettechnischefoutenvanDigikoppelingwordenverplicht overgenomendoorelkeleverendeserviceen/ofintermediair. III. Elimineerdoubluresineigenlijstenmetfoutmeldingentenopzichtevande lijstvandigikoppeling.domein#ofstandaardspecifieketechnische foutmeldingenwordenmeteenverwijzingnaarhetdomein/standaardinde faultcodeopgenomen. IV. FunctionelefoutenmogennooitindeSOAPfaultwordenopgenomen. V. Zorgvooreenjuistecategoriseringvanmeldingen,zodatfoutenopeenjuiste manierverwerktkunnenworden. Verschillendefout#categorieënzijn: 1. syntaxfouten,zowelopstructuuralsopinhoudelijkewaardencq.domein check 2. inhoudelijkefouten,waaronderookprotocolfouten,leidendtot onbestaanbareen/ofinconsistentesituaties 3. foutendoordateenserviceniet(onvoldoendeqos)beschikbaaris, waaronderooktime#outenautorisatieproblemen/fouten. 02#12#1415:37 1

Percategoriekanophoofdlijneneenprocedurevoordefoutafhandeling gedefinieerdworden. 1. bijsyntaxfoutendientzomogelijkaangegeventewordenwelkelement foutis(zoalsinfoutmeldingen0005t/m0008aangegevenstaat) 2. Zomogelijkaangevenwaarom.Bijprotocolfoutenaangevenwatdestatus isenwatwelverwachtwordt,bijinhoudelijkefoutenaangevendathet berichtvanwegeinconsistentienietverwerktkanworden.(ditiseigenlijk geentransport/koppelvlakprobleem,maarveeleereenbusinessprobleem meteenbijbehorendeafhandelingsprocedure,vgl.deterugmeldinginhet stelsel). VI. Houdrekeningmethoemeldingenbijgebruikersterechtkomen.De faultstringkangebruiktwordenommeldingenrechtstreeksaan eindgebruikersdoortegeven. VII. Technischefoutmeldingenmoeteneenduidigwordengeïnterpreteerd. Lijstvantechnischefoutmeldingenmetclassificatienaarfout#categorieën nr) omschrijving) categorie) toelichting) 0001 invalideenvelope 1 Voldoetnietaanverwachtesyntax. Structuurvandeenvelopematchtnietmet waterverwachtwordt 0002 requestersysteemniet geauthoriseerd 0003 requestberichtinvalide soapaction 3 Servicenietbeschikbaar(QoS).Doorgebrek aanbevoegdheden. 2 Deinhoudleidtniettoteenvoltooideactie, isnietgedefinieerdofonbegrijpelijk. Protocolfout 0004 elementnietconformxsd 1 Voldoetnietaanverwachtesyntax 0005 WSaddressingheader 1 Voldoetnietaanverwachtesyntax to ontbreekt 0006 WSaddressingheader 1 Voldoetnietaanverwachtesyntax action ontbreekt 0007 WSaddressingheader 1 Voldoetnietaanverwachtesyntax messageid ontbreekt 0008 WSaddressingheader 1 Voldoetnietaanverwachtesyntax relatesto ontbreekt 0009 Nietvolgensutf 1 Voldoetnietaanverwachtecharacterset 0010 HeadersandersdanWS# 1 Voldoetnietaanverwachtesyntax headers 0011 Headeranderewaarde 1 Voldoetnietaanverwachtespec/waarde danvoorgeschreven 0050 procesvoorafhandelen berichtgeeftfout 2 Deinhoudleidtniettoteenvoltooideactie, isnietgedefinieerdofonbegrijpelijk. 02#12#1415:37 2

0051 antwoordendesysteem geefttime#outfout 0100 opslaanberichtniet mogelijk 1 0100 opslaanberichtniet mogelijk 0100 opslaanberichtniet mogelijk 3 Servicenietbeschikbaar(QoS).Doorgebrek aanresources/verwerkingscapaciteit. 1 VoldoetnietaanverwachtesyntaxBerichtis onleesbaar 2 Deinhoudleidtniettoteenvoltooideactie, isnietgedefinieerdofonbegrijpelijk.bericht isinconsistentmetoverigeinhoud 3 Servicenietbeschikbaar(QoS). Database/storageisnietbeschikbaar, (mogelijkdoorgebruik/lockvanander systeem) 2.2 Afspraken)voor)vulling)van)SOAPfault)elementen) VulbijtechnischefoutendeSOAPfaultconformonderstaandetabel.Gebaseerdop SOAPfaul1.1vanW3Chttp://www.w3.org/TR/2000/NOTE#SOAP#20000508/# _Toc478383507. Element) faultcode Standaardisatie)afspraak) BevatdedefaultwaardenVersionMismatch,MustUnderstand,Clienten Server. Despecifiekefoutcodediehoortbijdetechnischefout(format: <afkortingbron><coderingvanfout>. Dekorteomschrijvingvandefout(bijvoorbeeld:deDigikoppeling omschrijvinguitdelijst) faultstring Deeigenmeergedetailleerdebeschrijvingvandefoutsituatie. Deeigenbeschrijvingzoveelmogelijkgeschiktmakenvoorhetkunnen presenterenaangebruiker. Deontvangerisnietverplichtdezetekstovertenemen. faultactor BevateenURIvandeantwoordendeservice. VuldefaultactorinmetdeURIvandebronvandeoorzaak,indienhet SOAP#berichtlangseentussenstationgaat. faultdetail Alleendetailinformatieopnemenalsdetechnischefoutbetrekkingheeft opdebodyvanhetbericht. Ziebijlage1voorenkelevoorbeelden. 1 "Voor deze foutcode is het niet duidelijk waarom het bericht niet opgeslagen kan worden, vandaar dat het voor de 3 categorieën uitgesplitst is." 02#12#1415:37 3

Bijlage)1:)Voorbeelden)ter)illustratie) VoorbeeldA:Zondertussenstation <SOAP#ENV:Envelopexmlns:SOAP#ENV=khttp://schemas.xmlsoap.org/soap/envelope/k> <SOAP#ENV:Header/> <SOAP#ENV:Body> <SOAP#ENV:Fault> <faultcode>soap#env:server.dk0051.hetantwoordendesysteemisnietinstaatdebevragingaftehandelenbinnende connectietimeout.</faultcode> <faultstring>hetbronsysteemxyzheeftniettijdiggereageerd.mogelijkishetsysteemtijdelijknietbeschikbaar,ofishette druk.probeerhetlaternogeens.</faultstring> </SOAP#ENV:Fault> </SOAP#ENV:Body></SOAP#ENV:Envelope> VoorbeeldB:Zondertussenstation Situatie:(Burgerservicenummer(8(posities(aangeleverd(i.p.v.(9(posities.( <SOAP#ENV:Envelopexmlns:SOAP#ENV=khttp://schemas.xmlsoap.org/soap/envelope/k> <SOAP#ENV:Header/> <SOAP#ENV:Body> <SOAP#ENV:Fault> <faultcode>soap#env:server.dk0004elementbinnendeberichtbodyisnietconformdexsd</faultcode> <faultstring>hetrequestbevatindebodyeenofmeerelementendienietvoldoenaanhetberichtschema.</faultstring> <detail> <SOAP#ENV:Body> <smls:uwvpersoonsinfo> <Burgerservicenr>12345678</Burgerservicenr> <PeriodeGegevensvraagIko> <DatBPeriode>00011030</DatBPeriode> <DatEPeriode>00011030</DatEPeriode> </PeriodeGegevensvraagIko> </smls:uwvpersoonsinfo> </SOAP#ENV:Body> </detail> </SOAP#ENV:Fault> </SOAP#ENV:Body></SOAP#ENV:Envelope> VoorbeeldC:Mettussenstation <SOAP#ENV:Envelopexmlns:SOAP#ENV=khttp://schemas.xmlsoap.org/soap/envelope/k> <SOAP#ENV:Header/> <SOAP#ENV:Body> <SOAP#ENV:Fault> <faultcode>soap#env:server.dk0050.procesvoorafhandelenberichtgeeftfout</faultcode> <faultstring>deservicesuwibedrijvenregisteristijdelijknietbeschikbaar.probeerhetlaternogeens.</faultstring> <faultactor>https://www.sbr.nl/inlees_service</faultactor> </SOAP#ENV:Fault> </SOAP#ENV:Body></SOAP#ENV:Envelope> 02#12#1415:37 4

Bijlage)2:)Analyse)donerende)standaarden) 1 Analyse) Korte(beschrijving(van(de(huidige(situatie. ZowelStUF,NEN#3610alsSuwiMLhebbenhaareigenrichtlijnenenfilosofieënmet betrekkingtotdefoutafhandeling.deanalyseisgebaseerdopdehuidige koppelvlakstandaardwusvoordigikoppeling3.0(hierna(te(noemen( Digikoppeling ). DigikoppelingschrijftbinnendezestandaardSOAP1.1vooralsbasis. Wat(bieden(de(vier(standaarden(voor(dit(onderwerp?( 1.1 Algemeen) Allestandaardengevenaandatoptransportenprotocolniveaugeenstandaardisatie uitgevoerdkanworden.opditniveauvanfoutafhandelingzijnalvoorzieningen getroffenopinternationaalniveau.destandaardenhebbendaaromookniets beschrevenm.b.t.deafhandelingvanfoutenopditvlak. ZowelStUFalsSuwiMLhebbeneenstructuuromfunctionelefoutentekunnen uitwisselenvoorzowelsynchronealsasynchroneberichten.destructuurisgeëntop destructuurvansoapfault.onderaandezeanalyseisweergegevenhoede structuurvanstufensuwimlgemaptkunnenwordenopdeelementenvan SOAPfault. 1.2 Digikoppeling) Digikoppelinggeeftrichtlijnenvoorhetmeldenvantechnischefouten.Technische foutenwordenindesoap:faultbeschreven(soapversie1.1).erwordtgevraagd omdezemeldingenoptenemenindeservice.demeldingendiedigikoppeling voorstelt,wordenindesoap:faultfaultcodeenfaultstringopgenomen. VerbijzonderingvandetechnischefoutenkunnenopgenomenwordenSOAP:fault detailalsdefoutvoorkomtindebodyvanhetbericht.hieronderdestructuurvan desoap:fault. <xs:complextype name="fault" final="extension"> <xs:annotation> <xs:documentation>fault reporting structure</xs:documentation> </xs:annotation> <xs:sequence> <xs:element name="faultcode" type="xs:qname"/> <xs:element name="faultstring" type="xs:string"/> <xs:element name="faultactor" type="xs:anyuri" minoccurs="0"/> <xs:element name="detail" type="tns:detail" minoccurs="0"/> </xs:sequence> </xs:complextype> <xs:complextype name="detail"> <xs:sequence> <xs:any namespace="##any" minoccurs="0" maxoccurs="unbounded" processcontents="lax"/> </xs:sequence> <xs:anyattribute namespace="##any" processcontents="lax"/> </xs:complextype> Afbeelding)1)SOAP)faultFstructuur)W3C)waar))Digikoppeling)naar)verwijst) 02#12#1415:37 5

FunctionelefoutmeldingenwordendoorDigikoppelingnietbepaald,enkunnen daaromnietgestandaardiseerdworden.hiervoorzijndeleverendepartijenzelfvoor verantwoordelijk. BinnendekoppelvlakstandaardWUSvanDigikoppelingzijner4verschillende fouttypenteonderscheiden:protocol#,transport#,functionele#entechnischefouten. Protocol#entransportfoutenzijninhetalgemeeninhetprotocolzelfgedefinieerd. Defoutmeldingenzijningebakkenindestandaardsoftwareendaaromwordenze nietbeschreven.functionelefoutenzijnvoorverschillendeorganisatiesverschillend enhetcommunicerenvandefoutmeldingzalnietaltijdeenduidigzijn.inde SOAP:faultvandeSOAP#specificatiezijndetechnischefoutmeldingenbeschreven. 1.3 StUF) StUFondersteuntSOAP:faults.Naastdetechnischemeldingenwordende functionelefoutmeldingenindedetailvandesoap:faultopgenomen.hieronderde Ten(behoeve(van(foutafhandeling(kent(SOAP(het(<SOAP:fault>(element.( De(elementen(van(het(<SOAP:fault>(element(worden(gevuld(op(basis(van(de(elementen( binnen(het(stufmfoutbericht:( 1. Het(element(<SOAP:faultcode>(wordt(gevuld(met(de(namespace(qualifier(voor(de( namespace( http://schemas.xmlsoap.org/soap/envelope/( (gevolgd(door(een(s:s(en(de( waarde(van(<stuf:plek>(binnen(het(foutbericht,(bijvoorbeeld( SOAPM ENV:Client.( 2. Het(element(<SOAP:faultstring>(wordt(gevuld(met(de(waarde(van( <StUF:omschrijving>(binnen(het(foutbericht.( 3. Het(element(<SOAP:details>(wordt(gevuld(met(het(StUFMfoutbericht.( 4. Het(element(<SOAP:faultactor>(wordt(niet(opgenomen(in(het(<SOAP:fault>( Afbeelding)2)Uit)protocolbinding)StUF) element.( passageuitdestuf#documentatiemetbetrekkingtotfoutafhandeling. Erwordenelementenuiteenfoutberichtomgezetnaardeovereenkomstige elementenbinnendesoap:fault.enwordthetelementsoap:faultactorniet gebruikt.ditisechterwelverplichtalsdezendervandesoap:faultnietde uiteindelijkebestemmingisvanhetrequest.daarnaastbevateensoap:faultdetail informatie,dieindeheadervanhetberichtopgenomenzijn(denkhierbijaande elementenvanws#addressing). 02#12#1415:37 6

Afbeelding)2)Structuur)Fo01)bericht.) StUFbeschrijftindestandaardookeenlijstmetmogelijketechnischeenfunctionele foutmeldingen.dezelijstisdoordigikoppelingalsbasisgekozenomdestandaard Digikoppelinglijstmettechnischefoutmeldingensamentestellen. StUFmaaktvoorverschillendesoortenberichtuitwisselingen(synchroon, asynchroonentechnischesynchroneresponsbijverzendingvaneenasynchroon bericht)onderscheidinwelkedetailinformatiebijfoutsituatiesgecommuniceerd moetworden.nietelkefoutmeldingbevatdaarmeedezelfdeinformatieinhet onderdeelsoap:faultdetail. 1.4 NENF3610) NEN#3610houdtzichvoorfoutmeldingenaandeinternationalestandaarden. Geonovummaaktgebruikvaneenvalidatieservice(validator)en conformiteitstoetsingomtecontrolerenofdestandaardentechnischcorrectzijn toegepast.defoutmeldingenzijnafgeleidvandeinternationalestandaarden.inde interactiepatronenwordterverwezennaardefoutmeldingen.omdatnen#3610ook gebruikmaaktvanstuf,zaldemethodevanhetmeldenvanfoutmeldingengelijk zijn. 1.5 SuwiML) SuwiMLgeeftindestandaardaan,datvoorhetmeldenvanfoutenookde SOAP:faultgebruiktmoetworden.NetzoalsbijStUFwordtindeSOAP:faultook 02#12#1415:37 7

eendetailmeegeleverd,opbasisvaneeninhetkoppelvlakgedefinieerd Foutmeldingenblok(FWI).FWIstaatvoorfout,waarschuwingeninformatie.Alser eenfoutoptreedtwordthetonderdeelfwialsdetailindesoap:faultopgenomen. ErwordtechtergeeninformatievanuitdehetFWI#deelovergenomeninSOAP:fault elementen.hierwordenmeldingenvanuitdebrokerofvanuitdebronopgenomen. NetzoalsbijStUFwordterdoorSuwiMLgeengebruikgemaaktvan SOAP:faultactorterwijlditwelinbepaaldesituatiesgewenstis. Afbeelding)3)Structuur)FWI)in)bericht.) Indeafbeeldingistezien,datSuwiMLookvoorzietineenterugkoppelingvan fouten,waarschuwingeneninformatie,alserweleenresponsegeleverdwordt#het requestisgoedbevonden.hetgaatdanomeensituatie,daterwelinformatie geleverdwordt.endaterbijdeverwerking/leveringvangegevens/informatieiets nognietgoedisgegaan.oferkanextrainformatiemeegegevenworden.bijsuwiml kunnenookmeerdanéénmeldingvoorkomenvanverschillendebronnen.maardit mogengeenmeldingenzijn,diegecommuniceerdzoudenmoetenwordenineen SOAP:fault.Dezevoorzieningbinnendeberichtdefinitieisgekozen,omdeafnemers zelftekunnenlatenbeoordelen,omeenberichtinzijngeheelofdeelstelaten verwerkenofalsnogaftekeuren. Bijvoorbeeld:(Als(UWV(tijdens(het(samenstellen(van(de(response(delen(van(het(bericht(niet( kan(vullen.(de(arbeidsgegevens(en(uitkeringsgegevens(kunnen(worden(geleverd,(maar(alleen( het(deelsysteem(voor(arbeidsgeschiktheid(heeft(niet(of(niet(op(tijd(kunnen(reageren.(( SuwiMLschrijftindestandaardgeenfoutmeldingenvooraangebruikersvande standaard.maarlevertdemeldingendoorzoalsdoordebronnenaangeleverd worden. 02#12#1415:37 8

Ofeenberichtnusynchroonofasynchroonuitgewisseldwordt,SuwiMLmaaktgeen onderscheidindeinformatiediegecommuniceerdwordtbijfoutsituaties. 1.6 De)belangrijkste)overeenkomsten)zijn:) 1. Allebetrokkenstandaardenzeggendatfoutsituatiesopprotocol#en transportniveaunietgestandaardiseerdhoeventeworden. 2. DeDigikoppeling#standaard gebruikdesoap:faultvoorhetmeldenvan fouten wordendoorallestandaardengebruikt. 3. DetailsvanfoutenwordendoorStUF,NEN#3610enSuwiMLinSOAP:fault detailopgenomen.foutenwordengecommuniceerdindevormtechnische, functionelefoutmeldingen. 4. Detechnischefoutmeldingenwordennietvertaaldnaarvoorgebruikers betekenisvollemeldingen. 1.7 De)verschillen)zijn:) 1. Iedereenheeftzijneigenlijstmetfoutmeldingenmeteigencoderingen.En SuwiMLheeftgeenlijstvanmeldingen.Maarneemtdemeldingenvande bronnen1op1over. 2. Digikoppeling#foutmeldingenzijnnietopgenomenbinnendestandaarden. Digikoppelingheeftdevoordeopgenomenfoutmeldingenalsbasisdelijst vanstufgebruikt. 3. MeldenvanfoutenindebodyvanhetresponseversusEenapartfoutbericht (metnamebijasynchroneuitwisselingenmetstuf. 4. OpverschillendeniveausfoutmeldingenindebodyversusOpéénniveauin debodyvaneenfoutbericht 5. Verschillendetypefoutberichtenvoorverschillendesoortenuitwisselingen (synchroon/asynchroon)versuseéntypeafhandelingongeachtsoort uitwisseling. 6. Stuurgegevenswordennietindemeldingopgenomen(alleenindeheader) versusstuurgegevenswordenindebodyvandemeldingopgenomen. 1.8 Mogelijkheid)tot)harmonisatie) HetmeestopportuneonderdeeltotharmonisatieisdewijzewaaropdeSOAP:faults gevuldwordenbijdeverwerkingvanrequests.zoalsdigikoppelingalheefterkend zulleneropfunctioneelgebiedverschilleninmeldingenzijn.wijzullendie verschillenmoetenaccepteren.maarwatdeoverigestandaardenopzijnminst kunnendoen,zijndetechnischemeldingenstandaardiseren.metalsvertrekpuntde lijstvandigikoppeling.hetgaatdanvoornamelijkoverdeinhoudvanhetsoap faultelementfaultcodeenfaultstring. Ookkunnenafsprakengemaaktwordenoverhetformatvanditelement.Zodatde eigencodesdieaanmeldingentoegekendworden,inheteigendomeinbeheerd kunnenblijven. Defaultcodezoudandevolgendeopbouwkunnenkrijgen: 02#12#1415:37 9

<faultcode>soap#env:<clientofserver>.<beheerder><code>.<omschrijving></faultcode> <faultstring><eigenomschrijvingvandefout></faultstring> Voorbeeld: <faultcode>soap#env:client.dk0004.elementbinnendeberichtbodyisnietconformde XSD</faultcode> <faultstring>berichtbodyisnietconformschemainsectormodel<faultstring> DitvoorbeeldbevatindefaultstringdeeigenomschrijvingvandeStUFcode StUF055. HetelementfaultactorbinnendeSOAP:faultwordtnunietgebruikt.Terwijldittoch eenfunctieheeftbinnenuitwisselingen.hetheeftweldevoorkeuromditeen duidelijkeplektegevenbinnenharmonisatie. Conclusie:) Eenalgeheleenuniformelijstmetallemogelijkfouten,zalerwaarschijnlijknooit komen.maarerkunnenrelatiefgemakkelijkeonderlingeafsprakengemaakt worden,omeenverbeteringdoortevoeren.daarmeezaldeinteroperabiliteitopdit gebiedvergrotentussendestandaarden.defocusligtopgebruikvandesoap# standaardenhergebruik.maarermoetruimteblijvenv.w.b.domein#en standaardspecifiekefoutmeldingen. 02#12#1415:37 10

Mapping'en'harmonisatie'tussen'StUF'en'SuwiML't.o.v.'SOAP'fault'elementen'' StUF! StUF nieuw SOAP fault element SuwiML nieuw "SuwiML nu plek Plek <faultcode> Plek Vanuit service - String (enumeration) (nog verder analyseren) - Verplicht (1..1) code - string lengte 7 omschrijving - string lengte 200 code - string lengte omschrijving - string lengte <faultstring> Code - string lengte Omschrijving - string lengte Code - string lengte Tekst - string lengte Niet gebruikt. Vullen met informatie uit de stuurgevens van het Fobericht. <faultactor> Uit de SuwiML header of Bron FWI. Niet gebruikt. details - string lengte 1000 - optioneel (0..1) details - ANY lengte - optioneel (0.. ) <detail> Details - ANY lengte - optioneel (0.. ) Details - string lengte - optioneel (0.. ) detailsxml vervalt - ANY lengte - optioneel (0.. DezetabelbeschrijftwaardefoutstructurenvanStUFenSuwiMLgeharmoniseerdzijnvoorwatbetreftdeSOAPfault#elementen. Overigenszijnereenpaarelementendieextraaandachtenuitzoekwerkvereisen.Dezetabellaatziendatereenrechtstreeks verbandistussendestructuurvoortechnischefoutmeldingenindesoapfaultendefoutberichtenvanstufenfwisuwimlvoor functionelefoutmeldingen. 02#12#1415:37 11

Bijlage(3:(Over(dit(voorstel(van(het(project( Utrecht ( DitvoorsteliseenproductvanhetprojectUtrecht.Deaanleidingvoorhetproject Utrechtwasdebehoeftevanbasisregistratiesaaneenverzamelingtechnische afsprakendiezijkunnentoepassenbijdeberichtuitwisselingmetalhunafnemers. Dezeverzamelingafsprakenheeftdenaam GemeenschappelijkAfspraken Berichtstandaarden (GAB)gekregen.HetideevandezeGABisdatzowelde basisregistratiesalsdedriesectorstandaardenstuf,suwimlennen3610en,indien vantoepassing,ookdigikoppelingzichaandegabgaanhouden,zodatbinnende Nederlandseoverheidharmonisatievanberichtuitwisselingoptechnischniveau ontstaat. HetProjectUtrechtheeftvijfvoorstellenopgeleverdvoorelementenvandeGAB.De voorstellenzijnopgestelddooreenwerkgroepbestaandeuitvertegenwoordigers vannen3610,stuf,suwiml,digikoppelingeneenaantalbasisregistraties,met ondersteuningvanuithetbureauforumstandaardisatie(bfs)ende stelselarchitectenvanhetinup#programma. Devijfvoorstellenzijneenselectievan laaghangendfruit uiteenlijstmetpotentiële gemeenschappelijkeafspraken.deverwachtingisdatdezevijfvoorstellenrelatief eenvoudigteadopterenzijndoordebasisregistratiesendedriesectorstandaarden. DevoorstellenzijndoordewerkgroepvanhetprojectUtrechtbreeduitgezetter review.dedefinitieveversiesvandevoorstellenwordenaangebodenaande beheerdersvandedriesectorstandaardenenbijdebasisregistratiesmethetverzoek zealswijzigingsverzoekinbehandelingtenemen. DesturingophetprojectUtrechtlagtijdensheti#NUP#programmabijdestuurgroep Digikoppeling,namensdeProgrammaraadStelselvanBasisregistraties(PSB).Voor hetvervolgophetprojectutrechtnai#nupwordteenfederatiefoverlegopgericht waarinnaarverwachtingking,bkwi,geonovum,logiuseneenaantal basisregistratieszittingzullennemen.ditfederatiefoverlegwordtverantwoordelijk voordesturingvanhetvervolgophetprojectutrecht. 02#12#1415:37 12