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

FHIR IG analytics

Packageorg.sql-on-fhir.ig
Resource TypeOperationDefinition
IdOperationDefinition-ViewDefinitionExport.json
FHIR VersionR5
Sourcehttps://build.fhir.org/ig/FHIR/sql-on-fhir-v2/OperationDefinition-ViewDefinitionExport.html
URLhttp://sql-on-fhir.org/OperationDefinition/$viewdefinition-export
Version2.1.0-pre
Statusactive
Date2026-02-04T07:56:19+00:00
NameViewDefinitionExport
TitleViewDefinition Export
Realmuv
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

Reference to a ViewDefinition stored on the server.

INview.viewResource0..1https://sql-on-fhir.org/ig/StructureDefinition/ViewDefinition

Inline ViewDefinition resource to export.

INclientTrackingIdsystem, type0..1string

Client-provided tracking identifier for the export operation.

IN_formatsystem, type0..1codeOutput Format Codes (Extensible)

Bulk export output format (for example csv, ndjson, parquet, json).

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) -->"
  },
  "url": "http://sql-on-fhir.org/OperationDefinition/$viewdefinition-export",
  "version": "2.1.0-pre",
  "name": "ViewDefinitionExport",
  "title": "ViewDefinition Export",
  "status": "active",
  "kind": "operation",
  "date": "2026-02-04T07:56:19+00:00",
  "publisher": "SQL on FHIR Working Group",
  "contact": [
    {
      "name": "SQL on FHIR Working Group",
      "telecom": [
        {
          "system": "url",
          "value": "https://sql-on-fhir.org"
        }
      ]
    }
  ],
  "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"
        },
        {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/operationdefinition-allowed-type",
              "valueUri": "https://sql-on-fhir.org/ig/StructureDefinition/ViewDefinition"
            }
          ],
          "name": "viewResource",
          "use": "in",
          "min": 0,
          "max": "1",
          "documentation": "Inline ViewDefinition resource to export.",
          "type": "Resource"
        }
      ]
    },
    {
      "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 (for example csv, ndjson, parquet, json).",
      "type": "code",
      "binding": {
        "strength": "extensible",
        "valueSet": "https://sql-on-fhir.org/ig/ValueSet/OutputFormatCodes"
      }
    },
    {
      "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": "https://sql-on-fhir.org/ig/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": "https://sql-on-fhir.org/ig/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"
        }
      ]
    }
  ]
}