This project has been archived and is no longer actively maintained or supported. Please contact email@example.com with any questions.
Scorecard App is a
- SMART-on-FHIR App that computes a scorecard for an HL7® FHIR® Patient Record (represented as a Bundle).
- FHIR STU3 (v3.0.1) microservice that only supports a single Operation named
$completenessthat scores a patient record. JSON support only.
git clone https://github.com/mitre/scorecard_app.git bundle install bundle exec ruby app.rb
FHIR $completeness microservice
Access the FHIR microservice at
The FHIR microservice includes a
/metadata and a single
/OperationDefinition/$completeness which is executable via
A sample request for the microservice is available in
/test/sample-request-parameters.json and should be submitted with an HTTP content-type header of
You can optionally enable Implementation Guide (IG) validation of the submitted record using the
ig parameter. Allowable codes are
Access HTML at
The SMART launch and app urls are
Configuring Client ID and Scopes (required for SMART app)
Use of the SMART-on-FHIR app requires that OAuth2 client IDs and scopes for different FHIR servers are stored in the
config.yml file, so the deployed app can be used with multiple FHIR server implementations.
Each entry under
scopes should be a unique substring within
the FHIR server URL (for example,
epic), with the value being the
associated client ID to use or OAuth2 scopes to request.
Configuring Terminology (optional)
The Scorecard App and microservice can optionally use terminology data. To configure the terminology data, follow these instructions.
Deploying to AWS Elastic Beanstalk (optional)
Install the AWS Elastic Beanstalk Command Line Interface. For example, on Mac OS X:
brew install awsebcli
Build and deploy the app:
bundle install eb init eb create scorecard-app-dev --sample eb deploy
Launching the SMART-on-FHIR App
- Using Cerner Millenium
- Create an account on code.cerner.com
- Register a "New App"
- Launch URI:
- Redirect URI:
- App Type:
- FHIR Spec:
- Scopes: select all the Patient Scopes
- Launch URI:
- Select your App under "My Apps"
- Follow the directions and "Begin Testing"
- Using Epic
- Create an account on open.epic.com.
- Navigate to the Launchpad.
- Enter the details:
- Launch URL:
- Redirect URL:
- Launch URL:
- Click "Launch App"
Errors encountered during launch are probably associated with improper configuration of the client ID and scopes.
Copyright 2016-2018 The MITRE Corporation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.