Saltar al contenido principal

Tiet · Connect

Referencia de la interfaz: Cambio de marca ligero de octubre de 2026 · Verificado el 23 de octubre de 2026.

Tiet · Connect recibe mensajes de sistemas externos (HL7 v2 sobre MLLP, HTTP, archivos, Kafka, DICOMweb y otros), los procesa a través de un canal y los entrega a uno o más destinos. En el producto, un canal se muestra como una tubería. Esta página describe las funciones actuales de Connect y el grado de madurez de cada componente. Para crear una tubería paso a paso, consulte Crear una tubería de Connect.

Las etiquetas de disponibilidad y sus fechas de verificación se mantienen en el estado de Capacidad. El modo Hub utiliza el estado GA posterior confirmado por el propietario. El modo Spoke conserva la etiqueta Beta de la matriz a la espera de la confirmación de la disponibilidad de su versión actual. Las actualizaciones de estándares y otros límites de verificación se enumeran en esa página.

Dónde encontrarlo​

Conectar está en la navegación izquierda debajo de Tiet · Connect: Network tiene las entradas Mesh, Pipes, Messages & DLQ y Transformers. Dentro de la consola de red el interruptor en la parte superior dice Mesh | Pipes | DLQ.

Tiet · Connect → Red: estado del sistema, malla y tuberías

Por separado, Device Fleet (Dispositivos, Proveedores, Inscripción, Alertas, Automatizaciones, Configuración) administra los dispositivos conectados y los wearables. Consulte Wearables y Dispositivos.

nota

La entrada Transformers está en la navegación, pero no hay ninguna página vinculada en las rutas del frontend. Existe una página Transformations independiente que dice "Próximamente". Se seleccionan los pasos de transformación dentro de una tubería, en el paso de procesamiento.

Antes de crear una tubería​

Necesitas permiso para abrir la red, un origen y un destino accesibles, y las credenciales que requieran esos sistemas. Confirma si tu servidor Connect se ejecuta en modo independiente o en modo concentrador: las opciones de reintento y descarte solo están disponibles en modo concentrador.

  1. Abra Tiet · Connect → Network → Pipes y seleccione New pipe.
  2. Siga las instrucciones para crear una canalización Connect para configurar el origen, el procesamiento compatible y los destinos.
  3. Tras guardar, seleccione Resume para desplegar la tubería. Crearla por sí sola no inicia sus oyentes.
  4. Envía un mensaje de prueba sintético. Abre el mensaje Messages → In channel, inspecciona su carga útil y estado, y verifica que el destino haya recibido los datos esperados. Una confirmación de transporte exitosa por sí sola no prueba la asignación ni la escritura en el destino.

Modos de funcionamiento​

Modos autónomos y de concentrador y radios de Connect, con su madurez

Connect se ejecuta en uno de estos modos, elegido con la variable de entorno SERVER_MODE del servidor Connect:

ModoMadurezQué es
standalone (predeterminado)GeorgiaUna instancia de Connect gestiona los canales, los conectores y la consola de red. No requiere una red troncal centralizada.
hubGeorgiaUn concentrador con una red troncal NATS, un registro de nodos secundarios, enrutamiento y una cola de mensajes no entregados (DLQ) desde la que se pueden reintentar y descartar.
spokeBeta en la matriz retenida; disponibilidad actual no verificada.Un nodo en una topología de concentrador.

La conmutación por error entre nodos y una cola local en los nodos (resiliencia sin conexión) son Roadmap: no confíe en ellas.

Cuando Connect se ejecuta en modo independiente, la consola de red muestra el aviso "Modo independiente: sin red troncal del hub". Los nodos que aparecen en la lista son registros almacenados, y su estado solo se actualiza hasta su último latido.

Malla​

Tiet · Connect → Network → Mesh muestra el hub y los radios registrados con insignias de salud: Conectado, Degradado, Obsoleto, Fuera de línea, En proceso o Desconocido. Un radio que informa estar en buen estado pero no ha enviado una señal de actividad durante más de 5 minutos se muestra como Stale.

Tiet · Connect → Red → Malla: el centro y sus radios

Para agregar un nodo, use Add spoke en la vista Malla. Campos: Spoke ID (obligatorio, por ejemplo spoke-eu-west-1), un nombre; Region (por ejemplo eu-west-1 o on-prem), un punto final y capacidades. Programáticamente, POST /api/spokes/register requiere el token de servicio del nodo (SPOKE_SERVICE_TOKEN), no un token de usuario.

Tubería​

Tiet · Connect → Network → Pipes muestra cada canal como una tarjeta de tubería, agrupada bajo On the mesh y Direct. El resumen en la parte superior muestra Spokes en vivo, Canales (desplegados del total), Hub, Promg msg/min (un promedio desde que cada spoke se registró, no una tasa actual) y Dead-letter. Filtros: All, On mesh, Direct, Needs attention. New pipe inicia el constructor de seis pasos.

Tiet · Connect → Red → Tuberías

De qué está hecha una tubería

Una tubería es un conector de origen, procesadores que se ejecutan en el orden indicado y uno o más destinos. La ruta es Direct (origen a destino en un solo proceso) o On mesh (raíz de origen, concentrador, rama de destino). La consola de tuberías también denomina "Fan-out" a una ruta con varios destinos.

precaución

La API Connect ignora las opciones de radio enviadas con la creación o actualización de un canal: solo el punto final de la ruta del hub (PUT /api/channels/:id/route, token de malla) puede establecer source_spoke_id y destination_spoke_id. Los On mesh selectores de radio del constructor los envían con el canal, por lo que una tubería que cree de esa manera aún puede aparecer como Direct. Verifique la ruta en el inspector después de guardar.

Salud de las tuberías​

Haz clic en una tubería para abrir su inspector. El color y la etiqueta provienen de los indicadores del canal y sus contadores:

Estados de salud de las tuberías

EtiquetaSignificado
StoppedEl canal está desactivado.
ReadyHabilitado pero no desplegado, por lo que no hay nada escuchando. Una tubería que acaba de crear se encuentra en este estado.
DeployedImplementado correctamente y sin errores.
Errors recordedSe ha implementado y se ha detectado al menos un error desde que se creó el canal.
High error shareLos errores representan más del 20% de los mensajes entregados, incluyendo los mensajes con errores.

Los contadores (Total recibido, Entregado, Filtrado, Errores, En cola, Latencia promedio) son acumulativos desde que se creó el canal. Una tubería con errores antiguos conserva la etiqueta "Errores registrados" aunque ahora funcione correctamente. "En cola" cuenta los mensajes que entraron en la cola, no la profundidad actual de la misma.

Pausar y reanudar​

El pie de página del inspector tiene Pause / Resume, Messages, Edit (panel lateral para nombre, ruta, destinos y transformaciones) y Full editor (el constructor de seis pasos).

  • El comando Pause desactiva el canal: los conectores de origen y destino se detienen y los procesos terminan las tareas en cola. Un receptor HL7 en pausa ya no acepta conexiones.
  • Resume lo despliega de nuevo.

La pausa no retiene los mensajes para su posterior procesamiento: mientras una conexión está en pausa, el remitente recibe un error de conexión.

Mensajes y la perspectiva de la carta muerta​

Messages abre un cajón con dos pestañas, In channel y Dead-letter. Consulta Crear una tubería Connect para saber cómo usarla.

Estado de un mensaje en un canal

Tiet · Connect → Network → DLQ (entrada de menú Messages & DLQ) muestra los mensajes fallidos de todos los canales, con un filtro de canal.

Tiet · Connect → Red → Mensajes y DLQ

AcciónIndependiente (GA)Modo concentrador (GA)
Lo que aparece en la lista DLQMensajes cuyo estado es ErrorRegistros de la cola de mensajes no entregados con estado Pendiente, Reintentando, Descartado, Resuelto o Caducado
Reintentar / RepetirNo disponibleDisponible (individual, seleccionado o "Página de reproducción")
DesecharNo disponible para cartas muertasDisponible; se requiere y registra un motivo.
CaducanNo disponibleLa opción "Caducar por antigüedad" elimina los registros resueltos y descartados con más de N días de antigüedad (valor predeterminado: 7).
Número de reintentos y motivos de falloNo se realiza seguimientoMostrado

En modo independiente, la consola indica: "La cola de mensajes no entregados es de solo lectura". Para reenviar un mensaje que falló, corrija la causa y vuelva a enviarlo desde el origen.

Conectores (orígenes y destinos)​

La lista de conectores en el constructor proviene del catálogo de conectores de Connect (internal/connectors/catalog.go), por lo que muestra lo que el motor puede ejecutar. La madurez proviene de la matriz de capacidades.

Conector (tal como se indica en el constructor)FuenteDestinoMadurez
TCP (MLLP/HL7)SíSíGeorgia
HTTP / HTTPSSíSíGeorgia
WebSocketSíSíServidor GA, cliente Beta
Correo electrónico SMTPNoSíGeorgia
FHIR RESTSíSíUn destino que utiliza el conector HTTP. Comportamiento del paquete: consulte Crear una tubería Connect.
DICOMweb, oyente de DICOMwebSíSolo DICOMwebGeorgia
DICOM (DIMSE)SíSíGeorgia
Almacenamiento DICOMNoSíNo aparece en la matriz.
CDA / C-CDASíSíGA (análisis sintáctico)
XDS.b (IHE)NoSíGeorgia
Sistema de archivosSíSíGeorgia
Salida de parquetNoSíGeorgia
Activo del espacio de datosNoSíPunto final de extracción GA
Base de datosSíSíPostgreSQL GA. MySQL y MongoDB están en la hoja de ruta, aunque la lista de controladores los indique.
Apache KafkaSíSíGeorgia
CloudEvents HTTPSíNoNo aparece en la matriz.
IoT / MQTTSíSíVersión beta. Se conecta a un broker MQTT que usted proporcione. Connect no incluye un broker.
Hydra PipelineSíNoEjecuta un flujo de trabajo implementado según un cronograma o una sola vez.
Hydra SegmentNoSíNo aparece en la matriz.
Lago de datos de ClouderaSíSíNo aparece en la matriz.

El EDI X12 se gestiona únicamente mediante un analizador en el código base de Connect. Los nodos de análisis y flujo de trabajo X12 están disponibles de forma general; esto no implica un conector de transporte dedicado. No existe un conector X12 ni un conector SAP IDoc.

Los tipos de mensajes HL7 ADT^A01, A03, A08 y ORU^R01 son de disponibilidad general (GA). Los mensajes ORM, SIU, VXU, BAR y de farmacia también son de disponibilidad general (GA).

Procesamiento en una tubería​

El paso Procesamiento ofrece estas entradas (etiquetas como se muestra): Pipeline, Anonymizer, Filter, Tag Transformer, AI Inference, JavaScript, 6, HL7 to FHIR, FHIR to HL7, XPath, Regex. Cada una tiene On error configuración: Detener en caso de error, Omitir en caso de error o Volver a la JSONPath anterior en caso de error.

Por separado, el catálogo de transformadores del motor enumera estos transformadores integrados: HL7 v2.x a FHIR R4, IoT a HL7 (PCD DEC), Alerta a HL7 (PCD ACM), CDA a FHIR R4, FHIR R4 a CDA, MHD a XDS.b, XDS.b a MHD, Debezium CDC a FHIR R4 y JavaScript. XSLT, JSONPath y Template están en el catálogo marcados como planificados, aún no implementados.

Verifique el procesamiento antes de enviar tráfico en vivo.

Algunas opciones de procesamiento guardadas no se ejecutan. Una entrada no compatible también puede impedir que se cree la cadena de procesamiento DICOM del canal. Pruebe la carga útil convertida y la escritura de destino antes de utilizar una tubería.

OpciónLimitación actual¿Qué hacer?
PipelineEjecuta un flujo de trabajo en línea; necesita la conexión del motor de flujo de trabajo del servidor y el procesamiento agente habilitado.Confirma que HYDRA_API_URL y que CONNECT_AGENTIC_PROCESSORS_ENABLED no es false
Filter, AnonymizerEstos procesadores actúan únicamente sobre el contenido DICOM en formato JSON; otro contenido pasa a través deUtilice datos de prueba DICOM e inspeccione el resultado.
Tag Transformer, AI InferenceEl constructor guarda los identificadores que no coinciden con el registro del motor.No confíe en estas entradas guardadas hasta que se haya corregido y probado la discrepancia del identificador.
HL7 to FHIR, FHIR to HL7, JavaScript, XPath, JSONPath, RegexLas entradas de procesamiento guardadas no son ejecutadas por el registro del procesador en el backend auditado.Utilice un flujo de trabajo verificado o la conversión de canal configurada por separado que se describe a continuación.
Conversión de canal HL7 a FHIRRequiere transform_to_fhir=true; el constructor no tiene ningún campo para ello.Configure a través de la API del canal y verifique el manejo del tipo de paquete y del destino.
Conversión de resultados de laboratorio de ORURequiere transformer_type=HL7_ORU_TO_FHIR y sus opciones a través de la API del canal.Pruebe el paquete de transacciones resultante; esta asignación rechaza una conversión fallida.

Para obtener detalles sobre la conversión paso a paso y el procesamiento por lotes, consulte HL7 a FHIR: lo que necesita saber. Los diagnósticos de ingeniería, incluidos los identificadores del procesador, permanecen en el registro de evidencia de la página.

Cuando FHIR batching está activado, se muestra un mensaje Queued hasta que el servidor FHIR responde, luego Sent o Error. Consulte Crear una canalización Connect.

Los procesadores que llaman a un flujo de trabajo lo ejecutan en línea. Si se establece en CONNECT_AGENTIC_PROCESSORS_ENABLED=false en el servidor Connect, esto se desactiva.

Pedidos​

Por defecto, un canal distribuye los mensajes sin un orden específico. Si Max threads es mayor que 1, se pueden aplicar dos mensajes sobre el mismo paciente fuera de orden, por lo que una corrección puede ser sobrescrita por el mensaje que corrige. El canal ADT que Connect inicializa utiliza 25 subprocesos.

La opción Preserve per-key order (ordering_enabled, Beta, desactivada por defecto) mantiene los mensajes que comparten una clave de ordenación en orden de llegada entre los hilos. Las diferentes claves se siguen ejecutando en paralelo. La clave se deriva de la carga útil (HL7 PID-3, sujeto FHIR) a menos que se seleccione la opción Ordering key source (el motor acepta los valores hl7.pid3, fhir.subject o none). El orden se verifica solo a nivel de despacho, no de extremo a extremo.

Lo que no está disponible​

  • No hay opción TLS en el oyente MLLP en el catálogo de conectores. Finalice TLS delante de Connect.
  • El cifrado en reposo con claves por organización y mTLS entre el concentrador y los nodos periféricos forman parte de la hoja de ruta.
  • El creador de canales mediante arrastrar y soltar es Roadmap; el creador es un formulario paso a paso.
  • La asignación de roles para administrador, operador y espectador está en la hoja de ruta.
  • En Pipes no hay gráficos de rendimiento por minuto ni por hora. La vista de monitorización está en fase beta.

Solución de problemas​

SíntomaControlar
Una nueva tubería muestra Ready y no llega nada.Create channel no se despliega. Abra la tubería y haga clic en Resume.
Los mensajes son rechazados con un error de conexión.La tubería está en pausa o lista (no desplegada), o el puerto no es accesible desde el remitente.
Se muestra un mensaje ErrorAbra Messages → In channel, selecciónelo y lea Errors. El texto indica el destino que está fallando.
El error dice Queue fullLa cola del canal permaneció llena más allá del tiempo de espera de cola llena del motor y el mensaje se descartó. Generar Queue buffer size o Max threads.
La cola de denegación de servicio (DLQ) no tiene botón de reintento.El servidor Connect está en modo independiente. Consulte la tabla anterior.
El radio muestra StaleNo se ha registrado ningún latido cardíaco durante más de 5 minutos.

¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..