Kitegra 2.0: autocompletado, trace de mensajes, iFlow Inspector y documentación para SAP CPI

Construir un iFlow en el diseñador de SAP Integration Suite obliga a salir de él a menudo: al monitor para ver qué hizo un mensaje, a una hoja de cálculo para la especificación del mapping, a otra herramienta para llamar al endpoint, a un compañero para preguntar qué regla de nombres se aplica. Kitegra es una extensión para Chrome y Edge que pone ese trabajo junto al diagrama que estás editando.

La versión 2.0 pasa de un módulo a cinco áreas. Este artículo explica qué hace cada una, qué cambia la extensión en tu tenant y cuándo, qué guarda y qué sincroniza, y cuántos iFlows cubre cada plan. Es una de las extensiones de Chrome de Kitegra.

Cinco áreas alrededor del diseñador de iFlows

Abre un iFlow y verás un cuadro de Kitegra en la barra de herramientas del diagrama, tanto en modo de vista como de edición. «Mensajes», «Logs» e «Información del iFlow» tienen su propio botón en él; todas las demás herramientas están en el menú detrás del último botón, y Alt+Shift+P abre ese menú desde el teclado. Cada herramienta abre un panel que puedes mover por la página. Las herramientas pertenecen a cinco áreas:

• Helper (Integration Flow Helper): escribe iFlows más rápido, con sugerencias y comprobaciones en los propios campos del diseñador.
• Message Monitor: los mensajes, el trace y los logs del iFlow abierto, dentro del diseñador.
• iFlow Inspector: los detalles del iFlow desplegado, comprobaciones de nombres y de diseño, y búsqueda.
• iFlow Docs: documentos generados a partir de un iFlow o de un Message Mapping.
• Toolbox: herramientas gratuitas para comparar, convertir y generar payloads, fragmentos, notas y solicitudes HTTP.

Cada área se puede desactivar en la página de opciones, en «Módulos». A su alrededor, unos cuantos extras del espacio de trabajo hacen más cómodo el día a día en el tenant: una barra de entorno, la personalización de la pestaña, enlaces de monitorización y atajos de teclado.

Helper: escribe iFlows más rápido

Escribe ${ o $ en un campo del diseñador y se abre una lista con los nombres que encajan en ese punto del iFlow. El resto del Helper se apoya en el mismo modelo de tu iFlow:

• Sugerencias: los headers y las exchange properties que define tu iFlow, los headers estándar de SAP y Camel, los parámetros {{…}}, las variables, los Data Stores y, en los campos de credenciales, los nombres de Security Material y de Keystore.
• Revisión de expresiones: expresiones sin cerrar, espacios sobrantes, headers que nada define antes del paso actual y nombres de OData que el EDMX no contiene.
• Fuentes: rutas XPath a partir de un payload de ejemplo, URLs y cuerpos a partir de un archivo OpenAPI, Swagger o Postman, y headers que pasan por ProcessDirect y JMS.
• Ordenar diagrama: ordena el diagrama con un clic en modo de edición; Save lo conserva y el botón de deshacer de al lado lo deja como estaba.

Los seis artículos anteriores profundizan en estos temas, empezando por Expresiones Camel Simple en SAP CPI.

Message Monitor: mira qué pasó

• Mensajes: los últimos mensajes del iFlow abierto en un panel junto al diagrama, con estado, hora y duración, y el error de SAP explicado bajo «Qué suele significar:».
• Trace: un solo interruptor pone el nivel de log del iFlow en TRACE y lo mantiene activo mientras trabajas.
• En el diagrama: los pasos por los que pasó un mensaje trazado se colorean en el diagrama, y un clic en un paso muestra el body, los headers y las exchange properties antes de él.
• Logs de mensajes: un visor de logs con búsqueda por Message ID o Correlation ID, una línea de tiempo de los mensajes relacionados y los tiempos de cada paso en el diagrama.

Trazar un mensaje paso a paso muestra el flujo completo.

iFlow Inspector e iFlow Docs: revisar y documentar

• Nombres: las reglas que acuerda tu equipo, comprobadas en cada paso, con un nombre propuesto y un botón «Renombrar».
• Comprobaciones de diseño: manejo de errores, secretos en texto plano, protocolos inseguros, riesgos en scripts y más, con una puntuación de 0 a 100, una línea base y un informe en HTML, PDF o Excel. La lista de revisión de iFlows las enumera.
• Información del iFlow: despliegue, endpoints, entradas del Data Store, variables y el bloqueo de edición, con Undeploy, Unlock y Eliminar cuando los necesitas.
• Búsqueda en el iFlow o en todo su paquete.
• Un documento de diseño generado a partir del iFlow, en Word, PDF o HTML, con su diagrama y una narración de cada proceso, o volcado en tu propia plantilla de Word. Consulta cómo generar un documento de diseño técnico.
• Una hoja de mapping en Excel para los Message Mappings, y scripts explicados.

Toolbox y espacio de trabajo

• Comparación de payloads, un conversor de formatos, un generador de payloads de prueba con errores incluidos, fragmentos de Groovy y una hoja de referencia, y notas por iFlow, por tenant o globales.
• Un HTTP Runner para los endpoints de tus iFlows, con OAuth a partir de una service key de Process Integration Runtime.
• Una barra de entorno (PROD, TEST, DEV) y personalización de la pestaña por tenant, enlaces de monitorización, atajos de teclado y el tamaño del panel de propiedades.

La interfaz está disponible en 15 idiomas, en modo claro y oscuro.

Cómo empezar, paso a paso

1. Agrega Kitegra a Chrome o Microsoft Edge.
2. Abre un iFlow en el diseñador de SAP Integration Suite de tu tenant (una dirección *.hana.ondemand.com).
3. Haz clic en un campo, por ejemplo un valor de Content Modifier, y escribe ${ o $; elige un nombre de la lista.
4. En el cuadro de Kitegra de la barra de herramientas del diagrama, haz clic en «Mensajes», «Logs» o «Información del iFlow», o abre su menú para el «Inspector» y las demás herramientas.
5. Abre la ventana emergente de la extensión para ver tus tenants, paquetes e iFlows, y la vista «Herramientas» con las páginas de la Toolbox.

Sin cuenta puedes usar cada módulo en 5 iFlows. Para usarlos en más, elige Iniciar sesión con Kitegra en la extensión.

Pruébalo en tu próximo iFlow

Mira Kitegra junto a las demás extensiones de Chrome de Kitegra y compara lo que incluye cada plan.

Qué cambia en tu tenant, y cuándo

La extensión lee el iFlow abierto, sus mensajes y sus logs con tu propia sesión de SAP. Nunca guarda, despliega ni edita el contenido de un iFlow: «Renombrar» y los fragmentos solo escriben en los campos del diseñador, y eres tú quien guarda. Solo cambia tu tenant cuando haces clic en una de estas cuatro acciones con nombre:

Un solo interruptor en la página de opciones, «Permitir acciones que cambian el tenant», desactiva las cuatro: sus botones desaparecen y la extensión las rechaza. El HTTP Runner solo envía las solicitudes que tú escribes y envías.

Qué guarda y qué se sincroniza

• El contenido de los mensajes (bodies, headers, propiedades, adjuntos y logs) se muestra en la página y nunca se guarda ni se envía a ningún sitio.
• Sin una cuenta de Kitegra, nada sale de tu navegador.
• Con la sesión iniciada, Kitegra guarda, por cada iFlow que abres, su nombre e id, su paquete, el enlace al diseñador, los módulos usados, las fechas y un hash unidireccional de tu cuenta de SAP, para contar los iFlows de tu plan.
• Con la sesión iniciada, lo que escribiste te acompaña en cualquier equipo: configuración y atajos, notas, reglas de nombres, ajustes y líneas base de las comprobaciones de diseño, la personalización de los tenants, los fragmentos y las colecciones del HTTP Runner, sin ningún valor de autenticación ni variable secreta. Con el interruptor «Panel de Kitegra» activado en la página de opciones (activado de forma predeterminada), también se envían los nombres y los ids de tus paquetes e iFlows, y en un plan de equipo el propietario del equipo puede verlos, junto con tus notas.
• Nunca se envía: contenido de mensajes, scripts, mappings, payloads de ejemplo, especificaciones de API, credenciales ni secretos. En Opciones › Sincronización, «Eliminar datos sincronizados» borra de Kitegra lo que se sincronizó.

Cuántos iFlows cubre cada plan

El límite cuenta iFlows distintos, por módulo y de por vida: volver a abrir un iFlow que ya usaste no cuenta de nuevo, y un iFlow usado por un módulo solo lo cuenta otro módulo cuando usas ese otro módulo en él.

El Helper, Message Monitor, iFlow Inspector e iFlow Docs cuentan iFlows; la Toolbox y los extras del espacio de trabajo no cuentan ninguno. Un iFlow que supera el límite de tu plan muestra un candado en el diseñador y en la ventana emergente. Mientras Kitegra se lanza, todas las herramientas están abiertas para cualquiera que haya iniciado sesión, también en el plan Free. Al iniciar sesión con Kitegra, los iFlows que usaste sin cuenta pasan a tu cuenta. Compara los planes.

Preguntas frecuentes