FHIR IG analytics| Package | hl7.fhir.uv.sql-on-fhir |
| Resource Type | OperationDefinition |
| Id | OperationDefinition-ViewDefinitionExport.json |
| FHIR Version | R5 |
| Source | https://build.fhir.org/ig/HL7/sql-on-fhir/OperationDefinition-ViewDefinitionExport.html |
| URL | http://hl7.org/fhir/uv/sql-on-fhir/OperationDefinition/ViewDefinitionExport |
| Version | 3.0.0-ballot |
| Status | active |
| Date | 2026-08-05T23:37:23+00:00 |
| Name | ViewDefinitionExport |
| Title | ViewDefinition Export |
| Realm | uv |
| Authority | hl7 |
| Description | Export a view definition. User can provide view definition references and/or resources as part of the input parameters. |
| Type | true |
| Kind | operation |
No resources found
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: OperationDefinition ViewDefinitionExport
URL: [base]/$viewdefinition-export
URL: [base]/CanonicalResource/$viewdefinition-export
URL: [base]/CanonicalResource/[id]/$viewdefinition-export
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | view | system, type | 1..* | One or more ViewDefinitions to export. Each repetition identifies a single view. | ||
| IN | view.name | 0..1 | string | Optional friendly name for the exported view output. | ||
| IN | view.viewReference | 0..1 | Reference (View Definition) | Reference to a ViewDefinition stored on the server. | ||
| IN | view.viewResource | 0..1 | CanonicalResource (View Definition) | Inline ViewDefinition resource to export. | ||
| IN | clientTrackingId | system, type | 0..1 | string | Client-provided tracking identifier for the export operation. | |
| IN | _format | system, type | 0..1 | code | Export Output Format Codes (Extensible) | Bulk export output format (csv, ndjson, parquet, json). Optional; if omitted, the server returns ndjson by default. See Common Operation Behavior (operations-common.html). |
| IN | header | system, type | 0..1 | boolean | Include CSV headers (default true). Applies only when csv output is requested. | |
| IN | patient | system, type | 0..* | Reference | Filter exported data to the supplied patient(s). | |
| IN | group | system, type | 0..* | Reference | Filter exported data to members of the supplied group(s). | |
| IN | _since | system, type | 0..1 | instant | Export only resources updated since this instant. | |
| IN | source | system, type | 0..1 | string | External data source to use for the export (for example a URI or bucket name). | |
| OUT | exportId | 1..1 | string | Server-generated identifier assigned to the export request. | ||
| OUT | clientTrackingId | 0..1 | string | Echoed client tracking identifier when provided. | ||
| OUT | status | 1..1 | code | Export Status Codes (Required) | Status of the export (accepted, in-progress, completed, cancelled, failed). | |
| OUT | location | 1..1 | uri | URL to poll for export status updates. | ||
| OUT | cancelUrl | 0..1 | uri | Optional URL for cancelling the export. | ||
| OUT | _format | 0..1 | code | Output Format Codes (Extensible) | Format of the exported files (echoed from input if supplied). | |
| OUT | exportStartTime | 0..1 | instant | Timestamp when the export operation began. | ||
| OUT | exportEndTime | 0..1 | instant | Timestamp when the export operation completed. | ||
| OUT | exportDuration | 0..1 | integer | Duration of the export in seconds. | ||
| OUT | estimatedTimeRemaining | 0..1 | integer | Estimated seconds remaining until completion. | ||
| OUT | output | 0..* | Output information for each exported view. | |||
| OUT | output.name | 1..1 | string | Name assigned to the exported view output. | ||
| OUT | output.location | 1..* | uri | Download URL(s) for the exported file(s). |
{
"resourceType": "OperationDefinition",
"id": "ViewDefinitionExport",
"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/ViewDefinitionExport",
"identifier": [
{
"system": "urn:ietf:rfc:3986",
"value": "urn:oid:2.16.840.1.113883.4.642.40.77.33.3"
}
],
"version": "3.0.0-ballot",
"name": "ViewDefinitionExport",
"title": "ViewDefinition Export",
"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": "Export a view definition. User can provide view definition references and/or resources as part of the input parameters.",
"jurisdiction": [
{
"coding": [
{
"system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code": "001",
"display": "World"
}
]
}
],
"code": "viewdefinition-export",
"resource": [
"CanonicalResource"
],
"system": true,
"type": true,
"instance": true,
"parameter": [
{
"name": "view",
"use": "in",
"scope": [
"system",
"type"
],
"min": 1,
"max": "*",
"documentation": "One or more ViewDefinitions to export. Each repetition identifies a single view.",
"part": [
{
"name": "name",
"use": "in",
"min": 0,
"max": "1",
"documentation": "Optional friendly name for the exported view output.",
"type": "string"
},
{
"name": "viewReference",
"use": "in",
"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",
"min": 0,
"max": "1",
"documentation": "Inline ViewDefinition resource to export.",
"type": "CanonicalResource",
"targetProfile": [
"http://hl7.org/fhir/uv/sql-on-fhir/StructureDefinition/ViewDefinition"
]
}
]
},
{
"name": "clientTrackingId",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "1",
"documentation": "Client-provided tracking identifier for the export operation.",
"type": "string"
},
{
"name": "_format",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "1",
"documentation": "Bulk export output format (csv, ndjson, parquet, json). 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/ExportOutputFormatCodes"
}
},
{
"name": "header",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "1",
"documentation": "Include CSV headers (default true). Applies only when csv output is requested.",
"type": "boolean"
},
{
"name": "patient",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "*",
"documentation": "Filter exported data to the supplied patient(s).",
"type": "Reference"
},
{
"name": "group",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "*",
"documentation": "Filter exported data to members of the supplied group(s).",
"type": "Reference"
},
{
"name": "_since",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "1",
"documentation": "Export only resources updated since this instant.",
"type": "instant"
},
{
"name": "source",
"use": "in",
"scope": [
"system",
"type"
],
"min": 0,
"max": "1",
"documentation": "External data source to use for the export (for example a URI or bucket name).",
"type": "string"
},
{
"name": "exportId",
"use": "out",
"min": 1,
"max": "1",
"documentation": "Server-generated identifier assigned to the export request.",
"type": "string"
},
{
"name": "clientTrackingId",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Echoed client tracking identifier when provided.",
"type": "string"
},
{
"name": "status",
"use": "out",
"min": 1,
"max": "1",
"documentation": "Status of the export (accepted, in-progress, completed, cancelled, failed).",
"type": "code",
"binding": {
"strength": "required",
"valueSet": "http://hl7.org/fhir/uv/sql-on-fhir/ValueSet/ExportStatusCodes"
}
},
{
"name": "location",
"use": "out",
"min": 1,
"max": "1",
"documentation": "URL to poll for export status updates.",
"type": "uri"
},
{
"name": "cancelUrl",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Optional URL for cancelling the export.",
"type": "uri"
},
{
"name": "_format",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Format of the exported files (echoed from input if supplied).",
"type": "code",
"binding": {
"strength": "extensible",
"valueSet": "http://hl7.org/fhir/uv/sql-on-fhir/ValueSet/OutputFormatCodes"
}
},
{
"name": "exportStartTime",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Timestamp when the export operation began.",
"type": "instant"
},
{
"name": "exportEndTime",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Timestamp when the export operation completed.",
"type": "instant"
},
{
"name": "exportDuration",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Duration of the export in seconds.",
"type": "integer"
},
{
"name": "estimatedTimeRemaining",
"use": "out",
"min": 0,
"max": "1",
"documentation": "Estimated seconds remaining until completion.",
"type": "integer"
},
{
"name": "output",
"use": "out",
"min": 0,
"max": "*",
"documentation": "Output information for each exported view.",
"part": [
{
"name": "name",
"use": "out",
"min": 1,
"max": "1",
"documentation": "Name assigned to the exported view output.",
"type": "string"
},
{
"name": "location",
"use": "out",
"min": 1,
"max": "*",
"documentation": "Download URL(s) for the exported file(s).",
"type": "uri"
}
]
}
]
}