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 Group Maturity Level: 3 Trial Use 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.

5.5.1 Scope and Usage

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

5.5.2 Boundaries and Relationships

5.5.3 Background and Context

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.

5.5.4 Resource Content

Structure

Name Flags Card. Type Description & Constraints doco
.. SearchParameter IDomainResource Search 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..1uri Logical URI to reference this search parameter (globally unique)
... version Σ0..1string Business version of the search parameter
... name Σ1..1string Name for this search parameter (computer friendly)
... status ?!Σ1..1code draft | active | retired | unknown
PublicationStatus (Required)
... experimental ?!Σ0..1boolean For testing purposes, not real usage
... date Σ0..1dateTime Date this was last changed
... publisher Σ0..1string Name of the publisher (organization or individual)
... contact Σ0..*ContactDetail Contact details for the publisher
... useContext Σ0..*UsageContext Context the content is intended to support
... jurisdiction Σ0..*CodeableConcept Intended jurisdiction for search parameter (if applicable)
Jurisdiction ValueSet (Extensible)
... purpose 0..1markdown Why this search parameter is defined
... code Σ1..1code Code used in URL
... base Σ1..*code The resource type(s) this search parameter applies to
ResourceType (Required)
... type Σ1..1code number | date | string | token | reference | composite | quantity | uri
SearchParamType (Required)
... derivedFrom 0..1uri Original Definition for the search parameter
... description Σ1..1markdown Natural language description of the search parameter
... expression I0..1string FHIRPath expression that extracts the values
... xpath I0..1string XPath that extracts the values
... xpathUsage I0..1code normal | phonetic | nearby | distance | other
XPathUsageType (Required)
... target 0..*code Types of resource (if a resource reference)
ResourceType (Required)
... comparator 0..*code eq | ne | gt | lt | ge | le | sa | eb | ap
SearchComparator (Required)
... modifier 0..*code missing | exact | contains | not | text | in | not-in | below | above | type
SearchModifierCode (Required)
... chain 0..*string Chained names supported
... component 0..*BackboneElement For Composite resources to define the parts
.... definition 1..1Reference(SearchParameter)Defines how the part works
.... expression 1..1string Subexpression relative to main expression

doco Documentation for this format

UML Diagram (Legend)

SearchParameter (DomainResource)An absolute URI that is used to identify this search parameter when it is referenced in a specification, model, design or an instance. This SHALL be a URL, SHOULD be globally unique, and SHOULD be an address at which this search parameter is (or will be) published. The URL SHOULD include the major version of the search parameter. For more information see [Technical and Business Versions](resource.html#versions)url : uri [1..1]The identifier that is used to identify this version of the search parameter when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the search parameter author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequenceversion : string [0..1]A natural language name identifying the search parameter. This name should be usable as an identifier for the module by machine processing applications such as code generationname : string [1..1]The status of this search parameter. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements)status : code [1..1] The lifecycle status of a Value Set or Concept Map. (Strength=Required)PublicationStatus! A boolean value to indicate that this search parameter is authored for testing purposes (or education/evaluation/marketing), and is not intended to be used for genuine usage (this element modifies the meaning of other elements)experimental : boolean [0..1]The date (and optionally time) when the search parameter was published. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the search parameter changesdate : dateTime [0..1]The name of the individual or organization that published the search parameterpublisher : string [0..1]Contact details to assist a user in finding and communicating with the publishercontact : ContactDetail [0..*]The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate search parameter instancesuseContext : UsageContext [0..*]A legal or geographic region in which the search parameter is intended to be usedjurisdiction : CodeableConcept [0..*] Countries and regions within which this artifact is targeted for use (Strength=Extensible)Jurisdiction ValueSet+ Explaination of why this search parameter is needed and why it has been designed as it haspurpose : markdown [0..1]The code used in the URL or the parameter name in a parameters resource for this search parametercode : code [1..1]The base resource type(s) that this search parameter can be used againstbase : code [1..*] One of the resource types defined as part of FHIR. (Strength=Required)ResourceType! The type of value a search parameter refers to, and how the content is interpretedtype : code [1..1] Data types allowed to be used for search parameters. (Strength=Required)SearchParamType! Where this search parameter is originally defined. If a derivedFrom is provided, then the details in the search parameter must be consistent with the definition from which it is defined. I.e. the parameter should have the same meaning, and (usually) the functionality should be a proper subset of the underlying search parameterderivedFrom : uri [0..1]A free text natural language description of the search parameter from a consumer's perspective. and how it useddescription : markdown [1..1]A FHIRPath expression that returns a set of elements for the search parameterexpression : string [0..1]An XPath expression that returns a set of elements for the search parameterxpath : string [0..1]How the search parameter relates to the set of elements returned by evaluating the xpath queryxpathUsage : code [0..1] How a search parameter relates to the set of elements returned by evaluating its xpath query. (Strength=Required)XPathUsageType! Types of resource (if a resource is referenced)target : code [0..*] One of the resource types defined as part of FHIR. (Strength=Required)ResourceType! Comparators supported for the search parametercomparator : code [0..*] What Search Comparator Codes are supported in search (Strength=Required)SearchComparator! A modifier supported for the search parametermodifier : code [0..*] A supported modifier for a search parameter. (Strength=Required)SearchModifierCode! Contains the names of any search parameters which may be chained to the containing search parameter. Chained parameters may be added to search parameters of type reference, and specify that resources will only be returned if they contain a reference to a resource which matches the chained parameter value. Values for this field should be drawn from SearchParameter.code for a parameter on the target resource typechain : string [0..*]ComponentThe definition of the search parameter that describes this partdefinition : Reference [1..1] SearchParameter A sub-expression that defines how to extract values for this component from the output of the main SearchParameter.expressionexpression : string [1..1]Used to define the parts of a composite search parametercomponent [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

Name Flags Card. Type Description & Constraints doco
.. SearchParameter IDomainResource Search 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..1uri Logical URI to reference this search parameter (globally unique)
... version Σ0..1string Business version of the search parameter
... name Σ1..1string Name for this search parameter (computer friendly)
... status ?!Σ1..1code draft | active | retired | unknown
PublicationStatus (Required)
... experimental ?!Σ0..1boolean For testing purposes, not real usage
... date Σ0..1dateTime Date this was last changed
... publisher Σ0..1string Name of the publisher (organization or individual)
... contact Σ0..*ContactDetail Contact details for the publisher
... useContext Σ0..*UsageContext Context the content is intended to support
... jurisdiction Σ0..*CodeableConcept Intended jurisdiction for search parameter (if applicable)
Jurisdiction ValueSet (Extensible)
... purpose 0..1markdown Why this search parameter is defined
... code Σ1..1code Code used in URL
... base Σ1..*code The resource type(s) this search parameter applies to
ResourceType (Required)
... type Σ1..1code number | date | string | token | reference | composite | quantity | uri
SearchParamType (Required)
... derivedFrom 0..1uri Original Definition for the search parameter
... description Σ1..1markdown Natural language description of the search parameter
... expression I0..1string FHIRPath expression that extracts the values
... xpath I0..1string XPath that extracts the values
... xpathUsage I0..1code normal | phonetic | nearby | distance | other
XPathUsageType (Required)
... target 0..*code Types of resource (if a resource reference)
ResourceType (Required)
... comparator 0..*code eq | ne | gt | lt | ge | le | sa | eb | ap
SearchComparator (Required)
... modifier 0..*code missing | exact | contains | not | text | in | not-in | below | above | type
SearchModifierCode (Required)
... chain 0..*string Chained names supported
... component 0..*BackboneElement For Composite resources to define the parts
.... definition 1..1Reference(SearchParameter)Defines how the part works
.... expression 1..1string Subexpression relative to main expression

doco Documentation for this format

UML Diagram (Legend)

SearchParameter (DomainResource)An absolute URI that is used to identify this search parameter when it is referenced in a specification, model, design or an instance. This SHALL be a URL, SHOULD be globally unique, and SHOULD be an address at which this search parameter is (or will be) published. The URL SHOULD include the major version of the search parameter. For more information see [Technical and Business Versions](resource.html#versions)url : uri [1..1]The identifier that is used to identify this version of the search parameter when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the search parameter author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequenceversion : string [0..1]A natural language name identifying the search parameter. This name should be usable as an identifier for the module by machine processing applications such as code generationname : string [1..1]The status of this search parameter. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements)status : code [1..1] The lifecycle status of a Value Set or Concept Map. (Strength=Required)PublicationStatus! A boolean value to indicate that this search parameter is authored for testing purposes (or education/evaluation/marketing), and is not intended to be used for genuine usage (this element modifies the meaning of other elements)experimental : boolean [0..1]The date (and optionally time) when the search parameter was published. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the search parameter changesdate : dateTime [0..1]The name of the individual or organization that published the search parameterpublisher : string [0..1]Contact details to assist a user in finding and communicating with the publishercontact : ContactDetail [0..*]The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate search parameter instancesuseContext : UsageContext [0..*]A legal or geographic region in which the search parameter is intended to be usedjurisdiction : CodeableConcept [0..*] Countries and regions within which this artifact is targeted for use (Strength=Extensible)Jurisdiction ValueSet+ Explaination of why this search parameter is needed and why it has been designed as it haspurpose : markdown [0..1]The code used in the URL or the parameter name in a parameters resource for this search parametercode : code [1..1]The base resource type(s) that this search parameter can be used againstbase : code [1..*] One of the resource types defined as part of FHIR. (Strength=Required)ResourceType! The type of value a search parameter refers to, and how the content is interpretedtype : code [1..1] Data types allowed to be used for search parameters. (Strength=Required)SearchParamType! Where this search parameter is originally defined. If a derivedFrom is provided, then the details in the search parameter must be consistent with the definition from which it is defined. I.e. the parameter should have the same meaning, and (usually) the functionality should be a proper subset of the underlying search parameterderivedFrom : uri [0..1]A free text natural language description of the search parameter from a consumer's perspective. and how it useddescription : markdown [1..1]A FHIRPath expression that returns a set of elements for the search parameterexpression : string [0..1]An XPath expression that returns a set of elements for the search parameterxpath : string [0..1]How the search parameter relates to the set of elements returned by evaluating the xpath queryxpathUsage : code [0..1] How a search parameter relates to the set of elements returned by evaluating its xpath query. (Strength=Required)XPathUsageType! Types of resource (if a resource is referenced)target : code [0..*] One of the resource types defined as part of FHIR. (Strength=Required)ResourceType! Comparators supported for the search parametercomparator : code [0..*] What Search Comparator Codes are supported in search (Strength=Required)SearchComparator! A modifier supported for the search parametermodifier : code [0..*] A supported modifier for a search parameter. (Strength=Required)SearchModifierCode! Contains the names of any search parameters which may be chained to the containing search parameter. Chained parameters may be added to search parameters of type reference, and specify that resources will only be returned if they contain a reference to a resource which matches the chained parameter value. Values for this field should be drawn from SearchParameter.code for a parameter on the target resource typechain : string [0..*]ComponentThe definition of the search parameter that describes this partdefinition : Reference [1..1] SearchParameter A sub-expression that defines how to extract values for this component from the output of the main SearchParameter.expressionexpression : string [1..1]Used to define the parts of a composite search parametercomponent [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)

5.5.4.1 Terminology Bindings

PathDefinitionTypeReference
SearchParameter.status The lifecycle status of a Value Set or Concept Map.Required PublicationStatus
SearchParameter.jurisdiction Countries and regions within which this artifact is targeted for useExtensible Jurisdiction ValueSet
SearchParameter.base
SearchParameter.target 		One of the resource types defined as part of FHIR.Required Resource Types
SearchParameter.type Data types allowed to be used for search parameters.Required SearchParamType
SearchParameter.xpathUsage How a search parameter relates to the set of elements returned by evaluating its xpath query.Required XPathUsageType
SearchParameter.comparator What Search Comparator Codes are supported in searchRequired SearchComparator
SearchParameter.modifier A supported modifier for a search parameter.Required SearchModifierCode

5.5.4.2 Constraints

  • 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')

5.5.5 SearchParameters on Extensions

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.

5.5.6 Search Parameters

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

Name Type Description Expression In Common
base token The resource type(s) this search parameter applies to SearchParameter.base
code token Code used in URL SearchParameter.code
component reference Defines how the part works SearchParameter.component.definition
(SearchParameter)
date date The search parameter publication date SearchParameter.date
derived-from uri Original Definition for the search parameter SearchParameter.derivedFrom
description string The description of the search parameter SearchParameter.description
jurisdiction token Intended jurisdiction for the search parameter SearchParameter.jurisdiction
name string Computationally friendly name of the search parameter SearchParameter.name
publisher string Name of the publisher of the search parameter SearchParameter.publisher
status token The current status of the search parameter SearchParameter.status
target token Types of resource (if a resource reference) SearchParameter.target
type token number | date | string | token | reference | composite | quantity | uri SearchParameter.type
url uri The uri that identifies the search parameter SearchParameter.url
version token The business version of the search parameter SearchParameter.version

AltStyle によって変換されたページ (->オリジナル) /