FHIR Release 3 (STU)

This page is part of the FHIR Specification (v3.0.2: STU 3). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

5.5 Resource SearchParameter - Content

FHIR Infrastructure Work GroupMaturity Level: 3 Trial UseCompartments: Not linked to any defined compartments

A search parameter that defines a named search item that can be used to search/filter on a resource.

A SearchParameter resource specifies a search parameter that may be used on the RESTful API to search or filter on a resource. The SearchParameter resource declares:

  • how to refer to the search parameter from a client
  • how the search parameter is to be understood by the server
  • where in the source resource the parameter matches

Implementers should be familiar with the background and concepts described in Search on the RESTful API before working with this resource.

There is a registry of all Search Parameters.

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter IDomainResourceSearch Parameter for a resource
+ If an xpath is present, there SHALL be an xpathUsage
+ Search parameters can only have chain names when the search parameter type is 'reference'
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... url Σ1..1uriLogical URI to reference this search parameter (globally unique)
... version Σ0..1stringBusiness version of the search parameter
... name Σ1..1stringName for this search parameter (computer friendly)
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... experimental ?!Σ0..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate this was last changed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... useContext Σ0..*UsageContextContext the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for search parameter (if applicable)
Jurisdiction ValueSet (Extensible)
... purpose 0..1markdownWhy this search parameter is defined
... code Σ1..1codeCode used in URL
... base Σ1..*codeThe resource type(s) this search parameter applies to
ResourceType (Required)
... type Σ1..1codenumber | date | string | token | reference | composite | quantity | uri
SearchParamType (Required)
... derivedFrom 0..1uriOriginal Definition for the search parameter
... description Σ1..1markdownNatural language description of the search parameter
... expression I0..1stringFHIRPath expression that extracts the values
... xpath I0..1stringXPath that extracts the values
... xpathUsage I0..1codenormal | phonetic | nearby | distance | other
XPathUsageType (Required)
... target 0..*codeTypes of resource (if a resource reference)
ResourceType (Required)
... comparator 0..*codeeq | ne | gt | lt | ge | le | sa | eb | ap
SearchComparator (Required)
... modifier 0..*codemissing | exact | contains | not | text | in | not-in | below | above | type
SearchModifierCode (Required)
... chain 0..*stringChained names supported
... component 0..*BackboneElementFor Composite resources to define the parts
.... definition 1..1Reference(SearchParameter)Defines how the part works
.... expression 1..1stringSubexpression relative to main expression

doco Documentation for this format

UML Diagram (Legend)

SearchParameter (DomainResource)📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025url : uri [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025version : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025name : string [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025status : code [1..1] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025PublicationStatus! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025experimental : boolean [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025date : dateTime [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025publisher : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025contact : ContactDetail [0..*]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025useContext : UsageContext [0..*]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025jurisdiction : CodeableConcept [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025Jurisdiction ValueSet+ 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025purpose : markdown [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025code : code [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025base : code [1..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025ResourceType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025type : code [1..1] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025SearchParamType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025derivedFrom : uri [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025description : markdown [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025expression : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025xpath : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025xpathUsage : code [0..1] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025XPathUsageType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025target : code [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025ResourceType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025comparator : code [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025SearchComparator! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025modifier : code [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025SearchModifierCode! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025chain : string [0..*]Component📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025definition : Reference [1..1] SearchParameter 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025expression : string [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025component[0..*]

XML Template

<SearchParameter xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 1..1 Logical URI to reference this search parameter (globally unique) -->
 <version value="[string]"/><!-- 0..1 Business version of the search parameter -->
 <name value="[string]"/><!-- 1..1 Name for this search parameter (computer friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 0..1 Date this was last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <useContext><!-- 0..* UsageContext Context the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for search parameter (if applicable) --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this search parameter is defined -->
 <code value="[code]"/><!-- 1..1 Code used in URL -->
 <base value="[code]"/><!-- 1..* The resource type(s) this search parameter applies to -->
 <type value="[code]"/><!-- 1..1 number | date | string | token | reference | composite | quantity | uri -->
 <derivedFrom value="[uri]"/><!-- 0..1 Original Definition for the search parameter -->
 <description value="[markdown]"/><!-- 1..1 Natural language description of the search parameter -->
 <expression value="[string]"/><!-- ?? 0..1 FHIRPath expression that extracts the values -->
 <xpath value="[string]"/><!-- ?? 0..1 XPath that extracts the values -->
 <xpathUsage value="[code]"/><!-- ?? 0..1 normal | phonetic | nearby | distance | other -->
 <target value="[code]"/><!-- 0..* Types of resource (if a resource reference) -->
 <comparator value="[code]"/><!-- 0..* eq | ne | gt | lt | ge | le | sa | eb | ap -->
 <modifier value="[code]"/><!-- 0..* missing | exact | contains | not | text | in | not-in | below | above | type -->
 <chain value="[string]"/><!-- 0..* Chained names supported -->
 <component>  <!-- 0..* For Composite resources to define the parts -->
  <definition><!-- 1..1 Reference(SearchParameter) Defines how the part works --></definition>
  <expression value="[string]"/><!-- 1..1 Subexpression relative to main expression -->
 </component>
</SearchParameter>

JSON Template

{doco
  "resourceType" : "SearchParameter",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // R!  Logical URI to reference this search parameter (globally unique)
  "version" : "<string>", // Business version of the search parameter
  "name" : "<string>", // R!  Name for this search parameter (computer friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date this was last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "useContext" : [{ UsageContext }], // Context the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for search parameter (if applicable)
  "purpose" : "<markdown>", // Why this search parameter is defined
  "code" : "<code>", // R!  Code used in URL
  "base" : ["<code>"], // R!  The resource type(s) this search parameter applies to
  "type" : "<code>", // R!  number | date | string | token | reference | composite | quantity | uri
  "derivedFrom" : "<uri>", // Original Definition for the search parameter
  "description" : "<markdown>", // R!  Natural language description of the search parameter
  "expression" : "<string>", // C? FHIRPath expression that extracts the values
  "xpath" : "<string>", // C? XPath that extracts the values
  "xpathUsage" : "<code>", // C? normal | phonetic | nearby | distance | other
  "target" : ["<code>"], // Types of resource (if a resource reference)
  "comparator" : ["<code>"], // eq | ne | gt | lt | ge | le | sa | eb | ap
  "modifier" : ["<code>"], // missing | exact | contains | not | text | in | not-in | below | above | type
  "chain" : ["<string>"], // Chained names supported
  "component" : [{ // For Composite resources to define the parts
    "definition" : { Reference(SearchParameter) }, // R!  Defines how the part works
    "expression" : "<string>" // R!  Subexpression relative to main expression
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:SearchParameter;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:SearchParameter.url [ uri ]; # 1..1 Logical URI to reference this search parameter (globally unique)
  fhir:SearchParameter.version [ string ]; # 0..1 Business version of the search parameter
  fhir:SearchParameter.name [ string ]; # 1..1 Name for this search parameter (computer friendly)
  fhir:SearchParameter.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:SearchParameter.experimental [ boolean ]; # 0..1 For testing purposes, not real usage
  fhir:SearchParameter.date [ dateTime ]; # 0..1 Date this was last changed
  fhir:SearchParameter.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:SearchParameter.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:SearchParameter.useContext [ UsageContext ], ... ; # 0..* Context the content is intended to support
  fhir:SearchParameter.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for search parameter (if applicable)
  fhir:SearchParameter.purpose [ markdown ]; # 0..1 Why this search parameter is defined
  fhir:SearchParameter.code [ code ]; # 1..1 Code used in URL
  fhir:SearchParameter.base [ code ], ... ; # 1..* The resource type(s) this search parameter applies to
  fhir:SearchParameter.type [ code ]; # 1..1 number | date | string | token | reference | composite | quantity | uri
  fhir:SearchParameter.derivedFrom [ uri ]; # 0..1 Original Definition for the search parameter
  fhir:SearchParameter.description [ markdown ]; # 1..1 Natural language description of the search parameter
  fhir:SearchParameter.expression [ string ]; # 0..1 FHIRPath expression that extracts the values
  fhir:SearchParameter.xpath [ string ]; # 0..1 XPath that extracts the values
  fhir:SearchParameter.xpathUsage [ code ]; # 0..1 normal | phonetic | nearby | distance | other
  fhir:SearchParameter.target [ code ], ... ; # 0..* Types of resource (if a resource reference)
  fhir:SearchParameter.comparator [ code ], ... ; # 0..* eq | ne | gt | lt | ge | le | sa | eb | ap
  fhir:SearchParameter.modifier [ code ], ... ; # 0..* missing | exact | contains | not | text | in | not-in | below | above | type
  fhir:SearchParameter.chain [ string ], ... ; # 0..* Chained names supported
  fhir:SearchParameter.component [ # 0..* For Composite resources to define the parts
    fhir:SearchParameter.component.definition [ Reference(SearchParameter) ]; # 1..1 Defines how the part works
    fhir:SearchParameter.component.expression [ string ]; # 1..1 Subexpression relative to main expression
  ], ...;
]

Changes since DSTU2

SearchParameter
SearchParameter.version
  • Added Element
SearchParameter.status
  • Min Cardinality changed from 0 to 1
  • Change value set from http://hl7.org/fhir/ValueSet/conformance-resource-status to http://hl7.org/fhir/ValueSet/publication-status
SearchParameter.experimental
  • Now marked as Modifier
SearchParameter.contact
  • Type changed from BackboneElement to ContactDetail
SearchParameter.useContext
  • Added Element
SearchParameter.jurisdiction
  • Added Element
SearchParameter.purpose
  • Renamed from requirements to purpose
  • Type changed from string to markdown
SearchParameter.base
  • Max Cardinality changed from 1 to *
SearchParameter.derivedFrom
  • Added Element
SearchParameter.description
  • Type changed from string to markdown
SearchParameter.expression
  • Added Element
SearchParameter.comparator
  • Added Element
SearchParameter.modifier
  • Added Element
SearchParameter.chain
  • Added Element
SearchParameter.component
  • Added Element
SearchParameter.component.definition
  • Added Element
SearchParameter.component.expression
  • Added Element
SearchParameter.contact.name
  • deleted
SearchParameter.contact.telecom
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

See R2 <--> R3 Conversion Maps (status = 2 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.).

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter IDomainResourceSearch Parameter for a resource
+ If an xpath is present, there SHALL be an xpathUsage
+ Search parameters can only have chain names when the search parameter type is 'reference'
Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
... url Σ1..1uriLogical URI to reference this search parameter (globally unique)
... version Σ0..1stringBusiness version of the search parameter
... name Σ1..1stringName for this search parameter (computer friendly)
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... experimental ?!Σ0..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate this was last changed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... useContext Σ0..*UsageContextContext the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for search parameter (if applicable)
Jurisdiction ValueSet (Extensible)
... purpose 0..1markdownWhy this search parameter is defined
... code Σ1..1codeCode used in URL
... base Σ1..*codeThe resource type(s) this search parameter applies to
ResourceType (Required)
... type Σ1..1codenumber | date | string | token | reference | composite | quantity | uri
SearchParamType (Required)
... derivedFrom 0..1uriOriginal Definition for the search parameter
... description Σ1..1markdownNatural language description of the search parameter
... expression I0..1stringFHIRPath expression that extracts the values
... xpath I0..1stringXPath that extracts the values
... xpathUsage I0..1codenormal | phonetic | nearby | distance | other
XPathUsageType (Required)
... target 0..*codeTypes of resource (if a resource reference)
ResourceType (Required)
... comparator 0..*codeeq | ne | gt | lt | ge | le | sa | eb | ap
SearchComparator (Required)
... modifier 0..*codemissing | exact | contains | not | text | in | not-in | below | above | type
SearchModifierCode (Required)
... chain 0..*stringChained names supported
... component 0..*BackboneElementFor Composite resources to define the parts
.... definition 1..1Reference(SearchParameter)Defines how the part works
.... expression 1..1stringSubexpression relative to main expression

doco Documentation for this format

UML Diagram (Legend)

SearchParameter (DomainResource)📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025url : uri [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025version : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025name : string [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025status : code [1..1] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025PublicationStatus! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025experimental : boolean [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025date : dateTime [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025publisher : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025contact : ContactDetail [0..*]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025useContext : UsageContext [0..*]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025jurisdiction : CodeableConcept [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025Jurisdiction ValueSet+ 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025purpose : markdown [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025code : code [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025base : code [1..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025ResourceType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025type : code [1..1] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025SearchParamType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025derivedFrom : uri [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025description : markdown [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025expression : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025xpath : string [0..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025xpathUsage : code [0..1] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025XPathUsageType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025target : code [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025ResourceType! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025comparator : code [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025SearchComparator! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025modifier : code [0..*] 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025SearchModifierCode! 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025chain : string [0..*]Component📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025definition : Reference [1..1] SearchParameter 📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025expression : string [1..1]📢 แจ้งเตือน: fhir/STU/searchparameter.html - Kapook Update 2025component[0..*]

XML Template

<SearchParameter xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <url value="[uri]"/><!-- 1..1 Logical URI to reference this search parameter (globally unique) -->
 <version value="[string]"/><!-- 0..1 Business version of the search parameter -->
 <name value="[string]"/><!-- 1..1 Name for this search parameter (computer friendly) -->
 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <date value="[dateTime]"/><!-- 0..1 Date this was last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <useContext><!-- 0..* UsageContext Context the content is intended to support --></useContext>
 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for search parameter (if applicable) --></jurisdiction>
 <purpose value="[markdown]"/><!-- 0..1 Why this search parameter is defined -->
 <code value="[code]"/><!-- 1..1 Code used in URL -->
 <base value="[code]"/><!-- 1..* The resource type(s) this search parameter applies to -->
 <type value="[code]"/><!-- 1..1 number | date | string | token | reference | composite | quantity | uri -->
 <derivedFrom value="[uri]"/><!-- 0..1 Original Definition for the search parameter -->
 <description value="[markdown]"/><!-- 1..1 Natural language description of the search parameter -->
 <expression value="[string]"/><!-- ?? 0..1 FHIRPath expression that extracts the values -->
 <xpath value="[string]"/><!-- ?? 0..1 XPath that extracts the values -->
 <xpathUsage value="[code]"/><!-- ?? 0..1 normal | phonetic | nearby | distance | other -->
 <target value="[code]"/><!-- 0..* Types of resource (if a resource reference) -->
 <comparator value="[code]"/><!-- 0..* eq | ne | gt | lt | ge | le | sa | eb | ap -->
 <modifier value="[code]"/><!-- 0..* missing | exact | contains | not | text | in | not-in | below | above | type -->
 <chain value="[string]"/><!-- 0..* Chained names supported -->
 <component>  <!-- 0..* For Composite resources to define the parts -->
  <definition><!-- 1..1 Reference(SearchParameter) Defines how the part works --></definition>
  <expression value="[string]"/><!-- 1..1 Subexpression relative to main expression -->
 </component>
</SearchParameter>

JSON Template

{doco
  "resourceType" : "SearchParameter",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "url" : "<uri>", // R!  Logical URI to reference this search parameter (globally unique)
  "version" : "<string>", // Business version of the search parameter
  "name" : "<string>", // R!  Name for this search parameter (computer friendly)
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date this was last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "useContext" : [{ UsageContext }], // Context the content is intended to support
  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for search parameter (if applicable)
  "purpose" : "<markdown>", // Why this search parameter is defined
  "code" : "<code>", // R!  Code used in URL
  "base" : ["<code>"], // R!  The resource type(s) this search parameter applies to
  "type" : "<code>", // R!  number | date | string | token | reference | composite | quantity | uri
  "derivedFrom" : "<uri>", // Original Definition for the search parameter
  "description" : "<markdown>", // R!  Natural language description of the search parameter
  "expression" : "<string>", // C? FHIRPath expression that extracts the values
  "xpath" : "<string>", // C? XPath that extracts the values
  "xpathUsage" : "<code>", // C? normal | phonetic | nearby | distance | other
  "target" : ["<code>"], // Types of resource (if a resource reference)
  "comparator" : ["<code>"], // eq | ne | gt | lt | ge | le | sa | eb | ap
  "modifier" : ["<code>"], // missing | exact | contains | not | text | in | not-in | below | above | type
  "chain" : ["<string>"], // Chained names supported
  "component" : [{ // For Composite resources to define the parts
    "definition" : { Reference(SearchParameter) }, // R!  Defines how the part works
    "expression" : "<string>" // R!  Subexpression relative to main expression
  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:SearchParameter;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:SearchParameter.url [ uri ]; # 1..1 Logical URI to reference this search parameter (globally unique)
  fhir:SearchParameter.version [ string ]; # 0..1 Business version of the search parameter
  fhir:SearchParameter.name [ string ]; # 1..1 Name for this search parameter (computer friendly)
  fhir:SearchParameter.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:SearchParameter.experimental [ boolean ]; # 0..1 For testing purposes, not real usage
  fhir:SearchParameter.date [ dateTime ]; # 0..1 Date this was last changed
  fhir:SearchParameter.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:SearchParameter.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher
  fhir:SearchParameter.useContext [ UsageContext ], ... ; # 0..* Context the content is intended to support
  fhir:SearchParameter.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for search parameter (if applicable)
  fhir:SearchParameter.purpose [ markdown ]; # 0..1 Why this search parameter is defined
  fhir:SearchParameter.code [ code ]; # 1..1 Code used in URL
  fhir:SearchParameter.base [ code ], ... ; # 1..* The resource type(s) this search parameter applies to
  fhir:SearchParameter.type [ code ]; # 1..1 number | date | string | token | reference | composite | quantity | uri
  fhir:SearchParameter.derivedFrom [ uri ]; # 0..1 Original Definition for the search parameter
  fhir:SearchParameter.description [ markdown ]; # 1..1 Natural language description of the search parameter
  fhir:SearchParameter.expression [ string ]; # 0..1 FHIRPath expression that extracts the values
  fhir:SearchParameter.xpath [ string ]; # 0..1 XPath that extracts the values
  fhir:SearchParameter.xpathUsage [ code ]; # 0..1 normal | phonetic | nearby | distance | other
  fhir:SearchParameter.target [ code ], ... ; # 0..* Types of resource (if a resource reference)
  fhir:SearchParameter.comparator [ code ], ... ; # 0..* eq | ne | gt | lt | ge | le | sa | eb | ap
  fhir:SearchParameter.modifier [ code ], ... ; # 0..* missing | exact | contains | not | text | in | not-in | below | above | type
  fhir:SearchParameter.chain [ string ], ... ; # 0..* Chained names supported
  fhir:SearchParameter.component [ # 0..* For Composite resources to define the parts
    fhir:SearchParameter.component.definition [ Reference(SearchParameter) ]; # 1..1 Defines how the part works
    fhir:SearchParameter.component.expression [ string ]; # 1..1 Subexpression relative to main expression
  ], ...;
]

Changes since DSTU2

SearchParameter
SearchParameter.version
  • Added Element
SearchParameter.status
  • Min Cardinality changed from 0 to 1
  • Change value set from http://hl7.org/fhir/ValueSet/conformance-resource-status to http://hl7.org/fhir/ValueSet/publication-status
SearchParameter.experimental
  • Now marked as Modifier
SearchParameter.contact
  • Type changed from BackboneElement to ContactDetail
SearchParameter.useContext
  • Added Element
SearchParameter.jurisdiction
  • Added Element
SearchParameter.purpose
  • Renamed from requirements to purpose
  • Type changed from string to markdown
SearchParameter.base
  • Max Cardinality changed from 1 to *
SearchParameter.derivedFrom
  • Added Element
SearchParameter.description
  • Type changed from string to markdown
SearchParameter.expression
  • Added Element
SearchParameter.comparator
  • Added Element
SearchParameter.modifier
  • Added Element
SearchParameter.chain
  • Added Element
SearchParameter.component
  • Added Element
SearchParameter.component.definition
  • Added Element
SearchParameter.component.expression
  • Added Element
SearchParameter.contact.name
  • deleted
SearchParameter.contact.telecom
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON.

See R2 <--> R3 Conversion Maps (status = 2 tests that all execute ok. All tests pass round-trip testing and all r3 resources are valid.).

 

Alternate definitions: Master Definition (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle)

PathDefinitionTypeReference
SearchParameter.status The lifecycle status of a Value Set or Concept Map.RequiredPublicationStatus
SearchParameter.jurisdiction Countries and regions within which this artifact is targeted for useExtensibleJurisdiction ValueSet
SearchParameter.base
SearchParameter.target
One of the resource types defined as part of FHIR.RequiredResource Types
SearchParameter.type Data types allowed to be used for search parameters.RequiredSearchParamType
SearchParameter.xpathUsage How a search parameter relates to the set of elements returned by evaluating its xpath query.RequiredXPathUsageType
SearchParameter.comparator What Search Comparator Codes are supported in searchRequiredSearchComparator
SearchParameter.modifier A supported modifier for a search parameter.RequiredSearchModifierCode

  • spd-1: If an xpath is present, there SHALL be an xpathUsage (expression : xpath.empty() or xpathUsage.exists())
  • spd-2: Search parameters can only have chain names when the search parameter type is 'reference' (expression : chain.empty() or type = 'reference')

The SearchParameter resource may be used to define searches on extensions. Depending on the context of the extension (as defined in the StructureDefinition), this may require multiple instances of the SearchParameter.xpath element like so:

  • If the extension's context is scoped by a single resource, SearchParameter.base must be set to that resource, and there may be one or more xpath elements corresponding to the elements specified in the extension's context, e.g. "f:Patient/f:name/f:extension[@url='extension url']"
  • If the extension's context specifies multiple resources, SearchParameter.base must be set to "DomainResource".
  • You may use a single xpath element with the full URL of the Extension to indicate that the SearchParameter would search in all elements of the given SearchParameter.base resource for the given extension.

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionExpressionIn Common
basetokenThe resource type(s) this search parameter applies toSearchParameter.base
codetokenCode used in URLSearchParameter.code
componentreferenceDefines how the part worksSearchParameter.component.definition
(SearchParameter)
datedateThe search parameter publication dateSearchParameter.date
derived-fromuriOriginal Definition for the search parameterSearchParameter.derivedFrom
descriptionstringThe description of the search parameterSearchParameter.description
jurisdictiontokenIntended jurisdiction for the search parameterSearchParameter.jurisdiction
namestringComputationally friendly name of the search parameterSearchParameter.name
publisherstringName of the publisher of the search parameterSearchParameter.publisher
statustokenThe current status of the search parameterSearchParameter.status
targettokenTypes of resource (if a resource reference)SearchParameter.target
typetokennumber | date | string | token | reference | composite | quantity | uriSearchParameter.type
urluriThe uri that identifies the search parameterSearchParameter.url
versiontokenThe business version of the search parameterSearchParameter.version