Attribuutgroep: tekst:agAKN

Namespace https://standaarden.overheid.nl/stop/imop/tekst/
Definitie
Informatie

Beschrijving

De attribuutgroep agAKN bestaat uit de attributen @eId en @wId. Deze attributen zijn ontleend aan de Akoma Ntoso naamgevingsconventie.

@eId is binnen een component van een expressie van de tekstmodule uniek en is afgeleid van de positie van het element binnen de tekst van de component. Een @eId wijzigt als een element een andere plaats in een expressie krijgt of vernummerd wordt. De algemene vorm is: @eId = ([prefix]__) [element_ref](_[nummer])

Hierbij geldt:

[prefix]: de prefix bevat de eId van het hoger liggende XML element in de tekststructuur. Als het hoger liggende XML element het <tekst:Lichaam> is, dan wordt de prefix met de daarop volgende dubbele underscore (__) weggelaten.
[element-ref]: de element-ref bevat de afkorting van de naam van het xml-element volgens de bijgaande lijst.
[nummer]: zie onder de tabel voor een uitleg over het nummer.
Uitleg nummer:
  • voor een uniek element wordt [nummer] en de voorafgaande underscore (_) weggelaten
  • voor een expliciet genummerd element wordt het nummer van het element als volgt overgenomen:
    • Spaties in het nummer worden weggelaten.
    • Cijfers, letters, "-" en "." worden overgenomen.
    • Andere tekens worden vervangen door ".".
    • Mocht de voorgaande voorschriften leiden tot 1 of meerdere punten aan het eind van de eId dan worden deze weggelaten.
    • Mochten de voorgaande voorschriften niet leiden tot een unieken eId, dan wordt aan de eId toegevoegd _inst[volgnummer], waarbij volgnummer begint bij 2.
  • voor een element dat niet expliciet genummerd is, wordt het nummer: o_[volgnummer], waarbij volgnummer begint bij 1.

Lijst met elementnamen en de te gebruiken afkorting in [element-ref]

Aanhef formula_1
Afdeling subchp
AlgemeneToelichting genrecital
Artikel art
ArtikelgewijzeToelichting artrecital
Begrip item
Begrippenlijst list
Bijlage cmp
Boek book
Citaat cit
Deel part
Divisie div
Deel part
ExtIoRef ref
Figuur img
FormeleDivisie fdvs
FormeleInhoud fcontent
Hoofdstuk chp
Inhoudsopgave toc
IntIoRef ref
Li item
Lichaam body
Lid para
Lijst list
Motivering acc
Nawerk app
RegelingOpschrift longTitle
Paragraaf subsec
Sluiting formula_2
Subparagraaf subsec
Subsubparagraaf subsec
table table
Titel title
Toelichting recital
WijzigArtikel art
Wijzigbijlage cmp

@wId is binnen een component van de expressie van een tekstmodule uniek en wijzigt niet als een element een andere plaats in de tekst van de component van een expressie krijgt. De wId kan hiermee gebruikt worden om wijzigingen op een element over expressies heen te volgen. De algemene vorm: @wId = [bevoegd gezag]_[versienummer]__[eId]

Hierbij geldt:

[bevoegd gezag]: De identificatie van het bevoegd gezag dat het tekstelement introduceert. Dit is dezelfde identificatie voor overheden als ook in de naamgeving van documenten gebruikt wordt.
[versienummer]:

Een door het bevoegd gezag aan de regelingversie toegekend versienummer, waar het element voor het eerst in verschijnt. Zie begrip versienummer voor een toelichting. Als dit versienummer gebruikt wordt en het komt terug in de expression identificatie van de regelingversie, dan moet het versienummer in de @wId gelijk zijn aan dat in de expression identificatie.

Een alternatief voor versienummer is een compacte weergave van de datum waarop de versie is ontstaan, bijvoorbeeld '2018-11-29'

[eId]: Het eId van het element in de versie van de tekst waar het element voor het eerst in verschijnt.
Voor de volgende elementen geldt bovenstaande recept niet, maar geldt dat wId=eId:
  • Aanhef
  • Inhoudsopgave
  • Lichaam
  • Nawerk
  • RegelingOpschrift
  • Sluiting

Indien een leverancier moeite heeft met het traceren van de inhoud van tekstfragmenten (d.w.z. elementen binnen een artikel of lid) via wId, dan mag de wId van het element voor iedere versie van het omgevingsdocument opnieuw gegenereerd worden.

Attributen
  • @eId - verplicht - Type: xs:NMTOKEN
  • @wId - verplicht - Type: xs:NMTOKEN

Beperkingen

Zowel de @eId als de @wId zijn uniek binnen de component van de expressie van de tekstmodule.

Voorbeelden eId/wId:

Artikel 1 in lichaam van de regeling, introductie door bevoegd gezag gm0503 in versie v0.1 eId = art_1, wId = gm0503_v0-1__art_1
Een tweede artikel 1 in lichaam van dezelfde regeling, introductie door bevoegd gezag pv28 in versie v1.6 eId = art_1_inst2, wId = pv28_v1-6__art_1_inst2. NB: de eId van het eerste artikel 1 in de regeling blijft eId = art_1
Vernummering van het tweede artikel 1 naar 1a in versie v1.7 eId = art_1a, wId blijft wId = pv28_v1-6__art_1_inst2
Een artikel 10:2 in hoofdstuk 10 van een regeling, introductie door bevoegd gezag mn002 in versie 2018-25-10 eId = chp_10__art_10.2, wId = mn002_2018-25-10__chp_10__art_10.2
Lid 1. in voorgaand artikel 10:2 eId = chp_10__art_10.2__para_1, wId = mn002_2018-25-10__chp_10__art_10.2__para_1
Na tussenvoegen van een paragraaf 10.1 voor artikel 10:2 eId van artikel 10:2: eId = chp_10__subsec_10-1__art_10.2, de wId van het artikel blijft wId = mn002_2018-25-10__chp_10__art_10.2__para_1
Aanhef eId = formula_o_1 en wId = formula_o_1
Informatiemodel
Verwijzingen data:eId, attribuutgroep tekst:agComponent, attribuutgroep tekst:agNieuwComponent
Diagram

Gebruikt door
Attributen
QName Type Use
eId xs:NMTOKEN required
wId xs:NMTOKEN required