This page is part of the FHIR Specification (v4.5.0: R5 Preview #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
FHIR Infrastructure Work Group | Maturity Level: N/A | Standards Status: Informative | Compartments: Not linked to any defined compartments |
Raw Turtle (+ also see Turtle/RDF Format Specification)
Operation Definition
@prefix fhir: <http://hl7.org/fhir/> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . # - resource ------------------------------------------------------------------- [] a fhir:OperationDefinition; fhir:Resource.id [ fhir:value "NamingSystem-preferred-id"]; fhir:DomainResource.text [ fhir:Narrative.status [ fhir:value "extensions" ] ]; fhir:DomainResource.extension [ fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm" ]; fhir:Extension.value [ fhir:value "1" ] ], [ fhir:Extension.url [ fhir:value "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status" ]; fhir:Extension.value [ fhir:value "trial-use" ] ]; fhir:CanonicalResource.url [ fhir:value "http://hl7.org/fhir/OperationDefinition/NamingSystem-preferred-id"]; fhir:CanonicalResource.version [ fhir:value "4.5.0"]; fhir:CanonicalResource.name [ fhir:value "Fetch Preferred it"]; fhir:CanonicalResource.status [ fhir:value "draft"]; fhir:CanonicalResource.date [ fhir:value "2020-08-20T17:41:31+10:00"]; fhir:CanonicalResource.publisher [ fhir:value "HL7 (FHIR Project)"]; fhir:CanonicalResource.contact [ fhir:ContactDetail.telecom [ fhir:ContactPoint.system [ fhir:value "url" ]; fhir:ContactPoint.value [ fhir:value "http://hl7.org/fhir" ] ], [ fhir:ContactPoint.system [ fhir:value "email" ]; fhir:ContactPoint.value [ fhir:value "fhir@lists.hl7.org" ] ] ]; fhir:CanonicalResource.description [ fhir:value "This operation returns the preferred identifiers for identifiers, and terminologies. The operation takes 2 parameters: \n\n* a system identifier - either a URI, an OID, or a v2 table 0396 (other) code \n* a code for what kind of identifier is desired (URI, OID, v2 table 0396 identifier) \n\nand returns either the requested identifier, or an HTTP errors response with an OperationOutcome because either the provided identifier was not recognized, or the requested identiifer type is not known. \n\nThe principle use of this operation is when converting between v2, CDA and FHIR Identifier/CX/II and CodeableConcepts/C(N/W)E/CD but the operation may also find use when converting metadata such as profiles."]; fhir:OperationDefinition.url [ fhir:value "http://hl7.org/fhir/OperationDefinition/NamingSystem-preferred-id"]; fhir:OperationDefinition.version [ fhir:value "4.5.0"]; fhir:OperationDefinition.name [ fhir:value "Fetch Preferred it"]; fhir:OperationDefinition.status [ fhir:value "draft"]; fhir:OperationDefinition.kind [ fhir:value "operation"]; fhir:OperationDefinition.date [ fhir:value "2020-08-20T17:41:31+10:00"]; fhir:OperationDefinition.publisher [ fhir:value "HL7 (FHIR Project)"]; fhir:OperationDefinition.contact [ fhir:ContactDetail.telecom [ fhir:ContactPoint.system [ fhir:value "url" ]; fhir:ContactPoint.value [ fhir:value "http://hl7.org/fhir" ] ], [ fhir:ContactPoint.system [ fhir:value "email" ]; fhir:ContactPoint.value [ fhir:value "fhir@lists.hl7.org" ] ] ]; fhir:OperationDefinition.description [ fhir:value "This operation returns the preferred identifiers for identifiers, and terminologies. The operation takes 2 parameters: \n\n* a system identifier - either a URI, an OID, or a v2 table 0396 (other) code \n* a code for what kind of identifier is desired (URI, OID, v2 table 0396 identifier) \n\nand returns either the requested identifier, or an HTTP errors response with an OperationOutcome because either the provided identifier was not recognized, or the requested identiifer type is not known. \n\nThe principle use of this operation is when converting between v2, CDA and FHIR Identifier/CX/II and CodeableConcepts/C(N/W)E/CD but the operation may also find use when converting metadata such as profiles."]; fhir:OperationDefinition.code [ fhir:value "preferred-id"]; fhir:OperationDefinition.comment [ fhir:value "Servers handle this request by finding the provided identifier in their known naming systems, and returning the requested identifier type ([NamingSystem.uniqueId.type](namingsystem-definitions.html#NamingSystem.uniqueId.type)). If there are multiple possible identifiers of the specified type (e.g. multiple OIDs) the server returns an error. \n\nIf the server wishes, it can also look through all code systems and value sets it knows about when attempting to find the requested identifier"]; fhir:OperationDefinition.resource [ fhir:value "NamingSystem"]; fhir:OperationDefinition.system [ fhir:value "false"]; fhir:OperationDefinition.type [ fhir:value "true"]; fhir:OperationDefinition.instance [ fhir:value "false"]; fhir:OperationDefinition.parameter [ fhir:OperationDefinitionParameterComponent.name [ fhir:value "id" ]; fhir:OperationDefinitionParameterComponent.use [ fhir:value "in" ]; fhir:OperationDefinitionParameterComponent.min [ fhir:value "1" ]; fhir:OperationDefinitionParameterComponent.max [ fhir:value "1" ]; fhir:OperationDefinitionParameterComponent.documentation [ fhir:value "The server parses the provided id to see what type it is (mary a URI, an OID as a URI, a plain OID, or a v2 table 0396 code). If the server can't tell what type of identifier it is, it can try it as multiple types. It is an error if more than one system matches the provided identifier" ]; fhir:OperationDefinitionParameterComponent.type [ fhir:value "string" ] ], [ fhir:OperationDefinitionParameterComponent.name [ fhir:value "type" ]; fhir:OperationDefinitionParameterComponent.use [ fhir:value "in" ]; fhir:OperationDefinitionParameterComponent.min [ fhir:value "1" ]; fhir:OperationDefinitionParameterComponent.max [ fhir:value "1" ]; fhir:OperationDefinitionParameterComponent.type [ fhir:value "code" ]; fhir:OperationDefinitionParameterComponent.binding [ fhir:OperationDefinitionParameterBindingComponent.strength [ fhir:value "required" ]; fhir:OperationDefinitionParameterBindingComponent.valueSet [ fhir:value "http://hl7.org/fhir/ValueSet/namingsystem-identifier-type|4.5.0" ] ] ], [ fhir:OperationDefinitionParameterComponent.name [ fhir:value "result" ]; fhir:OperationDefinitionParameterComponent.use [ fhir:value "out" ]; fhir:OperationDefinitionParameterComponent.min [ fhir:value "1" ]; fhir:OperationDefinitionParameterComponent.max [ fhir:value "1" ]; fhir:OperationDefinitionParameterComponent.documentation [ fhir:value "OIDs are return as plain OIDs (not the URI form)." ]; fhir:OperationDefinitionParameterComponent.type [ fhir:value "string" ] ] . # -------------------------------------------------------------------------------------
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.