[{"data":1,"prerenderedAt":845},["ShallowReactive",2],{"navigation_docs":3,"-docs-troubleshooting-ehr-connection-issues":586,"-docs-troubleshooting-ehr-connection-issues-surround":840},[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":478,"body":588,"description":832,"extension":833,"links":834,"meta":835,"navigation":837,"path":479,"seo":838,"stem":480,"__hash__":839},"docs/docs/17.troubleshooting/2.ehr-connection-issues.md",{"type":589,"value":590,"toc":822},"minimark",[591,595,603,610,617,622,629,632,648,663,667,671,674,690,694,697,716,720,723,741,745,748,766,770,773,818],[592,593,594],"p",{},"EHR connections depend on external systems — your Epic, Cerner, or Athena instance — which means there are more potential failure points than in other parts of EVAL. This page helps you diagnose connection problems, authentication failures, sync errors, and launch issues using the Activity Log and connection status indicators.",[592,596,597,598,602],{},"For general EHR setup instructions, see ",[599,600,362],"a",{"href":601},"../integrations",". This page focuses specifically on what can go wrong and how to fix it.",[592,604,605,609],{},[606,607,608],"strong",{},"Prerequisites:"," Account Administrator access is required to view and manage EHR connections.",[592,611,612],{},[613,614],"img",{"alt":615,"src":616},"EHR connection activity log with errors","/screenshots/troubleshooting/ehr-activity-log-errors.png",[618,619,621],"h2",{"id":620},"using-the-activity-log","Using the Activity Log",[592,623,624,625,628],{},"The Activity Log on the ",[606,626,627],{},"EHR"," page (under Configuration) is your primary diagnostic tool. It records every sync operation, showing the operation type, connection name, timestamp, record count, elapsed time, and status.",[592,630,631],{},"Each log entry shows one of two statuses:",[633,634,635,642],"ul",{},[636,637,638,641],"li",{},[606,639,640],{},"SUCCESS"," (green badge) — The operation completed without errors. The entry shows how many records were fetched and how long it took.",[636,643,644,647],{},[606,645,646],{},"ERROR"," (red badge) — The operation failed. The entry includes error details that explain what went wrong.",[592,649,650,651,654,655,658,659,662],{},"You can filter the Activity Log by ",[606,652,653],{},"Operation"," type (Patient Sync, Bulk Import, etc.) and by ",[606,656,657],{},"Connection"," to narrow down issues with a specific integration. Click ",[606,660,661],{},"Refresh"," to load the latest entries.",[664,665,666],"tip",{},"When troubleshooting, filter the Activity Log to show only the connection experiencing issues. This eliminates noise from other working connections and makes it easier to identify error patterns — like whether failures are intermittent or consistent.",[618,668,670],{"id":669},"connection-errors","Connection errors",[592,672,673],{},"These issues prevent EVAL from communicating with your EHR system entirely.",[675,676,677,682,686],"accordion",{},[678,679,681],"accordion-item",{"label":680},"Connection fails during setup","The connection wizard couldn't validate your FHIR endpoint or credentials. Verify that the FHIR Base URL is correct and accessible from the internet (not behind a firewall that blocks EVAL's servers). Check that the client ID and secret are correct and haven't expired. If your organization uses IP allowlisting, ensure EVAL's server IPs are permitted.",[678,683,685],{"label":684},"Connection was working but stopped","A previously functional connection has started failing. The most common causes are expired credentials (client secrets have expiration dates), changes to your EHR's FHIR endpoint URL (sometimes after EHR upgrades), network or firewall changes that block EVAL's access, and revoked API permissions in your EHR system. Check the Activity Log for the specific error message, then work with your IT team to verify the FHIR endpoint and credentials are still valid.",[678,687,689],{"label":688},"Service discovery fails","EVAL couldn't retrieve the FHIR capability statement from your endpoint. This usually means the URL is wrong, the server isn't responding, or the endpoint requires authentication that hasn't been configured yet. Verify the FHIR Base URL by testing it directly in a browser — you should see a JSON capability statement. If you get a 401 or 403 response, authentication is required before discovery can succeed.",[618,691,693],{"id":692},"authentication-errors","Authentication errors",[592,695,696],{},"These issues involve credentials and authorization between EVAL and your EHR.",[675,698,699,703,707],{},[678,700,702],{"label":701},"Authentication token expired","EVAL's access token for the connection has expired and couldn't be refreshed. For Background Service connections, this typically means the client secret has expired and needs to be regenerated in your EHR's developer portal. For EHR Launch connections, the clinician may need to re-authorize EVAL from within the EHR.",[678,704,706],{"label":705},"Invalid client credentials","The client ID or client secret provided during connection setup is incorrect or has been revoked. Verify the credentials in your EHR's application registration or developer portal. If the credentials were recently rotated, update them in EVAL by editing the connection configuration.",[678,708,710,711,715],{"label":709},"Insufficient FHIR scopes","The connection is authenticated but doesn't have permission to access the requested resources. EVAL needs specific FHIR scopes (like ",[712,713,714],"code",{},"patient/*.read"," for patient sync) to function. Check the API permissions configured for EVAL in your EHR system and ensure all required scopes are granted.",[618,717,719],{"id":718},"patient-sync-errors","Patient sync errors",[592,721,722],{},"These issues affect the import and synchronization of patient records.",[675,724,725,729,733,737],{},[678,726,728],{"label":727},"Patient sync completed with partial failures","The sync operation finished but some records failed to import. This can happen when individual patient records have data formatting issues, required fields are missing in the EHR data, or specific records exceed FHIR resource size limits. Check the Activity Log for details on which records failed and why.",[678,730,732],{"label":731},"Duplicate patients after sync","The same patient appears multiple times in EVAL after a sync operation. This typically occurs when a patient has multiple medical record numbers (MRNs) in the EHR or when the matching algorithm can't link records across syncs. Contact EVAL support to resolve duplicate records — manual merging may be required.",[678,734,736],{"label":735},"Patient demographics not updating","An existing patient's information (name, address, phone number) isn't being updated when the EHR data changes. Verify that the connection type supports ongoing synchronization (not just initial import). Check whether the sync is configured for one-time import or continuous updates in the connection settings.",[678,738,740],{"label":739},"Bulk import takes too long or times out","Large patient populations can cause sync operations to exceed time limits. The Activity Log shows the elapsed time for each operation. If imports consistently time out, consider running them in smaller batches or during off-peak hours. For very large populations (10,000+ patients), contact EVAL support to arrange a bulk import with appropriate resource allocation.",[618,742,744],{"id":743},"ehr-launch-and-sso-issues","EHR Launch and SSO issues",[592,746,747],{},"These issues affect launching EVAL from within the EHR using SMART on FHIR.",[675,749,750,754,762],{},[678,751,753],{"label":752},"EVAL doesn't launch from within the EHR","The SMART on FHIR launch URL may not be correctly configured in your EHR. Verify that the launch URL registered in your EHR's application configuration matches the one provided by EVAL. Also check that the EHR Launch connection type is enabled in EVAL and that the clinician has appropriate permissions in both systems.",[678,755,757,758,761],{"label":756},"Patient context not passed during launch","EVAL launches from the EHR but doesn't load the correct patient. This usually means the FHIR launch context isn't including the patient ID, or the patient ID format doesn't match between systems. Check the launch scope configuration — it should include ",[712,759,760],{},"launch/patient"," — and verify that EVAL can resolve the patient ID from the launch context.",[678,763,765],{"label":764},"SSO authentication loop","The user is repeatedly redirected between EVAL and the EHR without completing sign-in. This typically indicates a misconfigured redirect URL, an expired SSO session, or conflicting cookies. Clear the browser cache and try again. If the issue persists, verify the redirect URL configuration in your EHR matches EVAL's expected callback URL.",[618,767,769],{"id":768},"diagnostic-checklist","Diagnostic checklist",[592,771,772],{},"When an EHR issue doesn't match any specific error above, work through this checklist:",[774,775,776,782,788,794,800,806,812],"ol",{},[636,777,778,781],{},[606,779,780],{},"Check the Activity Log"," — Filter by the affected connection and look for patterns in recent failures",[636,783,784,787],{},[606,785,786],{},"Verify credentials"," — Confirm the client ID and secret are current and haven't been rotated",[636,789,790,793],{},[606,791,792],{},"Test the FHIR endpoint"," — Try accessing the FHIR Base URL directly to verify it's reachable",[636,795,796,799],{},[606,797,798],{},"Check network access"," — Ensure EVAL's servers can reach your EHR (firewalls, IP allowlists, VPN requirements)",[636,801,802,805],{},[606,803,804],{},"Review EHR permissions"," — Verify that EVAL's registered application has the required FHIR scopes",[636,807,808,811],{},[606,809,810],{},"Check for EHR updates"," — Recent EHR upgrades can change endpoint URLs or API behaviors",[636,813,814,817],{},[606,815,816],{},"Contact EVAL support"," — If the issue persists, provide the Activity Log error details and connection configuration",[819,820,821],"note",{},"EHR connection issues often require coordination between your organization's IT team and EVAL support. When contacting support, include the connection name, the Activity Log error entries (screenshots or text), and any recent changes to your EHR environment.",{"title":823,"searchDepth":824,"depth":824,"links":825},"",2,[826,827,828,829,830,831],{"id":620,"depth":824,"text":621},{"id":669,"depth":824,"text":670},{"id":692,"depth":824,"text":693},{"id":718,"depth":824,"text":719},{"id":743,"depth":824,"text":744},{"id":768,"depth":824,"text":769},"Diagnose and resolve problems with EHR connections, patient synchronization failures, authentication errors, and SMART on FHIR launch issues.","md",null,{"icon":836},"i-mdi-lan-disconnect",true,{"title":478,"description":832},"0HW-foU9ZwoHL3k4Sdw9YtYG8QTILvisbGMJC4O7TpM",[841,843],{"title":474,"path":475,"stem":476,"description":842,"children":-1},"Understand and resolve every validation error that can appear in the Builder's Errors tab — from missing fields to formula problems and broken rules.",{"title":482,"path":483,"stem":484,"description":844,"children":-1},"Reference documentation for EVAL accounts, permissions, administration, security, and charts.",1776705235928]