T2.1: Adds Production Components

Resumen General

Al construir interfaces HL7 en InterSystems HealthConnect, tienes varios métodos para agregar componentes de production. La funcionalidad "Create New" te permite agregar un componente completamente nuevo desde cero.

Proceso de Creación

• Comienza seleccionando el tipo de componente (Business Service, Business Process o Business Operation)
• Para componentes HL7, selecciona el tipo de adaptador:
• TCP: Conexiones en tiempo real
• File: Procesamiento basado en archivos
• FTP: Transferencias de archivos remotas
• HTTP: Servicios web
• SOAP: Integraciones basadas en SOAP

Configuración Inicial

Durante el proceso de creación:

• Configura los parámetros más relevantes para el tipo de adaptador seleccionado
• Adaptador TCP: Requiere configuración de puerto
• Adaptador File: Necesita una ruta de directorio (FilePath)
• Todos los ajustes pueden modificarse posteriormente a través de la interfaz de configuración del componente

Pautas de Selección de Adaptador

• Adaptadores TCP: Conexiones persistentes en tiempo real con sistemas remotos
• Adaptadores File: Procesamiento por lotes, comunicación de directorio compartido
• Adaptadores FTP: Capacidades de transferencia de archivos remotos
• Adaptadores HTTP/SOAP: Integraciones de servicios web
• Cada tipo de adaptador tiene requisitos de configuración y comportamientos específicos

Cuándo Usar "Create New"

Es mejor cuando necesitas un componente con configuración única que no coincide con componentes existentes:

• Comienza con configuraciones predeterminadas apropiadas para el tipo de adaptador
• Construye la configuración para que coincida con los requisitos de integración específicos

Resumen General

La función Copy proporciona un método eficiente para crear nuevos componentes cuando ya tienes un componente similar configurado en tu production.

Casos de Uso

Particularmente útil cuando necesitas:

• Múltiples instancias del mismo tipo de componente con configuraciones similares
• Ejemplo: Enviar mensajes HL7 a múltiples sistemas externos mediante TCP
• Copiar una Business Operation HL7 TCP existente y modificar solo la configuración específica del destino

Qué Se Copia

Cuando copias un componente, todas las configuraciones se duplican:

• Tamaño de pool
• Configuración de alertas
• Referencias de credenciales
• Parámetros específicos del adaptador
• Esto asegura consistencia y reduce errores de configuración

Limitación de Renombrar

InterSystems HealthConnect no proporciona una función directa de "renombrar":

• Debe usar la función Copy para crear un nuevo componente con el nombre deseado
• Luego eliminar el componente original
• Este flujo de trabajo de copiar y eliminar preserva toda la configuración

Consideraciones Importantes

Ten cuidado con las configuraciones que referencian recursos externos:

• Credenciales: Pueden necesitar actualizarse
• Rutas de archivo: A menudo específicas del entorno
• Direcciones IP: Usualmente necesitan cambios
• Puertos: Pueden entrar en conflicto con otros componentes
• La función Copy ahorra tiempo pero requiere revisión cuidadosa de todas las configuraciones

Resumen General

InterSystems HealthConnect proporciona herramientas completas de despliegue para mover productions entre entornos (Desarrollo, Prueba y Producción).

Navegación

Accede al proceso de importación a través de:

• Interoperability → Manage → Deployment Changes → Deploy
• Esta interfaz centralizada de despliegue asegura consistencia
• Proporciona mecanismos de seguridad para despliegues de producción

Característica de Rollback Automático

Una característica de seguridad crítica:

• La función Deploy exporta toda la configuración actual a un archivo de rollback externo
• Crea un backup completo del estado de production existente antes de importar
• Te permite revertir un despliegue fallido y volver al estado de trabajo anterior
• Minimiza el tiempo de inactividad y el riesgo durante los despliegues

Contenido del Bundle de Despliegue

El bundle contiene todas las definiciones de production en un solo archivo:

• Definición de production misma
• Todos los Business Services, Business Processes y Business Operations
• Definiciones de mensajes HL7
• Reglas de enrutamiento
• Tablas de búsqueda
• Schemas personalizados
• Transformaciones Data Transformation Language (DTL)
• Puede necesitar agregar manualmente clases personalizadas fuera de componentes de production estándar

Mejores Prácticas

Antes de desplegar en producción:

• Siempre prueba el despliegue en un entorno TEST
• Valida que todos los componentes importen correctamente
• Verifica que el proceso de rollback funcione como se espera
• Verifica diferencias de configuración específicas del entorno
• El proceso de despliegue compila todos los componentes, lo que puede revelar errores

Resumen General

El proceso de exportación comienza desde la página de Production usando el menú Actions y seleccionando Export. Esto crea un paquete completo de despliegue para desplegar integraciones HL7 completas entre entornos.

Contenido de Exportación

La exportación incluye:

• Definición de production misma
• Todos los Business Services, Business Processes y Business Operations configurados
• Definiciones de mensajes HL7
• Reglas de enrutamiento
• Tablas de búsqueda
• Definiciones de schema personalizadas
• Transformaciones DTL

Detección de Dependencias

La herramienta de despliegue intenta detectar automáticamente todas las dependencias:

• Puede no capturar clases personalizadas que no son componentes de production estándar
• Ejemplo: Clases de lógica de negocio personalizadas o clases de utilidad
• La interfaz de exportación proporciona botones para agregar manualmente elementos adicionales
• Asegura que todas las dependencias sean capturadas

Repeat Export

Cuando necesitas una exportación actualizada:

• Usa el botón "repeat export"
• Crea nuevas versiones sin reconfigurar la configuración de exportación cada vez
• Particularmente útil durante ciclos iterativos de desarrollo y pruebas

Advertencia de Valores de Configuración

Crítico para comprender:

• Las configuraciones exportan con los valores actualmente establecidos en Desarrollo
• Direcciones IP, puertos, rutas de archivo todas exportan tal cual
• Cuando se importan a Test o Producción, estos valores también se importan
• Potencialmente causa conexiones a servidores incorrectos
• Por esto los Default Site Settings son esenciales para valores específicos del entorno

El Desafío

Uno de los desafíos más importantes en el despliegue de production:

• Cuando exportas desde Desarrollo, todas las configuraciones exportan con valores de Desarrollo
• Incluye direcciones IP, números de puerto, rutas de archivo, credenciales
• Importar a Test o Producción configuraría esos entornos para usar recursos de Desarrollo

La Solución: Default Site Settings

Default Site Settings resuelve este desafío:

• Definidos fuera de la definición de production misma, a nivel de sitio o entorno
• Cuando se configuran para un componente y configuración particular, tienen precedencia sobre valores importados
• Permite exportar production con valores de Desarrollo intactos
• Los entornos de Test y Producción usan sus valores apropiados

Ejemplo: Configuración de Servidor SMTP

• Desarrollo, Test y Producción cada uno tienen diferentes servidores SMTP
• Define un Default Site Setting en Test y Producción para la dirección IP del servidor SMTP
• Durante el despliegue, la IP SMTP de Desarrollo se importa pero inmediatamente se anula
• Cada entorno se conecta a su servidor SMTP correcto sin cambios manuales

Notación Wildcard

Default Site Settings pueden usar asterisco (*) para múltiples componentes:

• Aplicar una configuración de ruta de archivo a todos los Business Services que usan adaptadores File
• Aplicar una configuración de tamaño de pool a todas las Business Operations
• Proporciona flexibilidad poderosa para gestionar configuración
• Mantiene control específico del entorno

Casos de Uso Comunes

• Servidores SMTP: Diferentes servidores de correo por entorno
• Conexiones de base de datos: Bases de datos específicas del entorno
• Rutas de archivo: Diferentes estructuras de directorios
• Direcciones IP: Endpoints específicos del entorno

Mejor Práctica Fundamental

Siempre prueba el despliegue en un entorno TEST antes de desplegar a PRODUCCIÓN:

• Esta fase de pruebas previene interrupciones de producción
• El entorno TEST debe reflejar producción tan cercanamente como sea posible
• Misma versión de InterSystems IRIS, configuración y ajustes del sistema

Validación Durante el Despliegue TEST

Verifica que todos los componentes importen correctamente:

• Verifica errores de compilación
• Asegura que todas las dependencias estén incluidas en el paquete de despliegue
• Busca advertencias o errores durante la importación
• Verifica clases o recursos faltantes
• Ejecuta mensajes de prueba a través de la production
• Valida reglas de enrutamiento, transformaciones DTL y configuraciones de componentes

Probar Funcionalidad de Rollback

En tu entorno TEST:

• Deliberadamente crea un escenario donde necesites hacer rollback
• Verifica que el archivo de rollback se creó correctamente
• Confirma que el proceso de rollback restaura exitosamente el estado anterior
• Comprender el rollback es esencial antes de usarlo en emergencia de producción

Validar Default Site Settings

Confirma Default Site Settings específicos del entorno:

• Asegura que el mecanismo funcionará cuando se despliegue a PRODUCCIÓN
• Verifica conexiones de base de datos
• Verifica rutas de archivo
• Confirma que las direcciones IP apunten a recursos TEST, no Desarrollo
• Valida cualquier otra configuración específica del entorno

Resumen General

Aunque InterSystems HealthConnect proporciona componentes HL7 estándar adecuados para la mayoría de escenarios, a veces se necesitan clases de componentes personalizadas para:

• Lógica de negocio específica
• Requisitos de integración únicos
• Desarrollo avanzado de interfaces HL7

Estructura de Clase de Componente

Los componentes de production son clases ObjectScript que extienden clases base de componentes de production:

• Business Services: Extienden Ens.BusinessService
• Business Processes: Extienden Ens.BusinessProcess
• Business Operations: Extienden Ens.BusinessOperation

Las clases base proporcionan el framework para:

• Integración con el entorno de production
• Manejo de mensajes
• Manejo de errores
• Gestión de configuración

Business Services Personalizados

Típicamente implementan lógica específica de recepción de mensajes:

• Lectura de formatos de archivo propietarios
• Recepción de mensajes a través de protocolos personalizados
• Usar adaptadores para aspectos de conectividad
• La lógica de negocio se enfoca en el procesamiento de mensajes, no en la gestión de conexiones

Business Processes Personalizados

Implementan lógica compleja de enrutamiento u orquestación:

• Más allá de lo que se puede lograr con reglas de enrutamiento estándar
• Más de lo que las transformaciones DTL pueden manejar
• Flujos de trabajo multi-etapa
• Toma de decisiones compleja

Business Operations Personalizadas

Manejan requisitos específicos para enviar mensajes:

• Requisitos de formato personalizados
• Manejo de protocolo
• Procesamiento de confirmación requerido por el sistema destino
• Usar adaptadores para conectividad, separando la gestión de conexión de la lógica de negocio

Mejores Prácticas

Al crear componentes personalizados:

• Seguir mejores prácticas de InterSystems para manejo de errores
• Implementar registro apropiado
• Usar gestión de configuración
• Asegurar integración sin problemas con el entorno de production