TaskController

TaskController

Controller class that can be instantiated from either a Request conformant FHIR resource or an Instrument type with three main functions.

1. Controller handles ResearchKit user session for generating patient generated data producing an output FHIR Bundle.
2. Controller.reports holds historical FHIR resources generated as a response to the Instrument fetched from the FHIR Server, relying on the Instrument specified code and search parameters.
3. Controller enqueues newly generated FHIR output to be "ready" for submission.

TaskController can be instantiated with a Request type or an Instrument type. If initialized with a request, it will try to resolve the instrument embedded with the request FHIR resource.

import SMARTMarkers

// Grab an instrument
let instrument = Instruments.ActiveTasks.AmslerGrid.instance

// Instantiate TaskController with an Instrument; An instance or type should hold onto the variable
self.controller = TaskController(instrument: instrument)

// prepare User Session Task Controller; powered by ResearchKit
controller.prepareSession() { taskViewController, error in 

    if let taskViewController = taskViewController { 
        self.present(taskViewController, animated: true, completion: nil)
    } 
    else { 
        // check error:
        smLog(error)
    } 
} 

// Session completion callback; the submissionBundle is retained by the receiver 
controller.onTaskCompletion = { submissionBundle, error in 
    if let submissionBundle = submissionBundle { 
        // Output: FHIR Bundle 
        smLog(submissionBundle.bundle)
    } 
    else { 
        smLog(error)
    }
}

Multiple PGHD Sessions

An array of PDControllers can be passed onto SessionController to create a unified session for multiple back to back task. Also included is a SubmissionsController– a ResearchKit based ORKTaskViewController module to seek explicit permission before submitted the generated data to the FHIR Server.

Check ➔SessionController for more.

Also relevant: Protocols

1. ➔ Request
2. ➔ Instrument
3. ➔ Report