Release 4

This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). 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 UseSecurity Category: Anonymous Compartments: 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.

This resource is referenced by CapabilityStatement and itself

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter ITUDomainResourceSearch parameter for a resource
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: If an xpath is present, there SHALL be an xpathUsage
+ Rule: 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..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version Σ0..1stringBusiness version of the search parameter
... name ΣI1..1stringName for this search parameter (computer friendly)
... derivedFrom 0..1canonical(SearchParameter)Original definition for the search parameter
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... experimental Σ0..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description Σ1..1markdownNatural language description of the search parameter
... useContext Σ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for search parameter (if applicable)
Jurisdiction (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 | special
SearchParamType (Required)
... 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)
... multipleOr 0..1booleanAllow multiple values per parameter (or)
... multipleAnd 0..1booleanAllow multiple parameters (and)
... 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 | identifier | ofType
SearchModifierCode (Required)
... chain 0..*stringChained names supported
... component 0..*BackboneElementFor Composite resources to define the parts
.... definition 1..1canonical(SearchParameter)Defines how the part works
.... expression 1..1stringSubexpression relative to main expression

doco Documentation for this format

UML Diagram (Legend)

SearchParameter (DomainResource)🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดurl : uri [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดversion : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดname : string [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดderivedFrom : canonical [0..1] « SearchParameter »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดstatus : code [1..1] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดPublicationStatus! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดexperimental : boolean [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดdate : dateTime [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดpublisher : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcontact : ContactDetail [0..*]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดdescription : markdown [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดuseContext : UsageContext [0..*]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดjurisdiction : CodeableConcept [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดJurisdiction ValueSet+ »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดpurpose : markdown [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcode : code [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดbase : code [1..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดResourceType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดtype : code [1..1] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดSearchParamType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดexpression : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดxpath : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดxpathUsage : code [0..1] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดXPathUsageType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดtarget : code [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดResourceType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดmultipleOr : boolean [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดmultipleAnd : boolean [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcomparator : code [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดSearchComparator! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดmodifier : code [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดSearchModifierCode! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดchain : string [0..*]Component🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดdefinition : canonical [1..1] « SearchParameter »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดexpression : string [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcomponent[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 Canonical identifier for this search parameter, represented as a URI (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) -->
 <derivedFrom><!-- 0..1 canonical(SearchParameter) Original definition for the search parameter --></derivedFrom>
 <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 last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- 1..1 Natural language description of the search parameter -->
 <useContext><!-- 0..* UsageContext The context that 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 | special -->
 <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) -->
 <multipleOr value="[boolean]"/><!-- 0..1 Allow multiple values per parameter (or) -->
 <multipleAnd value="[boolean]"/><!-- 0..1 Allow multiple parameters (and) -->
 <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 | identifier | ofType -->
 <chain value="[string]"/><!-- 0..* Chained names supported -->
 <component>  <!-- 0..* For Composite resources to define the parts -->
  <definition><!-- 1..1 canonical(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!  Canonical identifier for this search parameter, represented as a URI (globally unique)
  "version" : "<string>", // Business version of the search parameter
  "name" : "<string>", // C? R!  Name for this search parameter (computer friendly)
  "derivedFrom" : { canonical(SearchParameter) }, // Original definition for the search parameter
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // R!  Natural language description of the search parameter
  "useContext" : [{ UsageContext }], // The context that 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 | special
  "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)
  "multipleOr" : <boolean>, // Allow multiple values per parameter (or)
  "multipleAnd" : <boolean>, // Allow multiple parameters (and)
  "comparator" : ["<code>"], // eq | ne | gt | lt | ge | le | sa | eb | ap
  "modifier" : ["<code>"], // missing | exact | contains | not | text | in | not-in | below | above | type | identifier | ofType
  "chain" : ["<string>"], // Chained names supported
  "component" : [{ // For Composite resources to define the parts
    "definition" : { canonical(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 Canonical identifier for this search parameter, represented as a URI (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.derivedFrom [ canonical(SearchParameter) ]; # 0..1 Original definition for the search parameter
  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 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.description [ markdown ]; # 1..1 Natural language description of the search parameter
  fhir:SearchParameter.useContext [ UsageContext ], ... ; # 0..* The context that 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 | special
  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.multipleOr [ boolean ]; # 0..1 Allow multiple values per parameter (or)
  fhir:SearchParameter.multipleAnd [ boolean ]; # 0..1 Allow multiple parameters (and)
  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 | identifier | ofType
  fhir:SearchParameter.chain [ string ], ... ; # 0..* Chained names supported
  fhir:SearchParameter.component [ # 0..* For Composite resources to define the parts
    fhir:SearchParameter.component.definition [ canonical(SearchParameter) ]; # 1..1 Defines how the part works
    fhir:SearchParameter.component.expression [ string ]; # 1..1 Subexpression relative to main expression
  ], ...;
]

Changes since R3

SearchParameter
SearchParameter
  • Min Cardinality changed from 1 to 0
  • Max Cardinality changed from 1 to *
SearchParameter.derivedFrom
  • Type changed from uri to canonical(SearchParameter)
SearchParameter.status
  • Change value set from http://hl7.org/fhir/ValueSet/publication-status to http://hl7.org/fhir/ValueSet/publication-status|4.0.1
SearchParameter.experimental
  • No longer marked as Modifier
SearchParameter.base
  • Change value set from http://hl7.org/fhir/ValueSet/resource-types to http://hl7.org/fhir/ValueSet/resource-types|4.0.1
SearchParameter.type
  • Change value set from http://hl7.org/fhir/ValueSet/search-param-type to http://hl7.org/fhir/ValueSet/search-param-type|4.0.1
SearchParameter.xpathUsage
  • Change value set from http://hl7.org/fhir/ValueSet/search-xpath-usage to http://hl7.org/fhir/ValueSet/search-xpath-usage|4.0.1
SearchParameter.target
  • Change value set from http://hl7.org/fhir/ValueSet/resource-types to http://hl7.org/fhir/ValueSet/resource-types|4.0.1
SearchParameter.multipleOr
  • Added Element
SearchParameter.multipleAnd
  • Added Element
SearchParameter.comparator
  • Change value set from http://hl7.org/fhir/ValueSet/search-comparator to http://hl7.org/fhir/ValueSet/search-comparator|4.0.1
SearchParameter.modifier
  • Change value set from http://hl7.org/fhir/ValueSet/search-modifier-code to http://hl7.org/fhir/ValueSet/search-modifier-code|4.0.1
SearchParameter.component.definition
  • Type changed from Reference(SearchParameter) to canonical(SearchParameter)

See the Full Difference for further information

This analysis is available as XML or JSON.

See R3 <--> R4 Conversion Maps (status = 3 tests that all execute ok. All tests pass round-trip testing and 3 r3 resources are invalid (0 errors).)

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter ITUDomainResourceSearch parameter for a resource
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
+ Rule: If an xpath is present, there SHALL be an xpathUsage
+ Rule: 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..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version Σ0..1stringBusiness version of the search parameter
... name ΣI1..1stringName for this search parameter (computer friendly)
... derivedFrom 0..1canonical(SearchParameter)Original definition for the search parameter
... status ?!Σ1..1codedraft | active | retired | unknown
PublicationStatus (Required)
... experimental Σ0..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher Σ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description Σ1..1markdownNatural language description of the search parameter
... useContext Σ0..*UsageContextThe context that the content is intended to support
... jurisdiction Σ0..*CodeableConceptIntended jurisdiction for search parameter (if applicable)
Jurisdiction (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 | special
SearchParamType (Required)
... 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)
... multipleOr 0..1booleanAllow multiple values per parameter (or)
... multipleAnd 0..1booleanAllow multiple parameters (and)
... 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 | identifier | ofType
SearchModifierCode (Required)
... chain 0..*stringChained names supported
... component 0..*BackboneElementFor Composite resources to define the parts
.... definition 1..1canonical(SearchParameter)Defines how the part works
.... expression 1..1stringSubexpression relative to main expression

doco Documentation for this format

UML Diagram (Legend)

SearchParameter (DomainResource)🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดurl : uri [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดversion : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดname : string [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดderivedFrom : canonical [0..1] « SearchParameter »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดstatus : code [1..1] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดPublicationStatus! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดexperimental : boolean [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดdate : dateTime [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดpublisher : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcontact : ContactDetail [0..*]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดdescription : markdown [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดuseContext : UsageContext [0..*]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดjurisdiction : CodeableConcept [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดJurisdiction ValueSet+ »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดpurpose : markdown [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcode : code [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดbase : code [1..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดResourceType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดtype : code [1..1] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดSearchParamType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดexpression : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดxpath : string [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดxpathUsage : code [0..1] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดXPathUsageType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดtarget : code [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดResourceType! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดmultipleOr : boolean [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดmultipleAnd : boolean [0..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcomparator : code [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดSearchComparator! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดmodifier : code [0..*] « 🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดSearchModifierCode! »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดchain : string [0..*]Component🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดdefinition : canonical [1..1] « SearchParameter »🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดexpression : string [1..1]🔴 Hot News: fhir/R/searchparameter.html - สรุปดราม่าล่าสุดcomponent[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 Canonical identifier for this search parameter, represented as a URI (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) -->
 <derivedFrom><!-- 0..1 canonical(SearchParameter) Original definition for the search parameter --></derivedFrom>
 <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 last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>
 <description value="[markdown]"/><!-- 1..1 Natural language description of the search parameter -->
 <useContext><!-- 0..* UsageContext The context that 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 | special -->
 <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) -->
 <multipleOr value="[boolean]"/><!-- 0..1 Allow multiple values per parameter (or) -->
 <multipleAnd value="[boolean]"/><!-- 0..1 Allow multiple parameters (and) -->
 <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 | identifier | ofType -->
 <chain value="[string]"/><!-- 0..* Chained names supported -->
 <component>  <!-- 0..* For Composite resources to define the parts -->
  <definition><!-- 1..1 canonical(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!  Canonical identifier for this search parameter, represented as a URI (globally unique)
  "version" : "<string>", // Business version of the search parameter
  "name" : "<string>", // C? R!  Name for this search parameter (computer friendly)
  "derivedFrom" : { canonical(SearchParameter) }, // Original definition for the search parameter
  "status" : "<code>", // R!  draft | active | retired | unknown
  "experimental" : <boolean>, // For testing purposes, not real usage
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher
  "description" : "<markdown>", // R!  Natural language description of the search parameter
  "useContext" : [{ UsageContext }], // The context that 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 | special
  "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)
  "multipleOr" : <boolean>, // Allow multiple values per parameter (or)
  "multipleAnd" : <boolean>, // Allow multiple parameters (and)
  "comparator" : ["<code>"], // eq | ne | gt | lt | ge | le | sa | eb | ap
  "modifier" : ["<code>"], // missing | exact | contains | not | text | in | not-in | below | above | type | identifier | ofType
  "chain" : ["<string>"], // Chained names supported
  "component" : [{ // For Composite resources to define the parts
    "definition" : { canonical(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 Canonical identifier for this search parameter, represented as a URI (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.derivedFrom [ canonical(SearchParameter) ]; # 0..1 Original definition for the search parameter
  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 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.description [ markdown ]; # 1..1 Natural language description of the search parameter
  fhir:SearchParameter.useContext [ UsageContext ], ... ; # 0..* The context that 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 | special
  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.multipleOr [ boolean ]; # 0..1 Allow multiple values per parameter (or)
  fhir:SearchParameter.multipleAnd [ boolean ]; # 0..1 Allow multiple parameters (and)
  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 | identifier | ofType
  fhir:SearchParameter.chain [ string ], ... ; # 0..* Chained names supported
  fhir:SearchParameter.component [ # 0..* For Composite resources to define the parts
    fhir:SearchParameter.component.definition [ canonical(SearchParameter) ]; # 1..1 Defines how the part works
    fhir:SearchParameter.component.expression [ string ]; # 1..1 Subexpression relative to main expression
  ], ...;
]

Changes since Release 3

SearchParameter
SearchParameter
  • Min Cardinality changed from 1 to 0
  • Max Cardinality changed from 1 to *
SearchParameter.derivedFrom
  • Type changed from uri to canonical(SearchParameter)
SearchParameter.status
  • Change value set from http://hl7.org/fhir/ValueSet/publication-status to http://hl7.org/fhir/ValueSet/publication-status|4.0.1
SearchParameter.experimental
  • No longer marked as Modifier
SearchParameter.base
  • Change value set from http://hl7.org/fhir/ValueSet/resource-types to http://hl7.org/fhir/ValueSet/resource-types|4.0.1
SearchParameter.type
  • Change value set from http://hl7.org/fhir/ValueSet/search-param-type to http://hl7.org/fhir/ValueSet/search-param-type|4.0.1
SearchParameter.xpathUsage
  • Change value set from http://hl7.org/fhir/ValueSet/search-xpath-usage to http://hl7.org/fhir/ValueSet/search-xpath-usage|4.0.1
SearchParameter.target
  • Change value set from http://hl7.org/fhir/ValueSet/resource-types to http://hl7.org/fhir/ValueSet/resource-types|4.0.1
SearchParameter.multipleOr
  • Added Element
SearchParameter.multipleAnd
  • Added Element
SearchParameter.comparator
  • Change value set from http://hl7.org/fhir/ValueSet/search-comparator to http://hl7.org/fhir/ValueSet/search-comparator|4.0.1
SearchParameter.modifier
  • Change value set from http://hl7.org/fhir/ValueSet/search-modifier-code to http://hl7.org/fhir/ValueSet/search-modifier-code|4.0.1
SearchParameter.component.definition
  • Type changed from Reference(SearchParameter) to canonical(SearchParameter)

See the Full Difference for further information

This analysis is available as XML or JSON.

See R3 <--> R4 Conversion Maps (status = 3 tests that all execute ok. All tests pass round-trip testing and 3 r3 resources are invalid (0 errors).)

 

See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis

PathDefinitionTypeReference
SearchParameter.status The lifecycle status of an artifact.RequiredPublicationStatus
SearchParameter.jurisdiction Countries and regions within which this artifact is targeted for use.ExtensibleJurisdiction ValueSet
SearchParameter.base
SearchParameter.target
One of the resource types defined as part of this version 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 search.RequiredSearchComparator
SearchParameter.modifier A supported modifier for a search parameter.RequiredSearchModifierCode

idLevelLocationDescriptionExpression
spd-0Warning (base)Name should be usable as an identifier for the module by machine processing applications such as code generationname.matches('[A-Z]([A-Za-z0-9_]){0,254}')
spd-1Rule (base)If an xpath is present, there SHALL be an xpathUsagexpath.empty() or xpathUsage.exists()
spd-2Rule (base)Search parameters can only have chain names when the search parameter type is 'reference'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)
contexttokenA use context assigned to the search parameter(SearchParameter.useContext.value as CodeableConcept)
context-quantityquantityA quantity- or range-valued use context assigned to the search parameter(SearchParameter.useContext.value as Quantity) | (SearchParameter.useContext.value as Range)
context-typetokenA type of use context assigned to the search parameterSearchParameter.useContext.code
context-type-quantitycompositeA use context type and quantity- or range-based value assigned to the search parameterOn SearchParameter.useContext:
  context-type: code
  context-quantity: value.as(Quantity) | value.as(Range)
context-type-valuecompositeA use context type and value assigned to the search parameterOn SearchParameter.useContext:
  context-type: code
  context: value.as(CodeableConcept)
datedateThe search parameter publication dateSearchParameter.date
derived-fromreferenceOriginal definition for the search parameterSearchParameter.derivedFrom
(SearchParameter)
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 | uri | specialSearchParameter.type
urluriThe uri that identifies the search parameterSearchParameter.url
versiontokenThe business version of the search parameterSearchParameter.version