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": "R3-SearchParameter-element-map-to-R4",
  "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-r3.r4"
          }
        ]
      }
    },
    {
      "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-r3.r4"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/xver/ConceptMap/R3-SearchParameter-element-map-to-R4",
  "version": "0.1.0",
  "name": "R3SearchParameterElementMapToR4",
  "title": "Cross-version mapping for FHIR STU3 SearchParameter to FHIR R4 SearchParameter",
  "status": "active",
  "experimental": false,
  "date": "2026-03-17T16:03:24.1585245-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 STU3 SearchParameter to FHIR R4.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "sourceCanonical": "http://hl7.org/fhir/3.0",
  "targetUri": "http://hl7.org/fhir/4.0",
  "group": [
    {
      "source": "http://hl7.org/fhir/StructureDefinition/SearchParameter",
      "sourceVersion": "3.0.2",
      "target": "http://hl7.org/fhir/StructureDefinition/SearchParameter",
      "targetVersion": "4.0.1",
      "element": [
        {
          "code": "SearchParameter.meta",
          "display": "meta",
          "target": [
            {
              "code": "SearchParameter.meta",
              "display": "SearchParameter.meta",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.meta` is mapped to FHIR R4 element `SearchParameter.meta` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.implicitRules",
          "display": "implicitRules",
          "target": [
            {
              "code": "SearchParameter.implicitRules",
              "display": "SearchParameter.implicitRules",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.implicitRules` is mapped to FHIR R4 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. \n\nThis element is labelled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation."
            }
          ]
        },
        {
          "code": "SearchParameter.language",
          "display": "language",
          "target": [
            {
              "code": "SearchParameter.language",
              "display": "SearchParameter.language",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.language` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.text` is mapped to FHIR R4 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 in formation is added later."
            }
          ]
        },
        {
          "code": "SearchParameter.contained",
          "display": "contained",
          "target": [
            {
              "code": "SearchParameter.contained",
              "display": "SearchParameter.contained",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.contained` is mapped to FHIR R4 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."
            }
          ]
        },
        {
          "code": "SearchParameter.url",
          "display": "url",
          "target": [
            {
              "code": "SearchParameter.url",
              "display": "SearchParameter.url",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.url` is mapped to FHIR R4 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."
            }
          ]
        },
        {
          "code": "SearchParameter.version",
          "display": "version",
          "target": [
            {
              "code": "SearchParameter.version",
              "display": "SearchParameter.version",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.version` is mapped to FHIR R4 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 refrence 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.name` is mapped to FHIR R4 element `SearchParameter.name` as `Equivalent`.\nThe name is not expected to be globally unique. The name should be a simple alpha-numeric type name to ensure that it is computable friendly."
            }
          ]
        },
        {
          "code": "SearchParameter.status",
          "display": "status",
          "target": [
            {
              "code": "SearchParameter.status",
              "display": "SearchParameter.status",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.status` is mapped to FHIR R4 element `SearchParameter.status` as `Equivalent`.\nAllows filtering of search parameters that are appropriate for use vs. not.  \nThis is labeled as \"Is Modifier\" because applications should not use a retired search parameter without due consideration."
            }
          ]
        },
        {
          "code": "SearchParameter.experimental",
          "display": "experimental",
          "target": [
            {
              "code": "SearchParameter.experimental",
              "display": "SearchParameter.experimental",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.experimental` is mapped to FHIR R4 element `SearchParameter.experimental` as `Equivalent`.\nAllows filtering of search parameter that are appropriate for use vs. not. This is labeled as \"Is Modifier\" because applications should not use an experimental search parameter in production."
            }
          ]
        },
        {
          "code": "SearchParameter.date",
          "display": "date",
          "target": [
            {
              "code": "SearchParameter.date",
              "display": "SearchParameter.date",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.date` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.publisher` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.contact` is mapped to FHIR R4 element `SearchParameter.contact` as `Equivalent`.\nMay be a web site, an email address, a telephone number, etc."
            }
          ]
        },
        {
          "code": "SearchParameter.useContext",
          "display": "useContext",
          "target": [
            {
              "code": "SearchParameter.useContext",
              "display": "SearchParameter.useContext",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.useContext` is mapped to FHIR R4 element `SearchParameter.useContext` as `Equivalent`.\nWhen multiple useContexts are specified, there is no expectation whether all or any of the contexts apply."
            }
          ]
        },
        {
          "code": "SearchParameter.jurisdiction",
          "display": "jurisdiction",
          "target": [
            {
              "code": "SearchParameter.jurisdiction",
              "display": "SearchParameter.jurisdiction",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.jurisdiction` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.purpose` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.code` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.base` is mapped to FHIR R4 element `SearchParameter.base` as `SourceIsNarrowerThanTarget`.\nThe mappings for `SearchParameter.base` do not allow expression of the necessary codes, per the bindings on the source and target.\nA search parameter must always have at least one type. When search parameters have more than one resource, 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.type` is mapped to FHIR R4 element `SearchParameter.type` as `SourceIsNarrowerThanTarget`.\nThe mappings for `SearchParameter.type` do not allow expression of the necessary codes, per the bindings on the source and target."
            }
          ]
        },
        {
          "code": "SearchParameter.derivedFrom",
          "display": "derivedFrom",
          "target": [
            {
              "code": "SearchParameter.derivedFrom",
              "display": "SearchParameter.derivedFrom",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.derivedFrom` is mapped to FHIR R4 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.description",
          "display": "description",
          "target": [
            {
              "code": "SearchParameter.description",
              "display": "SearchParameter.description",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.description` is mapped to FHIR R4 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 profile is presumed to be the predominant language in the place the profile was created)."
            }
          ]
        },
        {
          "code": "SearchParameter.expression",
          "display": "expression",
          "target": [
            {
              "code": "SearchParameter.expression",
              "display": "SearchParameter.expression",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.expression` is mapped to FHIR R4 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.xpath",
          "display": "xpath",
          "target": [
            {
              "code": "SearchParameter.xpath",
              "display": "SearchParameter.xpath",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.xpath` is mapped to FHIR R4 element `SearchParameter.xpath` as `Equivalent`.\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."
            }
          ]
        },
        {
          "code": "SearchParameter.xpathUsage",
          "display": "xpathUsage",
          "target": [
            {
              "code": "SearchParameter.xpathUsage",
              "display": "SearchParameter.xpathUsage",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.xpathUsage` is mapped to FHIR R4 element `SearchParameter.xpathUsage` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.target",
          "display": "target",
          "target": [
            {
              "code": "SearchParameter.target",
              "display": "SearchParameter.target",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.target` is mapped to FHIR R4 element `SearchParameter.target` as `SourceIsNarrowerThanTarget`.\nThe mappings for `SearchParameter.target` do not allow expression of the necessary codes, per the bindings on the source and target."
            }
          ]
        },
        {
          "code": "SearchParameter.comparator",
          "display": "comparator",
          "target": [
            {
              "code": "SearchParameter.comparator",
              "display": "SearchParameter.comparator",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.comparator` is mapped to FHIR R4 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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.modifier` is mapped to FHIR R4 element `SearchParameter.modifier` as `SourceIsNarrowerThanTarget`.\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",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.chain` is mapped to FHIR R4 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 may not know to use them."
            }
          ]
        },
        {
          "code": "SearchParameter.component",
          "display": "component",
          "target": [
            {
              "code": "SearchParameter.component",
              "display": "SearchParameter.component",
              "equivalence": "wider",
              "comment": "Element `SearchParameter.component` is mapped to FHIR R4 element `SearchParameter.component` as `Equivalent`."
            }
          ]
        },
        {
          "code": "SearchParameter.component.definition",
          "display": "definition",
          "target": [
            {
              "code": "SearchParameter.component.definition",
              "display": "SearchParameter.component.definition",
              "equivalence": "wider",
              "comment": "Element `SearchParameter.component.definition` is mapped to FHIR R4 element `SearchParameter.component.definition` as `SourceIsBroaderThanTarget`.\nThe mappings for `SearchParameter.component.definition` do not cover the following types: Reference.\nThe mappings for `SearchParameter.component.definition` do not cover the following types based on type expansion: display, identifier, reference."
            }
          ]
        },
        {
          "code": "SearchParameter.component.expression",
          "display": "expression",
          "target": [
            {
              "code": "SearchParameter.component.expression",
              "display": "SearchParameter.component.expression",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.component.expression` is mapped to FHIR R4 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",
      "sourceVersion": "3.0.2",
      "target": "http://hl7.org/fhir/3.0/StructureDefinition/extension-SearchParameter.component.definition",
      "targetVersion": "0.1.0",
      "element": [
        {
          "code": "SearchParameter.component.definition",
          "display": "definition",
          "target": [
            {
              "code": "Extension",
              "equivalence": "equivalent",
              "comment": "Element `SearchParameter.component.definition` is mapped to FHIR R4 element `SearchParameter.component.definition` as `SourceIsBroaderThanTarget`.\nThe mappings for `SearchParameter.component.definition` do not cover the following types: Reference.\nThe mappings for `SearchParameter.component.definition` do not cover the following types based on type expansion: display, identifier, reference."
            }
          ]
        }
      ]
    }
  ]
}