Element tekst:IntRef

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

tekstonderdeel dat verwijst naar een identificeerbaar element dat zich bevindt binnen de tekst van dezelfde expression als de verwijzing.

Bij mutaties hoeft de "tekst binnen dezelfde expression" waarnaar verwezen wordt niet in hetzelfde "document" (XML-instance) gecodeerd te zijn.

Informatie

Het element <tekst:IntRef> mag niet gebruikt worden voor verwijzingen naar tekst buíten de expression. daar is het element tekst:ExtRef voor bedoeld.

De "tekst van de expression" waarnaar verwezen wordt kan in een ander XML-document gecodeerd zijn dan de <tekst:IntRef> zelf. Zeker IntRefs binnen regelingmutaties (zoals artikelwijzigingen) in een besluit verwijzen regelmatig naar andere onderdelen (zoals andere artikelen) binnen dezelfde regelingversie en die niet tegelijkertijd gemuteerd worden .

De leesbare tekst van de verwijzing zoals die wordt getoond aan de eindgebruiker is de inhoud van het <tekst:IntRef>. <tekst:IntRef> gebruikt het attribuut @eId om het doelelement van de verwijzing te identificeren. De reden voor het gebruik van @eId is dat de verwijzingstekst de verwijzing zelf niet mag tegenspreken. Als in de <tekst:IntRef> verwezen wordt naar een stuk tekst op basis van positie (zoals bijvoorbeeld "artikel 5"), dan moet de lezer bij volgen van de @ref door bijvoorbeeld te klikken op een hyperlink altijd bij "artikel 5" uitkomen, ongeacht of er inmiddels de inhoud van het artikel inmiddels is verplaatst naar een nieuwe positie. Dit betekent ook dat bij vernummeringen alle interne verwijzingen naar vernummerde (verplaatste) onderdelen zullen moeten worden aangepast.

Attributen

  • @ref - verplicht - De waarde van het @eId van het doelelement. Zie ook attribuutgroep tekst:agDoelReferentie
  • @scope - optioneel - De naam van het doelelement, in XML-termen de localName zonder namespace of de prefix daarvan. Deze @scope kan door STOP-verwerkende systemen worden gebruikt om een voorspelling te doen over het doelelement zonder de noodzaak voor verwerking van de gehele expression, die over meerdere XML-documenten kan zijn opgeknipt.

Beperkingen

  • De bestemming van de verwijzing wordt aangewezen door middel van zijn eId.
  • De in het attribuut @ref genoemde waarde voor eId moet binnen de tekst van dezelfde expression als de verwijzing aanwezig zijn.
  • @scope moet als waarde de naam (localName) van het doelelement in het STOP-schema bevatten. Omdat de hele expressie altijd in zijn geheel in STOP is gecodeerd, is het niet nodig om de namespace of prefix daarvan te vermelden.

Voorbeeld

<IntRef ref="art_3__para_1" scope="Lid">eerste lid van artikel 3</IntRef>
Informatiemodel
Verwijzingen tekst:ExtIoRef, tekst:ExtRef, tekst:IntIoRef, attribuutgroep tekst:agDoelReferentie
Diagram
Attribuutgroep: tekst:agDoelReferentieAttribuutgroep: tekst:agAlgemeenElement tekst:subElement tekst:supElement tekst:abbrElement tekst:brElement tekst:InlineTekstAfbeeldingElement tekst:ContactElement tekst:VerwijderdeTekstElement tekst:NieuweTekst
Eigenschappen
content: complex
mixed: true
Gebruikt door
Kinderen Element tekst:Contact, Element tekst:InlineTekstAfbeelding, Element tekst:NieuweTekst, Element tekst:VerwijderdeTekst, Element tekst:abbr, Element tekst:br, Element tekst:sub, Element tekst:sup
Attributen
QName Type Use
ref xs:anyURI required
scope Simple Type tekst:dtScope optional
Wildcard: ANY attribute from ANY namespace OTHER than 'https://standaarden.overheid.nl/stop/imop/tekst/'
Beperkingen
STOP0010

De waarde van IntRef/@ref MOET voorkomen als identifier (@eId) van een element binnen:

  1. OFWEL de tekst van dezelfde expression als de IntRef
  2. OFWEL binnen de tekst van hetzelfde component als de IntRef.
STOP0053

De scope van een interne verwijzing moet overeenkomen met de naam van het doelelement.

STOP0919

Het elementen tekst:br MAG NIET binnen de context van tekst:IntRef, tekst:ExtRef en tekst:IntIoRef gebruikt worden omdat deze mogelijkheid in de volgende versie van STOP vervalt.

STOP1071

Een componentverwijzing in akn of join moet beginnen met een '!'.

STOP1072

Het laatste deel van een akn of join voor een optionele componentverwijzing mag geen '!' bevatten.