[{"data":1,"prerenderedAt":825},["ShallowReactive",2],{"navigation_docs":3,"-docs-integrations-fhir-and-smart":586,"-docs-integrations-fhir-and-smart-surround":820},[4,8,46,68,82,148,173,219,256,266,276,313,347,361,379,437,467,481,543,581],{"title":5,"path":6,"stem":7},"Learn EVAL","/docs","docs/0.index",{"title":9,"path":10,"stem":11,"children":12},"Introduction","/docs/introduction","docs/01.introduction/0.index",[13,14,18,22,26,30,34,38,42],{"title":9,"path":10,"stem":11},{"title":15,"path":16,"stem":17},"What is EVAL Health","/docs/introduction/what-is-eval","docs/01.introduction/1.what-is-eval",{"title":19,"path":20,"stem":21},"Key concepts","/docs/introduction/key-concepts","docs/01.introduction/2.key-concepts",{"title":23,"path":24,"stem":25},"Navigating EVAL","/docs/introduction/navigation","docs/01.introduction/3.navigation",{"title":27,"path":28,"stem":29},"Account types and plans","/docs/introduction/account-types","docs/01.introduction/4.account-types",{"title":31,"path":32,"stem":33},"Getting started: clinical providers","/docs/introduction/getting-started-clinician","docs/01.introduction/5.getting-started-clinician",{"title":35,"path":36,"stem":37},"Getting started: building evaluations","/docs/introduction/getting-started-builder","docs/01.introduction/6.getting-started-builder",{"title":39,"path":40,"stem":41},"Getting started: administrators","/docs/introduction/getting-started-admin","docs/01.introduction/7.getting-started-admin",{"title":43,"path":44,"stem":45},"Getting started: patient portal","/docs/introduction/getting-started-patient","docs/01.introduction/8.getting-started-patient",{"title":47,"path":48,"stem":49,"children":50},"Marketplace","/docs/marketplace","docs/02.marketplace/0.index",[51,52,56,60,64],{"title":47,"path":48,"stem":49},{"title":53,"path":54,"stem":55},"Browsing the Marketplace","/docs/marketplace/browsing","docs/02.marketplace/1.browsing",{"title":57,"path":58,"stem":59},"Search","/docs/marketplace/search","docs/02.marketplace/2.search",{"title":61,"path":62,"stem":63},"Collections","/docs/marketplace/collections","docs/02.marketplace/3.collections",{"title":65,"path":66,"stem":67},"Evaluation preview","/docs/marketplace/evaluation-preview","docs/02.marketplace/4.evaluation-preview",{"title":69,"path":70,"stem":71,"children":72},"Library","/docs/library","docs/03.library/0.index",[73,74,78],{"title":69,"path":70,"stem":71},{"title":75,"path":76,"stem":77},"Folders","/docs/library/folders","docs/03.library/1.folders",{"title":79,"path":80,"stem":81},"Folder permissions","/docs/library/permissions","docs/03.library/2.permissions",{"title":83,"path":84,"stem":85,"children":86},"Builder","/docs/builder","docs/04.builder/0.index",[87,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144],{"title":83,"path":84,"stem":85},{"title":89,"path":90,"stem":91},"General tab","/docs/builder/general-tab","docs/04.builder/01.general-tab",{"title":93,"path":94,"stem":95},"Content tab","/docs/builder/content-tab","docs/04.builder/02.content-tab",{"title":97,"path":98,"stem":99},"Sections","/docs/builder/sections","docs/04.builder/03.sections",{"title":101,"path":102,"stem":103},"Questions","/docs/builder/questions","docs/04.builder/04.questions",{"title":105,"path":106,"stem":107},"Question types","/docs/builder/question-types","docs/04.builder/05.question-types",{"title":109,"path":110,"stem":111},"Results and scoring","/docs/builder/results","docs/04.builder/06.results",{"title":113,"path":114,"stem":115},"Formula editor","/docs/builder/formula-editor","docs/04.builder/07.formula-editor",{"title":117,"path":118,"stem":119},"Scenario testing","/docs/builder/scenario-testing","docs/04.builder/08.scenario-testing",{"title":121,"path":122,"stem":123},"Visibility rules","/docs/builder/visibility-rules","docs/04.builder/09.visibility-rules",{"title":125,"path":126,"stem":127},"Publishing","/docs/builder/publishing","docs/04.builder/10.publishing",{"title":129,"path":130,"stem":131},"Evaluations","/docs/builder/evaluations","docs/04.builder/11.evaluations",{"title":133,"path":134,"stem":135},"Media","/docs/builder/media","docs/04.builder/12.media",{"title":137,"path":138,"stem":139},"Error resolution","/docs/builder/error-resolution","docs/04.builder/13.error-resolution",{"title":141,"path":142,"stem":143},"AI Builder","/docs/builder/ai-builder","docs/04.builder/14.ai-builder",{"title":145,"path":146,"stem":147},"Embedded evaluations","/docs/builder/embedded-evaluations","docs/04.builder/15.embedded-evaluations",{"title":129,"path":149,"stem":150,"children":151},"/docs/evaluations","docs/05.evaluations/0.index",[152,153,157,161,165,169],{"title":129,"path":149,"stem":150},{"title":154,"path":155,"stem":156},"The Player","/docs/evaluations/player","docs/05.evaluations/1.player",{"title":158,"path":159,"stem":160},"About page","/docs/evaluations/about","docs/05.evaluations/2.about",{"title":162,"path":163,"stem":164},"Revisions","/docs/evaluations/revisions","docs/05.evaluations/3.revisions",{"title":166,"path":167,"stem":168},"Permissions","/docs/evaluations/permissions","docs/05.evaluations/4.permissions",{"title":170,"path":171,"stem":172},"Actions and sharing","/docs/evaluations/menu-options","docs/05.evaluations/5.menu-options",{"title":174,"path":175,"stem":176,"children":177},"Care Panels","/docs/care-panels","docs/06.care-panels/0.index",[178,179,183,187,191,195,199,203,207,211,215],{"title":174,"path":175,"stem":176},{"title":180,"path":181,"stem":182},"Creating and configuring panels","/docs/care-panels/creating-and-configuring","docs/06.care-panels/01.creating-and-configuring",{"title":184,"path":185,"stem":186},"Tracking results","/docs/care-panels/tracking-results","docs/06.care-panels/02.tracking-results",{"title":188,"path":189,"stem":190},"Managing patients","/docs/care-panels/managing-patients","docs/06.care-panels/03.managing-patients",{"title":192,"path":193,"stem":194},"Scheduling assessments","/docs/care-panels/scheduling-assessments","docs/06.care-panels/04.scheduling-assessments",{"title":196,"path":197,"stem":198},"Filtering and exporting data","/docs/care-panels/filters-and-export","docs/06.care-panels/05.filters-and-export",{"title":200,"path":201,"stem":202},"Panel visibility","/docs/care-panels/panel-visibility","docs/06.care-panels/06.panel-visibility",{"title":204,"path":205,"stem":206},"Panel roles and permissions","/docs/care-panels/panel-roles-and-permissions","docs/06.care-panels/07.panel-roles-and-permissions",{"title":208,"path":209,"stem":210},"Collecting responses with public intakes","/docs/care-panels/collecting-responses","docs/06.care-panels/08.collecting-responses",{"title":212,"path":213,"stem":214},"Notifications and alerts","/docs/care-panels/notifications-and-alerts","docs/06.care-panels/09.notifications-and-alerts",{"title":216,"path":217,"stem":218},"Common workflows","/docs/care-panels/common-workflows","docs/06.care-panels/10.common-workflows",{"title":220,"path":221,"stem":222,"children":223},"Patients","/docs/patients","docs/08.patients/0.index",[224,225,228,232,236,240,244,248,252],{"title":220,"path":221,"stem":222},{"title":188,"path":226,"stem":227},"/docs/patients/managing-patients","docs/08.patients/01.managing-patients",{"title":229,"path":230,"stem":231},"Patient charts","/docs/patients/charts","docs/08.patients/02.charts",{"title":233,"path":234,"stem":235},"Reviewing results","/docs/patients/patient-results","docs/08.patients/03.patient-results",{"title":237,"path":238,"stem":239},"Running an evaluation","/docs/patients/running-an-evaluation","docs/08.patients/04.running-an-evaluation",{"title":241,"path":242,"stem":243},"Medical information","/docs/patients/patient-medical-tab","docs/08.patients/05.patient-medical-tab",{"title":245,"path":246,"stem":247},"Medical data types","/docs/patients/patient-medical-data-types","docs/08.patients/06.patient-medical-data-types",{"title":249,"path":250,"stem":251},"Patient identity and demographics","/docs/patients/patient-identity-tab","docs/08.patients/07.patient-identity-tab",{"title":253,"path":254,"stem":255},"Patient portal connections","/docs/patients/patient-portal-tab","docs/08.patients/08.patient-portal-tab",{"title":257,"path":258,"stem":259,"children":260},"Schedules","/docs/schedule","docs/09.schedule/0.index",[261,262],{"title":257,"path":258,"stem":259},{"title":263,"path":264,"stem":265},"Creating and managing schedules","/docs/schedule/creating-schedules","docs/09.schedule/1.creating-schedules",{"title":267,"path":268,"stem":269,"children":270},"Results","/docs/results","docs/10.results/0.index",[271,272],{"title":267,"path":268,"stem":269},{"title":273,"path":274,"stem":275},"Filtering and exporting results","/docs/results/filtering-and-export","docs/10.results/1.filtering-and-export",{"title":277,"path":278,"stem":279,"children":280},"Patient Portal","/docs/patient-portal","docs/11.patient-portal/0.index",[281,282,286,290,294,297,301,305,309],{"title":277,"path":278,"stem":279},{"title":283,"path":284,"stem":285},"Today dashboard","/docs/patient-portal/today","docs/11.patient-portal/1.today",{"title":287,"path":288,"stem":289},"Completing an evaluation","/docs/patient-portal/completing-an-evaluation","docs/11.patient-portal/2.completing-an-evaluation",{"title":291,"path":292,"stem":293},"Viewing results","/docs/patient-portal/results","docs/11.patient-portal/3.results",{"title":257,"path":295,"stem":296},"/docs/patient-portal/schedules","docs/11.patient-portal/4.schedules",{"title":298,"path":299,"stem":300},"Task links","/docs/patient-portal/task-links","docs/11.patient-portal/5.task-links",{"title":302,"path":303,"stem":304},"Public intakes","/docs/patient-portal/public-intakes","docs/11.patient-portal/6.public-intakes",{"title":306,"path":307,"stem":308},"Account and settings","/docs/patient-portal/account","docs/11.patient-portal/7.account",{"title":310,"path":311,"stem":312},"How practitioners use the Patient Portal","/docs/patient-portal/practitioner-workflows","docs/11.patient-portal/8.practitioner-workflows",{"title":314,"path":315,"stem":316,"children":317},"Account Administration","/docs/account-administration","docs/12.account-administration/0.index",[318,319,323,327,331,335,339,343],{"title":314,"path":315,"stem":316},{"title":320,"path":321,"stem":322},"Organization profile","/docs/account-administration/organization-profile","docs/12.account-administration/1.organization-profile",{"title":324,"path":325,"stem":326},"Managing team members","/docs/account-administration/managing-team-members","docs/12.account-administration/2.managing-team-members",{"title":328,"path":329,"stem":330},"Roles and permissions","/docs/account-administration/roles-and-permissions","docs/12.account-administration/3.roles-and-permissions",{"title":332,"path":333,"stem":334},"Managing evaluations","/docs/account-administration/managing-evaluations","docs/12.account-administration/4.managing-evaluations",{"title":336,"path":337,"stem":338},"Billing and subscriptions","/docs/account-administration/billing-and-subscriptions","docs/12.account-administration/5.billing-and-subscriptions",{"title":340,"path":341,"stem":342},"API keys","/docs/account-administration/api-keys","docs/12.account-administration/6.api-keys",{"title":344,"path":345,"stem":346},"Account settings","/docs/account-administration/settings","docs/12.account-administration/7.settings",{"title":348,"path":349,"stem":350,"children":351},"My Profile","/docs/my-profile","docs/13.my-profile/0.index",[352,353,357],{"title":348,"path":349,"stem":350},{"title":354,"path":355,"stem":356},"Contact and profile","/docs/my-profile/contact-and-profile","docs/13.my-profile/1.contact-and-profile",{"title":358,"path":359,"stem":360},"Security and notifications","/docs/my-profile/security-and-notifications","docs/13.my-profile/2.security-and-notifications",{"title":362,"path":363,"stem":364,"children":365},"Integrations","/docs/integrations","docs/14.integrations/0.index",[366,367,371,375],{"title":362,"path":363,"stem":364},{"title":368,"path":369,"stem":370},"Creating connections","/docs/integrations/creating-connections","docs/14.integrations/1.creating-connections",{"title":372,"path":373,"stem":374},"Managing connections","/docs/integrations/managing-connections","docs/14.integrations/2.managing-connections",{"title":376,"path":377,"stem":378},"FHIR and SMART on FHIR","/docs/integrations/fhir-and-smart","docs/14.integrations/3.fhir-and-smart",{"title":380,"path":381,"stem":382,"children":383},"Guides","/docs/guides","docs/15.guides/0.index",[384,385,389,393,397,401,433],{"title":380,"path":381,"stem":382},{"title":386,"path":387,"stem":388},"Planning","/docs/guides/planning","docs/15.guides/1.planning",{"title":390,"path":391,"stem":392},"Data","/docs/guides/data","docs/15.guides/2.data",{"title":394,"path":395,"stem":396},"Logic","/docs/guides/logic","docs/15.guides/3.logic",{"title":398,"path":399,"stem":400},"Design","/docs/guides/design","docs/15.guides/4.design",{"title":402,"path":403,"stem":404,"children":405},"Evaluation Reference","/docs/guides/evaluation-reference","docs/15.guides/5.evaluation-reference/0.index",[406,407,411,415,418,422,426,430],{"title":402,"path":403,"stem":404},{"title":408,"path":409,"stem":410},"Intro to Evaluations","/docs/guides/evaluation-reference/intro-to-evaluations","docs/15.guides/5.evaluation-reference/1.intro-to-evaluations",{"title":412,"path":413,"stem":414},"Menu Options","/docs/guides/evaluation-reference/menu-options","docs/15.guides/5.evaluation-reference/2.menu-options",{"title":162,"path":416,"stem":417},"/docs/guides/evaluation-reference/revisions","docs/15.guides/5.evaluation-reference/3.revisions",{"title":419,"path":420,"stem":421},"Learn More","/docs/guides/evaluation-reference/learn-more","docs/15.guides/5.evaluation-reference/4.learn-more",{"title":423,"path":424,"stem":425},"Download Results","/docs/guides/evaluation-reference/download-results","docs/15.guides/5.evaluation-reference/5.download-results",{"title":427,"path":428,"stem":429},"Security in Emailing Results","/docs/guides/evaluation-reference/security-emailing-results","docs/15.guides/5.evaluation-reference/6.security-emailing-results",{"title":166,"path":431,"stem":432},"/docs/guides/evaluation-reference/permissions","docs/15.guides/5.evaluation-reference/7.permissions",{"title":434,"path":435,"stem":436},"Player Reference","/docs/guides/player-reference","docs/15.guides/6.player-reference",{"title":438,"path":439,"stem":440,"children":441},"Tutorials","/docs/tutorials","docs/16.tutorials/0.index",[442,443,447,451,455,459,463],{"title":438,"path":439,"stem":440},{"title":444,"path":445,"stem":446},"101: Basic Evaluation with Visibility Rules","/docs/tutorials/basic-eval-with-visibility-rules","docs/16.tutorials/1.basic-eval-with-visibility-rules",{"title":448,"path":449,"stem":450},"Build a PHQ-9 depression screener","/docs/tutorials/build-a-phq9-screener","docs/16.tutorials/2.build-a-phq9-screener",{"title":452,"path":453,"stem":454},"Set up a care panel","/docs/tutorials/set-up-a-care-panel","docs/16.tutorials/3.set-up-a-care-panel",{"title":456,"path":457,"stem":458},"Connect Epic to EVAL","/docs/tutorials/connect-epic-to-eval","docs/16.tutorials/4.connect-epic-to-eval",{"title":460,"path":461,"stem":462},"Create a scheduled assessment","/docs/tutorials/create-a-scheduled-assessment","docs/16.tutorials/5.create-a-scheduled-assessment",{"title":464,"path":465,"stem":466},"Onboard patients via the patient portal","/docs/tutorials/onboard-patients-via-portal","docs/16.tutorials/6.onboard-patients-via-portal",{"title":468,"path":469,"stem":470,"children":471},"Troubleshooting","/docs/troubleshooting","docs/17.troubleshooting/0.index",[472,473,477],{"title":468,"path":469,"stem":470},{"title":474,"path":475,"stem":476},"Builder errors","/docs/troubleshooting/builder-errors","docs/17.troubleshooting/1.builder-errors",{"title":478,"path":479,"stem":480},"EHR connection issues","/docs/troubleshooting/ehr-connection-issues","docs/17.troubleshooting/2.ehr-connection-issues",{"title":482,"path":483,"stem":484,"children":485},"Reference","/docs/reference","docs/18.reference/0.index",[486,487,491,494,498,502,528,532,536,539],{"title":482,"path":483,"stem":484},{"title":488,"path":489,"stem":490},"Account","/docs/reference/account","docs/18.reference/1.account",{"title":166,"path":492,"stem":493},"/docs/reference/permissions","docs/18.reference/2.permissions",{"title":495,"path":496,"stem":497},"Administration","/docs/reference/administration","docs/18.reference/3.administration",{"title":499,"path":500,"stem":501},"Security and privacy","/docs/reference/security-privacy","docs/18.reference/4.security-privacy",{"title":503,"path":504,"stem":505,"children":506},"Charts","/docs/reference/charts","docs/18.reference/5.charts/0.index",[507,508,512,516,520,524],{"title":503,"path":504,"stem":505},{"title":509,"path":510,"stem":511},"Introduction to charts","/docs/reference/charts/intro","docs/18.reference/5.charts/1.intro",{"title":513,"path":514,"stem":515},"Patient evaluations","/docs/reference/charts/patient-evaluations","docs/18.reference/5.charts/2.patient-evaluations",{"title":517,"path":518,"stem":519},"Charts Landing Page","/docs/reference/charts/charts-landing-page","docs/18.reference/5.charts/3.charts-landing-page",{"title":521,"path":522,"stem":523},"Patient Medical","/docs/reference/charts/patient-medical","docs/18.reference/5.charts/4.patient-medical",{"title":525,"path":526,"stem":527},"Patient Identity","/docs/reference/charts/patient-identity","docs/18.reference/5.charts/5.patient-identity",{"title":529,"path":530,"stem":531},"Verified Accounts","/docs/reference/verified-accounts","docs/18.reference/6.verified-accounts",{"title":533,"path":534,"stem":535},"Account Creation","/docs/reference/account-creation","docs/18.reference/7.account-creation",{"title":348,"path":537,"stem":538},"/docs/reference/my-profile","docs/18.reference/8.my-profile",{"title":540,"path":541,"stem":542},"IT Deployment Strategy","/docs/reference/it-deployment","docs/18.reference/9.it-deployment",{"title":544,"path":545,"stem":546,"children":547},"Legal","/docs/legal","docs/19.legal/0.index",[548,549,553,557,561,565,569,573,577],{"title":544,"path":545,"stem":546},{"title":550,"path":551,"stem":552},"Terms of service","/docs/legal/terms-of-service","docs/19.legal/1.terms-of-service",{"title":554,"path":555,"stem":556},"Privacy policy","/docs/legal/privacy-policy","docs/19.legal/2.privacy-policy",{"title":558,"path":559,"stem":560},"HIPAA BAA","/docs/legal/hipaa-baa","docs/19.legal/3.hipaa-baa",{"title":562,"path":563,"stem":564},"GDPR DPA","/docs/legal/gdpr-dpa","docs/19.legal/4.gdpr-dpa",{"title":566,"path":567,"stem":568},"Patient privacy policy","/docs/legal/patient-privacy-policy","docs/19.legal/5.patient-privacy-policy",{"title":570,"path":571,"stem":572},"Free open source app license","/docs/legal/free-open-source-license","docs/19.legal/6.free-open-source-license",{"title":574,"path":575,"stem":576},"Limited open source app license","/docs/legal/limited-open-source-license","docs/19.legal/7.limited-open-source-license",{"title":578,"path":579,"stem":580},"Data sub-processors","/docs/legal/data-sub-processors","docs/19.legal/8.data-sub-processors",{"title":141,"path":582,"stem":583,"children":584},"/docs/ai-builder","docs/21.ai-builder/0.index",[585],{"title":141,"path":582,"stem":583},{"id":587,"title":376,"body":588,"description":812,"extension":813,"links":814,"meta":815,"navigation":817,"path":377,"seo":818,"stem":378,"__hash__":819},"docs/docs/14.integrations/3.fhir-and-smart.md",{"type":589,"value":590,"toc":803},"minimark",[591,604,616,621,628,635,638,642,646,662,665,671,677,683,689,693,697,700,706,712,720,724,727,733,739,745,751,762,766,770,773,800],[592,593,594,595,599,600,603],"p",{},"EVAL's EHR integrations are built on two open healthcare interoperability standards: ",[596,597,598],"strong",{},"FHIR"," (Fast Healthcare Interoperability Resources) and ",[596,601,602],{},"SMART on FHIR",". These standards allow EVAL to communicate securely with your electronic health record system without custom point-to-point integrations — the same connection architecture works across Epic, Cerner, athena, and every other supported EHR.",[592,605,606,607,611,612,615],{},"Understanding these standards helps your IT team evaluate EVAL's integration requirements, configure your EHR's FHIR capabilities, and troubleshoot connection issues. If you're a clinician or researcher who just wants to use the integration, you don't need to read this page — the ",[608,609,368],"a",{"href":610},"./creating-connections"," and ",[608,613,372],{"href":614},"./managing-connections"," guides cover everything you need to get started.",[617,618,620],"h2",{"id":619},"what-is-fhir","What is FHIR?",[592,622,623,624,627],{},"FHIR (Fast Healthcare Interoperability Resources) is a standard developed by HL7 International for exchanging healthcare data between systems. It defines a common language — a set of ",[596,625,626],{},"resources"," — that represent clinical concepts like patients, observations, conditions, medications, and encounters. When EVAL requests patient data from your EHR, both systems speak FHIR, so the data arrives in a predictable, structured format regardless of which EHR vendor you use.",[592,629,630,631,634],{},"EVAL uses ",[596,632,633],{},"FHIR R4",", the current production release of the standard and the version mandated by the US Office of the National Coordinator for Health IT (ONC) for certified health IT modules. All eight supported EHR systems in EVAL implement FHIR R4 endpoints, which is why the connection experience is consistent across vendors.",[592,636,637],{},"In practical terms, FHIR means that when EVAL synchronizes a patient chart from your EHR, it receives standardized resources — patient demographics, clinical observations, diagnoses, and other relevant data — that EVAL can reliably interpret and display. Your EHR team doesn't need to build a custom export for EVAL; they just need to ensure the FHIR R4 endpoint is accessible and properly configured.",[639,640,641],"note",{},"FHIR R4 is the minimum required version for EVAL integrations. Earlier versions (DSTU2, STU3) are not supported. If your EHR's FHIR capabilities are unclear, ask your EHR vendor whether they support FHIR R4 endpoints — most major EHR systems have supported R4 since 2020.",[617,643,645],{"id":644},"what-is-smart-on-fhir","What is SMART on FHIR?",[592,647,648,649,653,654,657,658,661],{},"SMART on FHIR (Substitutable Medical Applications, Reusable Technologies) is a security and authorization layer built on top of FHIR. While FHIR defines ",[650,651,652],"em",{},"what"," data can be exchanged, SMART on FHIR defines ",[650,655,656],{},"who"," can access it and ",[650,659,660],{},"how"," they get permission.",[592,663,664],{},"SMART on FHIR handles three critical functions for EVAL's integrations:",[592,666,667,670],{},[596,668,669],{},"Authentication"," — When a clinician launches EVAL from within the EHR (via EHR Launch mode), SMART on FHIR manages the identity handoff. The EHR tells EVAL who the clinician is and which patient they're viewing, so EVAL can open directly to the right context without requiring a separate login.",[592,672,673,676],{},[596,674,675],{},"Authorization"," — SMART on FHIR controls what data EVAL can access. Your EHR administrator configures the specific scopes (permissions) that EVAL receives — typically read access to patient demographics, clinical observations, and conditions. EVAL only sees the data your organization has explicitly authorized.",[592,678,679,682],{},[596,680,681],{},"App launch"," — The SMART App Launch framework defines how EVAL starts from within an EHR session. When a clinician clicks the EVAL link in Epic, Cerner, or another EHR, the SMART protocol orchestrates the secure handoff — passing the current patient context to EVAL while maintaining the clinician's authenticated session.",[592,684,630,685,688],{},[596,686,687],{},"SMART on FHIR v1",", which is the widely adopted version supported across all major EHR platforms.",[690,691,692],"tip",{},"Think of FHIR as the language and SMART on FHIR as the security guard. FHIR ensures EVAL and your EHR can understand each other. SMART on FHIR ensures only authorized users and applications can participate in the conversation, and only see the data they're permitted to access.",[617,694,696],{"id":695},"how-eval-uses-these-standards","How EVAL uses these standards",[592,698,699],{},"Each connection mode leverages FHIR and SMART on FHIR differently:",[592,701,702,705],{},[596,703,704],{},"EHR Launch and SSO connections"," use the full SMART App Launch flow. When a clinician opens EVAL from within the EHR, the SMART protocol authenticates the user, passes the patient context, and grants EVAL time-limited access to read clinical data. This all happens in the background — the clinician sees a seamless transition from the EHR to EVAL with the correct patient already loaded.",[592,707,708,711],{},[596,709,710],{},"Background Service connections"," use SMART Backend Services authorization (also known as the SMART system-level authorization flow). Instead of authenticating an individual clinician, the connection authenticates EVAL itself as a trusted service using a client credential. This allows EVAL to access patient data for bulk import and patient sync operations without requiring a user to be logged in — essential for keeping patient records synchronized overnight or during off-hours.",[592,713,714,715,719],{},"During the ",[608,716,718],{"href":717},"./creating-connections#the-discovery-wizard","discovery step"," of connection creation, EVAL queries your EHR's FHIR capability statement — a standardized document that every FHIR server publishes describing what it can do. This tells EVAL which FHIR resources are available, which SMART authorization flows are supported, and whether the server meets the requirements for the connection mode you've selected.",[617,721,723],{"id":722},"what-your-it-team-needs-to-know","What your IT team needs to know",[592,725,726],{},"If you're configuring EVAL's EHR integration for your organization, here are the key requirements your EHR technical team should be aware of:",[592,728,729,732],{},[596,730,731],{},"FHIR R4 endpoint"," — Your EHR must expose a FHIR R4-compliant endpoint. This is the Service Base URL you enter during connection setup. Most major EHR systems have FHIR R4 enabled by default, but some require activation through the EHR's administration console.",[592,734,735,738],{},[596,736,737],{},"SMART on FHIR v1 support"," — Your EHR's FHIR endpoint must support SMART on FHIR v1 for authentication and authorization. For EHR Launch connections, this means supporting the SMART App Launch Framework. For Background Service connections, this means supporting SMART Backend Services.",[592,740,741,744],{},[596,742,743],{},"Client registration"," — EVAL needs to be registered as an authorized application in your EHR's FHIR configuration. This typically involves creating a client ID (and sometimes a client secret) through your EHR vendor's developer portal or application registration process — for example, Epic's App Orchard, Cerner's Code Console, or athena's Developer Portal.",[592,746,747,750],{},[596,748,749],{},"Network accessibility"," — Your EHR's FHIR endpoint must be reachable from EVAL's servers. For Background Service connections that synchronize data automatically, this means the endpoint needs to be available around the clock, not just during business hours.",[592,752,753,756,757,761],{},[596,754,755],{},"FHIR Bulk Data Export"," (optional) — If you plan to use ",[608,758,760],{"href":759},"./managing-connections#bulk-import","bulk import"," to transfer large batches of patient data, your EHR must support the FHIR Bulk Data Export specification. This is a requirement for Background Service connections that need to import an entire patient population. Not all EHR configurations enable bulk export by default — check with your vendor.",[763,764,765],"warning",{},"The most common cause of connection failures is an incorrect or inaccessible FHIR endpoint URL. Before creating a connection in EVAL, verify that your FHIR endpoint responds to a direct browser request (navigating to the URL should return a FHIR CapabilityStatement JSON document). If it doesn't, work with your EHR vendor to confirm the correct endpoint and ensure network access is configured.",[617,767,769],{"id":768},"further-reading","Further reading",[592,771,772],{},"EVAL's integration architecture follows published open standards. If your IT team wants to understand the specifications in detail, the authoritative sources are:",[774,775,776,783,789,795],"ul",{},[777,778,779,782],"li",{},[596,780,781],{},"HL7 FHIR R4"," — the data exchange standard that defines how clinical data is structured and transmitted",[777,784,785,788],{},[596,786,787],{},"SMART App Launch Framework"," — the specification for launching applications from within an EHR with patient context",[777,790,791,794],{},[596,792,793],{},"SMART Backend Services"," — the specification for system-to-system authorization used by Background Service connections",[777,796,797,799],{},[596,798,755],{}," — the specification for efficient large-scale data transfer",[592,801,802],{},"These standards are maintained by HL7 International and the SMART Health IT project. Your EHR vendor's technical documentation will describe how they implement these standards in their specific system.",{"title":804,"searchDepth":805,"depth":805,"links":806},"",2,[807,808,809,810,811],{"id":619,"depth":805,"text":620},{"id":644,"depth":805,"text":645},{"id":695,"depth":805,"text":696},{"id":722,"depth":805,"text":723},{"id":768,"depth":805,"text":769},"Understand the FHIR and SMART on FHIR standards behind EVAL's EHR integrations, how each connection mode uses them, and what your IT team needs to configure.","md",null,{"icon":816},"i-mdi-swap-horizontal",true,{"title":376,"description":812},"yQunqThJCmIdzCCzLIYOppe7gsztmVY9wHamB9V6HQg",[821,823],{"title":372,"path":373,"stem":374,"description":822,"children":-1},"View connection details, configure bulk import and patient sync schedules, monitor activity logs, and troubleshoot EHR integration issues.",{"title":380,"path":381,"stem":382,"description":824,"children":-1},"Learn the methodology for building effective clinical evaluations — from planning through design.",1776705235165]