Módulo de este artículo: iFlow Docs
Después de Deploy en SAP CPI: vigilancia del despliegue, documentos de paquete, panorama de sistemas y Value Mapping en Excel
Ve cuándo un iFlow está Started o por qué falló, elige el runtime Cloud o Edge, ejecuta nuevas comprobaciones de diseño, documenta un paquete completo con su panorama de sistemas, exporta Value Mappings a Excel y desactiva cualquier herramienta.
Pulsar Deploy en SAP Cloud Integration (SAP CPI) da paso a una espera: cambiar a Monitor, buscar el iFlow, actualizar hasta que diga Started o Error, y luego averiguar qué significa el error. Y cuando una interfaz está terminada, alguien sigue pidiendo el documento, el diagrama del panorama de sistemas y el Value Mapping en una hoja de cálculo.
Kitegra ahora cubre esa parte del trabajo junto al diseñador de SAP Integration Suite: una vigilancia del despliegue con llamada de prueba, un selector de runtime para tenants con Edge Integration Cell, nuevas comprobaciones de diseño, un documento del paquete con diagrama del panorama de sistemas y estado de la documentación, una hoja de Value Mapping en Excel y explicaciones en lenguaje sencillo de los scripts Groovy. Cada herramienta se puede desactivar por separado. Este artículo las repasa una por una.
Vigilancia del despliegue: Started o Error, sin salir del iFlow
Pulsa Deploy en el diseñador como siempre y confirma el diálogo de SAP. Aparece un aviso de Despliegue con "Desplegando…" y el tiempo transcurrido, y tú sigues trabajando. Kitegra pregunta a SAP por el estado a los tres segundos, y luego cada vez con menos frecuencia, como mucho cada 20 segundos. Cuando SAP responde, el aviso pasa a mostrar:
- Started, con la versión desplegada. Si el iFlow tiene un endpoint HTTP, Enviar una llamada de prueba abre el HTTP Runner con la solicitud lista, y Mostrar el último mensaje abre el panel Mensajes actualizado.
- Error, con el texto de error de SAP y, cuando es un caso conocido, lo que suele significar: otro iFlow desplegado ya usa la dirección del emisor, un script no compila, un parámetro externalizado no tiene valor o SAP no pudo compilar el iFlow. Abrir el contenido desplegado en SAP te lleva a los detalles.
- Aún desplegando tras diez minutos, con un enlace al contenido desplegado en SAP.
Si cancelas el diálogo Deploy de SAP, no se vigila nada. La vigilancia solo lee el estado del despliegue; el despliegue lo hace SAP, iniciado por tu propio clic. Seguir después un mensaje a través del iFlow se explica en rastrear un mensaje paso a paso, y la llamada en sí en probar un iFlow HTTPS con una service key.
Selector de runtime: Cloud o Edge
Un tenant con Edge Integration Cell ejecuta iFlows en más de un runtime. Solo en un tenant así, el cuadro de Kitegra muestra Runtime: Cloud (o el nombre del runtime de Edge). Elige ahí el runtime, y el Message Monitor lee los mensajes de este iFlow y ajusta su nivel de log en ese runtime. El selector también muestra si hay una versión desplegada en cada uno, y cuál. Los tenants con un solo runtime nunca lo ven.
Nuevas comprobaciones de diseño en el iFlow Inspector
La lista de revisión del iFlow suma cinco comprobaciones, con una nueva categoría Documentación:
| Comprobación | Por qué importa |
|---|---|
| Receptor sin dirección (error) | El iFlow se despliega, pero cada llamada a este receptor falla en tiempo de ejecución. |
| Emisor HTTPS con una dirección predeterminada (advertencia) | Una dirección vacía, / o de relleno como /test no les dice nada a quienes llaman, y dos iFlows pueden chocar en ella. |
| El emisor HTTPS espera un token CSRF (información) | Cada llamante debe obtener primero un X-CSRF-Token, o su POST recibe un 403. |
| Dirección del receptor escrita en el iFlow (información) | Pasar entre DEV, QA y PROD obliga a editar el iFlow; Externalize Parameters lo resuelve en un paso. |
| El participante conserva su nombre predeterminado (información, Documentación) | "Sender" y "Receiver" también aparecen en el monitoreo, así que nadie sabe a qué sistema se refieren. |
Como las demás comprobaciones, cuentan para la puntuación y se pueden desactivar una por una. Verlas es gratis; exportar el informe forma parte de Pro. Externalize Parameters y las demás herramientas nuevas del Helper se describen en Externalize Parameters, copia de pasos e importación desde el Hub.
Un documento para todo el paquete
Junto a Documentar este iFlow, el menú de Kitegra ahora tiene Documento del paquete. Lee uno por uno todos los iFlows del paquete del iFlow abierto ("Leyendo el iFlow 2 de 5…"), y puedes detenerlo y abrir lo leído hasta ese momento. Los iFlows que no se pudieron leer aparecen en una lista. El documento se abre en una pestaña nueva, en Word, PDF o HTML, o rellenado en tu propia plantilla de Word, igual que el documento de diseño técnico de un iFlow. Contiene la versión, el proveedor, las etiquetas y el número de iFlows del paquete, luego cada iFlow, y dos partes nuevas:
- Panorama de sistemas: un diagrama con los emisores a la izquierda, los iFlows del paquete en el centro y los receptores a la derecha. Los participantes con el mismo nombre se convierten en un solo cuadro, y cada línea indica sus tipos de adaptador.
- Estado de la documentación: lo que necesita un lector, comprobado punto por punto: la descripción y las etiquetas del paquete, una descripción para cada iFlow, participantes renombrados en lugar de Sender y Receiver, y direcciones de receptores externalizadas. Muestra cuántas comprobaciones se superaron y qué falta, para que completes los huecos antes de entregarlo.
Value Mapping en Excel
En la página de iFlow Docs, en Value Mappings, sube el ZIP de un Value Mapping (descárgalo desde su paquete en SAP) o su value_mapping.xml. Kitegra lista los valores y genera un libro de Excel con una hoja por cada par de agencia e identificador: agencia, identificador y valor de origen, y luego agencia, identificador y valor de destino. El archivo se lee en tu navegador; no se lee nada de SAP y no se envía nada a ninguna parte. La hoja de Message Mapping funciona igual para los mappings.
Scripts explicados en lenguaje sencillo
Explicar scripts en el menú de Kitegra lista cada paso de script Groovy del iFlow. Para cada uno muestra el comentario de resumen del autor, las funciones que define, lo que lee (body, headers, exchange properties, adjuntos), lo que define y cambia, su lógica principal (analizar o construir XML o JSON, bucles, decisiones, llamadas HTTP, fechas), las API de SAP que usa, como Security Material, Value Mapping o Partner Directory, y notas y riesgos. Haz clic en el nombre de un paso para seleccionarlo en el diagrama. La explicación se elabora a partir del texto del script en tu navegador; el script nunca se envía a ninguna parte.
Desactiva cualquier herramienta que no uses
La página de opciones ahora tiene una sección Herramientas con un interruptor para cada herramienta, agrupada bajo su módulo: desde la comprobación de XPath, Ordenar, Security Material, Externalize, copiar y pegar pasos y la importación desde el Hub en el Helper, pasando por Mensajes, el selector de runtime, el visor de logs y la vigilancia del despliegue, la información del iFlow, el Inspector y la búsqueda, Documentos y Scripts explicados, hasta Notas, Fragmentos, Comparar, Convertir, Generar y el HTTP Runner en la Toolbox. Una herramienta desactivada desaparece al instante del diseñador y de la ventana emergente; tus datos se conservan, y Activar todas lo restablece todo. Para desactivar un módulo entero, usa Módulos en la misma página; consulta la página de opciones.
La vigilancia del despliegue, el selector de runtime, Scripts explicados y ver las comprobaciones de diseño son gratis. El documento del paquete, el panorama de sistemas y la hoja de Value Mapping pertenecen a iFlow Docs, con algunos usos en Free y Starter. Mientras Kitegra se lanza, todas las herramientas están abiertas para cualquiera que haya iniciado sesión. Compara los planes.
Pruébalo en tu próximo iFlow
Lee lo que Kitegra agrega alrededor del diseñador de SAP Integration Suite, o las nuevas herramientas para escribir iFlows.
Preguntas frecuentes
¿Kitegra despliega mi iFlow?
No. Tú pulsas Deploy en SAP; la vigilancia del despliegue solo lee el estado del despliegue y te avisa cuando está Started o ha fallado.
¿Cómo documento un paquete completo de SAP CPI?
Abre cualquier iFlow del paquete y elige Documento del paquete en el menú de Kitegra. Lee cada iFlow y abre un solo documento con el diagrama del panorama de sistemas y el estado de la documentación, en Word, PDF o HTML.
¿Puedo exportar un Value Mapping a Excel?
Sí. Descarga el ZIP del Value Mapping desde su paquete en SAP y súbelo en la página de iFlow Docs. Obtienes una hoja por cada par de agencia e identificador; el archivo nunca sale de tu navegador.
¿Por qué no veo el selector de runtime?
Solo aparece en tenants con más de un runtime, como Cloud junto con Edge Integration Cell.
Si desactivo una herramienta, ¿se borran mis datos?
No. La herramienta desaparece del diseñador y de la ventana emergente, y sus datos se conservan. Vuelve a activarla en la sección Herramientas de la página de opciones.