[InterSystems IRIS por primera vez] Interoperabilidad: Qué es una Producción

Este artículo es una continuación de esta publicación.

En ese artículo, expliqué cómo funciona el menú de Interoperabilidad para su integración en el sistema.

En este artículo, me gustaría explicar cómo desarrollar una integración de sistemas utilizando el menú de interoperabilidad.

En primer lugar, ¿qué tipo de proceso quieres crear? Mientras piensas en ello, prepara el siguiente contenido.

• Producción
• Mensaje
• Componentes
  • Business Services
  • Business Processes
  • Business Operations

Producción es una definición que se utiliza para especificar los componentes necesarios para la integración de sistemas y para almacenar la configuración de los componentes, que se configuran mediante el Portal de Administración (almacenado de forma interna como una definición de clase para la Producción).

Por ejemplo, supón que quieres crear un business service que procese los archivos colocados en un directorio específico a intervalos regulares. En ese caso, es necesario configurar exactamente qué directorios monitorizar y qué archivos procesar. Hay una Producción disponible para almacenar dicha configuración.

La configuración depende del adaptador usado por el componente que envía y recibe los datos.

Los adaptadores son clases para simplificar la conexión a los sistemas externos. Algunos son específicos de protocolos, como Mail/File/SOAP/FTP/HTTP/SQL/TCP, y otros son de específicos de estándares, como HL7.

Consulta la documentación (adaptadores específicos de protocolos y adaptadores relacionados con la documentación EDI) para más información sobre los adaptadores.

Como definiremos los componentes necesarios para la Producción, "Start Production" iniciará la integración del sistema, y "Stop Production" detendrá la integración del sistema.

El desarrollo necesario para completar la Producción es la creación de los componentes necesarios para la integración del sistema, concretamente los siguientes contenidos:

• Mensaje
• Componentes (Business Services, Business Processes, Business Operations)
• Conversión de datos, etc.

El contenido anterior se explicará con más detalle en próximos artículos.

Primero vamos a iniciar la Producción utilizando la muestra Producción y comprobaremos el proceso de los mensajes al procesar los datos mientras se verifica la configuración.

La muestra puede descargarse en https://github.com/Intersystems-jp/selflearning-interoperability.

Para utilizar un contenedor, descarga el código de muestra por medio del clon en Git, ve al directorio del clon y ejecuta docker-compose up -d ¡Es así de fácil!

Consulta aquí el procedimiento (lleva un poco de tiempo crear un contenedor).

Si no utilizas contenedores, crea un nuevo namespace después de descargar la muestra, e importa todos los archivos de definición de clases (extensión .cls) a la carpeta src en el namespace creado.

Para más información sobre el proceso para crear un namespace, consulta el video desde el minuto 07:03 que aparece en este artículo.

Consulta el archivo README para más información sobre el código de muestra.

Cuando estés listo, ve al Portal de Administración (cambia el número de puerto del servidor web para que coincida con tu entorno).

http://localhost:52773/csp/sys/UtilHome.csp

Ve a Management Portal > Interoperability > Configuration > Production.

Si utilizas un método distinto al de los contenedores, conéctate al namespace donde importaste el código fuente, accede a [Configuration] > [Production], haz clic en el botón [Open], selecciona [Start] > [Production], y después haz clic en el botón [Start].

※ Si utilizas algo que no sea un contenedor, tendrás que hacer unos ajustes iniciales. Configura los contenidos descritos más abajo antes de probar los siguientes contenidos.

La página de producción se mostrará como [● Component Name] para cada uno de los componentes "Service", "Process" y "Operation".

Haz clic sobre el nombre del componente para cambiar el contenido de la pestaña "Settings" en la parte derecha de la pantalla.

Por ejemplo, cuando haces clic sobre Start.GetKionOperation (un solo clic), se mostrará lo siguiente.

Este componente tiene la configuración de [HTTP Server] y de la [URL] para conectarse a la API Web.
Hay un campo [appid] en la parte inferior de la configuración, donde se puede introducir la clave de la API que recibes.
Hay un campo [lang] cerca de [appid] y se configura "ja" ("ja" = japonés). [lang] establece el idioma de la respuesta de OpenWeather. En el caso del inglés, selecciona "en".
Cuando termines de definir esta configuración, haz clic en el botón "Apply".

Si utilizas un contenedor, la configuración está completa. Para más información, haz clic aquí.

---

Si estás probando con algo distinto a los contenedores

Realiza estos dos ajustes por adelantado:

1) Configurar el cliente SSL.

Debido a que la API Web a la que se conectará estará comunicada mediante HTTPS, configura previamente el cliente SSL en el lado de IRIS.

Para que coincida con la configuración de la producción de muestra, utilizaremos el nombre [openweather]. La configuración de la Producción es la siguiente:

Haz clic en Management Portal > [System Administration] > [Security] > [SSL/TLS Configuration] > [Create New Configuration], escribe "openweather" en el campo "Configuration Name", y haz clic en el botón "Save" para terminar.

2) Crear una URL base para REST

En la producción de muestra, lo configuramos para que la información se pueda introducir mediante REST, y la URL base para REST debe configurarse en el lado de IRIS.

En la muestra, definimos /start como la URL base. Dado que la clase Start.REST se encuentra en el namespace donde se importó la muestra, especificaremos esta clase como clase dispatch y añadiremos %All como el rol de aplicación para omitir la autenticación en el momento del acceso.

Management Portal > System Administration > Security > Applications > Web Application Path > Haz clic en el botón "Create new web application".

En el campo Name, especifica /start; en el campo Namespace, especifica el namespace desde el que se importó la muestra; en el campo Dispatch Class, especifica Start.REST; en el campo Allowed Authentication Method, selecciona "Unauthenticated", y guarda el archivo.

Después de guardar, añade %All al rol de aplicación en la pestaña "Application Roles".

---

Tratar de enviar datos

En cuanto tengas todo configurado, intenta utilizar un business service para enviar información a través de REST y hazlo funcionar.

http://localhost:52773/start/weather/Takoyaki/Osaka

El ejemplo anterior es una URL donde se supone que alguien compró "Takoyaki" en la ciudad de Osaka.

Después de la ejecución, en la pantalla aparece esto:

Comprueba los mensajes que se han enviado a la Producción.

En Management Portal > Interoperability > Configuration > Production, haz clic en el servicio que aparece a continuación:

Seleccione la pestaña "Messages " que aparece en la parte derecha de la pantalla y haz clic en cualquier número que se encuentre debajo de la columna "Header". Si no lo encuentras, vuelve a cargar tu navegador.

A través de la página de Visual Trace, se puede ver la información de messages enviados y recibidos entre los componentes. Puedes ver que la información meteorológica se recupera de la API web y se envía de nuevo en el marco azul claro.

De esta manera, se puede utilizar el seguimiento para ver qué datos se enviaron y recibieron en ese momento y en qué orden.

En este artículo, confirmamos que en la Producción se definieron los componentes necesarios y sus configuraciones para la integración del sistema, basándose en las configuraciones del código de muestra.

Además, confirmamos que podemos consultar los mensajes que circulan dentro de la Producción en orden cronológico, utilizando la página Visual Trace.

En los siguientes artículos, analizaremos el concepto que hay detrás de la creación del "mensaje" que se muestra en este recorrido y cómo se define realmente.