Skip to main content

Standalone Launch

In standalone launch mode the application is opened directly (not from within an EHR), so there is no pre-set patient context. The user authenticates first, then selects a patient.

Differences from EHR launch

AspectEHR LaunchStandalone Launch
Entry pointGET /launch?iss=...&launch=...GET /launch?iss=... (no launch)
Patient contextPre-set by EHRUser selects after auth
launch scopelaunchlaunch/patient
needPatientBannerFrom token responseAlways true

Configuration

smart:
epic:
scopes: openid fhirUser launch/patient patient/Patient.rs patient/Condition.rs

For standalone launch, omit launch from scopes and add launch/patient instead. Epic will show a patient picker after the clinician authenticates.

Patient context extraction

In standalone launch, the patient field in the token response is set after patient selection. SmartContextExtractor handles both cases:

String patientId = tokenResponse.getExtra("patient");
boolean needBanner = patientId != null;

The rest of the application behaves identically to EHR launch once SmartLaunchContext is populated.


Next: FHIR Client →