Operation-valueset-expand.json

Operation Definition

{
  "resourceType": "OperationDefinition",
  "id": "ValueSet-expand",
  "text": {
    "status": "generated",
    "div": "<div>!-- Snipped for Brevity --></div>"
  },
  "url": "http://hl7.org/fhir/OperationDefinition/ValueSet-expand",
  "name": "Value Set Expansion",
  "publisher": "HL7 (FHIR Project)",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "http://hl7.org/fhir"
        },
        {
          "system": "email",
          "value": "fhir@lists.hl7.org"
        }
      ]
    }
  ],
  "description": "The definition of a value set is used to create a simple collection of codes suitable for use for data entry or validation. \n\nIf the operation is not called at the instance level, one of the in parameters identifier or valueset must be provided.\n\nAn expanded value set will be returned, or an OperationOutcome with an error message",
  "status": "draft",
  "date": "2015-03-27T00:13:00+11:00",
  "kind": "operation",
  "code": "expand",
  "notes": "The value set expansion returned by this query should be treated as a transient result that will change over time (whether it does or not depends on how the value set is specified), so applications should repeat the operation each time the value set is used. \n\nDifferent servers may return different results from expanding a value set for the following reasons:\n\n* The underlying code systems are different (e.g. different versions, possibly with different defined behaviour)\n* The server optimises filter includes differently, such as sorting by code frequency\n* Servers introduce arbitrary groups to assist a user to navigate the lists based either on extensions in the definition, or additional knowledge available to the server",
  "system": false,
  "type": [
    "ValueSet"
  ],
  "instance": true,
  "parameter": [
    {
      "name": "identifier",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "A logical value set identifier (i.e. ValueSet.identifier). The server must know the value set (e.g. it is defined explicitly in the server's valuesets, or it is defined implicitly by some code system known to the server",
      "type": "uri"
    },
    {
      "name": "valueSet",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "The value set is provided directly as part of the request. Servers may choose not to accept value sets in this fashion",
      "type": "ValueSet"
    },
    {
      "name": "filter",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "A text filter that is applied to restrict the codes that are returned (this is useful in a UI context)",
      "type": "string"
    },
    {
      "name": "profile",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "A reference to an external definition that provides additional control information about how the expansion is performed.\n\nAt this time, there is no agreed format or funtionality for the target of this URI. The [VSAC Documentation](http://www.nlm.nih.gov/vsac/support/authorguidelines/updatingvaluesets.html) provides one example of the use of this parameter.  Implementers using this element will need to agree on an appropriate mechanism for use within their interoperability community",
      "type": "uri"
    },
    {
      "name": "date",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "The date for which the expansion should be generated. Normally, this is the current conditions (which is the default value) but under some circumstances, systems need to generate an expansion as it would have been in the past. A typical example of this would be where code selection is constrained to the set of codes that were available when the patient was treated, not when the record is being edited. Note that which date is appropriate is a matter for implementation policy.",
      "type": "dateTime"
    },
    {
      "name": "return",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "The result of the expansion",
      "type": "ValueSet"
    }
  ]
}