Regels en structuur voor elementen binnen aanvullendeElementen

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

4 reacties / 0 nieuw
Frank Samwel
Regels en structuur voor elementen binnen aanvullendeElementen

In de StUF0302 specificaties staat:

De standaard eist dat de gebruikelijke StUF-berichtstructuur doorloopt binnen StUF:aanvullendeElementen. Voor elementen binnen stuf:aanvullendeElementen/ae:bankgegevens gelden dezelfde regels als de andere elementen van de StUF-entiteit waarbinnen het element <StUF:aanvullendeElementen> voorkomt. Het komt erop neer dat de tags <StUF:aanvullendeElementen>, <ae:bankgegevens>, </ae:bankgegevens>, <ae:mijnLocatie>, </ae:mijnLocatie> en </StUF:aanvullendeElementen> weggedacht kunnen worden en dat er dan een gewone StUF-entiteit overblijft met alle regels die daarvoor gelden.

Had hier niet moeten staan "De standaard eist dat de gebruikelijke StUF-berichtstructuur doorloopt buiten StUF:aanvullendeElementen."?

Wat wordt bedoeld met "Voor elementen binnen stuf:aanvullendeElementen/ae:bankgegevens gelden dezelfde regels als de andere elementen van de StUF-entiteit"? Op welke regels wordt hier gedoeld? 

Robert Melskens

Frank,

Wat hier wordt bedoeld, tenminste zo heb ik het altijd geïnterpreteerd, is dat de gebruikelijke StUF-berichtstructuur doorloopt in de elementcontent van 'StUF:aanvullendeElementen/*'.

Wat de regels betreft gedlt dat de evt. binnen 'StUF:aanvullendeElementen/*' opgenomen entiteiten eenzelfde structuur moeten hebben als entiteiten in het koppelvlakschema. Dus kunnen ze relaties bevatten en bevatten deze relatie 'gerelateerde' elementen. Daarnaast bevatten alle entiteiten, relaties en 'gerelateerde' elementen de voor StUF geëigende xml attributes. Ook moeten elementen op de laagste niveau's zonodig ook een 'noValue' of 'wildcard' attributes kunnen bevatten.

Frank Samwel

Robert,

Jouw interpretatie van deze tekst begrijp ik wel lezende regel 2 van deze alinea: " Voor elementen binnen stuf:aanvullendeElementen/ae:bankgegevens gelden dezelfde regels als de andere elementen van de StUF-entiteit waarbinnen het element <StUF:aanvullendeElementen> voorkomt."

Maar ik begrijp deze niet lezende de laatste zin ervan: "Het komt erop neer dat de tags <StUF:aanvullendeElementen>, <ae:bankgegevens>, </ae:bankgegevens>, <ae:mijnLocatie>, </ae:mijnLocatie> en </StUF:aanvullendeElementen> weggedacht kunnen worden en dat er dan een gewone StUF-entiteit overblijft met alle regels die daarvoor gelden."

Wellicht staan er twee verschillende StUF eisen in één alinea?

  1. Eisen aan de bericht-, entiteit- en elementstructuur van de StUF standaard gelden ook voor elementen opgenomen in aanvullendeElementen.
  2. Het opnemen van aanvullendeElementen in een StUF-entiteit mag (afgezien van deze aanvullendeElementen) mag deze StUF-entiteit, de structuur daarvan en regels die ervoor gelden niet wijzigen.
Robert Melskens

Frank,

Ik begrijp niet wat je bij bullet 2 wil zeggen.

Maar misschien kan ik het beter illustreren met een voorbeeld. Stel ik heb de volgende structuur:

<bg:persoon bg:entiteittype="NPS" ...>
    <bg:inp.bsn>123456789</bg:inp.bsn>
    <bg:geslachtsnaam>Korver</bg:geslachtsnaam>
    <bg:voornamen>Henri Peter</bg:voornamen>
    <StUF:aanvullendeElementen>
        <ae:bankgegevens xmlns:ae="http://www.egem.nl/StUF/sector/bg/0310/aanvullendeElementen">
            <ae:bic>INGBNL2A</ae:bic>
            <ae:iban>NL06INGB0006053682</ae:iban>
        </ae:bankgegevens>
        <ae:mijnVervoer xmlns:ae="http://www.egem.nl/StUF/sector/bg/0310/aanvullendeElementen">
            <ae:heeftVoertuig ae:entiteittype="NPSVRT">
                <ae:gerelateerde ae:entiteittype="VRT">
                    <ae:fiets ae:entiteittype="FTS">
                        <ae:framenummer>XXXXXXXXXXXXXX</ae:framenummer>
                        <ae:kleur>groen</ae:kleur>
                        <ae:chip noValue="waardeOnbekend"/>
                    </ae:fiets>
                </ae:gerelateerde>
            </ae:heeftVoertuig>
        <ae:mijnVervoer>
    </StUF:aanvullendeElementen>
</bg:persoon>

Dan blijft er door het weglaten van <StUF:aanvullendeElementen>, <ae:bankgegevens>, </ae:bankgegevens>, <ae:mijnVervoer>, </ae:mijnVervoer> en </StUF:aanvullendeElementen> de volgende normale StUF structuur over:

<bg:persoon bg:entiteittype="NPS" ...>
    <bg:inp.bsn>123456789</bg:inp.bsn>
    <bg:geslachtsnaam>Korver</bg:geslachtsnaam>
    <bg:voornamen>Henri Peter</bg:voornamen>
    <ae:bic>INGBNL2A</ae:bic>
    <ae:iban>NL06INGB0006053682</ae:iban>
    <ae:heeftVoertuig ae:entiteittype="NPSVRT">
        <ae:gerelateerde ae:entiteittype="VRT">
            <ae:fiets ae:entiteittype="FTS">
                <ae:framenummer>XXXXXXXXXXXXXX</ae:framenummer>
                <ae:kleur>groen</ae:kleur>
                <ae:chip noValue="waardeOnbekend"/>
            </ae:fiets>
        </ae:gerelateerde>
    </ae:heeftVoertuig>
</bg:persoon>