Ocean offre une flexibilité étendue pour effectuer des mises à jour de l'orientation et recevoir des notifications tout au long du cycle de vie de l'orientation. 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 autorisations afin que les implémenteurs puissent évaluer lesquels peuvent être pris en charge par leur intégration.
- Les notifications, paramètres et autorisations 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 sa liaison à un ou plusieurs Directory Listing.
-
- 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.
Passer le curseur sur l'icône fournit des détails supplémentaires sur le code de réponse d'erreur qu'Ocean reçoit.
Point de terminaison Webhook
- Utilisé pour préciser où Ocean enverra les notifications de webhook eOrientation à mesure que l'orientation est mise à jour dans l'Ocean Portail.
-
- Si le Type de Payload 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 Payload
Ocean propose deux ensembles d'APIs pour l'intégration eOrientation - les Open APIs et les HL7 FHIR APIs. Ce paramètre est utilisé pour sélectionner quel ensemble d'API Ocean utilisera pour communiquer avec votre système.
Note : Les deux ensembles d'APIs ne sont pas équivalents en termes d'événements qu'ils prennent en charge, de structures de données ou de leurs mécanismes de sécurité. Étant donné que les APIs FHIR sont basées sur des normes et plus largement adoptées, il est conseillé aux implémenteurs de les utiliser à moins qu'il n'y ait une raison spécifique d'utiliser les Open APIs, comme le lancement contextuel du système.
Lancement du système contextuel
- Certains cibles d'orientation nécessitent qu'un autre système soit lancé pendant ou après qu'une orientation ait été créée.
-
- 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 uniquement disponible pour des acheminements spécifiques. Veuillez soumettre un ticket de support pour explorer si elle s'applique à votre intégration.
Notifications par courriel
- Lorsque des mises à jour d'eOrientation sont effectuées dans l'Ocean Portail, Ocean envoie des notifications par courriel. Celles-ci sont décrites dans l'article de support "Où sont envoyés les courriels de notification de consultation électronique et/ou d'eOrientation ?".
-
- Par défaut, les mises à jour effectuées via les API ne déclencheront pas de notifications par courriel aux participants de l'orientation. Si elles sont activées, Ocean enverra une notification par courriel au(x) participant(s) 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 à cocher "Empêcher les expéditeurs d'orientation d'inclure des pièces jointes" masque le bouton sur toutes les orientations initiées vers des listes configurées avec cette intégration. Elle est utile si le système en aval ne souhaite pas stocker ou gérer des pièces jointes.
Autorisations
Développez chaque paramètre ci-dessous pour obtenir des informations supplémentaires concernant la fonctionnalité.
- Par défaut, un site avec intégration API aura les boutons d'action liés à ces mises à jour d'état cachés dans la page de l'orientation.
-
- 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 d'Ocean puissent également gérer l'orientation dans l'Ocean Portail.
- La messagerie dans l'eOrientation permet à l'expéditeur et au spécialiste de communiquer au sujet de l'orientation. Par exemple, le spécialiste peut demander des informations supplémentaires avant d'accepter l'orientation ou l'expéditeur pourrait s'enquérir du traitement auprès du spécialiste.
-
- Ocean désactive par défaut le volet de messagerie pour les expéditeurs et les destinataires, de sorte qu'ils n'ont pas accès pour taper ou envoyer des messages sur les orientations envoyées à une liste configurée avec une intégration API.
- Cette autorisation 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 cadre de l'orientation 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.
- Certaines 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 fonctionnalité '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 d'Ocean peuvent ajouter des notes à l'orientation qui aident d'autres utilisateurs à comprendre comment l'orientation est traitée.
-
- Lorsqu'une intégration API est en place, cette fonctionnalité est désactivée par défaut. Le système en aval peut prendre en charge une fonctionnalité de 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 l'Ocean Portail après que l'orientation a été initialement envoyée. Cela peut ajouter de la complexité pour un système en aval intégré à supporter en termes de gestion des records (scénarios de fusion/séparation de patients).
-
- Par défaut, la fonctionnalité de mise à jour est cachée pour les orientations associées à un Directory Listing qui a une intégration API, ce qui cache le bouton de modification à côté de la démographie du patient pour les expéditeurs et les destinataires, afin qu'ils n'aient pas accès à la modification de la démographie sur les orientations envoyées à un listing configuré avec cette intégration.
- Les expéditeurs d'orientation peuvent annuler l'orientation dans l'Ocean Portail (par exemple, le patient n'a plus besoin du service). Cette fonctionnalité est désactivée pour les sites avec une intégration API car elle ajoute de la complexité à la gestion des orientations dans le système en aval intégré.
-
- Si activée, Ocean enverra une notification webhook lorsque l'orientation a été annulée dans le Portail.
- Les orientations peuvent être transférées d'un site Ocean à un autre. Par exemple, un site de réception centralisée transférera une orientation à un fournisseur de services.
-
- Cette fonctionnalité 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 des orientations dans le système en aval intégré.
- Lorsqu'elle est activée, les spécialistes peuvent transférer manuellement l'orientation dans l'Ocean Portail; il n'y a actuellement pas de support API pour le transfert. (Note: Les expéditeurs ne peuvent pas transférer les orientations.)
- La section du résumé du formulaire de recommandation contient le contenu du formulaire de recommandation 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 de recommandation pour les expéditeurs, afin qu'ils n'aient pas accès à la modification du formulaire sur les recommandations envoyées à une liste configurée avec cette intégration.
- Lorsqu'elle est activée, Ocean enverra des mises à jour de la charge utile de la recommandation via l'API chaque fois que le résumé du formulaire de recommandation a été mis à jour.
Comportement de l'API
Lorsqu'une recommandation est envoyée depuis un site qui a une intégration API et que le paramètre "Publier une copie de la recommandation (toutes les intégrations) et toutes les mises à jour de statut ultérieures (FHIR v0.11 uniquement) à ce point de terminaison lorsqu'une nouvelle recommandation est envoyée depuis ce site" est activée, Ocean enverra une copie de la recommandation au système expéditeur (Ceci est l'événement de message notify-add-service-request FHIR et l'événement de message notify-upstream-service-request Open API).
Cela élimine le besoin pour l'expéditeur de copier et coller manuellement ou de télécharger un PDF du résumé de la recommandation dans leur système.
Les intégrations utilisant FHIR v11 recevront toutes les mises à jour de statut en amont ultérieures (y compris les rendez-vous et les communications) à ce point de terminaison lorsqu'une nouvelle recommandation est envoyée depuis ce site.
Cette option applique l'intégration sélectionnée comme point de terminaison par défaut pour les listings qui sont créés en utilisant l'API HealthcareService. Elle ne s'applique pas aux listings créés manuellement.