Zum Hauptinhalt springen

Tiet · Connect

Schnittstellenreferenz: Leichte Überarbeitung im Oktober 2026 · Geprüft am 23. Oktober 2026.

Tiet · Connect empfängt Nachrichten von externen Systemen (HL7 v2 über MLLP, HTTP, Dateien, Kafka, DICOMweb u. a.), leitet sie über einen Kanal weiter und stellt sie an ein oder mehrere Ziele zu. Im Produkt wird ein Kanal als Pipe dargestellt. Diese Seite beschreibt die aktuellen Funktionen von Connect und den Entwicklungsstand der einzelnen Komponenten. Eine schrittweise Anleitung zum Erstellen einer Connect-Pipe finden Sie unter „Connect-Pipe erstellen“.

Verfügbarkeitsbezeichnungen und deren Prüfdaten werden im Funktionsstatus verwaltet. Im Hub-Modus wird der spätere, vom Eigentümer bestätigte GA-Status verwendet. Im Spoke-Modus behält die Matrix die Beta-Bezeichnung bis zur Bestätigung der aktuellen Verfügbarkeitsfreigabe bei. Aktualisierungen von Standards und andere Prüfgrenzen werden auf dieser Seite aufgeführt.

Wo man es finden kann​

Connect befindet sich in der linken Navigation unter Tiet · Connect: Network und enthält die Einträge Mesh, Pipes, Messages & DLQ und Transformers. In der Netzwerkkonsole zeigt der Schalter oben die Zahl Mesh | Pipes | DLQ an.

Tiet · Connect → Netzwerk: Systemzustand, Mesh und Pipes

Separat verwaltet Device Fleet (Geräte, Anbieter, Registrierung, Benachrichtigungen, Automatisierungen, Einstellungen) verbundene Geräte und Wearables. Siehe Wearables & Geräte.

hinweis

Der Eintrag Transformers befindet sich in der Navigation, aber es ist keine Seite in den Frontend-Routen damit verknüpft. Es existiert eine separate Seite Transformations mit dem Text „Demnächst verfügbar“. Transformationsschritte werden innerhalb einer Pipeline im Verarbeitungsschritt ausgewählt.

Bevor Sie eine Rohrleitung erstellen​

Sie benötigen die Berechtigung zum Öffnen des Netzwerks, eine erreichbare Quelle und ein erreichbares Ziel sowie alle von diesen Systemen benötigten Anmeldeinformationen. Prüfen Sie, ob Ihr Connect-Server im Standalone- oder Hub-Modus läuft: Wiederholungsversuche und Verwerfen sind nur im Hub-Modus verfügbar.

  1. Öffnen Sie Tiet · Connect → Network → Pipes und wählen Sie New pipe.
  2. Folgen Sie dem Abschnitt „Erstellen einer Verbindungspipeline“, um die Quelle, die unterstützte Verarbeitung und die Ziele zu konfigurieren.
  3. Nach dem Speichern wählen Sie Resume, um die Pipe bereitzustellen. Das bloße Erstellen startet die Listener nicht.
  4. Senden Sie eine synthetische Testnachricht. Öffnen Sie Messages → In channel, prüfen Sie deren Nutzdaten und Status und vergewissern Sie sich, dass das Ziel die erwarteten Daten empfangen hat. Eine erfolgreiche Transportbestätigung allein beweist weder die Zuordnung noch das Schreiben des Ziels.

Betriebsarten​

Standalone- und Hub-and-Spoke-Modi von Connect mit ihrer Reife

Connect läuft in einem dieser Modi, der über die Umgebungsvariable SERVER_MODE des Connect-Servers ausgewählt wird:

ModusReifeWas es ist
standalone (Standardwert)GAEine One Connect-Instanz steuert die Kanäle, die Konnektoren und die Netzwerkkonsole. Kein Hub-Backbone.
hubGAEin Hub mit einem NATS-Backbone, einer Spoke-Registry, Routing und einer Dead-Letter-Queue (DLQ), aus der man erneut versuchen und E-Mails verwerfen kann.
spokeBeta in der beibehaltenen Matrix; aktuelle Verfügbarkeit nicht geprüftEine Speiche in einer Hub-Topologie.

Cross-Spoke-Failover und lokale Warteschlange auf Spokes (Offline-Resilienz) sind Roadmap: Verlassen Sie sich nicht darauf.

Wenn Connect im Standalone-Modus ausgeführt wird, zeigt die Netzwerkkonsole die Meldung „Standalone-Modus – kein Hub-Backbone“ an. Die dort aufgeführten Spokes sind gespeicherte Registrierungen, und ihr Status entspricht dem letzten Heartbeat.

Netz​

Die Tiet · Connect → Network → Mesh zeigt den Hub und die registrierten Spokes mit ihren jeweiligen Statusanzeigen an: Verbunden, Beeinträchtigt, Veraltet, Offline, Wird angewendet oder Unbekannt. Ein Spoke, der zwar als fehlerfrei gemeldet wird, aber seit mehr als 5 Minuten kein Lebenszeichen mehr gesendet hat, wird mit Stale angezeigt.

Tiet · Connect → Netzwerk → Masche: die Nabe und ihre Speichen

Um einen Spoke hinzuzufügen, verwenden Sie Add spoke in der Mesh-Ansicht. Felder: Spoke ID (erforderlich, z. B. spoke-eu-west-1), ein Name, Region (z. B. eu-west-1 oder on-prem), ein Endpunkt und die zugehörigen Funktionen. Programmatisch benötigt POST /api/spokes/register das Spoke-Service-Token (SPOKE_SERVICE_TOKEN), kein Benutzer-Token.

Rohre​

Tiet · Connect → Network → Pipes listet jeden Kanal als Pipe-Karte auf, gruppiert unter On the mesh und Direct. Die Zusammenfassung oben zeigt aktive Spokes, Kanäle (bereitgestellt von der Gesamtzahl), Hub, durchschnittliche Nachrichten pro Minute (ein Durchschnittswert seit der Registrierung jedes Spokes, keine aktuelle Rate) und unzustellbare E-Mails. Filter: All, On mesh, Direct, Needs attention. New pipe startet den sechsstufigen Builder.

Tiet · Connect → Netzwerk → Rohre

Woraus ein Rohr besteht

Eine Pipe ist ein Quellverbinder, der Prozessoren in der angegebenen Reihenfolge und ein oder mehrere Ziele verbindet. Die Route ist entweder Direct (Quelle zu Ziel in einem Prozess) oder On mesh (Quellknoten, Hub, Zielknoten). In der Pipe-Konsole wird eine Route mit mehreren Zielen auch als „Fan-out“ bezeichnet.

vorsicht

Die Connect-API ignoriert Spoke-Auswahlen, die beim Erstellen oder Aktualisieren eines Kanals gesendet werden: Nur der Hub-Routenendpunkt (PUT /api/channels/:id/route, Mesh-Token) kann source_spoke_id und destination_spoke_id festlegen. Die On mesh. Spoke-Selektoren des Builders senden diese mit dem Kanal, sodass eine so erstellte Pipe möglicherweise immer noch als Direct angezeigt wird. Überprüfen Sie die Route nach dem Speichern im Inspektor.

Rohrgesundheit​

Klicken Sie auf ein Rohr, um dessen Inspektor zu öffnen. Farbe und Beschriftung stammen von den Kanalfahnen und den Zählern:

Zustand der Rohrleitungen

EtikettBedeutung
StoppedDer Kanal ist deaktiviert.
ReadyAktiviert, aber noch nicht bereitgestellt, daher lauscht nichts. Eine soeben erstellte Pipe befindet sich in diesem Zustand.
DeployedEinsatz erfolgreich und ohne Fehler.
Errors recordedDer Kanal wurde bereitgestellt, und seit seiner Erstellung wurde mindestens ein Fehler gezählt.
High error shareMehr als 20 % der zugestellten und fehlerhaften Nachrichten sind fehlerhaft.

Die Zähler (Empfangene Nachrichten insgesamt, Zugestellte Nachrichten, Gefilterte Nachrichten, Fehler, Nachrichten in der Warteschlange, Durchschnittliche Latenz) werden seit der Kanalerstellung kumulativ erfasst. Eine Pipe mit alten Fehlern behält die Kennzeichnung „Fehler aufgezeichnet“, selbst wenn sie aktuell fehlerfrei funktioniert. „Nachrichten in der Warteschlange“ zählt die Nachrichten, die in die Warteschlange gelangt sind, nicht die aktuelle Warteschlangenlänge.

Pause und Fortsetzung​

Die Fußzeile des Inspektors enthält Pause / Resume, Messages, Edit (Seitenleiste für Name, Route, Ziele und Transformationen) und Full editor (den sechsstufigen Builder).

  • Pause hebt die Bereitstellung des Kanals auf: Quell- und Zielkonnektoren werden gestoppt, und die Worker beenden die in der Warteschlange befindlichen Aufgaben. Ein pausierter HL7-Listener akzeptiert keine Verbindungen mehr.
  • Resume stellt es erneut bereit.

Die Pause-Funktion speichert keine Nachrichten für später: Während eine Verbindung pausiert ist, erhält der Sender eine Verbindungsfehlermeldung.

Nachrichten und die Dead-Letter-Ansicht​

Messages öffnet eine Schublade mit zwei Registerkarten, In channel und Dead-letter Informationen zur Verwendung finden Sie unter „Erstellen einer Verbindungspipeline“.

Nachrichtenstatus einer Nachricht in einem Kanal

Tiet · Connect → Network → DLQ (Menüpunkt Messages & DLQ) listet fehlgeschlagene Nachrichten für alle Kanäle mit einem Kanalfilter auf.

Tiet · Connect → Netzwerk → Nachrichten & DLQ

AktionStandalone (GA)Hub-Modus (GA)
Was die DLQ-ListenMeldungen mit dem Status „Fehler“Unzustellbare E-Mails mit den Status „Ausstehend“, „Wiederholen“, „Verworfen“, „Aufgelöst“ oder „Abgelaufen“.
Wiederholen / WiedergabeNicht verfügbarVerfügbar (einzeln, ausgewählt oder auf der "Wiederholungsseite")
VerwerfenNicht verfügbar für unzustellbare BriefeVerfügbar; eine Begründung ist erforderlich und wird protokolliert.
AblaufdatumNicht verfügbarDie Option „Expire old“ entfernt Datensätze, die älter als N Tage sind (Standardwert: 7).
Anzahl der Wiederholungsversuche und Gründe für FehlerNicht erfasstGezeigt

Im Standalone-Modus zeigt die Konsole folgende Meldung an: „Die Warteschlange für unzustellbare Nachrichten ist hier schreibgeschützt.“ Um eine fehlgeschlagene Nachricht erneut zu senden, beheben Sie die Ursache und senden Sie die Nachricht erneut von der Quelle.

Konnektoren (Quellen und Ziele)​

Die im Builder angezeigte Konnektorliste stammt aus dem Connect-Konnektorkatalog (internal/connectors/catalog.go) und zeigt somit an, welche Schnittstellen die Engine unterstützt. Der Reifegrad wird aus der Fähigkeitsmatrix abgeleitet.

Anschluss (wie im Builder beschriftet)QuelleZielReife
TCP (MLLP/HL7)JaJaGA
HTTP / HTTPSJaJaGA
WebSocketJaJaGA-Serverseite, Beta-Clientseite
SMTP-E-MailNEINJaGA
FHIR RESTJaJaEin Ziel, das den HTTP-Connector verwendet. Verhalten des Bundles: siehe Erstellen einer Connect-Pipe.
DICOMweb, DICOMweb ListenerJaDICOMweb onlyGA
DICOM (DIMSE)JaJaGA
DICOM-SpeicherNEINJaNicht in der Matrix aufgeführt
CDA / C-CDAJaJaGA (Parsing)
XDS.b (IHE)NEINJaGA
DateisystemJaJaGA
Parkett-AusgangNEINJaGA
DatenbereichsressourceNEINJaPull-Endpunkt GA
DatenbankJaJaPostgreSQL ist allgemein verfügbar. MySQL und MongoDB befinden sich noch in der Roadmap, obwohl sie in der Treiberliste aufgeführt sind.
Apache KafkaJaJaGA
CloudEvents HTTPJaNEINNicht in der Matrix aufgeführt
IoT / MQTTJaJaBeta. Es verbindet sich mit einem von Ihnen bereitgestellten MQTT-Broker. Connect beinhaltet keinen Broker.
Hydra PipelineJaNEINFührt einen bereitgestellten Workflow nach einem Zeitplan oder einmalig aus.
Hydra SegmentNEINJaNicht in der Matrix aufgeführt
Cloudera Data LakeJaJaNicht in der Matrix aufgeführt

X12 EDI wird ausschließlich über einen Parser in der Connect-Codebasis verarbeitet. X12-Parsing und Workflow-Knoten sind allgemein verfügbar; dies impliziert jedoch keinen dedizierten Transportkonnektor. Es gibt weder einen X12-Konnektor noch einen SAP-IDoc-Konnektor.

HL7-Nachrichtentypen: ADT^A01, A03, A08 und ORU^R01 sind allgemein verfügbar. ORM-, SIU-, VXU-, BAR- und Apothekennachrichten sind ebenfalls allgemein verfügbar.

Verarbeitung in einem Rohr​

Der Verarbeitungsschritt bietet folgende Einträge (Bezeichnungen wie abgebildet): Pipeline, Anonymizer, Filter, Tag Transformer, AI Inference, JavaScript, HL7 to FHIR, FHIR to HL7, XPath, JSONPath, Regex. Jeder Eintrag hat eine On error: Bei Fehler anhalten, Bei Fehler überspringen oder Bei Fehler auf eine andere Methode zurückgreifen.

Der Transformerkatalog der Engine listet separat folgende integrierte Transformatoren auf: HL7 v2.x zu FHIR R4, IoT zu HL7 (PCD DEC), Alert zu HL7 (PCD ACM), CDA zu FHIR R4, FHIR R4 zu CDA, MHD zu XDS.b, XDS.b zu MHD, Debezium CDC zu FHIR R4 und JavaScript. XSLT, JSONPath und Template sind im Katalog als geplant, aber noch nicht implementiert gekennzeichnet.

Überprüfen Sie die Verarbeitung, bevor Sie Live-Datenverkehr senden.

Einige gespeicherte Verarbeitungsoptionen werden nicht ausgeführt. Ein nicht unterstützter Eintrag kann außerdem verhindern, dass die DICOM-Prozessorkette des Kanals erstellt wird. Testen Sie die konvertierte Nutzlast und das Schreiben an das Ziel, bevor Sie sich auf eine Pipe verlassen.

OptionAktuelle BeschränkungWas zu tun
PipelineFührt einen Workflow inline aus; benötigt die Workflow-Engine-Verbindung des Servers und aktivierte agentenbasierte Verarbeitung.Bestätigen Sie, dass HYDRA_API_URL und CONNECT_AGENTIC_PROCESSORS_ENABLED nicht false ist.
Filter, AnonymizerDiese Prozessoren verarbeiten ausschließlich DICOM-Inhalte im JSON-Format; andere Inhalte werden durchgeschleift.Verwenden Sie DICOM-Testdaten und überprüfen Sie das Ergebnis.
Tag Transformer, AI InferenceDer Builder speichert Kennungen, die nicht mit der Engine-Registry übereinstimmen.Verwenden Sie diese gespeicherten Einträge erst, nachdem die Diskrepanz bei den Kennungen behoben und getestet wurde.
HL7 to FHIR, FHIR to HL7, JavaScript, XPath, JSONPath, RegexGespeicherte Verarbeitungseinträge werden von der Prozessorregistrierung im überwachten Backend nicht ausgeführt.Verwenden Sie einen verifizierten Workflow oder die separat konfigurierte Kanalkonvertierung, die unten beschrieben wird.
Kanal-HL7-zu-FHIR-KonvertierungErfordert transform_to_fhir=true; der Builder hat kein Feld dafür.Konfiguration über die Channel-API und Überprüfung der Bundle-Typ- und Zielverarbeitung
ORU-LaborergebnisumrechnungErfordert transformer_type=HL7_ORU_TO_FHIR und dessen Optionen über die Kanal-APITesten Sie das resultierende Transaktionsbündel; diese Zuordnung weist eine fehlgeschlagene Konvertierung zurück.

Eine detaillierte Schritt-für-Schritt-Anleitung zur Konvertierung und Stapelverarbeitung finden Sie unter HL7 zu FHIR: Was Sie wissen müssen. Die technischen Diagnosedaten, einschließlich der Prozessorkennungen, bleiben im Nachweisdatensatz der Seite erhalten.

Wenn FHIR batching aktiviert ist, wird eine Meldung mit der Ziffer Queued angezeigt, bis der FHIR-Server antwortet, danach Sent oder Error. Siehe Erstellen einer Connect-Pipe.

Prozessoren, die einen Workflow aufrufen, führen ihn inline aus. Die Einstellung CONNECT_AGENTIC_PROCESSORS_ENABLED=false auf dem Connect-Server deaktiviert diese Funktion.

Bestellung​

Standardmäßig versendet ein Kanal Nachrichten in ungeordneter Reihenfolge. Bei einem Wert zwischen Max threads und 1 können zwei Nachrichten zum selben Patienten in beliebiger Reihenfolge angewendet werden, sodass eine Korrektur durch die zu korrigierende Nachricht überschrieben werden kann. Der von Connect initialisierte ADT-Kanal verwendet 25 Threads.

Option Preserve per-key order (ordering_enabled, Beta, standardmäßig deaktiviert) sorgt dafür, dass Nachrichten mit demselben Ordnungsschlüssel in der Reihenfolge ihres Eintreffens über verschiedene Threads hinweg verarbeitet werden. Nachrichten mit unterschiedlichen Schlüsseln werden weiterhin parallel verarbeitet. Der Schlüssel wird aus der Nutzlast (HL7 PID-3, FHIR-Subjekt) abgeleitet, sofern Sie nicht Option Ordering key source wählen (die Engine akzeptiert die Werte hl7.pid3, fhir.subject oder none). Die Reihenfolge wird nur auf Dispatch-Ebene, nicht durchgängig, überprüft.

Was nicht verfügbar ist​

  • Im Connector-Katalog ist keine TLS-Option für den MLLP-Listener verfügbar. Beenden Sie TLS vor Connect.
  • Roadmap: Verschlüsselung ruhender Daten mit organisationsspezifischen Schlüsseln und mTLS zwischen Hub und Spoke.
  • Der Drag-and-Drop-Kanalgenerator ist Roadmap; der Generator ist ein Formular-Stepper.
  • Die Rollendurchsetzung für Administrator, Bediener und Betrachter ist im Fahrplan vorgesehen.
  • Pipes bietet keine Durchsatzdiagramme pro Minute oder Stunde. Die Monitoransicht befindet sich in der Beta-Phase.

Fehlerbehebung​

SymptomÜberprüfen
Eine neue Leitung zeigt Ready an und es kommt nichts an.Create channel wird nicht bereitgestellt. Öffnen Sie die Pipe und klicken Sie auf Resume.
Nachrichten werden aufgrund eines Verbindungsfehlers abgelehnt.Die Pipe ist pausiert oder bereit (nicht bereitgestellt), oder der Port ist vom Sender aus nicht erreichbar.
Es wird eine Meldung angezeigt ErrorÖffnen Sie Messages → In channel, wählen Sie es aus und lesen Sie Errors. Der Text nennt das fehlerhafte Ziel.
Fehlermeldung Queue fullDie Kanalwarteschlange blieb auch nach dem Timeout der Engine für volle Warteschlange voll, und die Nachricht wurde verworfen. Ausnahme: Queue buffer size oder Max threads.
Die DLQ hat keine WiederholungstasteDer Connect-Server befindet sich im Standalone-Modus. Siehe die obige Tabelle.
Speichenanzeige StaleSeit mehr als 5 Minuten kein Herzschlag.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..