Tiet · Connect
Référence d'interface : légère refonte de marque d'octobre 2026 · Vérifié le 23 octobre 2026.
Tiet · Connect reçoit des messages provenant de systèmes externes (HL7 v2 sur MLLP, HTTP, fichiers, Kafka, DICOMweb, etc.), les achemine via un canal et les distribue vers une ou plusieurs destinations. Dans le produit, un canal est représenté par un tuyau. Cette page décrit les fonctionnalités actuelles de Connect et le niveau de maturité de chaque composant. Pour créer un tuyau Connect étape par étape, consultez la section « Créer un tuyau Connect ».
Les étiquettes de disponibilité et leurs dates de vérification sont conservées dans l'état des capacités. Le mode Hub utilise le statut GA confirmé par le propriétaire le plus récent. Le mode Spoke conserve l'étiquette Beta de la matrice en attendant la confirmation de la disponibilité de sa version actuelle. Les mises à jour des normes et autres limites de vérification sont répertoriées sur cette page.
Où le trouver
L'option « Se connecter » se trouve dans le menu de navigation de gauche, sous Tiet · Connect : Network et comporte les entrées Mesh, Pipes, Messages & DLQ et Transformers. Dans la console réseau, le commutateur en haut affiche Mesh | Pipes | DLQ.
Par ailleurs, la section Device Fleet (Appareils, Fournisseurs, Inscription, Alertes, Automatisations, Paramètres) gère les appareils connectés et les objets connectés. Voir Objets connectés et appareils.
L'entrée Transformers figure dans la navigation, mais aucune page n'y est associée dans les routes front-end. Une page distincte, nommée Transformations existe et affiche « Bientôt disponible ». Vous choisissez les étapes de transformation à l'intérieur d'un pipeline, dans l'étape de traitement.
Avant de créer un tuyau
Vous devez disposer de l'autorisation d'ouvrir le réseau, d'une source et d'une destination accessibles, ainsi que des informations d'identification requises par ces systèmes. Vérifiez si votre serveur Connect fonctionne en mode autonome ou en mode concentrateur : les options de nouvelle tentative et d'abandon ne sont disponibles qu'en mode concentrateur.
- Ouvrez Tiet · Connect → Network → Pipes et sélectionnez New pipe.
- Suivez la procédure « Créer un pipeline Connect » pour configurer la source, le traitement pris en charge et les destinations.
- Après l'enregistrement, sélectionnez Resume pour déployer le canal. Sa création seule ne démarre pas ses écouteurs.
- Envoyez un message de test synthétique. Ouvrez-le Messages → In channel, examinez son contenu et son statut, et vérifiez que la destination a bien reçu les données attendues. Un accusé de réception de transport positif ne suffit pas à prouver le mappage ou l'écriture à destination.
Modes de fonctionnement
Connect s'exécute dans l'un de ces modes, choisi avec la variable d'environnement SERVER_MODE du serveur Connect :
| Mode | Maturité | Qu'est-ce que c'est |
|---|---|---|
standalone (par défaut) | Géorgie | Une seule instance Connect gère les canaux, les connecteurs et la console réseau. Aucun hub dorsal n'est nécessaire. |
hub | Géorgie | Un hub avec un réseau dorsal NATS, un registre de satellites, un système de routage et une file d'attente de lettres mortes (DLQ) à partir de laquelle vous pouvez réessayer et supprimer. |
spoke | Bêta dans la matrice conservée ; disponibilité actuelle non vérifiée | Un rayon dans une topologie en étoile. |
Le basculement entre les branches et une file d'attente locale sur les branches (résilience hors ligne) sont Roadmap : ne vous y fiez pas.
Lorsque Connect fonctionne en mode autonome, la console réseau affiche le message « Mode autonome — pas de réseau dorsal central ». Les nœuds distants listés correspondent aux enregistrements stockés, et leur statut est mis à jour uniquement lors de leur dernier signal de présence.
Engrener
Le chiffre Tiet · Connect → Network → Mesh indique le hub et les spokes enregistrés avec leur statut : Connecté, Dégradé, Inactif, Hors ligne, En cours d’application ou Inconnu. Un spoke signalé comme sain mais n’ayant pas émis de signal depuis plus de 5 minutes est affiché comme Stale.
Pour ajouter un rayon, utilisez Add spoke dans la vue Mesh. Champs : Spoke ID (obligatoire, par exemple spoke-eu-west-1), un nom ; Region (par exemple eu-west-1 ou on-prem), un point de terminaison et des capacités. Par programmation, POST /api/spokes/register nécessite le jeton de service du rayon (SPOKE_SERVICE_TOKEN), et non un jeton utilisateur.
Tuyaux
La liste Tiet · Connect → Network → Pipes présente chaque canal sous forme de carte de canalisation, regroupés sous On the mesh et Direct. Le résumé en haut affiche les Spokes actifs, les canaux (déployés sur le total), le Hub, le débit moyen de messages par minute (moyenne depuis l'enregistrement de chaque Spoke, et non un débit actuel) et les messages non distribués. Filtres : All, On mesh, Direct, Needs attention. New pipe lance le processus de création en six étapes.
Un tube est composé d'un connecteur source, de processeurs exécutés dans l'ordre indiqué et d'une ou plusieurs destinations. Le chemin est Direct (de la source à la destination en un seul processus) ou On mesh (source en étoile, hub, destination en étoile). La console des tubes désigne également un chemin avec plusieurs destinations par l'appellation « Fan-out ».
L'API Connect ignore les choix de branches envoyés lors de la création ou de la mise à jour d'un canal : seul le point de terminaison de la route principale (PUT /api/channels/:id/route, jeton de maillage) peut définir source_spoke_id et destination_spoke_id. Les sélecteurs de On mesh du générateur les envoient avec le canal ; par conséquent, un canal créé de cette manière peut toujours apparaître comme Direct. Vérifiez la route dans l'inspecteur après l'enregistrement.
Santé des canalisations
Cliquez sur un tuyau pour ouvrir son inspecteur. La couleur et l'étiquette proviennent des drapeaux du canal et de leurs compteurs :
| Étiquette | Signification |
|---|---|
| Stopped | La chaîne est désactivée. |
| Ready | Activé mais non déployé, donc rien n'est à l'écoute. Un canal que vous venez de créer se trouve dans cet état. |
| Deployed | Déployé avec succès, sans aucune erreur détectée. |
| Errors recorded | Déployé, et au moins une erreur a été comptabilisée depuis la création du canal. |
| High error share | Les erreurs représentent plus de 20 % des messages délivrés, sans compter les messages erronés. |
Les compteurs (Total reçu, Distribué, Filtré, Erreurs, Messages mis en file d'attente, Latence moyenne) sont cumulatifs depuis la création du canal. Un canal présentant d'anciennes erreurs conserve l'étiquette « Erreurs enregistrées » même s'il est désormais fonctionnel. Le compteur « Messages mis en file d'attente » comptabilise les messages ayant été placés dans la file d'attente, et non la profondeur actuelle de celle-ci.
Pause et reprise
Le pied de page de l'inspecteur comporte Pause / Resume, Messages, Edit (panneau latéral pour le nom, l'itinéraire, les destinations et les transformations) et Full editor (le constructeur en six étapes).
- La commande Pause désactive le canal : les connecteurs source et de destination s’arrêtent et les processus terminent les tâches en attente. Un écouteur HL7 en pause n’accepte plus de connexions.
- Resume le redéploie.
La pause ne conserve pas les messages pour plus tard : lorsqu’un canal est en pause, l’expéditeur reçoit une erreur de connexion.
Messages et la vue des lettres mortes
La Messages ouvre un tiroir comportant deux onglets, In channel et Dead-letter. Consultez la section « Créer un tuyau Connect » pour savoir comment l'utiliser.
Tiet · Connect → Network → DLQ (entrée de menu Messages & DLQ) liste les messages d'échec pour tous les canaux, avec un filtre de canal.
| Action | Autonome (GA) | Mode Hub (GA) |
|---|---|---|
| Liste des listes DLQ | Messages dont le statut est Erreur | Enregistrements de la file d'attente des lettres non distribuées avec le statut En attente, Nouvelle tentative, Rejeté, Résolu ou Expiré |
| Réessayer / Rejouer | Pas disponible | Disponible (unique, sélectionné ou « page de rediffusion ») |
| Jeter | Non disponible pour les lettres mortes | Disponible ; une raison est requise et enregistrée. |
| Expiration des anciens | Pas disponible | L'option « Expire old » supprime les enregistrements résolus et abandonnés datant de plus de N jours (7 jours par défaut). |
| Nombre de tentatives et raisons des échecs | Non suivi | Affiché |
En mode autonome, la console affiche le message suivant : « La file d’attente des messages non distribués est en lecture seule. » Pour renvoyer un message ayant échoué, corrigez la cause du problème et renvoyez le message depuis la source.
Connecteurs (sources et destinations)
La liste des connecteurs dans l'outil de création provient du catalogue de connecteurs Connect (internal/connectors/catalog.go), et indique donc les applications compatibles avec le moteur. Le niveau de maturité est issu de la matrice de capacités.
| Connecteur (tel qu'indiqué dans le générateur) | Source | Destination | Maturité |
|---|---|---|---|
| TCP (MLLP/HL7) | Oui | Oui | Géorgie |
| HTTP / HTTPS | Oui | Oui | Géorgie |
| WebSocket | Oui | Oui | Serveur GA, client Beta |
| Courriel SMTP | Non | Oui | Géorgie |
| FHIR REST | Oui | Oui | Destination utilisant le connecteur HTTP. Comportement du bundle : voir Créer un canal Connect. |
| DICOMweb, écouteur DICOMweb | Oui | DICOMweb uniquement | Géorgie |
| DICOM (DIMSE) | Oui | Oui | Géorgie |
| Stockage DICOM | Non | Oui | Non répertorié dans la matrice |
| CDA / C-CDA | Oui | Oui | GA (analyse syntaxique) |
| XDS.b (IHE) | Non | Oui | Géorgie |
| Système de fichiers | Oui | Oui | Géorgie |
| Sortie Parquet | Non | Oui | Géorgie |
| Ressources de l'espace de données | Non | Oui | Point de terminaison Pull GA |
| Base de données | Oui | Oui | PostgreSQL est disponible en version finale. MySQL et MongoDB sont encore en développement, même s'ils figurent dans la liste des pilotes. |
| Apache Kafka | Oui | Oui | Géorgie |
| CloudEvents HTTP | Oui | Non | Non répertorié dans la matrice |
| IoT / MQTT | Oui | Oui | Version bêta. Elle se connecte à un courtier MQTT que vous fournissez. La connexion ne comprend pas de courtier. |
| Hydra Pipeline | Oui | Non | Exécute un flux de travail déployé selon une planification ou une seule fois. |
| Hydra Segment | Non | Oui | Non répertorié dans la matrice |
| Lac de données Cloudera | Oui | Oui | Non répertorié dans la matrice |
L'EDI X12 est géré par un analyseur syntaxique intégré au code source de Connect. Les nœuds d'analyse et de flux de travail X12 sont disponibles en disponibilité générale ; cela n'implique pas l'existence d'un connecteur de transport dédié. Il n'existe ni connecteur X12, ni connecteur SAP IDoc.
Les types de messages HL7 suivants : ADT^A01, A03, A08 et ORU^R01 sont GA. Les messages ORM, SIU, VXU, BAR et les messages de pharmacie sont également GA.
Traitement dans un tuyau
L'étape de traitement propose ces entrées (étiquettes comme indiqué) : Pipeline, Anonymizer, Filter, Tag Transformer, AI Inference, JavaScript, HL7 to FHIR, FHIR to HL7, XPath, JSONPath, Regex. Chacune a un On error paramètre : Arrêter en cas d'erreur, Ignorer en cas d'erreur ou Basculer en cas d'erreur.
Par ailleurs, le catalogue de transformateurs du moteur répertorie les transformateurs intégrés suivants : HL7 v2.x vers FHIR R4, IoT vers HL7 (PCD DEC), Alerte vers HL7 (PCD ACM), CDA vers FHIR R4, FHIR R4 vers CDA, MHD vers XDS.b, XDS.b vers MHD, Debezium CDC vers FHIR R4 et JavaScript. XSLT, JSONPath et Template figurent dans le catalogue comme étant prévus, mais non encore implémentés.
Certaines options de traitement enregistrées ne s'exécutent pas. Une entrée non prise en charge peut également empêcher la création de la chaîne de traitement DICOM du canal. Testez la charge utile convertie et l'écriture de destination avant d'utiliser un tube.
| Option | limitation actuelle | Ce qu'il faut faire |
|---|---|---|
| Pipeline | Exécute un flux de travail en temps réel ; nécessite une connexion au moteur de flux de travail du serveur et l’activation du traitement par agent. | Confirmez que HYDRA_API_URL est égal à 0 et que CONNECT_AGENTIC_PROCESSORS_ENABLED n'est pas égal false |
| Filter, Anonymizer | Ces processeurs traitent uniquement le contenu DICOM au format JSON ; les autres contenus transitent par d’autres voies. | Utilisez des données de test DICOM et examinez le résultat. |
| Tag Transformer, AI Inference | Le générateur enregistre des identifiants qui ne correspondent pas au registre du moteur | Ne vous fiez pas à ces entrées enregistrées tant que l'incohérence d'identifiants n'est pas corrigée et testée. |
| HL7 to FHIR, FHIR to HL7, JavaScript, XPath, JSONPath, Regex | Les entrées de traitement enregistrées ne sont pas exécutées par le registre du processeur dans le système dorsal audité. | Utilisez un flux de travail vérifié ou la conversion de canal configurée séparément décrite ci-dessous. |
| Conversion du canal HL7 vers FHIR | Nécessite transform_to_fhir=true ; le générateur ne possède aucun champ pour cela | Configurez la configuration via l'API du canal et vérifiez le type de bundle et la gestion de la destination. |
| conversion des résultats de laboratoire ORU | Nécessite transformer_type=HL7_ORU_TO_FHIR et ses options via l'API du canal | Testez le bundle de transactions résultant ; ce mappage rejette une conversion ayant échoué. |
Pour plus de détails sur la conversion et le traitement par lots étape par étape, consultez HL7 vers FHIR : ce que vous devez savoir. Les diagnostics d’ingénierie, y compris les identifiants du processeur, restent dans l’enregistrement de preuve de la page.
Lorsque FHIR batching est activé, un message affiche Queued jusqu'à ce que le serveur FHIR réponde, puis Sent ou Error. Voir Créer un canal de connexion.
Les processeurs qui appellent un flux de travail l'exécutent en temps réel. La valeur CONNECT_AGENTIC_PROCESSORS_ENABLED=false sur le serveur Connect désactive cette fonctionnalité.
Commander
Par défaut, un canal distribue les messages de manière désordonnée. Avec une valeur de Max threads supérieure à 1, deux messages concernant le même patient peuvent être appliqués dans le désordre, de sorte qu'une correction peut être écrasée par le message qu'elle corrige. Le canal ADT initialisé par Connect utilise 25 threads.
L'option Preserve per-key order (ordering_enabled, bêta, désactivée par défaut) conserve l'ordre d'arrivée des messages partageant une même clé d'ordonnancement entre les threads. Les messages avec des clés différentes peuvent être traités en parallèle. La clé est extraite de la charge utile (HL7 PID-3, sujet FHIR) sauf si vous définissez Ordering key source (hl7.pid3, fhir.subject ou none sont les valeurs acceptées par le moteur). L'ordonnancement est vérifié uniquement au niveau de la distribution, et non de bout en bout.
Ce qui n'est pas disponible
- Aucune option TLS n'est disponible pour l'écouteur MLLP dans le catalogue de connecteurs. Terminez la connexion TLS avant la connexion.
- Le chiffrement au repos avec des clés par organisation et le protocole mTLS entre le hub et les spokes figurent dans la feuille de route.
- Le générateur de canaux par glisser-déposer est Roadmap ; le générateur est un générateur de formulaires étape par étape.
- L'application des rôles pour les administrateurs, les opérateurs et les spectateurs est prévue dans la feuille de route.
- Pipes ne propose pas de graphiques de débit par minute ou par heure. La vue Monitor est en version bêta.
Dépannage
| Symptôme | Vérifier |
|---|---|
| Un nouveau tuyau affiche Ready et rien n'arrive. | Create channel ne se déploie pas. Ouvrez le canal et cliquez sur Resume. |
| Les messages sont rejetés en raison d'une erreur de connexion. | Le canal est en pause ou prêt (non déployé), ou le port est inaccessible depuis l'expéditeur. |
| Un message affiche Error | Ouvrez Messages → In channel, sélectionnez-le et lisez Errors. Le texte indique la destination défaillante. |
L'erreur indique Queue full | La file d'attente du canal est restée pleine au-delà du délai d'expiration du moteur et le message a été abandonné. Augmentez Queue buffer size ou Max threads. |
| Le DLQ ne possède pas de bouton Réessayer | Le serveur Connect est en mode autonome. Voir le tableau ci-dessus. |
| Le rayon affiche Stale | Aucun battement de cœur pendant plus de 5 minutes. |
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.



