12.7 Notas de la versión de Harmony

Versión 12.7 Harmony

La versión 12.7 Harmony se implementa de forma 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 lanzamiento por categoría de componente, consulta el cronograma de lanzamiento.

App Builder 4.63 y Wevo iPaaS tienen notas de la versión separadas.

También están disponibles compilaciones de notas de la 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 y App Builder están disponibles en Jitterbit's Docker Hub. 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 funciones

Agentes de IA

• Agente QBR Deck
  El Agente QBR Deck, accesible desde la categoría Agente de IA del Marketplace, automatiza la creación de presentaciones de revisión trimestral de negocios (QBR) en Google Slides al recopilar datos de clientes de Salesforce, NetSuite y API de uso de productos, y utiliza IA para producir resúmenes e información estructurada. Para agregarlo a tu licencia, contáctanos.

• Agente de RFI de Seguridad
  El Agente de RFI de Seguridad, accesible desde la categoría Agente de IA del Marketplace, automatiza el procesamiento integral de cuestionarios de RFI de Seguridad (Solicitud de Información) para elaborar respuestas fundamentadas a partir de tus bases de conocimiento internas y entregar documentos Word y Excel listos para enviar. Para agregarlo a tu licencia, contáctanos.

Mejoras

Agente y Design Studio

• Codificación de caracteres predeterminada cambiada a UTF-8
  A partir de la versión 12.7 del agente y la versión 11.63 de Design Studio, la codificación de caracteres predeterminada para la plataforma Harmony ha cambiado de Latin-1 (ISO-8859-1) a UTF-8. Si tu integración requiere una codificación de caracteres específica, configúrala explícitamente usando las variables de codificación de caracteres.

Agente

• Compatibilidad con proxy para métricas de observabilidad nativa
  La función de observabilidad nativa de un agente privado, que reporta métricas a través de la página Agentes de la Consola de Administración, ahora hereda automáticamente la configuración de proxy del agente cuando este se comunica a través de un servidor proxy.

• Actualización de Apache Tomcat
  El servidor Apache Tomcat incluido con el agente ha sido actualizado para mejorar la seguridad y el rendimiento.

Agente, Studio y Design Studio

• Compatibilidad con la versión 66 de la API de Salesforce
  La versión 66 de la API de Salesforce (Spring '26) ahora es compatible con los siguientes conectores:

  • El conector Salesforce de Studio utiliza automáticamente esta versión de API para actividades no masivas cuando su conexión está configurada con Credenciales de Cliente OAuth 2.0 y se usa con agentes versión 12.7 o posterior.

  • El conector Salesforce de Design Studio es compatible con esta versión de API mediante el uso de agentes versión 12.7 o posterior y Design Studio versión 11.63 o posterior. Cuando se cumplen ambos requisitos de versión, se muestra un diálogo de actualización de API al abrir proyectos existentes que usen este conector.

API Manager, EDI y portal Harmony

• Controles de expansión y redimensionamiento para paneles del asistente de IA
  Los paneles AskJB AI, Asistente de IA de APIM y Asistente de IA de EDI ahora incluyen un control Expandir para hacer el panel más ancho. Los paneles también se pueden redimensionar manualmente arrastrando el borde izquierdo del panel. Cuando un panel está expandido, usa el icono Minimizar para volver a la vista anterior.

API Manager y Consola de Administración

• Opción de exportación a CSV de Registros de Tiempo de Ejecución y Registros de API para incluir mensajes de registro
  La opción Descargar como CSV en la página Tiempo de Ejecución de la Consola de Administración y la página Registros de API de API Manager ahora abre un diálogo Descargar registros donde puedes seleccionar Incluir mensajes para agregar el contenido completo de los mensajes de registro a la exportación.

Conectores

• Compatibilidad del conector Google Docs con OAuth de 3 etapas
  Una conexión de Google Docs tiene un nuevo menú Tipo de autenticación donde seleccionas OAuth (recién compatible) o Basado en Clave Privada (predeterminado existente). La opción OAuth utiliza OAuth 2.0 de 3 etapas (3LO) y requiere un registro de aplicación de la Consola de Administración configurado. Para obtener instrucciones de configuración, consulta Requisitos previos de 3LO de Google Docs.

• Compatibilidad del conector Shopify con OAuth de 3 pasos y versión de API 2026-04
  Una conexión de Shopify tiene un nuevo menú Mecanismo de autenticación donde se selecciona OAuth (recién compatible) o Autenticación basada en credenciales (predeterminada existente). La opción OAuth utiliza OAuth 2.0 de 3 pasos (3LO) y requiere un registro de aplicación de la Consola de administración configurado. Para obtener instrucciones de configuración, consulta Requisitos previos de Shopify 3LO. El menú Versión de API ahora también tiene la versión 2026-04 de la API REST Admin como opción de selección.

• Compatibilidad del conector ZoomInfo (Beta) con OAuth de 3 pasos
  Una conexión de ZoomInfo tiene un nuevo menú Autenticación donde se selecciona Flujo de código de autorización (recién compatible) o Flujo de credenciales de cliente (predeterminado existente). La opción Flujo de código de autorización utiliza OAuth 2.0 de 3 pasos (3LO) y requiere un registro de aplicación de la Consola de administración configurado. Para obtener instrucciones de configuración, consulta Requisitos previos de ZoomInfo 3LO.

EDI

• Filtro de tipo de documento de dos niveles en la página Transacciones
  En la página Transacciones, el panel Filtros ahora agrupa el filtro Todos los tipos de documento en dos niveles: un tipo de documento general (como Pedido o Factura) que se puede expandir para revelar sus subtipos específicos, cada uno identificado por su código de tipo de documento (como 850 u 810). Selecciona un tipo de documento general para filtrar por todos sus subtipos a la vez, o selecciona uno o más subtipos para filtrar solo por esos.

• Compatibilidad del Asistente de IA de EDI para consultar documentos no conformes
  El Asistente de IA de EDI ahora admite la búsqueda de documentos que no pasaron las verificaciones de cumplimiento. Opcionalmente, puedes filtrar los resultados por nombre de socio, tipo de documento, dirección, estado o rango de fechas. Si se encuentran 20 o menos documentos coincidentes, el asistente enumera los ID de documento; si se encuentran más de 20, el asistente ofrece agrupar los resultados por socio o refinar la búsqueda.

Consola de administración

• Configuraciones de política de contraseña adicionales editables en organizaciones habilitadas para SSO
  En la página Organizaciones, dos políticas de Gestión de usuarios, Requerir carácter(es) especial(es) en la contraseña y Requerir autenticación de dos factores (TFA), ahora se pueden editar después de que se habilite el inicio de sesión único de Harmony (SSO) para una organización. Estas configuraciones se aplican a los usuarios en la lista Omitir SSO de la organización.

Studio y Consola de administración

• Finalización de línea generada por IA en el editor de scripts de Jitterbit
  El editor de scripts de Jitterbit de Studio ahora puede mostrar sugerencias de línea generadas por IA en línea mientras escribes, que aplicas presionando Tab. La función se controla mediante dos nuevas configuraciones:

  • Política de organización: Un administrador de la organización habilita la finalización de línea generada por IA a través de la política Permitir finalización de código de línea completa en el editor de scripts de Jitterbit en la pestaña Studio de la página Organizaciones de la Consola de administración. Esta política está deshabilitada de forma predeterminada.

  • Configuración del proyecto: Una vez habilitada la política, la configuración Habilitar sugerencia de finalización de código de línea completa en el editor de scripts de Jitterbit en la pestaña Avanzado de creación y configuración de proyectos controla la función por proyecto.

Studio y Agent

• Configuración del orden de procesamiento de archivos para conectores basados en archivos
  Las actividades Leer de Compartir archivos, FTP, Almacenamiento local y Almacenamiento temporal tienen cada una una nueva opción Orden de procesamiento de archivos en Configuraciones opcionales. Selecciona Nombre de archivo (predeterminado) para procesar archivos en orden alfabético por nombre de archivo, u Más antiguo primero para procesar archivos en el orden en que fueron modificados, comenzando con el más antiguo. Para actividades Leer de FTP, Más antiguo primero utiliza precisión de marca de tiempo a nivel de minuto debido a limitaciones del protocolo FTP; los archivos modificados dentro del mismo minuto se procesan en el orden devuelto por el servidor FTP. La clasificación Más antiguo primero requiere la versión 12.7 del agent o posterior.

Studio

• Vista de diferencias para transferencia e importación selectiva
  Ahora se puede obtener una vista previa de los cambios en un script o transformación en conflicto antes de transferirlo o importarlo. Haz clic en el botón Ver cambios para abrir una comparación lado a lado, con las líneas eliminadas en rojo y las líneas añadidas en verde. El botón aparece para los componentes en la categoría Sobrescribir durante una transferencia selectiva, y para los componentes en conflicto durante una importación selectiva.

• Detalle a nivel de campo del historial de proyectos para la configuración del conector
  El historial de proyectos ahora registra detalles a nivel de campo para los cambios de configuración de actividad y punto de conexión del conector, incluidos los campos de autenticación.

• Rediseño de la vista de tarjetas de la página Proyectos
  La vista de tarjetas en la página Proyectos ha sido rediseñada para mantener coherencia con otras aplicaciones de Harmony, mostrando las tarjetas con iconos de punto de conexión junto con la información estándar del proyecto.

Cambios

Agent

• Valores predeterminados de capacidad de CPU actualizados para agentes privados
  Los valores predeterminados de CpuConsecutiveFailureThreshold y CapabilityRefreshCooldown en la sección [AgentCapability] de jitterbit.conf han cambiado:

  • CpuConsecutiveFailureThreshold (introducido en 12.6) ahora tiene un valor predeterminado de 3 (anteriormente 1), lo que requiere tres violaciones consecutivas del umbral de CPU antes de que el agente cambie de Capaz a Incapaz.

  • CapabilityRefreshCooldown ahora tiene un valor predeterminado de 1 (anteriormente 2), lo que reduce el período de enfriamiento en segundos antes de que el estado de capacidad se actualice después de que el agente se vuelva incapaz.

API gateway

• Cambios generales
  La puerta de enlace de API tiene cambios generales para mantenimiento y rendimiento.

Conectores

• Eliminación de modelos de OpenAI obsoletos
  Se han eliminado seis modelos de OpenAI obsoletos del menú desplegable Modelo en las actividades Prompt y Registrar herramientas de OpenAI: gpt-4-turbo-preview, gpt-4-vision-preview, gpt-4-32k, gpt-3.5-turbo-instruct, babbage-002 y davinci-002. OpenAI ya no admite estos modelos y devolverían errores si se utilizaran.

Correcciones

Agent y Design Studio

• Correcciones de caracteres multibyte
  Las siguientes correcciones resuelven problemas con fallos de operación, salida incorrecta, caracteres mostrados incorrectamente y archivos y copias de seguridad inaccesibles.

  Estas correcciones se aplican cuando se utiliza la versión 12.7 del agente o posterior:

  • La función WriteToOperationLog ahora escribe caracteres multibyte en el registro de operaciones correctamente. Anteriormente, estos caracteres se corrompían.

  • La función GetEnvironmentName ahora devuelve caracteres multibyte correctamente, por lo que las comparaciones con nombres de entorno que los contienen tienen éxito.

  • La función StringLength ahora cuenta caracteres multibyte correctamente en lugar de contar bytes. Una nueva variable jitterbit.script.string.utf8size controla este comportamiento y tiene un valor predeterminado de true; establécela en false para utilizar el recuento de bytes heredado.

  • Las funciones ToLower, ToUpper y ToProper ahora convierten correctamente la mayúscula y minúscula de caracteres multibyte. Anteriormente, podían dejar la mayúscula y minúscula de un carácter multibyte sin cambios o cambiar incorrectamente la mayúscula y minúscula de un carácter adyacente.

• Los archivos de texto de ancho fijo ahora calculan el ancho de los campos por conteo de caracteres en lugar de conteo de bytes, por lo que los caracteres multibyte ya no desplazan las posiciones de las columnas. Una nueva variable jitterbit.text.fixed_width_use_byte_length controla este comportamiento y tiene como valor predeterminado false; establécela en true para usar el ancho basado en bytes heredado.

• Las programaciones de operaciones cuyos nombres contienen caracteres multibyte ya no fallan al ejecutarse. Anteriormente, ciertos caracteres en el nombre de una programación podían interrumpir la conexión a la base de datos del agente e impedir que la operación se ejecutara según la programación.

Estas correcciones requieren tanto la versión del agente 12.7 o posterior como Design Studio 11.63 o posterior:

• Las operaciones de consulta de NetSuite que contienen caracteres multibyte ya no fallan con un error de análisis XML.

• La función Probar llamada de servicio web ahora muestra correctamente los caracteres multibyte en el destino.

• Las copias de seguridad del proyecto implementadas con caracteres multibyte en la etiqueta de implementación ahora se pueden descargar desde la página Proyectos de la Consola de administración.

Agente

• Estabilidad mejorada del agente bajo procesamiento concurrente de solicitudes de API
  Los agentes son más resilientes al manejar solicitudes activadas por API concurrentes, lo que resuelve un bloqueo que podría ocurrir durante el procesamiento.

• La función FromDataLoaderDateTime ahora analiza fechas en formato europeo
  La función FromDataLoaderDateTime obsoleta en Design Studio ahora analiza correctamente las fechas en formato europeo usando un punto (DD.MM.YYYY) o guion (DD-MM-YYYY) como separador de fecha. Anteriormente, estos formatos devolvían el error 1007 Unparseable date.

API Manager

• Regenerar documentos ya no produce documentación OpenAPI vacía
  El botón Regenerar documentos del Portal Manager ahora genera documentación OpenAPI para todas las API personalizadas y proxy en un entorno. Anteriormente, generar documentación para un entorno cuyos servicios de API hacían referencia a ciertas operaciones podía producir una especificación sin operaciones definidas.

• La búsqueda con comodín en mensajes de registro de API ahora es compatible
  La barra de búsqueda Consultas en la página Registros de API ahora maneja correctamente el carácter comodín % en búsquedas de filtro de message. Anteriormente, usar % en una búsqueda de mensaje (por ejemplo, message=%final client%) causaba un error y no devolvía datos.

• Las descargas grandes de CSV de registro de API ya no generan errores
  La opción Descargar como CSV en la página Registros de API ahora genera y descarga correctamente archivos CSV para conjuntos de datos grandes. Anteriormente, descargar registros de API para rangos de fechas grandes o volúmenes de registros altos resultaba en errores como CSV file is still being generated. Please try again later y An error occurred while generating the CSV file.

Conectores

• Error SSLException del conector BMC Helix ITSM resuelto
  Se ha resuelto un error intermitente SSLException: Connection reset que ocurría durante llamadas HTTPS realizadas por el conector BMC Helix ITSM en ciertos casos.

• El conector HTTP v2 OAuth 2.0 Client Credentials ahora admite puntos finales de token que omiten expires_in
  El tipo OAuth 2.0 Client Credentials Grant del conector HTTP v2 ahora genera un token de acceso cuando la respuesta del punto final del token OAuth no incluye un campo expires_in. Anteriormente, la generación de tokens fallaba contra puntos finales que omiten este campo.

• La actividad Create Image de OpenAI ahora genera imágenes usando gpt-image-2
  La actividad Create Image de OpenAI anteriormente utilizaba el modelo deprecado dall-e-2, lo que causaba que la actividad fallara. Ahora la actividad utiliza el modelo gpt-image-2 e incluye nuevas configuraciones opcionales: Output Format (jpeg, png, webp), Number of Images, Quality, Output Compression, Moderation y Background. Los datos de imagen se devuelven como una cadena JSON codificada en Base64 (b64_json); las respuestas en formato de URL ya no son compatibles.

Management Console

• Eliminar un entorno ahora elimina los recursos asociados
  Eliminar un entorno desde la página Environments de Management Console ahora elimina automáticamente todos los almacenamientos de Cloud Datastore asociados, colas de mensajes y certificados de cliente. Anteriormente, eliminar un entorno podía dejar recursos huérfanos que ya no se podían editar o eliminar, causando errores de cierre de sesión al acceder a ellos.

Studio

• Rendimiento mejorado al cargar proyectos
  Abrir un proyecto en Studio ahora es significativamente más rápido en entornos con un gran número de proyectos y operaciones.

Avisos

Agent

• Retiro del versionamiento de agentes privados 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 llegado al final de su desarrollo planeado. Todas las mejoras futuras, nuevas funciones 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 ocasionales para problemas que impacten la producción, no hay versiones futuras planeadas.

  • Recomendación: Recomendamos encarecidamente actualizar a agentes privados 12.x lo antes posible para beneficiarse de las mejoras más recientes de rendimiento, seguridad y funciones.

  • 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 API gateway

• Fin de vida para la versión 11.45
  A partir del 26 de junio de 2026, estas versiones de producto han llegado al fin de vida y ya no son compatibles:

  • Versión del agente privado 11.45

  • Versión de la puerta de enlace de API privada 11.45

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

Connectors

• Acción requerida: Próxima eliminación de la actividad deprecada Cloud Datastore Query Items
  En una próxima versión, la actividad Query Items deprecada 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.

Design Studio

• Requisito de versión incorrecto en proyectos con un endpoint de Salesforce
  Design Studio 11.63 y 11.64 pueden marcar un proyecto que contiene un endpoint de Salesforce con una versión requerida de 12.7.0.0, una versión de Design Studio que no existe. Abrir o importar un proyecto afectado genera un error indicando que el Jitterpak requiere la versión 12.7.0.0 o superior. Design Studio 11.64.1, disponible en la página Descargas del portal Harmony, exporta el requisito de versión correcto. Para corregir un proyecto que ya está afectado, consulta Problemas conocidos de Design Studio.