Configurer une intégration eOrientation avec Intrahealth Profile

Cet article décrit comment configurer une intégration FHIR eOrientation entre Ocean et Intrahealth Profile.

Note : Ce guide couvre l'intégration FHIR eOrientation. Il ne couvre pas les intégrations FHIR Engagement du patient.

Prérequis

Étape 1 : Préparez votre site Ocean

Complétez le guide de démarrage OceanMD

Complétez les trois étapes du Guide de démarrage OceanMD :

  1. Créez votre compte utilisateur Ocean.
  2. Créez votre site Ocean.
  3. Soumettez le formulaire de demande Ocean.
  • Lors de la création de votre compte utilisateur Ocean et de votre site Ocean, il vous sera demandé de préciser le DMÉ que vous utilisez. Sélectionnez 'Autre' et saisissez Intrahealth Profile dans le champ 'Précisez'.
  • Lors de la soumission de votre formulaire de demande Ocean, saisissez Intrahealth Profile dans le champ 'Détails supplémentaires'.

Enregistrez la clé de chiffrement partagée dans Connexion Cloud Ocean & activez Connexion Cloud Ocean

  • Dans votre site Ocean, ouvrez le 'Menu' et sélectionnez 'Admin'.
  • Admin option in the Ocean Portal menu
  • Sélectionnez 'Fonctionnalités du site'.
  • Cochez la case intitulée 'Activer Connexion Cloud Ocean'.
  • Sélectionnez 'Sauvegarder les modifications'.

Générez les identifiants OAuth Ocean

  • À partir de la page Paramètres Admin, sélectionnez 'Gérer les identifiants'.
  • Manage Credentials option in Admin Settings
  • Sélectionnez 'Gérer les identifiants OAuth'.
  • Manage OAuth Credentials option
  • Saisissez le mot de passe de votre compte Ocean et le code d'authentification à deux facteurs, puis sélectionnez 'Se connecter'.
  • Saisissez un nom descriptif dans le champ 'Nom' (ex. Identifiants OAuth Intrahealth Profile), puis sélectionnez 'Ajouter un nouvel identifiant'.
  • Add New Credential section
  • Le ClientID OAuth et le Secret Client OAuth sont générés et ajoutés au tableau. Ces valeurs sont nécessaires pour l'étape 2 : Coordination de la configuration avec Intrahealth.

Étape 2 : Coordonnez la configuration avec Intrahealth 

Contactez Intrahealth pour commencer la configuration de l'intégration Ocean eOrientation. Intrahealth va :

  1. Obtenir et saisir l'identifiant de votre base de données Profile.
  2. Générer la licence de services Ocean requise.
  3. Saisir la licence dans la section Module de licence de Profile.
  4. Planifier et effectuer un redémarrage de votre environnement Profile afin que la licence prenne effet.

Une fois ces étapes terminées, Intrahealth vous fournira des instructions détaillées pour activer Ocean dans votre DMÉ. Vous aurez besoin des renseignements suivants obtenus à l'étape 1 :

  • Site n° Ocean 
  • ID Client OAuth
  • Secret Client OAuth
  • Clé de chiffrement partagée

Astuce : Pour obtenir de l'aide afin de trouver votre site n° Ocean, consultez Où puis-je trouver mon site n° Ocean ?

Intrahealth vous fournira également l'URL de demande, les identifiants d'authentification OAuth2, ainsi que les paramètres et permissions d'intégration requis que vous utiliserez à l'étape 3 : Enregistrez l'intégration dans Ocean.

Étape 3 : Enregistrez l'intégration dans Ocean

Complétez ces étapes vous-même ou avec l'aide d'Intrahealth.

Note : Si Intrahealth a besoin d'accéder à votre site Ocean pour vous aider à la configuration, suivez les instructions dans Ajouter un site de soutien à votre site. Si vous rejoignez le Réseau de fournisseurs Ocean par l'entremise d'un programme provincial, il se peut que vous deviez également ajouter le site de soutien du programme provincial.

  • Dans le Portail Ocean, ouvrez le Menu et sélectionnez Admin.
  • Option Admin dans le menu du Portail Ocean
  • Sélectionnez Intégrations.
  • Option Intégrations dans les Paramètres Admin
  • Sélectionnez Enregistrer une intégration.
  • Bouton Enregistrer une intégration
  • Sélectionnez eOrientations comme type d'intégration.
  • Type d'intégration eOrientations
  • Saisissez un Nom d'intégration descriptif (par exemple, Profil Intrahealth), et saisissez l'URL de requête fournie par Intrahealth.
  • Champs Nom d'intégration et URL de requête
  • Sous Type de charge utile, sélectionnez FHIR V0.11.1.
  • Type de charge utile FHIR V0.11.1
  • Sélectionnez Authentification OAuth2. Saisissez les informations d'authentification fournies par Intrahealth.
  • Champs de configuration Authentification OAuth2
  • Sélectionnez les paramètres de configuration pour votre intégration FHIR eOrientation recommandés par Intrahealth. Pour plus d'informations sur les paramètres et permissions disponibles, consultez Configuration des paramètres et permissions pour les intégrations API.
  • Paramètres des événements d'intégration et des permissions
  • Important

    Sous Comportement de l'API, sélectionnez Publier une copie de l’orientation (toutes les intégrations) et toutes les mises à jour d’état subséquentes (FHIR v0.11 seulement) à ce point de terminaison lorsqu’une nouvelle orientation est envoyée à partir de ce site. Ce paramètre doit rester sélectionné afin que Profile reçoive les mises à jour de l’eOrientation.

  • Sélectionnez 'Sauvegarder'.
  • L'intégration eOrientation Profil Intrahealth de votre site Ocean est maintenant configurée.

Étape 4 : Lier l'intégration à votre Liste d'annuaire (pour les Spécialistes seulement)

Complétez cette étape uniquement si votre intégration reçoit des eOrientations.

Prérequis

Pour lier l'intégration :

  • Dans le Portail Ocean, ouvrez le 'Menu' et sélectionnez 'Admin'.
  • Option Admin dans le menu du Portail Ocean
  • Sélectionnez 'Listes d'annuaires'.
  • Option Listes d'annuaires dans les Paramètres Admin
  • Sélectionnez 'Modifier' sur la liste concernée.
  • Page Listes d'annuaires
  • Dans l'onglet 'Renseignements sur la liste', assurez-vous que 'Cette liste acceptera-t-elle des eRequêtes ?' est réglé sur 'Oui, eOrientations et/ou eConsultations.'
  • Paramètre d'acceptation des eRequêtes dans Renseignements sur la liste
  • Dans l'onglet Activation de la Liste d'annuaire, repérez la section Intégrations.

    Dans le champ 'ID du service externe', saisissez manuellement le nom de l'intégration FHIR eOrientation que vous avez configurée précédemment.

    Dans le champ 'Intégration', utilisez le menu déroulant pour sélectionner l'intégration FHIR eOrientation que vous avez configurée précédemment.

  • Section Intégrations dans l'onglet Activation de la Liste d'annuaire
  • Sélectionnez 'Sauvegarder'.

Étape 5 : Demandez l’ajout des identifiants et URL de lancement SMART à la liste d’autorisation Ocean

Profil Intrahealth permet aux utilisateurs de lancer Ocean directement à partir du DMÉ. Cela prend en charge la connexion unique et permet de préremplir les formulaires eRequête Ocean avec les informations du dossier patient dans le DMÉ.

Si vous ne savez pas où trouver les valeurs de lancement SMART, contactez Intrahealth. Pour plus d’informations, consultez la section Liste d’autorisation de l’Aperçu du lancement de l’application Ocean SMART.

Obtenez les valeurs suivantes et fournissez-les au Soutien OceanMD afin que votre serveur Intrahealth puisse être ajouté à la liste d’autorisation :

Renseignements requis Comment l’obtenir
Site n° Ocean

Pour obtenir de l’aide pour trouver votre numéro de site Ocean, consultez Où puis-je trouver mon numéro de site Ocean ?

Numéro de site Ocean

ID client OAuth
Secret client OAuth

Obtenez ces valeurs à l’étape 1 : Générer les identifiants OAuth.

ID client OAuth et Secret client OAuth

Point de terminaison d’autorisation
Point de terminaison de jeton
URL de l’émetteur du jeton
Obtenez ces valeurs auprès de votre DMÉ Intrahealth.
URL du serveur

Sur la page Paramètres Admin de votre site Ocean, sélectionnez 'Intégrations'.

Option Intégrations sur la page Paramètres Admin

Sous l’en-tête SMART sur FHIR, trouvez l’URL de lancement SMART sur FHIR de votre site Ocean.

URL de lancement SMART sur FHIR

Étape 6 : Liez votre compte Profile à votre compte utilisateur Ocean

Chaque personne utilisant l’intégration doit lier son compte Profile à son compte Ocean une seule fois.

  • Suivez les instructions d’Intrahealth pour lancer Ocean à partir de Profile.
  • Connectez-vous à votre compte utilisateur Ocean.
  • Après vous être connecté avec succès, votre compte utilisateur Profile sera lié à votre compte utilisateur Ocean. Cela signifie que la prochaine fois que vous lancerez Ocean à partir de Profile, vous serez automatiquement connecté à votre compte utilisateur Ocean.

Note : Lier les comptes est une étape unique qui doit être effectuée individuellement par chaque utilisateur DMÉ qui utilisera Ocean.

Assurez-vous que chaque personne qui utilisera Ocean a été invitée à rejoindre votre site Ocean et a créé son compte utilisateur Ocean avant de tenter de lier ses comptes.

Étape 7 : Tester l’intégration

  • Lancez Ocean à partir de Profile.
  • Confirmez que le bon patient est affiché.
  • Envoyez une eOrientation de test.
  • Recevez et traitez une eOrientation de test, si votre clinique reçoit des eOrientations.
  • Confirmez que les renseignements sur l’orientation et les mises à jour d’état apparaissent correctement dans les deux systèmes.