FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.fhir.uv.v2mappings.r4
Resource TypeConceptMap
IdConceptMap-segment-rol-to-relatedperson.json
FHIR VersionR4

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: ConceptMap segment-rol-to-relatedperson

Mapping from (not specified) to (not specified)


Group 1 Mapping from unspecified code system to unspecified code system

Source CodeRelationshipTarget CodeComment
ROL-1 (Role Instance ID)is equivalent toidentifier
ROL-3 (Role-ROL)is equivalent torelationship
ROL-4 (Role Person)is equivalent to$thisA given ROL segment should create a single RelatedPerson resource, with the name coming from ROL-4 via the Data Type Map provided here and other attributes (eg. address, phone number) from other ROL fields. Therefor, when performing $this, the data type map updates the RelatedPerson resource created from this ROL[RelatedPerson] map.
ROL-5 (Role Begin Date/Time)is equivalent toperiod.start
ROL-6 (Role End Date/Time)is equivalent toperiod.end
ROL-11 (Office/Home Address/Birthplace)is equivalent toaddress
ROL-12 (Phone)is equivalent totelecom

Source1

{
  "resourceType": "ConceptMap",
  "id": "segment-rol-to-relatedperson",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "extension": [
        {
          "url": "type",
          "valueCode": "derived-from"
        },
        {
          "url": "label",
          "valueString": "Segment ROL to RelatedPerson.fsh"
        },
        {
          "url": "url",
          "valueUri": "https://docs.google.com/spreadsheets/d/11aEEi0skCde4ANez6cvm75IFqi2cTaVtUc2MJvnDlpY/edit#gid=0"
        }
      ],
      "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "oo"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "informative",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-rol-to-relatedperson",
  "version": "1.0.0",
  "name": "SegmentROLToRelatedPerson",
  "title": "Segment ROL to RelatedPerson Map",
  "status": "active",
  "experimental": true,
  "date": "2025-08-25",
  "publisher": "HL7 International / Orders and Observations",
  "contact": [
    {
      "name": "HL7 Orders and Observations Workgroup",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/orders"
        }
      ]
    }
  ],
  "description": "This ConceptMap represents a mapping from the HL7 V2 Segment ROL to the FHIR RelatedPerson Resource.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001"
        }
      ]
    }
  ],
  "copyright": "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
  "group": [
    {
      "element": [
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "EI"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": 1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": 1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-1",
          "display": "Role Instance ID",
          "target": [
            {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "type",
                      "valueCode": "Identifier"
                    },
                    {
                      "url": "cardinalityMin",
                      "valueInteger": 0
                    },
                    {
                      "url": "cardinalityMax",
                      "valueInteger": -1
                    }
                  ],
                  "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
                }
              ],
              "code": "identifier",
              "display": "identifier",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "CWE"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": 1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": 1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-3",
          "display": "Role-ROL",
          "target": [
            {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "type",
                      "valueCode": "CodeableConcept"
                    },
                    {
                      "url": "cardinalityMin",
                      "valueInteger": 0
                    },
                    {
                      "url": "cardinalityMax",
                      "valueInteger": -1
                    },
                    {
                      "url": "mappedVia",
                      "valueUrl": "ConceptMap/table-hl70443-to-v3-participationtype"
                    }
                  ],
                  "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
                }
              ],
              "code": "relationship",
              "display": "relationship",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "XCN"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": -1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": -1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-4",
          "display": "Role Person",
          "target": [
            {
              "code": "$this",
              "display": "$this",
              "equivalence": "equivalent",
              "comment": "A given ROL segment should create a single RelatedPerson resource, with the name coming from ROL-4 via the Data Type Map provided here and other attributes (eg. address, phone number) from other ROL fields. Therefor, when performing $this, the data type map updates the RelatedPerson resource created from this ROL[RelatedPerson] map."
            }
          ]
        },
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "DTM"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": 1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": 1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-5",
          "display": "Role Begin Date/Time",
          "target": [
            {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "type",
                      "valueCode": "dateTime"
                    },
                    {
                      "url": "cardinalityMin",
                      "valueInteger": 0
                    },
                    {
                      "url": "cardinalityMax",
                      "valueInteger": 1
                    }
                  ],
                  "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
                }
              ],
              "code": "period.start",
              "display": "period.start",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "DTM"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": 1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": 1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-6",
          "display": "Role End Date/Time",
          "target": [
            {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "type",
                      "valueCode": "dateTime"
                    },
                    {
                      "url": "cardinalityMin",
                      "valueInteger": 0
                    },
                    {
                      "url": "cardinalityMax",
                      "valueInteger": 1
                    }
                  ],
                  "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
                }
              ],
              "code": "period.end",
              "display": "period.end",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "XAD"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": -1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": -1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-11",
          "display": "Office/Home Address/Birthplace",
          "target": [
            {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "type",
                      "valueCode": "Address"
                    },
                    {
                      "url": "cardinalityMin",
                      "valueInteger": 0
                    },
                    {
                      "url": "cardinalityMax",
                      "valueInteger": -1
                    }
                  ],
                  "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
                }
              ],
              "code": "address",
              "display": "address",
              "equivalence": "equivalent"
            }
          ]
        },
        {
          "extension": [
            {
              "extension": [
                {
                  "url": "type",
                  "valueCode": "XTN"
                },
                {
                  "url": "cardinalityMin",
                  "valueInteger": -1
                },
                {
                  "url": "cardinalityMax",
                  "valueInteger": -1
                }
              ],
              "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
            }
          ],
          "code": "ROL-12",
          "display": "Phone",
          "target": [
            {
              "extension": [
                {
                  "extension": [
                    {
                      "url": "type",
                      "valueCode": "ContactPoint"
                    },
                    {
                      "url": "cardinalityMin",
                      "valueInteger": 0
                    },
                    {
                      "url": "cardinalityMax",
                      "valueInteger": -1
                    }
                  ],
                  "url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
                }
              ],
              "code": "telecom",
              "display": "telecom",
              "equivalence": "equivalent"
            }
          ]
        }
      ]
    }
  ]
}