FHIR IG analytics| Package | hl7.fhir.uv.sql-on-fhir |
| Resource Type | OperationDefinition |
| Id | OperationDefinition-ViewDefinitionRun.json |
| FHIR Version | R5 |
| Source | https://build.fhir.org/ig/HL7/sql-on-fhir/OperationDefinition-ViewDefinitionRun.html |
| URL | http://hl7.org/fhir/uv/sql-on-fhir/OperationDefinition/ViewDefinitionRun |
| Version | 3.0.0-ballot |
| Status | active |
| Date | 2026-08-05T23:37:23+00:00 |
| Name | ViewDefinitionRun |
| Title | ViewDefinition Run |
| Realm | uv |
| Authority | hl7 |
| Description | Execute a view definition against supplied or server data. |
| Type | true |
| Kind | operation |
No resources found
No resources found
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
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | _format | system, type, instance | 0..1 | code | Output 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). |
| IN | header | system, type, instance | 0..1 | boolean | Include CSV headers (default true). Applies only when csv output is requested. | |
| IN | viewReference | system, type | 0..1 | Reference (View Definition) | Reference to a ViewDefinition stored on the server. | |
| IN | viewResource | system, type | 0..1 | CanonicalResource (View Definition) | Inline ViewDefinition resource to execute. | |
| IN | patient | system, type, instance | 0..1 | Reference | Restrict execution to the specified patient. | |
| IN | group | system, type, instance | 0..* | Reference | Restrict execution to members of the given group(s). | |
| IN | source | system, type, instance | 0..1 | string | External data source to use (for example a URI or bucket name). | |
| IN | resource | system, type, instance | 0..* | 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 | _limit | system, type, instance | 0..1 | integer | Maximum number of rows to return. | |
| IN | _since | system, type, instance | 0..1 | instant | Include only resources modified after this instant. | |
| OUT | return | 1..1 | Binary | 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). |
{
"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"
}
]
}