hl7:participant
|
|
0 … * |
|
Contactpersoon van patiënt |
(Con…oon) |
@typeCode
|
cs |
1 … 1 |
F |
IND |
hl7:templateId
|
II |
0 … 1 |
|
Template ID voor de template die de contactpersoon beschrijft |
(Con…oon) |
@root
|
|
1 … 1 |
F |
2.16.840.1.113883.2.4.3.11.60.3.10.35 |
hl7:functionCode
|
CE |
0 … 1 |
|
Bevat de familiaire relatie van de contactpersoon tot de patiënt |
(Con…oon) |
| |
CONF |
|
hl7:associatedEntity
|
|
0 … 1 |
|
|
(Con…oon) |
@classCode
|
cs |
1 … 1 |
F |
CON |
hl7:code
|
CE |
0 … 1 |
|
Bevat de rol van de contactpersoon in relatie tot de patiënt |
(Con…oon) |
| |
CONF |
|
hl7:addr
|
AD.NL |
0 … 1 |
|
Bevat adres |
(Con…oon) |
| Inclusie |
|
|
van 2.16.840.1.113883.2.4.3.11.60.3.10.1.101 address NL - generic (2017‑06‑02)
|
@use
|
set_cs |
1 … 1 |
R |
|
| |
CONF |
|
hl7:streetName
|
ST |
0 … 1 |
R |
Straatnaam. Als het adres een postbusnummer is dan dient hier het woord “Postbus”
te staan. Als het adres een antwoordnummer is, dan dient hier het woord “Antwoordnummer”
te staan.
|
(Con…oon) |
| |
Voorbeeld |
<streetName>Heereweg</streetName> |
hl7:houseNumber
|
ST |
0 … 1 |
R |
Het element houseNumber moet het huisnummer bevatten. Het huisnummer kan niet-numerieke
gedeelten bevatten die het adres mede identificeren, bijv. "23a", maar alleen als
de bron deze niet gescheiden kan aanbieden. Huisletter dient indien mogelijk in het
element buildingNumberSuffix te worden doorgegeven. Gegevens zoals "to" (woonboten)
of "3 hoog achter" maken geen deel uit van dit attribuut. Dit type gegevens is elders
in het Adres datatype opgenomen.
|
(Con…oon) |
| |
Voorbeeld |
<houseNumber>13</houseNumber> |
hl7:buildingNumberSuffix
|
ST |
0 … 1 |
R |
Het element buildingNumberSuffix bevat, indien aanwezig, huisletter en/of huisnummertoevoeging.
Het element houseNumber kan dan alleen het numerieke huisnummer bevatten.
Export
- Als er zowel een huisletter als een huisnummertoevoeging bekend is: de huisletter
komt eerst, dan een spatie en tenslotte de huisnummertoevoeging. Deze samengestelde
waarde wordt doorgegeven in de buildingNumberSuffix.
- Als er alleen een huisnummertoevoeging bekend is, wordt deze in de buildingNumberSuffix
doorgegeven.
- Als er alleen een huisletter bekend is, wordt deze in de buildingNumberSuffix doorgegeven.
Import
- Als de buildingNumberSuffix uit één karakter bestaat, dan wordt de waarde als huisletter
geïmporteerd.
- Als de buildingNumberSuffix uit meer dan één karakter bestaat en het tweede karakter
is geen spatie, dan wordt de waarde als huisnummertoevoeging geïmporteerd.
- Als de buildingNumberSuffix uit meer dan één karakter bestaat en het tweede karakter
is wel een spatie, dan wordt het gedeelte voor de spatie (het eerste karakter) als
huisletter geïmporteerd, en het gedeelte na de spatie (de rest) als huisnummertoevoeging.
|
(Con…oon) |
hl7:additionalLocator
|
ST |
0 … 1 |
R |
Extra informatie zoals naam van het gebouw, gebouwnummer, ingang, routenummer of informatie
over het ligging zoals bijv. 'tegenover', 'bij'. De waarde van @additionalLocator
komt uit AnduidingNummerCodelijst
|
(Con…oon) |
| |
CONF |
| elementinhoud moet "to" zijn |
| -of- |
| elementinhoud moet "by" zijn |
|
hl7:postalCode
|
ADXP |
0 … 1 |
R |
Postcode van het adres. Indien dit een Nederlandse postcode is, dan is het formaat
'nnnn AA' (met spatie). Het is mogelijk om Nederlandse postcodes te coderen volgens
NEN5825 (OID 2.16.840.1.113883.2.4.4.15). Let op dat in dit codestelsel Nederlandse
postcodes zonder spaties worden gehanteerd.
|
(Con…oon) |
@code
|
|
0 … 1 |
|
Gecodeerde postcode. Formaat Nederlandse postcodes volgens NEN5825 is 'nnnnAA' |
@codeSystem
|
|
0 … 1 |
|
Codesysteem voor gecodeerde postcodes. Voor Nederlandse postcodes is dit NEN5825 OID:
2.16.840.1.113883.2.4.4.15
|
hl7:county
|
ADXP |
0 … 1 |
R |
In Nederland wordt dit element gebruikt om de gemeente door te geven (in andere landen
kan een ander type administratieve eenheid binnen een staat/provincie gebruikt worden).
De gemeente kan, maar hoeft niet, overeen te komen met de stad. Sommige gemeenten,
bijvoorbeeld "Waterland", hebben een naam die geheel afwijkt van de steden die erin
gelegen zijn. In het HL7-berichtenverkeer wordt de gemeente in Nederland alleen gebruikt
in het kader van wettelijke identificatie van personen. Het datatype van county is
coded string (SC). Als de gemeente gecodeerd
wordt, dan dient GBA tabel 33 (OID 2.16.840.1.113883.2.4.6.14) gebruikt te worden.
Code 0000 zoals aanwezig in de GBA Tabel 33 mag onder geen enkele omstandigheid voorkomen
in een HL7 versie 3 bericht. Het equivalent van 0000 (onbekende gemeente) in HL7 versie
3 is het niet-opnemen van een code.
|
(Con…oon) |
hl7:city
|
ST |
0 … 1 |
R |
Woonplaats. Bij grotere gemeenten met meer woonkernen kan woonplaats en gemeente van
inschrijving verschillen
|
(Con…oon) |
hl7:country
|
ADXP |
0 … 1 |
R |
Land volgens BRP/GBA tabel 34 Landen (2.16.840.1.113883.2.4.4.16.34) of ISO 3166‐2
alpha (1.0.3166.1.2.2). De landnaam in de text() node is verplicht als het element
country wordt gebruikt, maar coderen van het land is niet verplicht. NB: het Nederlandse datatype AD versie 1 heeft de mogelijkheid om adresdelen te coderen.
|
(Con…oon) |
@code
|
|
0 … 1 |
|
Gecodeerd land. |
@codeSystem
|
|
0 … 1 |
|
Codesysteem voor gecodeerd land. |
| |
Voorbeeld |
BRP/GBA Tabel 34 Landen <country code="6030" codeSystem="2.16.840.1.113883.2.4.4.16.34">Nederland</country> |
| |
Voorbeeld |
ISO 3166-2 alpha <country code="NL" codeSystem="1.0.3166.1.2.2">Nederland</country> |
hl7:unitID
|
ST |
0 … 1 |
|
Een geheel of gedeeltelijke beschrijving van de ligging van een object indien dit
niet kan worden aangegeven met de andere adresaanduidingen. NB: het Nederlandse datatype AD versie 1 heeft ook een element <desc/> wat in aanmerking
zou kunen komen voor dit type informatie, maar gebruik daarvan wordt niet geadviseerd
omdat dit gebruik met CDA zou schaden. In CDA zou het wel als extensie kunnen worden
gebruikt. Het internationale datatype AD voorziet niet in een element dat direct geschikt is voor Locatieomschrijving
zoals hier bedoeld en dit element moet dan ook als een vorm van misbruik van een niet-gebruikt
veld worden gezien.
|
(Con…oon) |
hl7:useablePeriod
|
IVL_TS |
0 … 1 |
|
Het element useablePeriod duidt de periode aan waarin dit adres 'in gebruik'/geldig
is/was. De opties zijn:
- Er is geen useablePeriod element: het betreffende adres is in principe onbeperkt geldig.
- Er is een onder- en een bovengrens: het adres was geldig in de aangeduide periode.
- Er is alleen een ondergrens: het adres is geldig sinds de aangeduide datum.
- Er is alleen een bovengrens: het adres was geldig t/m de aangeduide datum.
|
(Con…oon) |
| |
Constraint |
In elke situatie waar één of meer adressen worden doorgegeven, moet minimaal het adres
worden aangeduid dat op het moment van verzenden geldig/actueel is. Vervallen adressen
kunnen dus alleen worden doorgegeven als het betreffende berichtelement herhalend
is (dus met cardinaliteit > 1). Adressen mogen ook in de toekomst geldig worden of
vervallen als bijvoorbeeld verhuizing reeds bekend is.
|
hl7:telecom
|
TEL.NL.EXTENDED |
|
|
Bevat telefoonnummer |
(Con…oon) |
 |
|
waar [starts-with(@value,'tel:')] |
|
|
| Inclusie |
|
|
van 2.16.840.1.113883.2.4.3.11.60.3.10.1.103 phone number - generic (2017‑06‑02)
|
@use
|
set_cs |
0 … 1 |
|
|
| |
CONF |
|
@value
|
url |
1 … 1 |
R |
Telefoonnummers bestaan uit een uri beginnend met tel:. Let op: een uri bevat bijvoorbeeld
geen spaties.
|
hl7:telecom
|
TEL.NL.EXTENDED |
|
|
Bevat e-mailadres |
(Con…oon) |
|
|
waar [starts-with(@value,'mailto:')] |
|
|
| Inclusie |
|
|
van 2.16.840.1.113883.2.4.3.11.60.3.10.1.104 email address - generic (2017‑06‑02)
|
@use
|
set_cs |
0 … 1 |
|
|
| |
CONF |
|
@value
|
url |
1 … 1 |
R |
E-mailadressen bestaan uit een uri beginnend met mailto:. Let op: een uri bevat bijvoorbeeld
geen spaties.
|
hl7:associatedPerson
|
|
0 … 1 |
|
|
(Con…oon) |
hl7:person
|
|
0 … 1 |
|
|
(Con…oon) |
hl7:name
|
|
0 … 1 |
|
Bevat naamgegevens van contactpersoon |
(Con…oon) |
@classCode
|
|
0 … 1 |
F |
PSN |
| Inclusie |
|
|
van 2.16.840.1.113883.2.4.3.11.60.3.10.1.100 name person NL - generic (2017‑06‑02)
|
@use
|
set_cs |
0 … 1 |
|
In principe kan van elke Person Name worden aangegeven in welke situatie deze gebruikt
kan worden. Voor Nederland is besloten dat de volgende naamgebruikstypen voor kunnen
komen:
- L - Reguliere naam. De naam zoals die door de persoon (entiteit) gevoerd wordt. De
afkorting 'L' stond oorspronkelijk voor Legal (wettelijk), maar feit is dat hier ook
componenten in voor mogen komen (zoals een roepnaam), die niet wettelijk zijn vastgelegd.
Dit naamgebruikstype is het standaardtype als geen type wordt doorgegeven.
- A - Pseudoniem. Een artiestennaam, 'schuilnaam' of tijdelijke naam voor een persoon
(entiteit). Deze wijkt dus af van de regulier gevoerde naam en wordt bijvoorbeeld
gebruikt om iemands identiteit te verbergen (in verband met privacy) of als tijdelijke
naam wanneer de echte niet bekend is ('John Doe').
- OR - Wettelijk geregistreerde naam. De naam met de exacte componenten zoals deze voorkomen
in het bevolkingsregister van het betreffende land. Voor Nederland is dit het GBA
register of ARNI voor niet-ingezetenen. Dit is de naam zoals die wordt geretourneerd
indien een BSN met succes wordt geverifieerd.
|
| |
CONF |
| @use moet "L" zijn |
| of |
| @use moet "A" zijn |
| of |
| @use moet "OR" zijn |
|
| Keuze |
0 … |
|
Minimaal één van de elementen voornaam, roepnaam of initialen en minimaal een geslachtsnaam
of geslachtsnaam partner, eventueel met voorvoegsels moet aanwezig zijn.
Elementen om uit te kiezen:
- hl7:given[@qualifier='BR']
- hl7:given[@qualifier='CL']
- hl7:given[@qualifier='IN']
- hl7:given[not(@qualifier)]
- hl7:prefix[not(@qualifier)]
- hl7:family[not(@qualifier)]
- hl7:prefix[tokenize(@qualifier,'\s')='VV'][following-sibling::hl7:family[1][@qualifier='BR']]
- hl7:family[@qualifier='BR']
- hl7:delimiter
- hl7:prefix[tokenize(@qualifier,'\s')='VV'][following-sibling::hl7:family[1][@qualifier='SP']]
- hl7:family[@qualifier='SP']
- hl7:suffix
|
hl7:given
|
ENXP |
… 1 |
|
Bevat de voornamen van een persoon. Het qualifier type 'BR' duidt een officiële voornaam
aan
|
(Con…oon) |
|
|
|
@qualifier
|
set_cs |
1 … 1 |
F |
BR |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<given qualifier="BR">Maria</given> |
hl7:given
|
ENXP |
… 1 |
|
Bevat de roepnaam van een persoon. Het qualifier type 'CL' duidt een roepnaam aan |
(Con…oon) |
|
|
|
@qualifier
|
set_cs |
1 … 1 |
F |
CL |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<given qualifier="CL">Ria</given> |
hl7:given
|
ENXP |
… 1 |
|
Bevat de voorletters van een persoon. Een afsluitende punt moet expliciet worden vermeld.
@qualifier heeft de waarde "IN" voor de initialen
|
(Con…oon) |
|
|
|
@qualifier
|
set_cs |
1 … 1 |
F |
IN |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<given qualifier="IN">M.</given> |
hl7:given
|
ENXP |
… 1 |
|
Voornaamdeel van ongedefinieerd type. Bij voorkeur alleen met type gebruiken. |
(Con…oon) |
|
|
|
hl7:prefix
|
ENXP |
… 1 |
|
Prefixdeel van ongedefinieerd type. Bij voorkeur alleen met type gebruiken. |
(Con…oon) |
|
|
|
hl7:family
|
ENXP |
… 1 |
|
Achternaamdeel van ongedefinieerd type. Bij voorkeur alleen met type gebruiken. |
(Con…oon) |
|
|
|
hl7:prefix
|
ENXP |
… 1 |
C |
Bevat voorvoegsels van de geslachtsnaam en moet direct voorafgaand aan de geslachtsnaam
in family staan
|
(Con…oon) |
|
|
|
|
|
|
waar [tokenize(@qualifier,'\s')='VV'] [following-sibling::hl7:family [1] [@qualifier='BR']] |
|
|
@qualifier
|
set_cs |
1 … 1 |
F |
VV |
| |
Merk op dat @qualifier="VV BR" ook is toegestaan. |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<prefix qualifier="VV">van der </prefix> |
hl7:family
|
ENXP |
… 1 |
C |
Bevat de geslachtsnaam van een persoon. Het qualifier type 'BR' duidt een geslachtsnaam
aan
|
(Con…oon) |
|
|
|
@qualifier
|
cs |
1 … 1 |
F |
BR |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<family qualifier="BR">Lelie</family> |
hl7:delimiter
|
ENXP |
|
|
Een delimiter heeft geen speciale betekenis als onderdeel van een Person Name, anders
dan het doorgeven van een (stukje) letterlijke tekst dat in de geschreven naam voorkomt.
Een delimiter moet altijd op de plaats in de Person Name staan waar de tekst ook geschreven
zou worden. Er zijn geen impliciete spaties, dus als er normaal gesproken een spatie
voor of achter geschreven wordt, dan moet deze expliciet worden meegegeven. Voorbeelden
van delimiters zijn:
- Het streepje '-' tussen de eigen achternaam en de partnernaam (of andersom).
- De komma plus spatie ', ' die tussen de naam en bepaalde achtervoegsels komt.
- De tekst ', geb. ' of ', e.v. ' die soms gebruikt wordt bij eigen- respectievelijk
partnernaam.
Merk op: de spatie tussen een voorvoegsel en de achternaam is geen delimiter, het
behoort bij het voorvoegsel. Dit geldt tevens voor andere scheidingstekens behorende
bij een voorvoegsel zoals in de naam "D'Artagnan".
|
(Con…oon) |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
hl7:prefix
|
ENXP |
… 1 |
|
Bevat voorvoegsels van de geslachtsnaam van partner en moet direct voorafgaand aan
de geslachtsnaam partner in family staan
|
(Con…oon) |
|
|
|
|
|
|
waar [tokenize(@qualifier,'\s')='VV'] [following-sibling::hl7:family [1] [@qualifier='SP']] |
|
|
@qualifier
|
set_cs |
1 … 1 |
F |
VV |
| |
Merk op dat @qualifier="VV SP" ook is toegestaan. |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<prefix qualifier="VV">van </prefix> |
hl7:family
|
ENXP |
… 1 |
|
Bevat de geslachtsnaam partner van een persoon. Het qualifier type 'SP' duidt een
geslachtsnaam partner aan
|
(Con…oon) |
|
|
|
@qualifier
|
cs |
1 … 1 |
F |
SP |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
| |
Voorbeeld |
<family qualifier="SP">Putten</family> |
hl7:suffix
|
ENXP |
|
|
Een suffix heeft betrekking op een deel van de naam dat hoort bij één of meer andere
naamdelen en daar achter wordt geschreven. In Nederland zijn als achtervoegsel alleen
academische titels toegestaan. Enkele regels voor person name parts van type suffix:
- Een suffix moet altijd direct achter de naamdelen worden geplaatst waar het betrekking
op heeft (d.w.z. waar het normaal gesproken wordt geschreven).
- Er is geen impliciete spatie als tussenruimte met het eraan voorafgaande name part,
d.w.z. een spatie voor het achtervoegsel moet expliciet worden vermeld!
- De aard van het achtervoegsel kan verder worden aangeduid door het optionele attribuut
qualifier te gebruiken.
Een person name part van type suffix dat zonder qualifier wordt gebruikt, moet worden
beschouwd als een niet nader bepaald achtervoegsel. Ook het gebruik van (vaak Amerikaanse)
termen als ' Jr.', ' Sr.' of ' III' valt in deze categorie.
Er is geen regel voor het aantal achtervoegsels dat wordt gecombineerd in één element.
D.w.z. dat " MSc" en " MD" apart kunnen worden doorgegeven, maar ook gecombineerd
als " MSc MD".
|
(Con…oon) |
@qualifier
|
cs |
0 … 1 |
F |
AC |
@nullFlavor
|
|
0 |
NP |
NP/niet aanwezig |
hl7:validTime
|
IVL_TS |
0 … 1 |
|
Dit is een optioneel XML-element binnen de Person Name en duidt de periode aan waarin
deze naam 'in gebruik'/geldig was voor de betreffende persoon. De opties zijn:
- Er is geen validTime element: de betreffende naam is in principe onbeperkt geldig.
- Er is een onder- en een bovengrens: de naam was geldig in de aangeduide periode.
- Er is alleen een ondergrens: de naam is geldig sinds de aangeduide datum.
- Er is alleen een bovengrens: de naam was geldig t/m de aangeduide datum.
Dit element van Person Name kan worden gebruikt om aan te geven dat een persoon gedurende
diens leven één of meer keer van naam veranderd is. Dit gebeurt o.a. bij:
- Adoptie van een baby, waarbij het de achternaam van de adoptieouders verkrijgt.
- Huwelijk, waarbij de partnernaam kan worden toegevoegd aan de eigen naam.
- Scheiding, waarbij een eerder aangenomen partnernaam juist weer vervalt.
- Personen die om andere redenen hun voor- of achternaam veranderen.
Merk op dat veel patiëntregistratiesystemen niet echt een historie (met ingangsdatum)
bijhouden van de patiëntnaam. Wel wordt vaak een 'audit trail' (wijzigingshistorie)
van de patiëntgegevens in het algemeen bijgehouden. Indien gewenst zou daaruit een
historie van de persoonsnaam kunnen worden afgeleid, hoewel het natuurlijk ook mogelijk
is om alleen de actuele naam door te geven (en dus geen validTime te gebruiken).
|
(Con…oon) |
| |
Constraint |
In elke situatie waar één of meer persoonsnamen worden doorgegeven, moet minimaal
de naam worden aangeduid die op het moment van verzenden geldig/actueel is. Vervallen
namen kunnen dus alleen worden doorgegeven als het betreffende berichtelement herhalend
is (dus met cardinaliteit > 1). In tegenstelling tot de situatie bij organisatienamen
is het bij persoonsnamen niet toegestaan dat de ondergrens of de bovengrens van een
validTime in de toekomst ligt. Er kan dus geen 'geplande' nieuwe naam of het 'gepland
vervallen' van de huidige naam worden
doorgegeven voor persoonsnamen.
|
| |
Schematron assert |
role |
 error
|
|
| |
test |
not(*) or (hl7:given and hl7:family) |
|
| |
Melding |
In een gestructureerde naam moet minimaal één voornaam, initiaal of roepnaam en minimaal
één geslachtsnaam of geslachtsnaam partner van een persoon aanwezig zijn, inclusief
voorvoegsel(s) indien van toepassing |
|
Template Contactpersoon
Ontwerp
address NL - generic