FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.fhir.uv.sql-on-fhir
Resource TypeOperationDefinition
IdOperationDefinition-ViewDefinitionRun.json
FHIR VersionR5
Sourcehttps://build.fhir.org/ig/HL7/sql-on-fhir/OperationDefinition-ViewDefinitionRun.html
URLhttp://hl7.org/fhir/uv/sql-on-fhir/OperationDefinition/ViewDefinitionRun
Version3.0.0-ballot
Statusactive
Date2026-08-05T23:37:23+00:00
NameViewDefinitionRun
TitleViewDefinition Run
Realmuv
Authorityhl7
DescriptionExecute a view definition against supplied or server data.
Typetrue
Kindoperation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: OperationDefinition ViewDefinitionRun

URL: [base]/$viewdefinition-run

URL: [base]/CanonicalResource/$viewdefinition-run

URL: [base]/CanonicalResource/[id]/$viewdefinition-run

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
IN_formatsystem, type, instance0..1codeOutput Format Codes (Extensible)

Output format for the result (json, ndjson, csv, parquet, fhir). Use fhir to return results as a FHIR Parameters resource. Optional; if omitted, the server returns ndjson by default. See Common Operation Behavior (operations-common.html).

INheadersystem, type, instance0..1boolean

Include CSV headers (default true). Applies only when csv output is requested.

INviewReferencesystem, type0..1Reference (View Definition)

Reference to a ViewDefinition stored on the server.

INviewResourcesystem, type0..1CanonicalResource (View Definition)

Inline ViewDefinition resource to execute.

INpatientsystem, type, instance0..1Reference

Restrict execution to the specified patient.

INgroupsystem, type, instance0..*Reference

Restrict execution to members of the given group(s).

INsourcesystem, type, instance0..1string

External data source to use (for example a URI or bucket name).

INresourcesystem, type, instance0..*Resource

FHIR resources to transform instead of using server data. Repeatable. A Bundle supplied here is unwrapped: the ViewDefinition runs against each Bundle.entry[*].resource rather than against the Bundle itself. See OperationDefinition-ViewDefinitionRun notes (Resource Parameter and Bundle Inputs).

IN_limitsystem, type, instance0..1integer

Maximum number of rows to return.

IN_sincesystem, type, instance0..1instant

Include only resources modified after this instant.

OUTreturn1..1Binary

Transformed data in the requested output format, returned as a raw binary stream in the format's native media type, not a serialized Binary resource envelope. When _format=fhir is requested, the response is a Parameters resource instead. See Common Operation Behavior (operations-common.html).


Source1

{
  "resourceType": "OperationDefinition",
  "id": "ViewDefinitionRun",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "fhir"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "draft",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/uv/sql-on-fhir/ImplementationGuide/hl7.fhir.uv.sql-on-fhir"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/uv/sql-on-fhir/OperationDefinition/ViewDefinitionRun",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.40.77.33.4"
    }
  ],
  "version": "3.0.0-ballot",
  "versionAlgorithmString": "semver",
  "name": "ViewDefinitionRun",
  "title": "ViewDefinition Run",
  "status": "active",
  "kind": "operation",
  "date": "2026-08-05T23:37:23+00:00",
  "publisher": "HL7 International / FHIR Infrastructure",
  "contact": [
    {
      "name": "HL7 International / FHIR Infrastructure",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/fiwg"
        }
      ]
    }
  ],
  "description": "Execute a view definition against supplied or server data.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001",
          "display": "World"
        }
      ]
    }
  ],
  "code": "viewdefinition-run",
  "resource": [
    "CanonicalResource"
  ],
  "system": true,
  "type": true,
  "instance": true,
  "parameter": [
    {
      "name": "_format",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Output format for the result (json, ndjson, csv, parquet, fhir). Use fhir to return results as a FHIR Parameters resource. Optional; if omitted, the server returns ndjson by default. See Common Operation Behavior (operations-common.html).",
      "type": "code",
      "binding": {
        "strength": "extensible",
        "valueSet": "http://hl7.org/fhir/uv/sql-on-fhir/ValueSet/OutputFormatCodes"
      }
    },
    {
      "name": "header",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Include CSV headers (default true). Applies only when csv output is requested.",
      "type": "boolean"
    },
    {
      "name": "viewReference",
      "use": "in",
      "scope": [
        "system",
        "type"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Reference to a ViewDefinition stored on the server.",
      "type": "Reference",
      "targetProfile": [
        "http://hl7.org/fhir/uv/sql-on-fhir/StructureDefinition/ViewDefinition"
      ]
    },
    {
      "name": "viewResource",
      "use": "in",
      "scope": [
        "system",
        "type"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Inline ViewDefinition resource to execute.",
      "type": "CanonicalResource",
      "targetProfile": [
        "http://hl7.org/fhir/uv/sql-on-fhir/StructureDefinition/ViewDefinition"
      ]
    },
    {
      "name": "patient",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Restrict execution to the specified patient.",
      "type": "Reference"
    },
    {
      "name": "group",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "*",
      "documentation": "Restrict execution to members of the given group(s).",
      "type": "Reference"
    },
    {
      "name": "source",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "1",
      "documentation": "External data source to use (for example a URI or bucket name).",
      "type": "string"
    },
    {
      "name": "resource",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "*",
      "documentation": "FHIR resources to transform instead of using server data. Repeatable. A Bundle supplied here is unwrapped: the ViewDefinition runs against each Bundle.entry[*].resource rather than against the Bundle itself. See OperationDefinition-ViewDefinitionRun notes (Resource Parameter and Bundle Inputs).",
      "type": "Resource"
    },
    {
      "name": "_limit",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Maximum number of rows to return.",
      "type": "integer"
    },
    {
      "name": "_since",
      "use": "in",
      "scope": [
        "system",
        "type",
        "instance"
      ],
      "min": 0,
      "max": "1",
      "documentation": "Include only resources modified after this instant.",
      "type": "instant"
    },
    {
      "name": "return",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "Transformed data in the requested output format, returned as a raw binary stream in the format's native media type, not a serialized Binary resource envelope. When _format=fhir is requested, the response is a Parameters resource instead. See Common Operation Behavior (operations-common.html).",
      "type": "Binary"
    }
  ]
}