Protocolbindingen voor StUF

Dit is een statische kopie van het eerdere discussie.kinggemeenten.nl.
Nieuwe discussies kunnen in de GitHub repository 'StUF standaarden' als issue worden opgevoerd.

2 reacties / 0 nieuw
Jan Campschroer
Protocolbindingen voor StUF

Twee opmerkingen:

1, op de vierde regel in de 2de paragraaf op pag 6 is er iets weggevallen.

De StUF-standaard schrijft in verband met Quality of Service voor, dat op een asynchrone notificatie en op een asynchroon verzoek of een asynchrone respons wordt in geval van fouten wordt gereageerd met een ????? of een Fo03-foutbericht.

2. Qua format zou ik aanbevelen om elke regel waar een binding aan moet voldoen expliciet (a) een nummer mee te geven (b) indien bekend: een rationale dan wel ontwerpbeslissing. Het is in de huidige tekst erg zoeken naar de regels. Bovenstaande tekst zou ik dan ook opnemen als:

Regel NNN - Op een asynchrone notificatie, een asynchroon verzoek of een asynchrone respons wordt in geval van fouten gereageerd met een Fo03-foutbericht.
Ratonale NNN - In verband met de Quality of Service .....

Wat mij betreft kunnen de rationales/ontwerpbeslissingen (zoals ook in het voorbeeld) wel enige aanvulling gebruiken.

Anoniem

Bedankt voor de 'close reading'.

1) De regel is waarschijnlijk door copy-en-paste handelingen beschadigd geraakt. Volgens mij zijn er geen andere niet-functionele foutberichten dan Fo03. Dus er is in feite niets weggevallen, het lijkt alleen zo.  Ik zal de tekst aanpassen met de volgende formulering:

De StUF-standaard schrijft in verband met 'Quality of Service' voor dat zowel op een asynchrone notificatie als op een asynchroon verzoek als op een asynchrone respons wordt gereageerd met een Fo03-bericht in geval van fouten.

2) Als de tijd het toelaat zullen we bekijken of we het 'format' van de specificatie kunnen verbeteren qua leesbaarheid. Maar we moeten eerst checken of de spec's qua functionaliteit kloppen. Dat heeft nu nog even de meeste prio.