FHIR IG analytics

Resources that use this resource

No resources found

Resources that this resource uses

Narrative

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

Source1

{
  "resourceType": "ConceptMap",
  "id": "R4-SearchParameter-element-map-to-R5",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "fhir"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 0,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r4.r5"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/xver/ImplementationGuide/hl7.fhir.uv.xver-r4.r5"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/xver/ConceptMap/R4-SearchParameter-element-map-to-R5",
  "version": "0.1.0",
  "name": "R4SearchParameterElementMapToR5",
  "title": "Cross-version mapping for FHIR R4 SearchParameter to FHIR R5 SearchParameter",
  "status": "active",
  "experimental": false,
  "date": "2026-03-17T16:04:37.914951-05:00",
  "contact": [
    {
      "name": "FHIR Infrastructure",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "This ConceptMap represents cross-version mappings for elements from a FHIR R4 SearchParameter to FHIR R5.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "sourceScopeCanonical": "http://hl7.org/fhir/4.0",
  "targetScopeUri": "http://hl7.org/fhir/5.0",
  "group": [
    {
      "source": "http://hl7.org/fhir/StructureDefinition/SearchParameter|4.0.1",
      "target": "http://hl7.org/fhir/StructureDefinition/SearchParameter|5.0.0",
      "element": [
        {
          "code": "SearchParameter.meta",
          "display": "meta",
          "target": [
            {
              "code": "SearchParameter.meta",
              "display": "SearchParameter.meta",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.meta` is mapped to FHIR R5 element `SearchParameter.meta` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.implicitRules",
          "display": "implicitRules",
          "target": [
            {
              "code": "SearchParameter.implicitRules",
              "display": "SearchParameter.implicitRules",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.implicitRules` is mapped to FHIR R5 element `SearchParameter.implicitRules` as `Equivalent`.\nAsserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc."
            }
          ]
        },
        {
          "code": "SearchParameter.language",
          "display": "language",
          "target": [
            {
              "code": "SearchParameter.language",
              "display": "SearchParameter.language",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.language` is mapped to FHIR R5 element `SearchParameter.language` as `Equivalent`.\nLanguage is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies  to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute)."
            }
          ]
        },
        {
          "code": "SearchParameter.text",
          "display": "text",
          "target": [
            {
              "code": "SearchParameter.text",
              "display": "SearchParameter.text",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.text` is mapped to FHIR R5 element `SearchParameter.text` as `Equivalent`.\nContained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied).  This may be necessary for data from legacy systems where information is captured as a \"text blob\" or where text is additionally entered raw or narrated and encoded information is added later."
            }
          ]
        },
        {
          "code": "SearchParameter.contained",
          "display": "contained",
          "target": [
            {
              "code": "SearchParameter.contained",
              "display": "SearchParameter.contained",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.contained` is mapped to FHIR R5 element `SearchParameter.contained` as `Equivalent`.\nThis should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels."
            }
          ]
        },
        {
          "code": "SearchParameter.url",
          "display": "url",
          "target": [
            {
              "code": "SearchParameter.url",
              "display": "SearchParameter.url",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.url` is mapped to FHIR R5 element `SearchParameter.url` as `Equivalent`.\nCan be a urn:uuid: or a urn:oid: but real http: addresses are preferred.  Multiple instances may share the same URL if they have a distinct version.\n\nThe determination of when to create a new version of a resource (same url, new version) vs. defining a new artifact is up to the author.  Considerations for making this decision are found in [Technical and Business Versions](https://hl7.org/fhir/resource..html#versions). \n\nIn some cases, the resource can no longer be found at the stated url, but the url itself cannot change. Implementations can use the [meta.source](https://hl7.org/fhir/resou.html#meta) element to indicate where the current master source of the resource can be found."
            }
          ]
        },
        {
          "code": "SearchParameter.version",
          "display": "version",
          "target": [
            {
              "code": "SearchParameter.version",
              "display": "SearchParameter.version",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.version` is mapped to FHIR R5 element `SearchParameter.version` as `Equivalent`.\nThere may be different search parameter instances that have the same identifier but different versions.  The version can be appended to the url in a reference to allow a reference to a particular business version of the search parameter with the format [url]|[version]."
            }
          ]
        },
        {
          "code": "SearchParameter.name",
          "display": "name",
          "target": [
            {
              "code": "SearchParameter.name",
              "display": "SearchParameter.name",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.name` is mapped to FHIR R5 element `SearchParameter.name` as `Equivalent`.\nThe name is not expected to be globally unique. The name should be a simple alphanumeric type name to ensure that it is machine-processing friendly."
            }
          ]
        },
        {
          "code": "SearchParameter.derivedFrom",
          "display": "derivedFrom",
          "target": [
            {
              "code": "SearchParameter.derivedFrom",
              "display": "SearchParameter.derivedFrom",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.derivedFrom` is mapped to FHIR R5 element `SearchParameter.derivedFrom` as `Equivalent`.\nThe intent of this is that a server can designate that it provides support for a search parameter defined in the specification itself (e.g.  [`value-quantity`](http://hl7.org/fhir/SearchParameter/Observation-value-quantity), but detail how it is supported by the server."
            }
          ]
        },
        {
          "code": "SearchParameter.status",
          "display": "status",
          "target": [
            {
              "code": "SearchParameter.status",
              "display": "SearchParameter.status",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.status` is mapped to FHIR R5 element `SearchParameter.status` as `Equivalent`.\nAllows filtering of search parameters that are appropriate for use versus not."
            }
          ]
        },
        {
          "code": "SearchParameter.experimental",
          "display": "experimental",
          "target": [
            {
              "code": "SearchParameter.experimental",
              "display": "SearchParameter.experimental",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.experimental` is mapped to FHIR R5 element `SearchParameter.experimental` as `Equivalent`.\nAllows filtering of search parameters that are appropriate for use versus not."
            }
          ]
        },
        {
          "code": "SearchParameter.date",
          "display": "date",
          "target": [
            {
              "code": "SearchParameter.date",
              "display": "SearchParameter.date",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.date` is mapped to FHIR R5 element `SearchParameter.date` as `Equivalent`.\nNote that this is not the same as the resource last-modified-date, since the resource may be a secondary representation of the search parameter. Additional specific dates may be added as extensions or be found by consulting Provenances associated with past versions of the resource."
            }
          ]
        },
        {
          "code": "SearchParameter.publisher",
          "display": "publisher",
          "target": [
            {
              "code": "SearchParameter.publisher",
              "display": "SearchParameter.publisher",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.publisher` is mapped to FHIR R5 element `SearchParameter.publisher` as `Equivalent`.\nUsually an organization but may be an individual. The publisher (or steward) of the search parameter is the organization or individual primarily responsible for the maintenance and upkeep of the search parameter. This is not necessarily the same individual or organization that developed and initially authored the content. The publisher is the primary point of contact for questions or issues with the search parameter. This item SHOULD be populated unless the information is available from context."
            }
          ]
        },
        {
          "code": "SearchParameter.contact",
          "display": "contact",
          "target": [
            {
              "code": "SearchParameter.contact",
              "display": "SearchParameter.contact",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.contact` is mapped to FHIR R5 element `SearchParameter.contact` as `Equivalent`.\nMay be a web site, an email address, a telephone number, etc."
            }
          ]
        },
        {
          "code": "SearchParameter.description",
          "display": "description",
          "target": [
            {
              "code": "SearchParameter.description",
              "display": "SearchParameter.description",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.description` is mapped to FHIR R5 element `SearchParameter.description` as `Equivalent`.\nThis description can be used to capture details such as why the search parameter was built, comments about misuse, instructions for clinical use and interpretation, literature references, examples from the paper world, etc. It is not a rendering of the search parameter as conveyed in the 'text' field of the resource itself. This item SHOULD be populated unless the information is available from context (e.g. the language of the search parameter is presumed to be the predominant language in the place the search parameter was created)."
            }
          ]
        },
        {
          "code": "SearchParameter.useContext",
          "display": "useContext",
          "target": [
            {
              "code": "SearchParameter.useContext",
              "display": "SearchParameter.useContext",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.useContext` is mapped to FHIR R5 element `SearchParameter.useContext` as `Equivalent`.\nWhen multiple useContexts are specified, there is no expectation that all or any of the contexts apply."
            }
          ]
        },
        {
          "code": "SearchParameter.jurisdiction",
          "display": "jurisdiction",
          "target": [
            {
              "code": "SearchParameter.jurisdiction",
              "display": "SearchParameter.jurisdiction",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.jurisdiction` is mapped to FHIR R5 element `SearchParameter.jurisdiction` as `Equivalent`.\nIt may be possible for the search parameter to be used in jurisdictions other than those for which it was originally designed or intended."
            }
          ]
        },
        {
          "code": "SearchParameter.purpose",
          "display": "purpose",
          "target": [
            {
              "code": "SearchParameter.purpose",
              "display": "SearchParameter.purpose",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.purpose` is mapped to FHIR R5 element `SearchParameter.purpose` as `Equivalent`.\nThis element does not describe the usage of the search parameter. Instead, it provides traceability of ''why'' the resource is either needed or ''why'' it is defined as it is.  This may be used to point to source materials or specifications that drove the structure of this search parameter."
            }
          ]
        },
        {
          "code": "SearchParameter.code",
          "display": "code",
          "target": [
            {
              "code": "SearchParameter.code",
              "display": "SearchParameter.code",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.code` is mapped to FHIR R5 element `SearchParameter.code` as `Equivalent`.\nFor maximum compatibility, use only lowercase ASCII characters."
            }
          ]
        },
        {
          "code": "SearchParameter.base",
          "display": "base",
          "target": [
            {
              "code": "SearchParameter.base",
              "display": "SearchParameter.base",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.base` is mapped to FHIR R5 element `SearchParameter.base` as `SourceIsBroaderThanTarget`.\nA search parameter must always apply to at least one resource type. When search parameters apply to more than one resource type, they can be used against any of the listed resource types, or in a cross-type search (see [Cross Resource Search](https://hl7.org/fhir/http.html#xr.html#xres-search))."
            }
          ]
        },
        {
          "code": "SearchParameter.type",
          "display": "type",
          "target": [
            {
              "code": "SearchParameter.type",
              "display": "SearchParameter.type",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.type` is mapped to FHIR R5 element `SearchParameter.type` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.expression",
          "display": "expression",
          "target": [
            {
              "code": "SearchParameter.expression",
              "display": "SearchParameter.expression",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.expression` is mapped to FHIR R5 element `SearchParameter.expression` as `Equivalent`.\nNote that the elements returned by the expression are sometimes complex elements where logic is required to determine quite how to handle them; e.g. CodeableConcepts may contain text and/or multiple codings, where the codings themselves contain a code and a system. For composite search parameters, the outcome of the expression must a collection of base elements from which the composites are derived."
            }
          ]
        },
        {
          "code": "SearchParameter.xpathUsage",
          "display": "xpathUsage",
          "target": [
            {
              "code": "SearchParameter.processingMode",
              "display": "SearchParameter.processingMode",
              "relationship": "related-to",
              "comment": "Element `SearchParameter.xpathUsage` is mapped to FHIR R5 element `SearchParameter.processingMode` as `RelatedTo`.\nThe mappings for `SearchParameter.xpathUsage` do not allow expression of the necessary codes, per the bindings on the source and target."
            }
          ]
        },
        {
          "code": "SearchParameter.target",
          "display": "target",
          "target": [
            {
              "code": "SearchParameter.target",
              "display": "SearchParameter.target",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.target` is mapped to FHIR R5 element `SearchParameter.target` as `SourceIsBroaderThanTarget`."
            }
          ]
        },
        {
          "code": "SearchParameter.multipleOr",
          "display": "multipleOr",
          "target": [
            {
              "code": "SearchParameter.multipleOr",
              "display": "SearchParameter.multipleOr",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.multipleOr` is mapped to FHIR R5 element `SearchParameter.multipleOr` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.multipleAnd",
          "display": "multipleAnd",
          "target": [
            {
              "code": "SearchParameter.multipleAnd",
              "display": "SearchParameter.multipleAnd",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.multipleAnd` is mapped to FHIR R5 element `SearchParameter.multipleAnd` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.comparator",
          "display": "comparator",
          "target": [
            {
              "code": "SearchParameter.comparator",
              "display": "SearchParameter.comparator",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.comparator` is mapped to FHIR R5 element `SearchParameter.comparator` as `Equivalent`.\nIf no comparators are listed, clients should not expect servers to support any comparators."
            }
          ]
        },
        {
          "code": "SearchParameter.modifier",
          "display": "modifier",
          "target": [
            {
              "code": "SearchParameter.modifier",
              "display": "SearchParameter.modifier",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `SearchParameter.modifier` is mapped to FHIR R5 element `SearchParameter.modifier` as `RelatedTo`.\nThe mappings for `SearchParameter.modifier` do not allow expression of the necessary codes, per the bindings on the source and target."
            }
          ]
        },
        {
          "code": "SearchParameter.chain",
          "display": "chain",
          "target": [
            {
              "code": "SearchParameter.chain",
              "display": "SearchParameter.chain",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.chain` is mapped to FHIR R5 element `SearchParameter.chain` as `Equivalent`.\nSystems are not required to list all the chain names they support, but if they don't list them, clients might not know to use them."
            }
          ]
        },
        {
          "code": "SearchParameter.component",
          "display": "component",
          "target": [
            {
              "code": "SearchParameter.component",
              "display": "SearchParameter.component",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `SearchParameter.component` is mapped to FHIR R5 element `SearchParameter.component` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.component.definition",
          "display": "definition",
          "target": [
            {
              "code": "SearchParameter.component.definition",
              "display": "SearchParameter.component.definition",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.component.definition` is mapped to FHIR R5 element `SearchParameter.component.definition` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.component.expression",
          "display": "expression",
          "target": [
            {
              "code": "SearchParameter.component.expression",
              "display": "SearchParameter.component.expression",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.component.expression` is mapped to FHIR R5 element `SearchParameter.component.expression` as `Equivalent`.\nThis expression overrides the expression in the definition and extracts the index values from the outcome of the composite expression."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/SearchParameter|4.0.1",
      "target": "http://hl7.org/fhir/4.0/StructureDefinition/extension-SearchParameter.xpath|0.1.0",
      "element": [
        {
          "code": "SearchParameter.xpath",
          "display": "xpath",
          "target": [
            {
              "code": "Extension",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.xpath` has a context of SearchParameter based on following the parent source element upwards and mapping to `SearchParameter`.\nElement `SearchParameter.xpath` has no mapping targets in FHIR R5. Typically, this is because the element has been added (is a new element).\nNote that the elements returned by the XPath are sometimes complex elements where logic is required to determine quite how to handle them; e.g. CodeableConcepts may contain text and/or multiple codings, where the codings themselves contain a code and a system."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/SearchParameter|4.0.1",
      "target": "http://hl7.org/fhir/4.0/StructureDefinition/extension-SearchParameter.xpathUsage|0.1.0",
      "element": [
        {
          "code": "SearchParameter.xpathUsage",
          "display": "xpathUsage",
          "target": [
            {
              "code": "Extension",
              "relationship": "source-is-broader-than-target",
              "comment": "Element `SearchParameter.xpathUsage` is mapped to FHIR R5 element `SearchParameter.processingMode` as `RelatedTo`.\nThe mappings for `SearchParameter.xpathUsage` do not allow expression of the necessary codes, per the bindings on the source and target."
            }
          ]
        }
      ]
    },
    {
      "source": "http://hl7.org/fhir/StructureDefinition/SearchParameter|4.0.1",
      "target": "http://hl7.org/fhir/4.0/StructureDefinition/extension-SearchParameter.modifier|0.1.0",
      "element": [
        {
          "code": "SearchParameter.modifier",
          "display": "modifier",
          "target": [
            {
              "code": "Extension",
              "relationship": "equivalent",
              "comment": "Element `SearchParameter.modifier` is mapped to FHIR R5 element `SearchParameter.modifier` as `RelatedTo`.\nThe mappings for `SearchParameter.modifier` do not allow expression of the necessary codes, per the bindings on the source and target."
            }
          ]
        }
      ]
    }
  ]
}