FHIR © HL7.org  |  Server Home  |  XIG Home  |  Server Source  |  FHIR  

FHIR IG Statistics: OperationDefinition/daf-execute-query

Packagehl7.fhir.us.daf
TypeOperationDefinition
Iddaf-execute-query
FHIR VersionR3
Sourcehttp://hl7.org/fhir/us/daf/OperationDefinition-daf-execute-query.html
URLhttp://hl7.org/fhir/us/daf-research/OperationDefinition/daf-execute-query
Version1.0.0
Statusdraft
Date2016-07-24
NameExecute Query
Realmus
Authorityhl7
DescriptionThe purpose of this operation is to enable composition and execution of a query in a research setting.Please refer to the Implementation Guidance for further information on how to use the task and execute-query operation together for querying research research data marts.
Typefalse
Kindoperation

Resources that use this resource

CapabilityStatement
daf-research-queryrequesterResearch Query Requester
daf-research-queryresponderResearch Query Responder

Resources that this resource uses

No resources found


Narrative

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

Execute Query

OPERATION: Execute Query

The official URL for this operation definition is:

http://hl7.org/fhir/us/daf-research/OperationDefinition/daf-execute-query

The purpose of this operation is to enable composition and execution of a query in a research setting.Please refer to the Implementation Guidance for further information on how to use the task and execute-query operation together for querying research research data marts.

URL: [base]/$execute-query

Parameters

UseNameCardinalityTypeBindingDocumentation
INqueryformat1..1CodeableConcept

The format of the actual query (e.g SAS, SQL).This will be used by the Data Marts to determine how to execute the query.

INqueryFormatVersion1..1string

The version of the queryFormat that was used to construct the query.

INdataModel1..1CodeableConcept

The data model that was used to construct the query.

INquerypackage1..1string

The actual query string.

INinstructions0..1string

The actual query string.

INqueryResultsPhiDisclosureLevel0..1string

The parameter indicates whether Aggregate, De-Identified, Patient Level data is expected as part of the query results. By default only aggregate data would be returned.

OUTreturn0..1Bundle

A Bundle containing the resulting data.

OUTissues0..1OperationOutcome

A list of hints and warnings about problems encountered while executing the query. These might be shown to the user as an advisory note. Note: if the query cannot be executed at all, then the operation should fail, and an OperationOutcome is returned directly with the failure, rather than using this parameter.

Pilots underway in PCORNet


Source

{
  "resourceType": "OperationDefinition",
  "id": "daf-execute-query",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "url": "http://hl7.org/fhir/us/daf-research/OperationDefinition/daf-execute-query",
  "version": "1.0.0",
  "name": "Execute Query",
  "status": "draft",
  "kind": "operation",
  "date": "2016-07-24",
  "description": "The purpose of this operation is to enable composition and execution of a query in a research setting.Please refer to the Implementation Guidance for further information on how to use the task and execute-query operation together for querying research research data marts.",
  "code": "execute-query",
  "comment": "Pilots underway in PCORNet",
  "base": {
    "reference": "OperationDefinition/daf-execute-query"
  },
  "system": true,
  "type": false,
  "instance": false,
  "parameter": [
    {
      "name": "queryformat",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The format of the actual query (e.g SAS, SQL).This will be used by the Data Marts to determine how to execute the query.",
      "type": "CodeableConcept"
    },
    {
      "name": "queryFormatVersion",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The version of the queryFormat that was used to construct the query.",
      "type": "string"
    },
    {
      "name": "dataModel",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The data model that was used to construct the query.",
      "type": "CodeableConcept"
    },
    {
      "name": "querypackage",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The actual query string.",
      "type": "string"
    },
    {
      "name": "instructions",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "The actual query string.",
      "type": "string"
    },
    {
      "name": "queryResultsPhiDisclosureLevel",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "The parameter indicates whether Aggregate, De-Identified, Patient Level data is expected as part of the query results. By default only aggregate data would be returned.",
      "type": "string"
    },
    {
      "name": "return",
      "use": "out",
      "min": 0,
      "max": "1",
      "documentation": "A Bundle containing the resulting data.",
      "type": "Bundle"
    },
    {
      "name": "issues",
      "use": "out",
      "min": 0,
      "max": "1",
      "documentation": "A list of hints and warnings about problems encountered while executing the query. These might be shown to the user as an advisory note. Note: if the query cannot be executed at all, then the operation should fail, and an OperationOutcome is returned directly with the failure, rather than using this parameter.",
      "type": "OperationOutcome"
    }
  ]
}