Epic-EHR-Konfiguration

Auf dieser Seite wird beschrieben, wie Sie eine Epic-Anwendung registrieren und konfigurieren, bevor Sie den Epic-EHR-Datenspeicher erstellen. Ihre Organisation registriert ihre eigene Epic-App. Diese Schritte werden normalerweise von Ihrem Epic-Analysten ausgeführt.

Epic-App registrieren

Registrieren Sie eine App für Gemini Enterprise in Epic on FHIR und machen Sie sie in Ihren Epic-Umgebungen verfügbar. Verwenden Sie die folgenden Einstellungen:

Einstellung Wert
Zielgruppe der Anwendung Kliniker oder Nutzer mit Administratorzugriff
Eingehende APIs Die R4-APIs, die unter Epic-APIs aktivieren aufgeführt sind
Ausgehende APIs Keine
Registriert diese App dynamische Clients? Nein
Ist vertraulicher Client Ja
Erfordert persistenten Zugriff Ja
Verwendet rollierende Aktualisierungstokens Ja
JWK-Satz-URL Leer lassen
SMART on FHIR-Version R4
SMART Scope-Version SMART v1
FHIR-ID-Generierungsschema FHIR-IDs mit maximal 64 Zeichen für USCDI-FHIR-Ressourcen verwenden

Die Einstellungen für den dauerhaften Zugriff Ihrer Organisation für die App bestimmen, wie lange die Autorisierung eines Nutzers gültig ist. Wenn es endet, autorisiert der Nutzer den Connector noch einmal.

Weiterleitungs-URIs festlegen

Registrieren Sie in der App die beiden folgenden Weiterleitungs-URIs genau wie angegeben:

  • https://vertexaisearch.cloud.google.com/oauth-redirect
  • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html

Epic APIs aktivieren

Aktivieren Sie in der App die R4-Lese- und Such-APIs für die folgenden FHIR-Ressourcen: Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization und Procedure.

Einige Ressourcen wie „Observation“ und „Condition“ haben für jede Kategorie eine separate API, z. B. für Labore und Vitalzeichen. Aktivieren Sie die Kategorien, die Nutzer abfragen können sollen. Aktivieren Sie keine Schreib-APIs.

Wenn eine API nicht aktiviert ist, schlagen nur die Aktionen fehl, die sie verwenden.

Client-ID und Clientschlüssel abrufen

Epic stellt eine Client-ID für die Nicht-Produktionsumgebung und eine Client-ID für die Produktionsumgebung der App aus. Verwenden Sie die Client-ID, die der Epic-Umgebung entspricht, auf die Ihre URLs verweisen. Da die App ein vertraulicher Client ist, hat sie auch einen Clientschlüssel. Sie geben die Client-ID und den Clientschlüssel ein, wenn Sie den Datenspeicher erstellen.

Epic-Endpunkte finden

Zum Erstellen des Datenspeichers benötigen Sie drei URLs aus Ihrer Epic-Umgebung: die FHIR R4-Basis-URL, die Autorisierungs-URL und die Token-URL. Ihr Epic-Analyst kann sie Ihnen zur Verfügung stellen. In der SMART-Konfiguration Ihrer Organisation unter FHIR_BASE_URL/.well-known/smart-configuration sind auch die Autorisierungs-URL (authorization_endpoint) und die Token-URL (token_endpoint) aufgeführt. Ersetzen Sie FHIR_BASE_URL durch Ihre FHIR R4-Basis-URL.

Geben Sie jede URL mit https:// und ohne abschließenden Schrägstrich ein. Die öffentliche Sandbox von Epic verwendet beispielsweise die folgenden URLs:

URL Beispiel für eine Epic-Sandbox
FHIR R4-Basis-URL https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
URL autorisieren https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
Token-URL https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

Fehlerbehebung

In der folgenden Tabelle sind häufige Probleme und ihre Behebung aufgeführt:

Problem Lösung
In der Konsole wird eine der folgenden Meldungen angezeigt:
  • „Die Epic FHIR R4-URL muss eine https://-URL ohne abschließenden Schrägstrich sein.“
  • „Die Epic-Autorisierungs-URL muss eine https://-URL ohne abschließenden Schrägstrich sein.“
  • „Die Epic-Token-URL muss eine https://-URL ohne abschließenden Schrägstrich sein.“
 Geben Sie die URL mit https:// und ohne abschließenden Schrägstrich ein.
In der Konsole wird „Aktualisierungstoken konnte nicht abgerufen werden“ angezeigt. Wählen Sie in der Epic-App Is Confidential Client (Ist vertraulicher Client) und Requires Persistent Access (Erfordert dauerhaften Zugriff) aus und speichern Sie die Änderungen. Klicken Sie dann in der Google Cloud Console noch einmal auf Authentifizieren.
Epic meldet, dass der Weiterleitungs-URI nicht übereinstimmt. Registrieren Sie beide Weiterleitungs-URIs genau wie unter Weiterleitungs-URIs festlegen beschrieben.
Epic zeigt bei der Anmeldung „Ungültige OAuth 2.0-Anfrage“ an. Jeder Epic-Anmeldelink funktioniert nur einmal. Wenn Sie das Anmeldefenster neu laden, wird dieser Fehler angezeigt. Schließen Sie das Fenster und starten Sie die Anmeldung noch einmal, ohne die Seite neu zu laden. Wenn der Fehler weiterhin auftritt, prüfen Sie, ob die App die APIs für die angeforderten Bereiche hat.
Epic gibt invalid_client zurück. Die Client-ID oder der Clientschlüssel ist falsch, enthält zusätzliche Leerzeichen oder gehört zur anderen Epic-Umgebung. Geben Sie die Client-ID und den Clientschlüssel für die Umgebung ein, auf die Ihre URLs verweisen.
Das Anmeldefenster kehrt nicht zu Gemini Enterprise zurück oder der Connector ist nach der Anmeldung nicht autorisiert. Schließen Sie das Anmeldefenster, aktualisieren Sie Gemini Enterprise und autorisieren Sie den Connector noch einmal.
Eine Aktion schlägt fehl, andere funktionieren. Die Epic API für diese Aktion ist nicht aktiviert. Aktivieren Sie sie in der App und lassen Sie den Nutzer den Connector dann noch einmal autorisieren.
Gemini Enterprise sagt: „Sie sind nicht berechtigt, diesen Vorgang auszuführen. Please contact an administrator.“ (Der Connector wurde deaktiviert. Wenden Sie sich an einen Administrator.) an einen Nutzer, der den Connector zuvor autorisiert hat. Die Epic-Autorisierung des Nutzers ist abgelaufen. Der Nutzer autorisiert den Connector noch einmal.
Gemini Enterprise findet einen Patienten nicht anhand des Namens. Fügen Sie das Geburtsdatum hinzu oder verwenden Sie die MRN oder die Epic-Patienten-ID.
Gemini Enterprise meldet, dass einige Einträge nicht abgerufen werden konnten. Epic Security enthält diese Datensätze dem Nutzer vor. Nutzer sehen nur die Datensätze, die Epic ihnen erlaubt.
Der Text eines Berichts oder einer Notiz ist nicht verfügbar. Das Dokument ist eine PDF-Datei oder ein anderes Format, das der Connector nicht lesen kann. Öffnen Sie das Dokument in Epic.
Die Autorisierung schlägt nur in einer App fehl. Entfernen Sie den Epic-EHR-Datenspeicher aus der App, fügen Sie ihn wieder hinzu und autorisieren Sie den Connector noch einmal.

Nächste Schritte