This page is part of the FHIR Specification (v1.0.2: DSTU 2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
An allowable parameter combination
{ "resourceType": "StructureDefinition", "id": "conformance-search-parameter-combination", "url": "http://hl7.org/fhir/StructureDefinition/conformance-search-parameter-combination", "name": "An allowable parameter combination", "display": "Search Parameter Combination", "status": "draft", "publisher": "Health Level Seven, Inc. - [WG Name] WG", "contact": [ { "telecom": [ { "system": "other", "value": "http://hl7.org/special/committees/fhir.htm" } ] } ], "date": "2014-04-12", "description": "A container for a single allowable parameter combination.", "fhirVersion": "1.0.2", "mapping": [ { "identity": "v2", "uri": "http://hl7.org/v2", "name": "HL7 v2" }, { "identity": "rim", "uri": "http://hl7.org/v3", "name": "RIM" } ], "kind": "datatype", "constrainedType": "Extension", "abstract": false, "contextType": "resource", "context": [ "Conformance.rest.resource" ], "base": "http://hl7.org/fhir/StructureDefinition/Extension", "snapshot": { "element": [ { "path": "Extension", "short": "An allowable parameter combination", "definition": "A container for a single allowable parameter combination.", "comments": "If a search combination is specified, clients should expect that they must submit that required combination or the search will be unsuccesful. If multiple search parameter combinations are specified, a client may pick between them, and supply the minimal required parameters for any of the combinations.", "min": 0, "max": "*", "base": { "path": "Extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ], "isModifier": false, "mapping": [ { "identity": "v2", "map": "N/A" }, { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.id", "representation": [ "xmlAttr" ], "short": "xml:id (or equivalent in JSON)", "definition": "unique id for the element within a resource (for internal references).", "min": 0, "max": "1", "base": { "path": "Extension.id", "min": 0, "max": "1" }, "type": [ { "code": "id" } ], "mapping": [ { "identity": "rim", "map": "n/a" } ] }, { "path": "Extension.extension", "slicing": { "discriminator": [ "url" ], "ordered": false, "rules": "open" }, "short": "Additional Content defined by implementations", "definition": "May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.", "comments": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.", "alias": [ "extensions", "user content" ], "min": 0, "max": "*", "base": { "path": "Extension.extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ], "mapping": [ { "identity": "rim", "map": "n/a" } ] }, { "path": "Extension.extension", "name": "required", "short": "A required search parameter name", "definition": "A search parameter name in the combination which is required.", "min": 1, "max": "*", "base": { "path": "Extension.extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ], "isModifier": false, "mapping": [ { "identity": "v2", "map": "N/A" }, { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension.id", "representation": [ "xmlAttr" ], "short": "xml:id (or equivalent in JSON)", "definition": "unique id for the element within a resource (for internal references).", "min": 0, "max": "1", "base": { "path": "Extension.id", "min": 0, "max": "1" }, "type": [ { "code": "id" } ], "mapping": [ { "identity": "rim", "map": "n/a" } ] }, { "path": "Extension.extension.extension", "name": "extension", "short": "Extension", "definition": "An Extension", "min": 0, "max": "0", "base": { "path": "Extension.extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ] }, { "path": "Extension.extension.url", "representation": [ "xmlAttr" ], "short": "identifies the meaning of the extension", "definition": "Source of the definition for the extension code - a logical name or a URL.", "comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition should be version specific. This will ideally be the URI for the Resource Profile defining the extension, with the code for the extension after a #.", "min": 1, "max": "1", "base": { "path": "Extension.url", "min": 1, "max": "1" }, "type": [ { "code": "uri" } ], "fixedUri": "required", "mapping": [ { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension.valueString", "short": "Value of extension", "definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).", "min": 1, "max": "1", "base": { "path": "Extension.value[x]", "min": 0, "max": "1" }, "type": [ { "code": "string" } ], "mapping": [ { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension", "name": "optional", "short": "An optional search parameter name", "definition": "A search parameter name in the combination which is optional.", "comments": "If a defined parameter is not listed as a required or optional parameter, the implication is that the parameter is not supported with this combination. Servers may ignore It, though some may return an error if it is used.", "min": 0, "max": "*", "base": { "path": "Extension.extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ], "isModifier": false, "mapping": [ { "identity": "v2", "map": "N/A" }, { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension.id", "representation": [ "xmlAttr" ], "short": "xml:id (or equivalent in JSON)", "definition": "unique id for the element within a resource (for internal references).", "min": 0, "max": "1", "base": { "path": "Extension.id", "min": 0, "max": "1" }, "type": [ { "code": "id" } ], "mapping": [ { "identity": "rim", "map": "n/a" } ] }, { "path": "Extension.extension.extension", "name": "extension", "short": "Extension", "definition": "An Extension", "min": 0, "max": "0", "base": { "path": "Extension.extension", "min": 0, "max": "*" }, "type": [ { "code": "Extension" } ] }, { "path": "Extension.extension.url", "representation": [ "xmlAttr" ], "short": "identifies the meaning of the extension", "definition": "Source of the definition for the extension code - a logical name or a URL.", "comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition should be version specific. This will ideally be the URI for the Resource Profile defining the extension, with the code for the extension after a #.", "min": 1, "max": "1", "base": { "path": "Extension.url", "min": 1, "max": "1" }, "type": [ { "code": "uri" } ], "fixedUri": "optional", "mapping": [ { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension.valueString", "short": "Value of extension", "definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).", "min": 1, "max": "1", "base": { "path": "Extension.value[x]", "min": 0, "max": "1" }, "type": [ { "code": "string" } ], "mapping": [ { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.url", "representation": [ "xmlAttr" ], "short": "identifies the meaning of the extension", "definition": "Source of the definition for the extension code - a logical name or a URL.", "comments": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition should be version specific. This will ideally be the URI for the Resource Profile defining the extension, with the code for the extension after a #.", "min": 1, "max": "1", "base": { "path": "Extension.url", "min": 1, "max": "1" }, "type": [ { "code": "uri" } ], "fixedUri": "http://hl7.org/fhir/StructureDefinition/conformance-search-parameter-combination", "mapping": [ { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.value[x]", "short": "Value of extension", "definition": "Value of extension - may be a resource or one of a constrained set of the data types (see Extensibility in the spec for list).", "min": 0, "max": "0", "base": { "path": "Extension.value[x]", "min": 0, "max": "1" }, "type": [ { "code": "boolean" }, { "code": "integer" }, { "code": "decimal" }, { "code": "base64Binary" }, { "code": "instant" }, { "code": "string" }, { "code": "uri" }, { "code": "date" }, { "code": "dateTime" }, { "code": "time" }, { "code": "code" }, { "code": "oid" }, { "code": "id" }, { "code": "unsignedInt" }, { "code": "positiveInt" }, { "code": "markdown" }, { "code": "Annotation" }, { "code": "Attachment" }, { "code": "Identifier" }, { "code": "CodeableConcept" }, { "code": "Coding" }, { "code": "Quantity" }, { "code": "Range" }, { "code": "Period" }, { "code": "Ratio" }, { "code": "SampledData" }, { "code": "Signature" }, { "code": "HumanName" }, { "code": "Address" }, { "code": "ContactPoint" }, { "code": "Timing" }, { "code": "Reference" }, { "code": "Meta" } ], "mapping": [ { "identity": "rim", "map": "N/A" } ] } ] }, "differential": { "element": [ { "path": "Extension", "short": "An allowable parameter combination", "definition": "A container for a single allowable parameter combination.", "comments": "If a search combination is specified, clients should expect that they must submit that required combination or the search will be unsuccesful. If multiple search parameter combinations are specified, a client may pick between them, and supply the minimal required parameters for any of the combinations.", "min": 0, "max": "*", "type": [ { "code": "Extension" } ], "isModifier": false, "mapping": [ { "identity": "v2", "map": "N/A" }, { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension", "name": "required", "short": "A required search parameter name", "definition": "A search parameter name in the combination which is required.", "min": 1, "max": "*", "type": [ { "code": "Extension" } ], "isModifier": false, "mapping": [ { "identity": "v2", "map": "N/A" }, { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension.extension", "name": "extension", "max": "0" }, { "path": "Extension.extension.url", "type": [ { "code": "uri" } ], "fixedUri": "required" }, { "path": "Extension.extension.value[x]", "min": 1, "type": [ { "code": "string" } ] }, { "path": "Extension.extension", "name": "optional", "short": "An optional search parameter name", "definition": "A search parameter name in the combination which is optional.", "comments": "If a defined parameter is not listed as a required or optional parameter, the implication is that the parameter is not supported with this combination. Servers may ignore It, though some may return an error if it is used.", "min": 0, "max": "*", "type": [ { "code": "Extension" } ], "isModifier": false, "mapping": [ { "identity": "v2", "map": "N/A" }, { "identity": "rim", "map": "N/A" } ] }, { "path": "Extension.extension.extension", "name": "extension", "max": "0" }, { "path": "Extension.extension.url", "type": [ { "code": "uri" } ], "fixedUri": "optional" }, { "path": "Extension.extension.value[x]", "min": 1, "type": [ { "code": "string" } ] }, { "path": "Extension.url", "type": [ { "code": "uri" } ], "fixedUri": "http://hl7.org/fhir/StructureDefinition/conformance-search-parameter-combination" }, { "path": "Extension.value[x]", "min": 0, "max": "0" } ] } }
Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.