Operation-conceptmap-translate.json

Operation Definition

{
  "resourceType" : "OperationDefinition",
  "id" : "ConceptMap-translate",
  "text" : {
    "status" : "extensions",
    "div" : "<div>!-- Snipped for Brevity --></div>"
  },
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
    "valueInteger" : 1
  },
  {
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
    "valueCode" : "trial-use"
  }],
  "url" : "http://hl7.org/fhir/OperationDefinition/ConceptMap-translate",
  "version" : "4.6.0",
  "name" : "translate",
  "title" : "Concept Translation",
  "status" : "draft",
  "kind" : "operation",
  "date" : "2021-04-15T12:25:09+10:00",
  "publisher" : "HL7 (FHIR Project)",
  "contact" : [{
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.org/fhir"
    },
    {
      "system" : "email",
      "value" : "fhir@lists.hl7.org"
    }]
  }],
  "description" : "Translate a code from one value set to another, based on the existing value set and concept maps resources, and/or other additional knowledge available to the server. \r\n\r\n One (and only one) of the in parameters (code, coding, codeableConcept) must be provided, to identify the code that is to be translated.  \r\n\r\n The operation returns a set of parameters including a 'result' for whether there is an acceptable match, and a list of possible matches. Note that the list of matches may include notes of codes for which mapping is specifically excluded (i.e. 'not-related-to'), so implementers have to check the target.relationship for each match.",
  "affectsState" : false,
  "code" : "translate",
  "resource" : ["ConceptMap"],
  "system" : false,
  "type" : true,
  "instance" : true,
  "parameter" : [{
    "name" : "url",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "A canonical URL for a concept map. The server must know the concept map (e.g. it is defined explicitly in the server's concept maps, or it is defined implicitly by some code system known to the server.",
    "type" : "uri"
  },
  {
    "name" : "conceptMap",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "The concept map is provided directly as part of the request. Servers may choose not to accept concept maps in this fashion.",
    "type" : "ConceptMap"
  },
  {
    "name" : "conceptMapVersion",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "The identifier that is used to identify a specific version of the concept map to be used for the translation. This is an arbitrary value managed by the concept map 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.",
    "type" : "string"
  },
  {
    "name" : "code",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "The code that is to be translated. If a code is provided, a system must be provided",
    "type" : "code"
  },
  {
    "name" : "system",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "The system for the code that is to be translated",
    "type" : "uri"
  },
  {
    "name" : "version",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "The version of the system, if one was provided in the source data",
    "type" : "string"
  },
  {
    "name" : "sourceScope",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Limits the scope of the $translate operation to source codes (ConceptMap.group.element.code) that are members of this value set.",
    "type" : "uri"
  },
  {
    "name" : "coding",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "A coding to translate",
    "type" : "Coding"
  },
  {
    "name" : "codeableConcept",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "A full codeableConcept to validate. The server can translate any of the coding values (e.g. existing translations) as it chooses",
    "type" : "CodeableConcept"
  },
  {
    "name" : "targetScope",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "Limits the scope of the $translate operation to target codes (ConceptMap.group.element.target.code) that are members of this value set.",
    "type" : "uri"
  },
  {
    "name" : "targetSystem",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "identifies a target code system in which a mapping is sought. This parameter is an alternative to the target parameter - only one is required. Searching for any translation to a target code system irrespective of the context (e.g. target valueset) may lead to unsafe results, and it is at the discretion of the server to decide when to support this operation",
    "type" : "uri"
  },
  {
    "name" : "dependency",
    "use" : "in",
    "min" : 0,
    "max" : "*",
    "documentation" : "Another element that may help produce the correct mapping",
    "part" : [{
      "name" : "element",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "The element for this dependency",
      "type" : "uri"
    },
    {
      "name" : "concept",
      "use" : "in",
      "min" : 0,
      "max" : "1",
      "documentation" : "The value for this dependency",
      "type" : "CodeableConcept"
    }]
  },
  {
    "name" : "reverse",
    "use" : "in",
    "min" : 0,
    "max" : "1",
    "documentation" : "If true, then the operation should return all the codes that are mapped to the 'code'/'coding'/'codeableConcept' input parameter. In this case:\n\nThe input code or coding(s) must belong to the target{{Scope}} ValueSet (rather than the source{{Scope}} ValueSet)\n\nAny provided dependency parameters are matched against ConceptMap.group.element.target.product (rather than ConceptMap.group.element.target.dependsOn)",
    "type" : "boolean"
  },
  {
    "name" : "result",
    "use" : "out",
    "min" : 1,
    "max" : "1",
    "documentation" : "True if the concept could be translated successfully. The value can only be true if at least one returned match has a relationship other than 'not-related-to'.",
    "type" : "boolean"
  },
  {
    "name" : "message",
    "use" : "out",
    "min" : 0,
    "max" : "1",
    "documentation" : "Error details, for display to a human. If this is provided when result = true, the message carries hints and warnings (e.g. a note that the matches could be improved by providing additional detail)",
    "type" : "string"
  },
  {
    "name" : "match",
    "use" : "out",
    "min" : 0,
    "max" : "*",
    "documentation" : "A concept in the target value set with a relationship. Note that there may be multiple matches of equal or differing relationships, and the matches may include the 'not-related-to' relationship value which means that there is no translation",
    "part" : [{
      "name" : "relationship",
      "use" : "out",
      "min" : 0,
      "max" : "1",
      "documentation" : "A code indicating the relationship (e.g., equivalent) of the translation, using values from [ConceptMapRelationship](valueset-concept-map-relationship.html)",
      "type" : "code"
    },
    {
      "name" : "concept",
      "use" : "out",
      "min" : 0,
      "max" : "1",
      "documentation" : "The translation outcome. Note that this would never have userSelected = true, since the process of translations implies that the user is not selecting the code (and only the client could know differently)",
      "type" : "Coding"
    },
    {
      "name" : "product",
      "use" : "out",
      "min" : 0,
      "max" : "*",
      "documentation" : "Another element that is the product of this mapping",
      "part" : [{
        "name" : "property",
        "use" : "out",
        "min" : 1,
        "max" : "1",
        "documentation" : "The element for this product",
        "type" : "uri"
      },
      {
        "name" : "value",
        "use" : "out",
        "min" : 1,
        "max" : "1",
        "documentation" : "The value for this product",
        "type" : "uri"
      }]
    },
    {
      "name" : "dependsOn",
      "use" : "out",
      "min" : 0,
      "max" : "*",
      "documentation" : "An element that this mapping depends on",
      "part" : [{
        "name" : "property",
        "use" : "out",
        "min" : 1,
        "max" : "1",
        "documentation" : "The element for this product",
        "type" : "uri"
      },
      {
        "name" : "value",
        "use" : "out",
        "min" : 1,
        "max" : "1",
        "documentation" : "The value for this product",
        "type" : "uri"
      }]
    },
    {
      "name" : "originalMap",
      "use" : "out",
      "min" : 0,
      "max" : "1",
      "documentation" : "The canonical reference to the concept map from which this mapping comes from",
      "type" : "uri"
    }]
  }]
}