Prérequis
- Vous devrez utiliser ou configurer l’authentification à deux facteurs (2FA) afin d’accéder au bouton de modification d’une intégration
Ocean offre une grande flexibilité pour effectuer des mises à jour à la eOrientation et recevoir des notifications tout au long du cycle de vie de la eOrientation. Cela peut introduire de la complexité dans une intégration API eOrientation entre Ocean et un système en aval. Cet article décrit ces notifications, paramètres et permissions afin que les intégrateurs puissent évaluer ceux qui peuvent être pris en charge par leur intégration.
- Les notifications, paramètres et permissions se trouvent sur la page Admin > Intégrations > eOrientation.
- Après avoir sélectionné « eOrientation », la fenêtre de configuration complète apparaîtra.
Nom de l’intégration
- Le nom de l’intégration est utilisé pour identifier l’intégration lors de son association à une ou plusieurs Listes d'annuaires.
- Il est également utilisé pour identifier l’intégration si le site a plusieurs intégrations configurées.
Note : La liste des intégrations inclut également des icônes d’état de l’intégration. Un hexagone jaune ou rouge apparaissant à droite du nom de l’intégration indique qu’Ocean ne peut pas communiquer avec succès avec le point de terminaison.
En survolant l’icône avec votre curseur, vous obtiendrez des détails supplémentaires sur le code de réponse d’erreur reçu par Ocean.
Point de terminaison Webhook
- Utilisé pour préciser où Ocean enverra les notifications webhook eOrientation à mesure que la demande est mise à jour dans Ocean Portail.
- Si le Type de charge utile est défini sur Open API, Ocean vérifiera automatiquement si l’URL saisie dans ce champ est valide. Si elle est Non valide, un hexagone jaune apparaîtra.
Type de charge utile
Ocean propose deux ensembles d’API pour l’intégration eOrientation : les Open API et les HL7 FHIR API. Ce paramètre permet de sélectionner l’ensemble d’API qu’Ocean utilisera pour communiquer avec votre système.
Note : Les deux ensembles d’API ne sont pas équivalents en termes d’événements pris en charge, de structures de données ou de mécanismes de sécurité. Comme les API FHIR sont basées sur des normes et plus largement adoptées, il est conseillé aux intégrateurs de les utiliser, sauf raison spécifique d’utiliser les Open API, comme le lancement contextuel d’un système.
Lancement contextuel du système
- Certains destinataires de demandes exigent qu’un autre système soit lancé pendant ou après la création d’une eOrientation.
-
L’onglet « Lancement du système d’orientation » dans l’article « Activer les intégrations Ocean » décrit comment configurer un lancement de système d’orientation.
Note : Cette fonctionnalité est disponible uniquement pour certains acheminements. Veuillez soumettre un billet de soutien pour vérifier si elle s’applique à votre intégration.
Notifications par courriel
- Lorsque des mises à jour eOrientation sont effectuées dans Ocean Portail, Ocean envoie des notifications par courriel. Celles-ci sont décrites dans l’article d’assistance « Où sont envoyés les courriels de notification de consultation électronique et/ou eOrientation ? ».
- Par Défaut, les mises à jour effectuées via les API ne déclencheront pas de notifications par courriel aux participants à la demande. Si elles sont Activée, Ocean enverra une notification par courriel aux participants appropriés.
Paramètres de soumission
- Par Défaut, tous les formulaires d’orientation incluent un bouton « Ajouter la pièce jointe » pour télécharger des fichiers.
- L’activation de la case « Empêcher les expéditeurs d’orientation d’inclure des pièces jointes » masque le bouton sur toute demande initiée vers des Listes d'annuaires configurées avec cette intégration. Ceci est utile si le système en aval ne souhaite pas stocker ou gérer les Pièces jointes.
Permissions
Développez chaque paramètre ci-dessous pour obtenir de l’Information supplémentaire concernant la fonctionnalité.
- Par défaut, un site avec une intégration API aura les boutons d’action liés à ces mises à jour d’état cachés dans la page d’eOrientation.
- Ces mises à jour d’état sont similaires à celles prises en charge par les API, donc le site doit déterminer s’il souhaite qu’elles soient activées afin que les utilisateurs Ocean puissent également gérer l’eOrientation dans Ocean Portail.
- La messagerie dans l’eOrientation permet à l’expéditeur et au spécialiste de communiquer au sujet de l’eOrientation. Par exemple, le spécialiste peut demander de l’information supplémentaire avant d’accepter l’eOrientation ou l’expéditeur peut s’informer du traitement auprès du spécialiste.
- Par défaut, Ocean désactive le panneau de messagerie pour les expéditeurs et les destinataires, de sorte qu’ils n’ont pas accès à la saisie ou à l’envoi de messages sur les eOrientations envoyées à une Listes d'annuaires configurée avec une intégration API.
- Cette permission doit être activée si l’intégration prend en charge la messagerie ou si la messagerie n’a pas besoin d’être stockée dans le système en aval. Qu’elle soit activée ou non, les messages peuvent toujours être envoyés via l’intégration API.
- Certains sites avec une intégration API qui prennent en charge la messagerie ne prennent pas en charge le stockage et la gestion des pièces jointes.
- Par défaut, la fonction « Ajouter la pièce jointe » est cachée à moins qu’elle ne soit activée, ce qui empêche les utilisateurs du Portail d’ajouter des pièces jointes à un message.
- Les utilisateurs Ocean peuvent ajouter des notes à l’eOrientation pour aider les autres utilisateurs à comprendre comment l’eOrientation est traitée.
- Lorsqu’une intégration API est en place, cette fonction est désactivée par défaut. Le système en aval peut prendre en charge une fonction Notes en interne ou ne souhaite pas recevoir de mises à jour liées aux notes.
- La démographie du patient peut être mise à jour dans Ocean Portail après l’envoi initial de l’eOrientation. Cela peut ajouter de la complexité pour un système en aval intégré en ce qui concerne la gestion des records (scénarios de fusion/défusion de patients).
- Par défaut, la fonction de mise à jour est cachée pour les eOrientations associées à une Listes d'annuaires ayant une intégration API, ce qui masque le bouton de modification à côté de la démographie du patient pour les expéditeurs et les destinataires, de sorte qu’ils n’ont pas accès à la modification de la démographie sur les eOrientations envoyées à une Listes d'annuaires configurée avec cette intégration.
- Les expéditeurs d’eOrientation peuvent annuler l’eOrientation dans Ocean Portail (par exemple, le patient n’a plus besoin du service). Cette fonction est désactivée pour les sites avec une intégration API car elle ajoute de la complexité à la gestion de l’eOrientation dans le système en aval intégré.
- Si activée, Ocean enverra une notification webhook lorsque l’eOrientation aura été annulée dans le Portail.
- Les eOrientations peuvent être transférées d’un site Ocean à un autre. Par exemple, un site de réception centralisée transférera une eOrientation à un fournisseur de services.
- Cette fonction est désactivée par défaut (l’option « Transférer » est cachée dans le Menu d'action pour les spécialistes) pour les sites avec une intégration API, car elle ajoute de la complexité à la gestion de l’eOrientation dans le système en aval intégré.
- Lorsqu’elle est activée, les spécialistes peuvent transférer manuellement l’eOrientation dans Ocean Portail; il n’y a actuellement aucun support API pour le transfert. (Note : Les expéditeurs ne peuvent pas transférer les eOrientations.)
- La section du résumé du formulaire d’eOrientation contient le contenu du formulaire d’eOrientation qui a été soumis par l’expéditeur.
- Par défaut, lorsqu’une intégration API est présente, Ocean masque le bouton de modification à côté du résumé du formulaire d’eOrientation pour les expéditeurs, de sorte qu’ils n’ont pas accès à la modification du formulaire sur les eOrientations envoyées à une Listes d'annuaires configurée avec cette intégration.
- Lorsqu’elle est activée, Ocean enverra des mises à jour du contenu de l’eOrientation via l’API chaque fois que le résumé du formulaire d’eOrientation aura été mis à jour.
Comportement de l’API
Lorsqu’une eOrientation est envoyée à partir d’un site ayant une intégration API et que le paramètre « Publier une copie de l’eOrientation (toutes les intégrations) et toutes les mises à jour d’état ultérieures (FHIR v0.11 seulement) à ce point de terminaison lorsqu’une nouvelle eOrientation est envoyée à partir de ce site » est activé, Ocean enverra une copie de l’eOrientation au système de l’expéditeur (il s’agit de l’événement de message FHIR notify-add-service-request et de l’événement de message Open API notify-upstream-service-request).
Cela élimine le besoin pour l’expéditeur de copier-coller manuellement ou de télécharger un PDF du résumé de l’eOrientation dans son système.
Les intégrations utilisant FHIR v11 recevront toutes les mises à jour d’état en amont ultérieures (y compris les rendez-vous et les communications) à ce point de terminaison lorsqu’une nouvelle eOrientation est envoyée à partir de ce site.
Cette option applique l’intégration sélectionnée comme point de terminaison par défaut pour les Listes d'annuaires créées à l’aide de l’API HealthcareService. Elle ne s’applique pas aux Listes d'annuaires créées manuellement.