Configuration du DME Epic

Cette page explique comment enregistrer et configurer une application Epic avant de créer le data store Epic EHR. Votre organisation enregistre sa propre application Epic. Votre analyste Epic effectue généralement ces étapes.

Enregistrer l'application Epic

Enregistrez une application pour Gemini Enterprise dans Epic on FHIR et rendez-la disponible dans vos environnements Epic. Utilisez les paramètres suivants :

Paramètre Valeur
Audience de l'application Cliniciens ou utilisateurs administratifs
API entrantes Les API R4 répertoriées dans la section Activer les API Epic
API sortantes Aucun
Cette application enregistrera-t-elle des clients dynamiques ? Non
Est un client confidentiel Oui
Nécessite un accès persistant Oui
Utilise des jetons d'actualisation alternatifs Oui
URL de l'ensemble JWK Laissez le champ vide
Version de SMART on FHIR R4
Version du champ d'application SMART SMART v1
Schéma de génération d'ID FHIR Utiliser des ID FHIR limités à 64 caractères pour les ressources FHIR USCDI

Les paramètres d'accès persistant de votre organisation pour l'application déterminent la durée de l'autorisation d'un utilisateur. Lorsqu'elle se termine, l'utilisateur autorise à nouveau le connecteur.

Définir les URI de redirection

Dans l'application, enregistrez les deux URI de redirection suivants exactement comme indiqué :

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

Activer les API Epic

Dans l'application, activez les API de lecture et de recherche R4 pour les ressources FHIR suivantes : Patient, Observation, Condition, MedicationRequest, AllergyIntolerance, DiagnosticReport, DocumentReference, Binary, Encounter, ServiceRequest, Coverage, Immunization et Procedure.

Certaines ressources, telles que Observation et Condition, disposent d'une API distincte pour chaque catégorie, par exemple les laboratoires et les signes vitaux. Activez les catégories que les utilisateurs peuvent interroger. N'activez pas les API d'écriture.

Si une API n'est pas activée, seules les actions qui l'utilisent échouent.

Obtenir l'ID client et le code secret du client

Epic émet un ID client hors production et un ID client de production pour l'application. Utilisez l'ID client qui correspond à l'environnement Epic vers lequel pointent vos URL. Comme l'application est un client confidentiel, elle dispose également d'un code secret du client. Vous saisissez l'ID client et le code secret du client lorsque vous créez le datastore.

Trouver vos points de terminaison Epic

Pour créer le data store, vous avez besoin de trois URL de votre environnement Epic : l'URL de base FHIR R4, l'URL d'autorisation et l'URL du jeton. Votre analyste Epic peut vous les fournir. La configuration SMART de votre organisation, à l'adresse FHIR_BASE_URL/.well-known/smart-configuration, liste également l'URL d'autorisation (authorization_endpoint) et l'URL du jeton (token_endpoint). Remplacez FHIR_BASE_URL par votre URL de base FHIR R4.

Saisissez chaque URL avec https:// et sans barre oblique finale. Par exemple, le bac à sable public d'Epic utilise les URL suivantes :

URL Exemple de bac à sable Epic
URL de base FHIR R4 https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
URL d'autorisation https://fhir.epic.com/interconnect-fhir-oauth/oauth2/authorize
URL du jeton https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token

Résoudre les problèmes

Le tableau suivant liste les problèmes courants et indique comment les résoudre :

Problème Solution
La console affiche l'un des messages suivants :
  • "L'URL Epic FHIR R4 doit être une URL https:// sans barre oblique finale."
  • "L'URL d'autorisation Epic doit être une URL https:// sans barre oblique finale."
  • "L'URL du jeton Epic doit être une URL https:// sans barre oblique finale."
 Saisissez l'URL avec https:// et sans barre oblique finale.
La console affiche "Échec de l'obtention du jeton d'actualisation". Dans l'application Epic, sélectionnez Is Confidential Client (Est un client confidentiel) et Requires Persistent Access (Nécessite un accès persistant), puis enregistrez les modifications. Ensuite, dans la console Google Cloud , cliquez à nouveau sur Vérifier l'authentification.
Epic indique que l'URI de redirection ne correspond pas. Enregistrez les deux URI de redirection exactement comme indiqué dans Définir les URI de redirection.
Epic affiche "Requête OAuth 2.0 non valide" lors de la connexion. Chaque lien de connexion Epic ne fonctionne qu'une seule fois. Par conséquent, l'actualisation de la fenêtre de connexion affiche cette erreur. Fermez la fenêtre et recommencez la connexion sans actualiser la page. Si l'erreur persiste, vérifiez que l'application dispose des API pour les champs d'application demandés.
Des retours épiques invalid_client. L'ID client ou le code secret du client est incorrect, comporte des espaces supplémentaires ou appartient à l'autre environnement Epic. Saisissez l'ID client et le code secret du client pour l'environnement vers lequel pointent vos URL.
La fenêtre de connexion ne revient pas à Gemini Enterprise, ou le connecteur n'est pas autorisé après la connexion. Fermez la fenêtre de connexion, actualisez Gemini Enterprise et autorisez à nouveau le connecteur.
Une action échoue, mais les autres fonctionnent. L'API Epic pour cette action n'est pas activée. Activez-le dans l'application, puis demandez à l'utilisateur d'autoriser à nouveau le connecteur.
Gemini Enterprise indique "Malheureusement, il semble que vous ne soyez pas autorisé à effectuer cette opération. Please contact an administrator." (Cet appareil est déjà associé à un utilisateur. Veuillez contacter un administrateur.) à un utilisateur qui a déjà autorisé le connecteur. L'autorisation Epic de l'utilisateur a pris fin. L'utilisateur autorise à nouveau le connecteur.
Gemini Enterprise ne trouve pas de patient par son nom. Ajoutez la date de naissance, ou utilisez le MRN ou l'ID de patient Epic.
Gemini Enterprise indique que certains enregistrements n'ont pas pu être récupérés. La sécurité Epic empêche l'utilisateur d'accéder à ces enregistrements. Les utilisateurs ne voient que les enregistrements qu'Epic les autorise à voir.
Le texte d'un rapport ou d'une note n'est pas disponible. Le document est au format PDF ou dans un autre format que le connecteur ne peut pas lire. Ouvrez le document dans Epic.
L'autorisation échoue systématiquement dans une seule application. Supprimez le data store Epic EHR de l'application, ajoutez-le à nouveau, puis autorisez à nouveau le connecteur.

Étapes suivantes