Build and Test SMART on FHIR Applications

Overview

This page provides the resources and steps for developers to build and test applications using the SMART on FHIR specification.

You can use the SMART on FHIR tutorial page as a reference for SMART applications built with Oracle Health FHIR APIs.

If you are not familiar with FHIR or SMART specifications, see the SMART on FHIR documentation on the SMART Health IT website. The Tutorial section provides an overview of the SMART framework for applications.
Review the FHIR R4 v4.0.1 documentation on the HL7 FHIR website. The executive summary, developer’s introduction, and clinical introduction are recommended.
Review the FHIR R4 REST API endpoints for information on the Oracle Health implementation of the FHIR standard. Develop your application for R4 as DSTU 2 is being retired.
Review the SMART page for information on the Oracle Health SMART framework. If you plan to use SMART to open your application from PowerChart (PowerChart.exe) with a patient selected, then ensure that your launch supports both of the following access points: the PowerChart table of contents (TOC) and an MPages component embedded in PowerChart.

Complete the following steps to build and test a SMART on FHIR application:

Use the open endpoint to access the sandbox without authentication. See the Open Sandbox section of the Service Root URL page for more information. This endpoint is recommended for initial proof of concepts and integration.

Note: The open endpoint exposes read-only resources. Writes are available only when using authentication.
If you encounter issues as you create your application, you can post questions on the Oracle Health Developer Forums. Questions and answers are also available to view on the archived Oracle Cerner FHIR Developers Google group.
When you are ready to test your application against the authenticated endpoint, review the Authorization Framework page.
Register your application in code Console to test the authentication and use of all the declared scopes. code Console requires a CernerCare account, which you can create upon initial use. For provider-facing applications, you can select any patient from a list of patients in the sandbox environment to begin testing. After selecting a patient to test, you can open your application from a new browser window in code Console.
Once your application is registered in code Console, you can use the authenticated endpoint (secure sandbox) to test the authentication and use of all declared scopes. See the Secure Sandbox section of the Service Root URL page for more information.

Build and Test SMART on FHIR Applications

F99981-01

June 2024

Primary Author: Oracle Corporation