NGS IG
0.1.0 - ci-build

NGS IG - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: OrganizationGeneTWNGS - Mappings

Draft as of 2025-01-13

Mappings for the Organization-gene-twngs resource profile.

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

OrganizationGeneTWNGS
Organization(also see master files messages)
   identifierCX / EI (occasionally, more often EI maps to a resource id or a URL), XON.10 / XON.3
      useN/A
      typeCE/CNE/CWE, CX.5
         codingCE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodDR, CX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   activeNo equivalent in HL7 v2
   typeCE/CNE/CWE, No equivalent in v2
      codingCE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
   nameXON.1
   telecomXTN, ORC-22?
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodDR, N/A
   addressXAD, ORC-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
         extension
         extension (PostalCode)
            value[x]CE/CNE/CWE
               codingCE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
               coding (PostalCode3)CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
               coding (PostalCode5)CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
               coding (PostalCode6)CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
      countryXAD.6
      periodDR, XAD.12 / XAD.13 + XAD.14
   partOfNo equivalent in HL7 v2
   contact
      purposeCE/CNE/CWE
         codingCE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
      nameXPN, PID-5, PID-9
      telecomXTN, PID-13, PID-14
      addressXAD, PID-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
            extension
            extension (PostalCode)
               value[x]CE/CNE/CWE
                  codingCE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
                  coding (PostalCode3)CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
                  coding (PostalCode5)CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
                  coding (PostalCode6)CE/CNE/CWE subset one of the sets of component 1-3 or 4-6, C*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
         countryXAD.6
         periodDR, XAD.12 / XAD.13 + XAD.14

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

OrganizationGeneTWNGS
OrganizationEntity. Role, or Act, Organization(classCode=ORG, determinerCode=INST)
   metan/a, N/A
   implicitRulesn/a
   languagen/a
   textn/a, N/A, Act.text?
   containedEntity. Role, or Act, N/A
   extensionn/a, N/A
   modifierExtensionn/a, N/A
   identifiern/a, II - 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], .scopes[Role](classCode=IDENT)
      idn/a
      extensionn/a, N/A
      usen/a, Role.code or implied by context
      typen/a, CD, Role.code or implied by context
         idn/a
         extensionn/a, N/A
         codingn/a, CV, union(., ./translation)
            idn/a
            extensionn/a, N/A
            systemn/a, ./codeSystem
            versionn/a, ./codeSystemVersion
            coden/a, ./code
            displayn/a, CV.displayName
            userSelectedn/a, CD.codingRationale
         textn/a, ./originalText[mediaType/code="text/plain"]/data
      systemn/a, II.root or Role.id.root
      valuen/a, II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodn/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], Role.effectiveTime or implied by context
      assignern/a, The target of a resource reference is a RIM entry point (Act, Role, or Entity), II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   activen/a, .status
   typen/a, CD, .code
      idn/a
      extensionn/a, N/A
      codingn/a, CV, union(., ./translation)
         idn/a
         extensionn/a, N/A
         systemn/a, ./codeSystem
         versionn/a, ./codeSystemVersion
         coden/a, ./code
         displayn/a, CV.displayName
         userSelectedn/a, CD.codingRationale
      textn/a, ./originalText[mediaType/code="text/plain"]/data
   namen/a, .name
   aliasn/a, .name
   telecomn/a, TEL, .telecom
      idn/a
      extensionn/a, N/A
      systemn/a, ./scheme
      valuen/a, ./url
      usen/a, unique(./use)
      rankn/a
      periodn/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], ./usablePeriod[type="IVL<TS>"]
   addressn/a, AD, .address
      idn/a
      extensionn/a, N/A
      extension (room)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (floor)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (number)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (alley)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (lane)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (section)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (neighborhood)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      extension (village)n/a, N/A
         idn/a
         urlN/A
         value[x]n/a, N/A
      usen/a, unique(./use)
      typen/a, unique(./use)
      textn/a, ./formatted
      linen/a, AD.part[parttype = AL]
      cityn/a, AD.part[parttype = CTY]
      districtn/a, AD.part[parttype = CNT | CPA]
      staten/a, AD.part[parttype = STA]
      postalCoden/a, AD.part[parttype = ZIP]
         idn/a
         extensionn/a, N/A
         extension (PostalCode)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A, CD
               idn/a
               extensionn/a, N/A
               codingn/a, CV, union(., ./translation)
                  idn/a
                  extensionn/a, N/A
                  systemn/a, ./codeSystem
                  versionn/a, ./codeSystemVersion
                  coden/a, ./code
                  displayn/a, CV.displayName
                  userSelectedn/a, CD.codingRationale
               coding (PostalCode3)n/a, CV, union(., ./translation)
                  idn/a
                  extensionn/a, N/A
                  systemn/a, ./codeSystem
                  versionn/a, ./codeSystemVersion
                  coden/a, ./code
                  displayn/a, CV.displayName
                  userSelectedn/a, CD.codingRationale
               coding (PostalCode5)n/a, CV, union(., ./translation)
                  idn/a
                  extensionn/a, N/A
                  systemn/a, ./codeSystem
                  versionn/a, ./codeSystemVersion
                  coden/a, ./code
                  displayn/a, CV.displayName
                  userSelectedn/a, CD.codingRationale
               coding (PostalCode6)n/a, CV, union(., ./translation)
                  idn/a
                  extensionn/a, N/A
                  systemn/a, ./codeSystem
                  versionn/a, ./codeSystemVersion
                  coden/a, ./code
                  displayn/a, CV.displayName
                  userSelectedn/a, CD.codingRationale
               textn/a, ./originalText[mediaType/code="text/plain"]/data
      countryn/a, AD.part[parttype = CNT]
      periodn/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], ./usablePeriod[type="IVL<TS>"]
   partOfn/a, The target of a resource reference is a RIM entry point (Act, Role, or Entity), .playedBy[classCode=Part].scoper
   contactn/a, .contactParty
      idn/a
      extensionn/a, N/A
      modifierExtensionn/a, N/A
      purposen/a, CD, ./type
         idn/a
         extensionn/a, N/A
         codingn/a, CV, union(., ./translation)
            idn/a
            extensionn/a, N/A
            systemn/a, ./codeSystem
            versionn/a, ./codeSystemVersion
            coden/a, ./code
            displayn/a, CV.displayName
            userSelectedn/a, CD.codingRationale
         textn/a, ./originalText[mediaType/code="text/plain"]/data
      namen/a, EN (actually, PN), ./name
      telecomn/a, TEL, ./telecom
      addressn/a, AD, ./addr
         idn/a
         extensionn/a, N/A
         extension (room)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (floor)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (number)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (alley)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (lane)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (section)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (neighborhood)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         extension (village)n/a, N/A
            idn/a
            urlN/A
            value[x]n/a, N/A
         usen/a, unique(./use)
         typen/a, unique(./use)
         textn/a, ./formatted
         linen/a, AD.part[parttype = AL]
         cityn/a, AD.part[parttype = CTY]
         districtn/a, AD.part[parttype = CNT | CPA]
         staten/a, AD.part[parttype = STA]
         postalCoden/a, AD.part[parttype = ZIP]
            idn/a
            extensionn/a, N/A
            extension (PostalCode)n/a, N/A
               idn/a
               urlN/A
               value[x]n/a, N/A, CD
                  idn/a
                  extensionn/a, N/A
                  codingn/a, CV, union(., ./translation)
                     idn/a
                     extensionn/a, N/A
                     systemn/a, ./codeSystem
                     versionn/a, ./codeSystemVersion
                     coden/a, ./code
                     displayn/a, CV.displayName
                     userSelectedn/a, CD.codingRationale
                  coding (PostalCode3)n/a, CV, union(., ./translation)
                     idn/a
                     extensionn/a, N/A
                     systemn/a, ./codeSystem
                     versionn/a, ./codeSystemVersion
                     coden/a, ./code
                     displayn/a, CV.displayName
                     userSelectedn/a, CD.codingRationale
                  coding (PostalCode5)n/a, CV, union(., ./translation)
                     idn/a
                     extensionn/a, N/A
                     systemn/a, ./codeSystem
                     versionn/a, ./codeSystemVersion
                     coden/a, ./code
                     displayn/a, CV.displayName
                     userSelectedn/a, CD.codingRationale
                  coding (PostalCode6)n/a, CV, union(., ./translation)
                     idn/a
                     extensionn/a, N/A
                     systemn/a, ./codeSystem
                     versionn/a, ./codeSystemVersion
                     coden/a, ./code
                     displayn/a, CV.displayName
                     userSelectedn/a, CD.codingRationale
                  textn/a, ./originalText[mediaType/code="text/plain"]/data
         countryn/a, AD.part[parttype = CNT]
         periodn/a, IVL<TS>[lowClosed="true" and highClosed="true"] or URG<TS>[lowClosed="true" and highClosed="true"], ./usablePeriod[type="IVL<TS>"]
   endpointn/a, The target of a resource reference is a RIM entry point (Act, Role, or Entity)

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

OrganizationGeneTWNGS
OrganizationOrganization
   identifierIdentifier, ./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
   telecomContactPoint, ./ContactPoints
      system./ContactPointType
      value./Value
      use./ContactPointPurpose
      period./StartDate and ./EndDate
   addressAddress, ./PrimaryAddress and ./OtherAddresses
      use./AddressPurpose
      line./StreetAddress (newline delimitted)
      city./Jurisdiction
      state./Region
      postalCode./PostalIdentificationCode
      country./Country
      period./StartDate and ./EndDate
   partOfn/a
   contact
      nameProviderName
      telecomContactPoint
      addressAddress
         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)

OrganizationGeneTWNGS
Organization
   identifierFiveWs.identifier
   activeFiveWs.status
   typeFiveWs.class