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-ViewDefinitionExport.json
FHIR VersionR5
Sourcehttps://build.fhir.org/ig/HL7/sql-on-fhir/OperationDefinition-ViewDefinitionExport.html
URLhttp://hl7.org/fhir/uv/sql-on-fhir/OperationDefinition/ViewDefinitionExport
Version3.0.0-ballot
Statusactive
Date2026-08-05T23:37:23+00:00
NameViewDefinitionExport
TitleViewDefinition Export
Realmuv
Authorityhl7
DescriptionExport a view definition. User can provide view definition references and/or resources as part of the input parameters.
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 ViewDefinitionExport

URL: [base]/$viewdefinition-export

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

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

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INviewsystem, type1..*

One or more ViewDefinitions to export. Each repetition identifies a single view.

INview.name0..1string

Optional friendly name for the exported view output.

INview.viewReference0..1Reference (View Definition)

Reference to a ViewDefinition stored on the server.

INview.viewResource0..1CanonicalResource (View Definition)

Inline ViewDefinition resource to export.

INclientTrackingIdsystem, type0..1string

Client-provided tracking identifier for the export operation.

IN_formatsystem, type0..1codeExport 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).

INheadersystem, type0..1boolean

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

INpatientsystem, type0..*Reference

Filter exported data to the supplied patient(s).

INgroupsystem, type0..*Reference

Filter exported data to members of the supplied group(s).

IN_sincesystem, type0..1instant

Export only resources updated since this instant.

INsourcesystem, type0..1string

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

OUTexportId1..1string

Server-generated identifier assigned to the export request.

OUTclientTrackingId0..1string

Echoed client tracking identifier when provided.

OUTstatus1..1codeExport Status Codes (Required)

Status of the export (accepted, in-progress, completed, cancelled, failed).

OUTlocation1..1uri

URL to poll for export status updates.

OUTcancelUrl0..1uri

Optional URL for cancelling the export.

OUT_format0..1codeOutput Format Codes (Extensible)

Format of the exported files (echoed from input if supplied).

OUTexportStartTime0..1instant

Timestamp when the export operation began.

OUTexportEndTime0..1instant

Timestamp when the export operation completed.

OUTexportDuration0..1integer

Duration of the export in seconds.

OUTestimatedTimeRemaining0..1integer

Estimated seconds remaining until completion.

OUToutput0..*

Output information for each exported view.

OUToutput.name1..1string

Name assigned to the exported view output.

OUToutput.location1..*uri

Download URL(s) for the exported file(s).


Source1

{
  "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"
        }
      ]
    }
  ]
}