<
This page is part of the FHIR Specification (v0.5.0: DSTU 2 Ballot 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2
ul class="nav nav-tabs">
Data TypesExamplesDetailed DescriptionsMappings
1.18.3 Data Type Mappings
This page provides mappings for the data types. There are mappings to HL7 v2, v3, and (where appropriate) vCard.
Table of Contents
1.18.3.1 Primitive Types
See also Base Definition, Examples and Detailed Descriptions.
Data Type | V2 | RIM |
base64Binary | ~ED | BIN |
boolean | n/a | BL |
date | DT | TS |
dateTime | DTM | TS |
decimal | ~NM | REAL |
instant | DTM | TS |
integer | ~NM/~SI | INT |
string | ST | ST |
time | TM | n/a |
uri | n/a | URL |
1.18.3.2 Attachment
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.3 Mappings for HL7 v2 (http://hl7.org/v2)
Attachment | ED/RP |
contentType | ED.2+ED.3/RP.2+RP.3. Note conversion may be needed if old style values are being used |
language | |
data | ED.5 |
url | RP.1+RP.2 - if they refer to a URL (see v2.6) |
size | |
hash | |
title | |
creation | |
1.18.3.4 Mappings for RIM (http://hl7.org/v3)
Attachment | ED |
contentType | ./mediaType, ./charset |
language | ./language |
data | ./data |
url | ./reference/literal |
size | N/A (needs data type R3 proposal) |
hash | .integrityCheck[parent::ED/integrityCheckAlgorithm="SHA-1"] |
title | ./title/data |
creation | N/A (needs data type R3 proposal) |
1.18.3.5 Identifier
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.6 Mappings for HL7 v2 (http://hl7.org/v2)
Identifier | CX / EI (occasionally, more often EI maps to a resource id or a URL) |
use | N/A |
type | CX.5 |
system | CX.4 / EI-2-4 |
value | CX.1 / EI.1 |
period | CX.7 + CX.8 |
assigner | CX.4 / (CX.4,CX.9,CX.10) |
1.18.3.7 Mappings for RIM (http://hl7.org/v3)
Identifier | II - see see identifier pattern at http://wiki.hl7.org/index.php?title=Common_Design_Patterns#Identifier_Pattern for relevant discussion. The Identifier class is a little looser than the v3 type II because it allows URIs as well as registered OIDs or GUIDs. Also maps to Role[classCode=IDENT] |
use | Role.code or implied by context |
type | Role.code or implied by context |
system | II.root or Role.id.root |
value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) |
period | Role.effectiveTime or implied by context |
assigner | II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper |
1.18.3.8 Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)
Identifier | Identifier |
use | |
type | |
system | ./IdentifierType |
value | ./Value |
period | ./StartDate and ./EndDate |
assigner | ./IdentifierIssuingAuthority |
1.18.3.9 Coding
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.10 Mappings for HL7 v2 (http://hl7.org/v2)
Coding | CE/CNE/CWE subset one of the sets of component 1-3 or 4-6 |
system | C*E.3 |
version | C*E.7 |
code | C*E.1 |
display | C*E.2 - but note this is not well followed |
primary | Sometimes implied by being first |
1.18.3.11 Mappings for RIM (http://hl7.org/v3)
Coding | CV |
system | ./codeSystem |
version | ./codeSystemVersion |
code | ./code |
display | CV.displayName |
primary | CD.codingRationale |
1.18.3.12 CodeableConcept
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.13 Mappings for HL7 v2 (http://hl7.org/v2)
CodeableConcept | CE/CNE/CWE |
coding | C*E.1-8, C*E.10-22 |
text | C*E.9. But note many systems use C*E.2 for this |
1.18.3.14 Mappings for RIM (http://hl7.org/v3)
CodeableConcept | CD |
coding | union(., ./translation) |
text | ./originalText[mediaType/code="text/plain"]/data |
1.18.3.15 Quantity
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.16 Mappings for HL7 v2 (http://hl7.org/v2)
Quantity | SN (see also Range) or CQ |
value | SN.2 / CQ - N/A |
comparator | SN.1 / CQ.1 |
units | (see OBX.6 etc) / CQ.2 |
system | (see OBX.6 etc) / CQ.2 |
code | (see OBX.6 etc) / CQ.2 |
1.18.3.17 Mappings for RIM (http://hl7.org/v3)
Quantity | PQ, IVL<PQ>, MO, CO, depending on the values |
value | PQ.value, CO.value, MO.value, IVL.high or IVL.low depending on the value |
comparator | IVL properties |
units | PQ.unit |
system | CO.codeSystem, PQ.translation.codeSystem |
code | PQ.code, MO.currency, PQ.translation.code |
1.18.3.18 Range
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.19 Mappings for HL7 v2 (http://hl7.org/v2)
Range | NR and also possibly SN (but see also quantity) |
low | NR.1 |
high | NR.2 |
1.18.3.20 Mappings for RIM (http://hl7.org/v3)
Range | IVL<QTY[not(type="TS")]> [lowClosed="true" and highClosed="true"]or URG<QTY[not(type="TS")]> |
low | ./low |
high | ./high |
1.18.3.21 Ratio
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.22 Mappings for HL7 v2 (http://hl7.org/v2)
Ratio | N/A |
numerator | |
denominator | |
1.18.3.23 Mappings for RIM (http://hl7.org/v3)
Ratio | RTO |
numerator | .numerator |
denominator | .denominator |
1.18.3.24 Period
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.25 Mappings for HL7 v2 (http://hl7.org/v2)
Period | DR |
start | DR.1 |
end | DR.2 |
1.18.3.26 Mappings for RIM (http://hl7.org/v3)
Period | IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"] |
start | ./low |
end | ./high |
1.18.3.27 SampledData
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.28 Mappings for HL7 v2 (http://hl7.org/v2)
SampledData | N/A (but see section 7.14 in v2.7) |
origin | |
period | |
factor | |
lowerLimit | |
upperLimit | |
dimensions | |
data | |
1.18.3.29 Mappings for RIM (http://hl7.org/v3)
SampledData | SLIST + GLIST |
origin | SLIST.origin |
period | GLIST.increment |
factor | SLIST.factor |
lowerLimit | N/A (use SLIST.digits.nullFlavor) |
upperLimit | N/A (use SLIST.digits.nullFlavor) |
dimensions | N/A (fixed to 1) |
data | SLIST.digits |
1.18.3.30 HumanName
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.31 Mappings for HL7 v2 (http://hl7.org/v2)
HumanName | XPN |
use | XPN.7, but often indicated by which field contains the name |
text | implied by XPN.11 |
family | XPN.1 |
given | XPN.2 + XPN.3 |
prefix | XPN.5 |
suffix | XPN/4 |
period | XPN.13 + XPN.14 |
1.18.3.32 Mappings for RIM (http://hl7.org/v3)
HumanName | EN (actually, PN) |
use | unique(./use) |
text | ./formatted |
family | ./part[partType = FAM] |
given | ./part[partType = GIV] |
prefix | ./part[partType = PFX] |
suffix | ./part[partType = SFX] |
period | ./usablePeriod[type="IVL<TS>"] |
1.18.3.33 Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)
HumanName | ProviderName |
use | ./NamePurpose |
text | |
family | ./FamilyName |
given | ./GivenNames |
prefix | ./TitleCode |
suffix | |
period | ./StartDate and ./EndDate |
vCard Mappings
- HumanName.text = vCard "FN" field
- HumanName.use = use of the vCard "TYPE" parameter
- HumanName.family, .given, .prefix, .suffix = parts of vCard "N" field. Note that there is no FHIR equivalent for the poorly defined "additional" name field. In FHIR, given names go in "middle" names
- The vCard nickname corresponds to a name with the use "nickname"
1.18.3.34 Address
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.35 Mappings for HL7 v2 (http://hl7.org/v2)
Address | XAD |
use | XAD.7 |
text | XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6 |
line | XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address) |
city | XAD.3 |
state | XAD.4 |
postalCode | XAD.5 |
country | XAD.6 |
period | XAD.12 / XAD.13 + XAD.14 |
1.18.3.36 Mappings for RIM (http://hl7.org/v3)
Address | AD |
use | unique(./use) |
text | ./formatted |
line | AD.part[parttype = AL] |
city | AD.part[parttype = CTY] |
state | AD.part[parttype = STA] |
postalCode | AD.part[parttype = ZIP] |
country | AD.part[parttype = CNT] |
period | ./usablePeriod[type="IVL<TS>"] |
1.18.3.37 Mappings for vCard (http://w3.org/vcard)
Address | |
use | |
text | |
line | street address |
city | locality |
state | region |
postalCode | postal code |
country | country name |
period | |
1.18.3.38 Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)
Address | Address |
use | ./AddressPurpose |
text | |
line | ./StreetAddress (newline delimitted) |
city | ./Jurisdiction |
state | ./Region |
postalCode | ./PostalIdentificationCode |
country | ./Country |
period | ./StartDate and ./EndDate |
vCard Mappings
- Address.text = vCard "ADDRESS" "LABEL" parameter
- Address.use = vCard "TYPE" parameter
- Address.line = vCard "street" list component
- Address.city = vCard "locality" list component
- Address.state = vCard "region" list component
- Address.zip = vCard "code" list component
- Address.country = vCard "country" list component
1.18.3.39 ContactPoint
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.40 Mappings for HL7 v2 (http://hl7.org/v2)
ContactPoint | XTN |
system | XTN.3 |
value | XTN.1 (or XTN.12) |
use | XTN.2 - but often indicated by field |
period | N/A |
1.18.3.41 Mappings for RIM (http://hl7.org/v3)
ContactPoint | TEL |
system | ./scheme |
value | ./url |
use | unique(./use) |
period | ./useablePeriod[type="IVL<TS>"] |
1.18.3.42 Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)
ContactPoint | ContactPoint |
system | ./ContactPointType |
value | ./Value |
use | ./ContactPointPurpose |
period | ./StartDate and ./EndDate |
1.18.3.43 Timing
See also Base Definition, Examples and Detailed Descriptions.
1.18.3.44 Mappings for HL7 v2 (http://hl7.org/v2)
Timing | N/A |
event | |
repeat | |
bounds | |
count | |
duration | |
durationUnits | |
frequency | |
frequencyMax | |
period | |
periodMax | |
periodUnits | |
when | |
code | |
1.18.3.45 Mappings for RIM (http://hl7.org/v3)
Timing | QSET<TS> (GTS) |
event | QLIST<TS> |
repeat | Implies PIVL or EIVL |
bounds | IVL(TS) used in a QSI |
count | PIVL.count |
duration | PIVL.phase / EIVL.offset |
durationUnits | PIVL.phase.unit |
frequency | PIVL.phase / EIVL.offset |
frequencyMax | PIVL.phase |
period | PIVL.phase |
periodMax | PIVL.phase |
periodUnits | PIVL.phase.unit |
when | EIVL.event |
code | QSC.code |
1.18.3.46 Signature
See also Base Definition, Examples and Detailed Descriptions.