BBMRI.de/GBA Implementation Guide
1.2.0 - CI Build

BBMRI.de/GBA Implementation Guide - Local Development build (v1.2.0). See the Directory of published versions

Resource Profile: Biobank - Mappings

Active as of 2023-09-01

Mappings for the Biobank resource profile.

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

Biobank
Organization(also see master files messages)
   identifierXON.10 / XON.3
   identifier (Bbmri-EricId)XON.10 / XON.3
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   activeNo equivalent in HL7 v2
   typeNo equivalent in v2
   nameXON.1
   telecomORC-22?
   telecom (url)ORC-22?
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodN/A
   addressORC-23?
      useXAD.7
      typeXAD.18
      textXAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
      lineXAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
      cityXAD.3
      districtXAD.9
      stateXAD.4
      postalCodeXAD.5
      countryXAD.6
      periodXAD.12 / XAD.13 + XAD.14
   partOfNo equivalent in HL7 v2
   contact
      purpose
      namePID-5, PID-9
      telecomPID-13, PID-14
      addressPID-11
   contact (head)
      purpose
         codingC*E.1-8, C*E.10-22
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
         textC*E.9. But note many systems use C*E.2 for this
      namePID-5, PID-9
         useXPN.7, but often indicated by which field contains the name
         textimplied by XPN.11
         familyXPN.1/FN.1
         givenXPN.2 + XPN.3
         prefixXPN.5
         suffixXPN/4
         periodXPN.13 + XPN.14
      telecomPID-13, PID-14
      addressPID-11
   contact (contact)
      purpose
         codingC*E.1-8, C*E.10-22
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
         textC*E.9. But note many systems use C*E.2 for this
      namePID-5, PID-9
         useXPN.7, but often indicated by which field contains the name
         textimplied by XPN.11
         familyXPN.1/FN.1
         givenXPN.2 + XPN.3
         prefixXPN.5
         suffixXPN/4
         periodXPN.13 + XPN.14
      telecomPID-13, PID-14
      telecom (phone)PID-13, PID-14
         systemXTN.3
         valueXTN.1 (or XTN.12)
         useXTN.2 - but often indicated by field
         rankn/a
         periodN/A
      telecom (email)PID-13, PID-14
         systemXTN.3
         valueXTN.1 (or XTN.12)
         useXTN.2 - but often indicated by field
         rankn/a
         periodN/A
      addressPID-11
         useXAD.7
         typeXAD.18
         textXAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
         lineXAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
         cityXAD.3
         districtXAD.9
         stateXAD.4
         postalCodeXAD.5
         countryXAD.6
         periodXAD.12 / XAD.13 + XAD.14

Mappings for RIM Mapping (http://hl7.org/v3)

Biobank
OrganizationEntity. Role, or Act, Organization(classCode=ORG, determinerCode=INST)
   textAct.text?
   containedN/A
   modifierExtensionN/A
   identifier.scopes[Role](classCode=IDENT)
   identifier (Bbmri-EricId).scopes[Role](classCode=IDENT)
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   active.status
   type.code
   name.name
   alias.name
   telecom.telecom
   telecom (url).telecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   address.address
      idn/a
      useunique(./use)
      typeunique(./use)
      text./formatted
      lineAD.part[parttype = AL]
      cityAD.part[parttype = CTY]
      districtAD.part[parttype = CNT | CPA]
      stateAD.part[parttype = STA]
      postalCodeAD.part[parttype = ZIP]
      countryAD.part[parttype = CNT]
      period./usablePeriod[type="IVL<TS>"]
   partOf.playedBy[classCode=Part].scoper
   contact.contactParty
      idn/a
      extensionn/a
      modifierExtensionN/A
      purpose./type
      name./name
      telecom./telecom
      address./addr
   contact (head).contactParty
      idn/a
      modifierExtensionN/A
      purpose./type
         idn/a
         extensionn/a
         codingunion(., ./translation)
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
         text./originalText[mediaType/code="text/plain"]/data
      name./name
         idn/a
         extensionn/a
         useunique(./use)
         text./formatted
         family./part[partType = FAM]
         given./part[partType = GIV]
         prefix./part[partType = PFX]
         suffix./part[partType = SFX]
         period./usablePeriod[type="IVL<TS>"]
      telecom./telecom
      address./addr
   contact (contact).contactParty
      idn/a
      extensionn/a
      modifierExtensionN/A
      purpose./type
         idn/a
         extensionn/a
         codingunion(., ./translation)
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
         text./originalText[mediaType/code="text/plain"]/data
      name./name
         idn/a
         extensionn/a
         useunique(./use)
         text./formatted
         family./part[partType = FAM]
         given./part[partType = GIV]
         prefix./part[partType = PFX]
         suffix./part[partType = SFX]
         period./usablePeriod[type="IVL<TS>"]
      telecom./telecom
      telecom (phone)./telecom
         idn/a
         extensionn/a
         system./scheme
         value./url
         useunique(./use)
         rankn/a
         period./usablePeriod[type="IVL<TS>"]
      telecom (email)./telecom
         idn/a
         extensionn/a
         system./scheme
         value./url
         useunique(./use)
         rankn/a
         period./usablePeriod[type="IVL<TS>"]
      address./addr
         idn/a
         extensionn/a
         useunique(./use)
         typeunique(./use)
         text./formatted
         lineAD.part[parttype = AL]
         cityAD.part[parttype = CTY]
         districtAD.part[parttype = CNT | CPA]
         stateAD.part[parttype = STA]
         postalCodeAD.part[parttype = ZIP]
         countryAD.part[parttype = CNT]
         period./usablePeriod[type="IVL<TS>"]
   endpointn/a

Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)

Biobank
OrganizationOrganization
   identifier./Identifiers
   identifier (Bbmri-EricId)./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   active./Status (however this concept in ServD more covers why the organization is active or not, could be delisted, deregistered, not operational yet) this could alternatively be derived from ./StartDate and ./EndDate and given a context date.
   typen/a
   name.PreferredName/Name
   telecom./ContactPoints
   telecom (url)./ContactPoints
      system./ContactPointType
      value./Value
      use./ContactPointPurpose
      period./StartDate and ./EndDate
   address./PrimaryAddress and ./OtherAddresses
      use./AddressPurpose
      line./StreetAddress (newline delimitted)
      city./Jurisdiction
      state./Region
      postalCode./PostalIdentificationCode
      country./Country
      period./StartDate and ./EndDate
   partOfn/a
   contact
      name
      telecom
      address
   contact (head)
      name
         use./NamePurpose
         family./FamilyName
         given./GivenNames
         prefix./TitleCode
         period./StartDate and ./EndDate
      telecom
      address
   contact (contact)
      name
         use./NamePurpose
         family./FamilyName
         given./GivenNames
         prefix./TitleCode
         period./StartDate and ./EndDate
      telecom
      telecom (phone)
         system./ContactPointType
         value./Value
         use./ContactPointPurpose
         period./StartDate and ./EndDate
      telecom (email)
         system./ContactPointType
         value./Value
         use./ContactPointPurpose
         period./StartDate and ./EndDate
      address
         use./AddressPurpose
         line./StreetAddress (newline delimitted)
         city./Jurisdiction
         state./Region
         postalCode./PostalIdentificationCode
         country./Country
         period./StartDate and ./EndDate

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

Biobank
Organization
   identifierFiveWs.identifier
   identifier (Bbmri-EricId)FiveWs.identifier
   activeFiveWs.status
   typeFiveWs.class