This app would be for Patients where they are be able to receive and respond to requests from their care-team by generating and submitting results, right from their device, and, all– in the FHIR Format. While this is an iOS version, we also have a React-Native version for Android and the Web built on similar principles.
$ git clone --recursive https://github.com/SMARTMarkers/demo-patientapp- Get SMART on FHIR Server endpoints from
https://launch.smarthealthit.org. SelectPatient Standalone Launchas the launch type. FHIR Version:R4. And finally select one patient from the drop down list. Finally, copy theFHIR Server Urlto be configured in the app`
(1) Import SMART Markers framework into the project directory, and, as a module in project files------ this is a simple one liner.
lazy var fhir: FHIRManager! = {
// Obtained form SMART Sandbox: https://launch.smarthealthit.org
let fhir_endpoint = "https://launch.smarthealthit.org/v/r4/sim/eyJrIjoiMSIsImIiOiJmYzIwMGZhMi0xMmM5LTQyNzYtYmE0YS1lMDYwMWQ0MjRlNTUifQ/fhir"
let settings = [
"client_name" : "appDemo",
"client_id" : "appDemo-id",
"redirect" : "smartmarkers-home://smartcallback",
"scope" : "openid profile user/*.* launch"
]
let client = Client(baseURL: URL(string: fhir_endpoint)!, settings: settings)
client.authProperties.granularity = .tokenOnly
return FHIRManager(main: client, promis: PROMISClient.New())
}()
func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
if fhir.main.awaitingAuthCallback {
return fhir.main.didRedirect(to: url)
}
if url.scheme == "smpro" {
fhir.callbackManager?.handleRedirect(url: url)
}
return false
}let fhr = (UIApplication.shared.delegate as! AppDelegate).fhir
return fhr
manager?.authorize { [weak self] (success, userName, error) in
if success {
if let patientName = userName {
self?.title = patientName
}
}
else {
if let error = error {
self?.showMsg(msg: "Authorization Failed.\n\(error.asOAuth2Error.localizedDescription)")
}
}
}guard let patient = manager?.patient else { return }
self.title = "Loading.."
TaskController.Requests(requestType: ServiceRequest.self,
for: patient,
server: manager!.main.server,
instrumentResolver: self) { [weak self] (taskcontrollers, error) in
DispatchQueue.main.async {
// Update the UI
if let taskcontrollers = taskcontrollers {
self?.tasks = self?.sort(taskcontrollers)
}
if nil != error { print(error! as Any) }
self?.markStandby()
}
}(5) Lets now take a deeper look at one Request and its data in a different View - DetailViewController
Lets add some code for show request metadata.
title = "REQ: #" + (task.request?.rq_identifier ?? "-")
graphView.title = task.instrument?.sm_title ?? task.request?.rq_title ?? "-"
graphView.subTitle = (task.request?.rq_categoryCode ?? "CODE: --")I'd like to show its identifier, request date, and the terminology code if any.
We also want to list any results that were submited previously, as part of this request
let result = reports![indexPath.row]
cell.textLabel?.text = "\(result.rp_date.shortDate): \(result.rp_description ?? "--")"
cell.detailTextLabel?.text = result.rp_observation ?? nil5.3: If I want to further explore the FHIR resource, the framework has built in Viewers that can be readily reused.
let report = reports![indexPath.row]
if let viewer = report.rp_viewController {
self.show(viewer, sender: nil)
} var sessionController : SessionController?
sessionController = SessionController([task],
patient: manager.patient!,
server: manager.main.server)
sessionController?.prepareController(callback: { (controller, error) in
if let controller = controller {
controller.view.tintColor = .red
self.present(controller, animated: true, completion: nil)
}
else if let error = error {
self.showMsg(msg: "Error occurred when creating a session\n\(error.localizedDescription)")
}
})
sessionController?.onConclusion = { [weak self] session in
self?.reload()
}Of course, we need some error handling.
extension DetailViewController : SessionControllerDelegate {
func sessionEnded(_ session: SessionController, taskViewController: ORKTaskViewController, reason: ORKTaskViewControllerFinishReason, error: Error?) {
if let error = error {
print(error as Any)
print(reason.rawValue)
}
reload()
}
func sessionShouldBegin(_ session: SessionController, taskViewController: ORKTaskViewController, reason: ORKTaskViewControllerFinishReason, error: Error?) -> Bool {
return true
}
}This is a standalone patient facing iOS app built on the SMART on FHIR open specification and powered by the SMART Markers [framework] to receive and respond to practitioner's requests with PGHD data generated through survey like modules in-app. Built using Swift for iOS.
The app relies on the SMART Markers framework's supported PGHD instruments to create a data generating user session. Many types of instruments are supported out of the box with more being actively developed. Some examples include: FHIR Questionnaire encoded surveys, PROMIS CAT surveys, activity data, sensor based activity tests and more. Check here for a complete list.
- Users can login to their SMART enabled health system
- Fetch all practitioner dispatched requests for data
- Users generate or aggregate health data as per the request and/or the Instrument requested
- Users submit data to their health systems through the app.
- You will need Xcode version 11.3 and Swift 5.0 and a
FHIR Serverendpoints and optionally their SMART credentials. - Clone repository:
$ git clone --recursive https://github.com/smartmarkers/demo-patientapp - Make sure SMARTMarkers and its submodules are downloaded
- Add SMARTMarkers.xcodeproj, ResearchKit.xcodeproj, SMART.xcodeproj to the application's project workspace
- Compile ResearchKit and SMARTMarkers.xcodeproj
- Go to Project Settings -> General Tab and add the three frameworks and HealthKit to the
Frameworks, Libraries, and Embedded Content. - Build and run the app
This app was built on top of the SMART Markers framework but with its own custom interface and user experience designed specifically for PROMIS instruments and has now expanded to include various instruments enabled by the framework. ResearchKit and SwiftSMART are used as its submodules