DAF Research Implementation Guide v2.0.0 (STU2)

OperationDefinition-daf-extract

Formats: XML, JSON, Turtle

Extract Data

OPERATION: Extract Data

The official URL for this operation definition is: 

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

The purpose of this operation is to enable data extraction from Clinical Data Sources (e.g EMRs) for Research Purposes. The extracted data will be de-identified and mapped from FHIR to the destination data model and then loaded into the data mart according to the local work flows. The work flow information is captured as part of the task which executes the extract operation. Please refer to the Implementation Guidance for further information on how to use the task and extract operation together for research work flows.

URL: [base]/$extract-operation

Parameters

UseNameCardinalityTypeBindingDocumentation
INtimereference1..1Period

This is the reference time based on which the extraction program will retrieve data for only those patients whose records have been created/updated based on the reference time. If only start is provided as part of the Period, then all records created/updated after the start time are extracted. If both start and end are provided, then only those records which have been created/updated between the start and end times of the Period are extracted.

INgroup0..1Reference

When a Group is specified, the extraction program needs to only extract the data for the patients that are part of the cohort group.Either the Group or an individual patient has to be specified for data extraction.

INpatient0..1Reference

When a Patient is specified, the extraction program needs to only extract the data for a specific patient.Either the Group or an individual patient has to be specified for data extraction.

OUTreturn0..1Bundle

The results of the extraction would provide the data for each patient whose data has been created/updated based on the referenceTime. This data will be in the form of a Bundle which has all the resources that are pertinent for each patient whose data has been extracted.

OUTissues0..1OperationOutcome

A list of hints and warnings about problems encountered while extracting the data. These might be show to the user as an advisory note. Note: if the extraction cannot be performed 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