Canonical Resource Management Infrastructure Implementation Guide
1.0.0-ballot - Ballot International flag

This page is part of the Canonical Resource Management Infrastructure Implementation Guide (v1.0.0-ballot: STU1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Resource Profile: CRMI Shareable SearchParameter

Official URL: http://hl7.org/fhir/uv/crmi/StructureDefinition/crmi-shareablesearchparameter Version: 1.0.0-ballot
Standards status: Trial-use Maturity Level: 3 Computable Name: CRMIShareableSearchParameter

Enforces the minimum information set for the search parameter metadata required by HL7 and other organizations that share and publish search parameters

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

This structure is derived from SearchParameter

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter 1..1SearchParameterSearch parameter for a resource
... knowledgeCapability S0..*codeshareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapabilityValues (required)
... knowledgeRepresentationLevel S0..*codenarrative | semi-structured | structured | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel
Binding: KnowledgeRepresentationLevelValues (required)
... artifactComment S0..*(Complex)Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
... versionPolicy S0..1Codingmetadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: Artifact Version Policy Values (extensible): The versioning policy of the artifact

... title S1..1stringName for this {{title}} (human friendly)
URL: http://hl7.org/fhir/StructureDefinition/artifact-title
... url S1..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version S1..1stringBusiness version of the search parameter
... name S1..1stringName for this search parameter (computer friendly)
... status S1..1codedraft | active | retired | unknown
... experimental S1..1booleanFor testing purposes, not real usage
... publisher S0..1stringName of the publisher (organization or individual)
... description S1..1markdownNatural language description of the search parameter

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter C1..1SearchParameterSearch parameter for a resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 1..*ExtensionExtension
Slice: Unordered, Open by value:url
... knowledgeCapability S0..*codeshareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapabilityValues (required)
... artifactComment S0..*(Complex)Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
... versionAlgorithm S0..1string, CodingHow to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: VersionAlgorithm (extensible): The algorithm used to compare versions for the artifact


... versionPolicy S0..1Codingmetadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: Artifact Version Policy Values (extensible): The versioning policy of the artifact


... title S1..1stringName for this {{title}} (human friendly)
URL: http://hl7.org/fhir/StructureDefinition/artifact-title
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url SΣ1..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version SΣ1..1stringBusiness version of the search parameter
... name SΣC1..1stringName for this search parameter (computer friendly)
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental SΣ1..1booleanFor testing purposes, not real usage
... publisher SΣ0..1stringName of the publisher (organization or individual)
... description SΣ1..1markdownNatural language description of the search parameter
... code Σ1..1codeCode used in URL
... base Σ1..*codeThe resource type(s) this search parameter applies to
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.


... type Σ1..1codenumber | date | string | token | reference | composite | quantity | uri | special
Binding: SearchParamType (required): Data types allowed to be used for search parameters.


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
SearchParameter.statusrequiredPublicationStatus
SearchParameter.baserequiredResourceType
SearchParameter.typerequiredSearchParamType

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorSearchParameterIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorSearchParameterIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorSearchParameterIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorSearchParameterIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceSearchParameterA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
spd-0warningSearchParameterName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
spd-1errorSearchParameterIf an xpath is present, there SHALL be an xpathUsage
: xpath.empty() or xpathUsage.exists()
spd-2errorSearchParameterSearch parameters can only have chain names when the search parameter type is 'reference'
: chain.empty() or type = 'reference'
NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter C1..1SearchParameterSearch parameter for a resource
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 1..*ExtensionExtension
Slice: Unordered, Open by value:url
... knowledgeCapability S0..*codeshareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapabilityValues (required)
... knowledgeRepresentationLevel S0..*codenarrative | semi-structured | structured | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel
Binding: KnowledgeRepresentationLevelValues (required)
... artifactComment S0..*(Complex)Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
... versionAlgorithm S0..1string, CodingHow to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: VersionAlgorithm (extensible): The algorithm used to compare versions for the artifact


... versionPolicy S0..1Codingmetadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: Artifact Version Policy Values (extensible): The versioning policy of the artifact


... title S1..1stringName for this {{title}} (human friendly)
URL: http://hl7.org/fhir/StructureDefinition/artifact-title
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url SΣ1..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version SΣ1..1stringBusiness version of the search parameter
... name SΣC1..1stringName for this search parameter (computer friendly)
... derivedFrom 0..1canonical(SearchParameter)Original definition for the search parameter
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental SΣ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description SΣ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)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... 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
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.


... type Σ1..1codenumber | date | string | token | reference | composite | quantity | uri | special
Binding: SearchParamType (required): Data types allowed to be used for search parameters.

... expression C0..1stringFHIRPath expression that extracts the values
... xpath C0..1stringXPath that extracts the values
... xpathUsage C0..1codenormal | phonetic | nearby | distance | other
Binding: XPathUsageType (required): How a search parameter relates to the set of elements returned by evaluating its xpath query.

... target 0..*codeTypes of resource (if a resource reference)
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.


... 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
Binding: SearchComparator (required): What Search Comparator Codes are supported in search.


... modifier 0..*codemissing | exact | contains | not | text | in | not-in | below | above | type | identifier | ofType
Binding: SearchModifierCode (required): A supported modifier for a search parameter.


... chain 0..*stringChained names supported
... component 0..*BackboneElementFor Composite resources to define the parts
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... definition 1..1canonical(SearchParameter)Defines how the part works
.... expression 1..1stringSubexpression relative to main expression

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
SearchParameter.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
SearchParameter.statusrequiredPublicationStatus
SearchParameter.jurisdictionextensibleJurisdiction ValueSet
SearchParameter.baserequiredResourceType
SearchParameter.typerequiredSearchParamType
SearchParameter.xpathUsagerequiredXPathUsageType
SearchParameter.targetrequiredResourceType
SearchParameter.comparatorrequiredSearchComparator
SearchParameter.modifierrequiredSearchModifierCode

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Differential View

This structure is derived from SearchParameter

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter 1..1SearchParameterSearch parameter for a resource
... knowledgeCapability S0..*codeshareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapabilityValues (required)
... knowledgeRepresentationLevel S0..*codenarrative | semi-structured | structured | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel
Binding: KnowledgeRepresentationLevelValues (required)
... artifactComment S0..*(Complex)Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
... versionPolicy S0..1Codingmetadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: Artifact Version Policy Values (extensible): The versioning policy of the artifact

... title S1..1stringName for this {{title}} (human friendly)
URL: http://hl7.org/fhir/StructureDefinition/artifact-title
... url S1..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version S1..1stringBusiness version of the search parameter
... name S1..1stringName for this search parameter (computer friendly)
... status S1..1codedraft | active | retired | unknown
... experimental S1..1booleanFor testing purposes, not real usage
... publisher S0..1stringName of the publisher (organization or individual)
... description S1..1markdownNatural language description of the search parameter

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter C1..1SearchParameterSearch parameter for a resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension 1..*ExtensionExtension
Slice: Unordered, Open by value:url
... knowledgeCapability S0..*codeshareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapabilityValues (required)
... artifactComment S0..*(Complex)Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
... versionAlgorithm S0..1string, CodingHow to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: VersionAlgorithm (extensible): The algorithm used to compare versions for the artifact


... versionPolicy S0..1Codingmetadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: Artifact Version Policy Values (extensible): The versioning policy of the artifact


... title S1..1stringName for this {{title}} (human friendly)
URL: http://hl7.org/fhir/StructureDefinition/artifact-title
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url SΣ1..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version SΣ1..1stringBusiness version of the search parameter
... name SΣC1..1stringName for this search parameter (computer friendly)
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental SΣ1..1booleanFor testing purposes, not real usage
... publisher SΣ0..1stringName of the publisher (organization or individual)
... description SΣ1..1markdownNatural language description of the search parameter
... code Σ1..1codeCode used in URL
... base Σ1..*codeThe resource type(s) this search parameter applies to
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.


... type Σ1..1codenumber | date | string | token | reference | composite | quantity | uri | special
Binding: SearchParamType (required): Data types allowed to be used for search parameters.


doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
SearchParameter.statusrequiredPublicationStatus
SearchParameter.baserequiredResourceType
SearchParameter.typerequiredSearchParamType

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorSearchParameterIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorSearchParameterIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorSearchParameterIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorSearchParameterIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceSearchParameterA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
spd-0warningSearchParameterName should be usable as an identifier for the module by machine processing applications such as code generation
: name.matches('[A-Z]([A-Za-z0-9_]){0,254}')
spd-1errorSearchParameterIf an xpath is present, there SHALL be an xpathUsage
: xpath.empty() or xpathUsage.exists()
spd-2errorSearchParameterSearch parameters can only have chain names when the search parameter type is 'reference'
: chain.empty() or type = 'reference'

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. SearchParameter C1..1SearchParameterSearch parameter for a resource
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension 1..*ExtensionExtension
Slice: Unordered, Open by value:url
... knowledgeCapability S0..*codeshareable | computable | publishable | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeCapability
Binding: KnowledgeCapabilityValues (required)
... knowledgeRepresentationLevel S0..*codenarrative | semi-structured | structured | executable
URL: http://hl7.org/fhir/StructureDefinition/cqf-knowledgeRepresentationLevel
Binding: KnowledgeRepresentationLevelValues (required)
... artifactComment S0..*(Complex)Additional documentation, review, or usage guidance
URL: http://hl7.org/fhir/StructureDefinition/cqf-artifactComment
... versionAlgorithm S0..1string, CodingHow to compare versions
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionAlgorithm
Binding: VersionAlgorithm (extensible): The algorithm used to compare versions for the artifact


... versionPolicy S0..1Codingmetadata | strict
URL: http://hl7.org/fhir/StructureDefinition/artifact-versionPolicy
Binding: Artifact Version Policy Values (extensible): The versioning policy of the artifact


... title S1..1stringName for this {{title}} (human friendly)
URL: http://hl7.org/fhir/StructureDefinition/artifact-title
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... url SΣ1..1uriCanonical identifier for this search parameter, represented as a URI (globally unique)
... version SΣ1..1stringBusiness version of the search parameter
... name SΣC1..1stringName for this search parameter (computer friendly)
... derivedFrom 0..1canonical(SearchParameter)Original definition for the search parameter
... status ?!SΣ1..1codedraft | active | retired | unknown
Binding: PublicationStatus (required): The lifecycle status of an artifact.

... experimental SΣ1..1booleanFor testing purposes, not real usage
... date Σ0..1dateTimeDate last changed
... publisher SΣ0..1stringName of the publisher (organization or individual)
... contact Σ0..*ContactDetailContact details for the publisher
... description SΣ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)
Binding: Jurisdiction ValueSet (extensible): Countries and regions within which this artifact is targeted for use.


... 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
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.


... type Σ1..1codenumber | date | string | token | reference | composite | quantity | uri | special
Binding: SearchParamType (required): Data types allowed to be used for search parameters.

... expression C0..1stringFHIRPath expression that extracts the values
... xpath C0..1stringXPath that extracts the values
... xpathUsage C0..1codenormal | phonetic | nearby | distance | other
Binding: XPathUsageType (required): How a search parameter relates to the set of elements returned by evaluating its xpath query.

... target 0..*codeTypes of resource (if a resource reference)
Binding: ResourceType (required): One of the resource types defined as part of this version of FHIR.


... 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
Binding: SearchComparator (required): What Search Comparator Codes are supported in search.


... modifier 0..*codemissing | exact | contains | not | text | in | not-in | below | above | type | identifier | ofType
Binding: SearchModifierCode (required): A supported modifier for a search parameter.


... chain 0..*stringChained names supported
... component 0..*BackboneElementFor Composite resources to define the parts
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... definition 1..1canonical(SearchParameter)Defines how the part works
.... expression 1..1stringSubexpression relative to main expression

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
SearchParameter.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
SearchParameter.statusrequiredPublicationStatus
SearchParameter.jurisdictionextensibleJurisdiction ValueSet
SearchParameter.baserequiredResourceType
SearchParameter.typerequiredSearchParamType
SearchParameter.xpathUsagerequiredXPathUsageType
SearchParameter.targetrequiredResourceType
SearchParameter.comparatorrequiredSearchComparator
SearchParameter.modifierrequiredSearchModifierCode

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron