12.11 Notas de la versión de Harmony

Versión 12.11 de Harmony

La versión 12.11 de Harmony se implementa de manera escalonada según las fechas y horas que se enumeran a continuación por componente y región. Para obtener una explicación más detallada de la cadencia de versiones por categoría de componente, consulta el cronograma de versiones.

App Builder 4.67 y Wevo iPaaS cuentan con notas de versión independientes.

También está disponible una recopilación de notas de versión para Grupos de agentes en la nube de producción, Grupos de agentes en la nube de espacio aislado y agentes privados.

Puedes suscribirte a notificaciones de mantenimiento para componentes basados en web en Jitterbit Trust. Los componentes instalados localmente están disponibles en la página Descargas. Las imágenes del agente privado Docker, la puerta de enlace de API privada y App Builder están disponibles en Docker Hub de Jitterbit. La fecha de fin de vida útil para estos componentes (excepto App Builder) es un año después de la fecha de lanzamiento.

Nuevas funcionalidades

Conectores

• Conector ServiceNow v2
  El conector ServiceNow v2 ahora está disponible de manera general. Se puede usar con agentes en la nube o privados para consultar, crear, actualizar o eliminar registros en ServiceNow.

Mejoras

Agent

• Agrupamiento de conexiones para conexiones de base de datos de origen y destino
  Los agentes ahora pueden reutilizar conexiones JDBC agrupadas para una conexión de base de datos en Studio y un origen de base de datos o destino en Design Studio, en lugar de abrir y cerrar una nueva conexión para cada operación. Esto reduce la sobrecarga de conexiones y mejora la confiabilidad bajo cargas concurrentes pesadas. El agrupamiento de conexiones se encuentra deshabilitado por defecto. Para habilitarlo en un agente privado, establece jdbc.hikari.enabled=true en la sección [SourceTargetPooling] de jitterbit.conf y reinicia el agente.

Conectores

• Soporte del conector Amazon Bedrock para modelos GPT-5.6
  Las actividades Prompt y Registrar herramientas de Amazon Bedrock ahora admiten la familia de modelos GPT-5.6 de OpenAI: gpt-5.6-sol, gpt-5.6-terra y gpt-5.6-luna. Como estos modelos requieren un ID de perfil de inferencia de AWS en lugar de un ID de modelo bajo demanda, selecciona la opción Ingresar identificador de modelo e introduce el ID de perfil de inferencia del modelo (por ejemplo, us.openai.gpt-5.6-sol) en lugar de seleccionar el modelo de la tabla Listar todos los modelos.

• Disponibilidad general de la actividad MCP Client Prompts and Resources y selección predeterminada
  El conector MCP Client incluye las siguientes actualizaciones en sus actividades Prompts and Resources:

  • Disponibilidad general: Las actividades Listar recursos, Listar indicaciones, Obtener indicación y Leer recurso están ahora disponibles de forma general.
  • Selección predeterminada: Los pasos Elegir herramienta, Elegir indicación y Elegir recurso de las actividades Invocar herramientas, Obtener indicación y Leer recurso ahora tienen como valor predeterminado la opción Seleccionar herramienta de la lista, Seleccionar indicación de la lista y Seleccionar recurso de la lista, en lugar de la opción de entrada manual.

• Etiquetas de entrada manual estandarizadas en conectores
  Los conectores ahora utilizan una etiqueta consistente para la opción de introducir manualmente el nombre, ID o URI de un objeto. Anteriormente, esta etiqueta variaba según el conector, utilizando redacciones como Informar..., Ingresar... o Usar entradas de texto.

  • Amazon S3: Las actividades Obtener objeto, Enviar objeto, Eliminar objeto, Listar objetos y Mover objeto especifican un depósito usando la opción Seleccionar depósito de la lista o Proporcionar depósito de S3 manualmente.
  • Cloud Datastore: Las actividades Insertar elementos, Consultar elementos, Actualizar elementos, Eliminar elementos, Eliminar almacenamiento y Obtener métricas especifican un nombre de almacenamiento usando la opción Proporcionar nombre de almacenamiento manualmente.
  • Google Pub/Sub: Las actividades Obtener, Publicar, Reconocer y Escucha especifican una suscripción o tema usando la opción Proporcionar suscripción manualmente o Proporcionar tema manualmente.
  • MCP Client: Las actividades Invocar herramientas, Leer recurso y Obtener indicación especifican una herramienta, recurso o indicación usando la opción Proporcionar nombre de herramienta manualmente, Proporcionar URI de recurso manualmente o Proporcionar nombre de indicación manualmente.
  • Microsoft Azure Key Vault: Las actividades Actualizar objetos de almacén, Eliminar objetos de almacén y Consultar objetos de almacén especifican un objeto usando la opción Proporcionar objeto manualmente.
  • Microsoft Azure Service Bus: La actividad Enviar mensaje especifica una cola o tema usando la opción Proporcionar cola o tema manualmente.
  • Microsoft Teams: La actividad Chat especifica un chat usando la opción Proporcionar ID de chat manualmente.
  • SMB: Las actividades Crear carpeta, Crear archivo, Buscar, Actualizar carpeta, Actualizar archivo, Eliminar carpeta, Eliminar archivo y Leer archivo especifican una carpeta usando la opción Proporcionar nombre de carpeta manualmente.
  • Slack: La opción Proporcionar ID de conversación manualmente de la actividad Enviar mensaje y el campo Proporcionar ID de conversación/ID de canal especifican la conversación o el canal.

Management Console

• Estado de uso y referencias de endpoints en la página App Registrations
  La tabla principal de la página App Registrations tiene nuevas columnas de Uso y Endpoints que muestran si cada registro de aplicación es referenciado por algún endpoint y, en caso afirmativo, por cuántos. El panel de detalles del registro tiene una nueva pestaña Endpoints usage que enumera el proyecto, el entorno, el conector, la expiración, el estado de autorización y la fecha de última implementación para cada endpoint referenciador, junto con una acción Go to endpoint para abrir la configuración del endpoint en Studio.

Studio

• Más tipos de componentes en la vista de diferencias de importación selectiva y transferencia selectiva
  La vista de diferencias para revisar conflictos de componentes ahora cubre más tipos de componentes:

  • Selective import: El botón View changes ahora cubre herramientas, operaciones, variables de proyecto, notificaciones de correo electrónico, endpoints de conector y actividades de conector, además del soporte existente de scripts y transformaciones. Estos tipos adicionales utilizan una nueva vista de diferencias de comparación de campos, mostrada como una tabla de Nombre, Antes y Después, junto con la vista de diferencias de código lado a lado existente utilizada para scripts y transformaciones.
  • Selective transfer: El icono View changes ahora también cubre herramientas, notificaciones de correo electrónico, operaciones, variables de proyecto y programaciones, además del soporte existente de scripts, transformaciones, endpoints de conector y actividades de conector.

Cambios

Agent

• Límite de llamadas sincrónicas de RunOperation dentro de bucles While
  Un bucle While que llama a RunOperation de forma sincrónica ahora está limitado a 50 llamadas por defecto, para evitar que un bucle sin control o no acotado invoque miles de operaciones secundarias. Cuando se alcanza el límite, RunOperation devuelve false y el script continúa ejecutándose; el motivo está disponible en GetLastError y también se registra en el registro de operaciones.

  Tres claves nuevas en la sección [OperationEngine] del archivo de configuración del agente privado (jitterbit.conf) controlan este comportamiento:

  • MaxSynchronousRunOperationCallsInLoop: Cambia o elimina el límite predeterminado.
  • MaxSynchronousRunOperationCallsInLoopOverrideAllowed: Controla si una operación individual puede anular el límite utilizando la nueva variable Jitterbit jitterbit.operation.max_sync_runop_calls_in_loop.
  • MaxSynchronousRunOperationCallsInLoopCustomError: Personaliza el mensaje de error mostrado cuando se alcanza el límite.

• Restricciones de entidad externa para RunXSLT
  Por razones de seguridad, los agentes ahora bloquean por defecto las declaraciones DOCTYPE y la resolución de entidades externas al procesar la función RunXSLT: se rechaza la entrada XML que contiene una referencia DOCTYPE, ENTITY o URI externa. Para permitir este procesamiento, actualiza la clave correspondiente en la sección [XsltEngine] del archivo de configuración del agente (jitterbit.conf) y luego reinicia el agente.

API gateway

• Límite de longitud del identificador de usuario para registros de API
  El valor registrado para identificar quién realizó una solicitud de API ahora se limita a 256 caracteres, coincidiendo con su límite de almacenamiento subyacente. Una solicitud falla con un error TRIGGER_USER_TOO_LONG si este valor excede el límite de longitud. Para resolver este error, verifica cuál de los siguientes se aplica:

• Autenticación básica con la configuración de Logging predeterminada: Actualiza el campo Nombre de usuario del perfil de seguridad a 256 caracteres o menos, luego actualiza las credenciales en cualquier aplicación de llamada que haga referencia al nombre de usuario anterior.

• Configuración de Logging personalizada: Actualiza la aplicación de llamada para enviar un valor de encabezado de 256 caracteres o menos.

Correcciones

Agente

• El conector File Share ahora sustituye una variable colocada después de una barra invertida en una ruta
  El campo Path del conector File Share, en su configuración de conexión, y la función FileList llamada desde un script ahora sustituyen una variable global o de proyecto que se encuentra inmediatamente después de una barra invertida (\\) en una ruta UNC (por ejemplo, \\\\server\\share\\[myVariable]\\). Anteriormente, la barra invertida inmediatamente anterior a la variable se trataba como un carácter de escape, por lo que se usaba el nombre literal de la variable en la ruta en lugar de su valor, causando errores como The system cannot find the path specified.

• La validación de campos de Design Studio ahora respeta una acción Skip Row configurada
  Una regla de validación de campo de Design Studio configurada con una acción Skip Row se respeta nuevamente durante la ejecución de operaciones. A partir de la versión 12.6 del agente, una fila que debería haberse omitido según una regla de validación configurada llegaba al destino sin cambios.

• La duración de la operación cancelada ahora se reporta con precisión
  Cuando se cancela una operación después de alcanzar su Tiempo de espera de operación configurado, la Duration que se muestra en la tabla de detalles de operaciones de Runtime de la Consola de Administración y en los registros de operaciones ahora refleja el tiempo real hasta la cancelación, típicamente dentro de unos segundos del valor de tiempo de espera configurado. Anteriormente, esta duración podría reportarse como hasta el doble del valor de tiempo de espera configurado, aunque la operación se cancelara en el momento correcto.

• Los nombres de archivo multibyte en agentes privados de Windows ahora se procesan de manera confiable
  La lectura o escritura de un archivo cuyo nombre contiene caracteres multibyte ahora se procesa de manera confiable en agentes privados de Windows usando File Share, FTP, Local Storage, o Temporary Storage en Studio o Design Studio.

Agente y Design Studio

• Los cambios en la conexión OAuth 2.0 de Salesforce ahora se guardan correctamente en Design Studio
  Los cambios a los campos Instance URL, Client ID, y Client secret de un Salesforce Org existente configurado con autenticación de cliente OAuth 2.0 de dos patas ahora se guardan antes de que se ejecute Test Salesforce Login. Anteriormente, probar la conexión inmediatamente después de editar estos campos podría validarse en comparación con los valores anteriores en lugar de los actualizados, devolviendo un resultado de éxito o fallo engañoso.

API Manager

• La descarga CSV de monitoreo de salud de API ahora coincide con la puerta de enlace seleccionada
  La descarga de la tabla de monitoreo de salud de API como CSV en la página Analytics ahora devuelve datos de la misma puerta de enlace que los resultados mostrados en pantalla. Anteriormente, la descarga siempre devolvía datos de la puerta de enlace predeterminada de la organización, independientemente de qué datos de puerta de enlace estuvieran actualmente seleccionados y mostrados.

Conectores

• El conector Microsoft Excel v2 ahora se carga correctamente en agentes privados Windows 12.x
  El conector Microsoft Excel v2 ahora se carga correctamente en agentes privados Windows 12.x. Anteriormente, probar una conexión o ejecutar una operación con este conector en un agente privado Windows 12.x devolvía un error indicando que el conector no se encontraba en el agente. Para aplicar esta corrección, haz clic en Test en la conexión de Studio para descargar la versión más reciente del conector, o utiliza la página Action > Update connectors de la consola de administración para forzar la actualización en todo el grupo de agentes.

Plataforma Harmony

• Las implementaciones de proyectos ya no fallan durante una conmutación por error de base de datos
  Implementar un proyecto en Studio o Design Studio ya no falla ni se queda sin respuesta durante un período extendido durante una conmutación por error de base de datos. Anteriormente, una conmutación por error en curso o un evento de mantenimiento extendido podía bloquear las implementaciones de proyectos hasta que se completara.

• Las operaciones que un agente no puede ejecutar ahora fallan más rápidamente
  Una operación cuyo agente asignado reporta que no puede ejecutarla ahora cambia al estado Error mucho más rápidamente. Esto también resuelve un problema relacionado en el que un gran atraso de tales operaciones competía por intentos de reintento limitados cada ciclo, retrasando aún más la resolución.

• Los datos de registros de API y análisis ahora se registran para versiones antiguas de la puerta de enlace de API privada
  Las solicitudes de API servidas a través de una puerta de enlace de API privada anterior a la versión 11.57 ahora generan entradas en API Logs y Analytics. Anteriormente, estas entradas podían no aparecer silenciosamente aunque la solicitud se procesara normalmente.

Consola de administración

• El recuento de acceso de roles de entorno ya no se vuelve inexacto después de ediciones concurrentes
  La pestaña Environment Role Access en la página User Management y el panel Role Access en la página Environments ahora permanecen sincronizados cuando el acceso del entorno del mismo rol se edita desde ambas ubicaciones simultáneamente. Anteriormente, hacer esto podía crear una asociación de rol-entorno duplicada, causando que el recuento de entorno mostrado en la página User Management ya no coincida con el número real de entornos activos de la organización.

• La tabla de almacenamiento de claves de Cloud Datastore ahora se desplaza horizontalmente
  La tabla de datos de almacenamiento de claves en el panel de detalles de un almacenamiento de claves ahora muestra una barra de desplazamiento horizontal cuando sus columnas son más anchas que el panel, permitiéndote desplazarte para ver cualquier columna, incluida Actions, que de otro modo se extendería más allá del borde derecho. Anteriormente, estas columnas se cortaban sin forma de desplazarse hacia ellas, aunque permanecían accesibles mediante desplazamiento con mayúsculas.

Studio

• Editar ciertos esquemas grandes o profundamente anidados ya no hace que Studio no responda
  Editar un esquema que es muy grande o profundamente anidado ya no hace que la pestaña del navegador no responda o se quede sin memoria cuando haces clic en Edit Schema. Los nodos en un esquema de 5,000 o más nodos ahora se expanden a 2 niveles de profundidad de forma predeterminada, en lugar de 5.

Avisos

Agente

• Jubilación del control de versiones del agente privado 11.x
  La versión 11.59 / 12.3 incluyó la versión final del agente privado 11.x (11.59) y la primera versión disponible del agente privado 12.x (12.3). Ten en cuenta lo siguiente respecto a futuras versiones:

  • Versión final 11.x: La versión del agente privado 11.x ha alcanzado el fin de su desarrollo planeado. Todas las mejoras futuras, características nuevas y actualizaciones de seguridad se entregarán a través de agentes privados 12.x. Aunque los agentes 11.x pueden recibir correcciones críticas raramente para problemas que afecten la producción, no hay versiones futuras planeadas.
  • Recomendación: Te recomendamos encarecidamente actualizar a agentes privados 12.x lo antes posible para beneficiarte de las mejoras más recientes de rendimiento, seguridad y características.
  • Ruta de actualización: Puedes actualizar directamente de 11.x a cualquier versión 12.x utilizando nuestras instrucciones de actualización documentadas: Windows, Linux, o Docker.

Agent y gateway de API

• Fin de vida útil de la versión 11.49
  A partir del 18 de septiembre de 2026, estas versiones de producto han alcanzado el fin de vida útil y ya no cuentan con soporte:

  • Agente privado versión 11.49
  • Gateway privado de API versión 11.49

  Recomendamos que los usuarios de estas versiones actualicen a la versión más reciente cuanto antes sea posible.

Conectores

• Acción requerida: Obsolescencia de las actividades OpenAI Prompt y Register Tools
  Las actividades Prompt y Register Tools de OpenAI ahora están obsoletas y ya no cuentan con soporte, y se eliminarán permanentemente en una próxima versión. Ambas fueron reemplazadas en la versión 12.8 por las actividades rediseñadas Prompt V2 y Register Tools V2, cuyo uso de la API de Responses de OpenAI permite persistir el contexto de chat e invocar herramientas registradas en grupos de agentes en la nube, no solo en agentes privados.

  Importante

  Si utilizas la actividad Prompt (Deprecated) o Register Tools (Deprecated) en cualquier operación, debes revisar tu diseño de operación y reemplazarla con la actividad Prompt V2 o Register Tools V2 cuanto antes, ya que las actividades obsoletas ya no cuentan con soporte y se eliminarán en el futuro.

• Acción requerida: Próxima eliminación de la actividad deprecated Cloud Datastore Query Items
  En una próxima versión, la actividad Query Items deprecated en el conector Cloud Datastore se eliminará permanentemente. Esta actividad fue reemplazada en la versión 11.47 por la actividad Query Items rediseñada, cuya estructura de respuesta aplanada devuelve los campos individuales que defines en la página Cloud Datastore de Management Console directamente en el nivel superior de la respuesta.

  Importante

  Si utilizas la actividad Query Items deprecated en cualquier operación, debes revisar tu diseño de operación y reemplazarla con la actividad Query Items rediseñada cuanto antes. La actividad deprecated ya no cuentan con soporte y se eliminará en una próxima versión.