11.59 / 12.3 Notas de la versión Harmony

Versión 11.59 / 12.3 Harmony

La versión 11.59 / 12.3 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 del calendario de versiones por categoría de componente, consulta el cronograma de versiones.

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

También están disponibles compilaciones 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 suscribirse 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

EDI

• Asistente de IA para EDI
  El Asistente de IA para EDI se puede usar para administrar y configurar Jitterbit EDI interactuando con un asistente de IA usando lenguaje natural. Puedes acceder a él usando el icono Jitterbit AI en el encabezado del portal Harmony en cualquier página de Jitterbit EDI. Para agregarlo a tu licencia, contacta a tu Gerente de Éxito del Cliente (CSM).

Conectores

• Conector Chroma
  El conector Chroma ahora está disponible de forma general. Se puede usar con agentes en la nube o privados para buscar, actualizar o eliminar registros en una colección de base de datos Chroma.

• Conector Wikipedia
  El conector Wikipedia ahora está disponible de forma general. Se puede usar con agentes en la nube o privados para recuperar objetos de Wikipedia.

Mejoras

Agente

• Rendimiento y seguridad mejorados
  Los agentes privados versión 12.3 incluyen mejoras de rendimiento y seguridad. Estas mejoras no se incluyen en la versión 11.59, que es la versión final planeada para agentes privados 11.x. Puedes actualizar directamente de un agente privado 11.x a 12.3 (o versiones posteriores de 12.x) usando nuestras instrucciones de actualización (Windows, Linux, o Docker).

  Acciones requeridas: Actualizaciones de complementos y verificación de conectores personalizados para agentes privados 12.x

  • Actualizaciones de complementos para agentes privados 12.x
    Las mejoras de rendimiento y seguridad para agentes privados 12.x son incompatibles con los complementos Multipart Pipeline y AWS S3 Create. Si utilizas estos complementos, se requiere acción del usuario como se describe en Avisos a continuación.

  • Verificación de conectores personalizados para agentes privados 12.x
    Los conectores creados por terceros con el SDK de Conectores deben someterse a cambios de desarrollo para ser compatibles con agentes privados 12.x. Antes de actualizar a agentes privados 12.x, verifica la compatibilidad con el desarrollador del conector, o las operaciones que usan esos conectores comenzarán a fallar en el momento de la actualización.

• Configuración de agentes privados para enmascarar encabezados de solicitud personalizados en registros
  Una nueva sección [Masking] en el archivo de configuración del agente privado (jitterbit.conf) te permite enmascarar encabezados de solicitud personalizados en actividades HTTP de Studio y orígenes y destinos HTTP de Design Studio dentro de registros en tiempo de ejecución. Se aplica a agentes privados 11.59 y 12.3.

• Compatibilidad con proxy en Endpoints Usage
  La página Endpoints Usage de la Management Console ahora reporta el uso de endpoints para agentes privados que se comunican a través de un servidor proxy. Se aplica a agentes privados 11.59 y 12.3.

• Manejo mejorado de errores de sincronización de agentes
  Los agentes ahora manejan errores durante operaciones de sincronización de forma más confiable, previniendo conflictos de base de datos que podrían resultar en bloqueos. Se aplica a agentes privados 11.59 y 12.3.

Agent, Studio y Design Studio

• Función GetJSONString mejorada con compatibilidad para manejo de errores
  La nueva función GetJSONStringEx, accesible en la categoría JSON de la pestaña Functions de la paleta de componentes de script de Studio, tiene el mismo comportamiento que la función GetJSONString con compatibilidad adicional para retornar un valor personalizable cuando una ruta no coincide. Esta función requiere versión de agente 11.59 / 12.3 o posterior y también se puede usar con Design Studio versión 11.59 o posterior.

• Compatibilidad del conector Salesforce con OAuth 2.0
  Los conectores Salesforce de Jitterbit ahora soportan OAuth 2.0 de dos patas:

  • Studio: Una conexión Salesforce tiene un nuevo menú Authentication type donde se selecciona Basic Auth (existente por defecto) u OAuth 2.0 Client Credentials (recién soportado con versión de agente 11.59 / 12.3 o posterior). Consulta Requisitos previos de OAuth 2.0.
  • Design Studio: Una Salesforce Org tiene una nueva casilla Select OAuth 2.0 Client Credentials que requiere tanto Design Studio versión 11.59 o posterior como versión de agente 11.59 / 12.3 o posterior. Consulta Requisitos previos de OAuth 2.0.

Agent y Design Studio

• Compatibilidad con Salesforce API versión 65
  El conector Salesforce de Design Studio ahora soporta Salesforce API versión 65 con el uso de Design Studio versión 11.59 o posterior y versión de agente 11.59 / 12.3 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 usan este conector. Los proyectos nuevos utilizan automáticamente Salesforce API versión 65 y deben configurarse con autenticación OAuth 2.0.

  Salesforce ya no soporta autenticación básica

  A partir de Salesforce API versión 65, Salesforce ya no soporta inicio de sesión SOAP API (autenticación básica). Para garantizar la operabilidad continua con Salesforce Orgs de Design Studio configuradas para usar autenticación básica, no aceptes la solicitud para actualizar tus proyectos existentes de Design Studio a Salesforce API versión 65. Antes de actualizar proyectos a Salesforce API versión 65, debes reconfigurar tus endpoints de Salesforce con la nueva opción de configuración Select OAuth 2.0 Client Credentials o tus operaciones fallarán.

API Manager, Management Console y Studio

• Interfaz de Analytics rediseñada y datos de solicitudes de API en registros de operaciones
  Se están implementando gradualmente dos nuevas funciones durante el próximo mes. Si te interesa acceso anticipado, contacta al soporte de Jitterbit.

  Interfaz de Analytics rediseñada

La página de Analytics en API Manager tiene una interfaz rediseñada. La nueva interfaz incluye:

• Nuevas vistas de analytics: Desglose de errores por códigos de estado (éxito vs. error), utilización de límite de velocidad a nivel de organización (promedio de llamadas por minuto), seguimiento de violaciones de políticas e información a nivel de método. Los gráficos existentes ahora también incluyen tiempo de respuesta mín/máx y datos de entorno.
• Gestión de gráficos: Los gráficos se pueden reordenar y expandir. Las leyendas se pueden habilitar o deshabilitar individualmente y siempre son completamente visibles independientemente del número de elementos. Pasa el cursor sobre los puntos de datos para ver métricas detalladas.
• Filtros actualizados: Un nuevo filtro de Métodos está disponible. Los filtros activos muestran un distintivo de conteo y se pueden borrar individualmente o todos a la vez con Borrar filtros.
• Selector de período de tiempo rediseñado: Elige entre rangos relativos preestablecidos o especifica un rango de fechas absoluto usando las nuevas pestañas Relativo y Absoluto.
• Corrección: Los errores de tiempo de espera 504 se resuelven en organizaciones con grandes cantidades de APIs, particularmente cuando se aplican filtros.

Hasta que tu organización se actualice, la interfaz anterior permanece disponible como la interfaz Analytics heredada.

Datos de solicitud de API en registros de operación

Cuando una operación se activa mediante una API personalizada de API Manager u OData API, ahora puedes ver qué API activó la operación directamente en la vista de registro de operación de Studio y la página Runtime de Management Console. Los registros de operación para operaciones activadas por API ahora incluyen:

• Información de API: Nombre de API, tipo, método de solicitud, ID de solicitud de API, IP de origen, puerta de enlace de API, URL del servicio de API y aplicación de origen.
• Información de llamada: Encabezados de solicitud HTTP enviados con la llamada de API.
• Registro de llamada: Información de seguimiento detallada sobre el procesamiento de solicitudes de API.

Cuando se habilitan tanto el registro de depuración de operación como el registro detallado de API, también se incluyen encabezados y cuerpo de solicitud y respuesta. La cantidad de información registrada varía según la configuración.

EDI

• Validación de ID de EDI del socio comercial
  Jitterbit EDI ahora valida que los ID de EDI sigan el formato correcto para el estándar de EDI del socio comercial (X12, EDIFACT o TRADACOMS) y no estén ya asignados a otro socio.

Management Console

• Política de organización para acortar el tiempo de espera de sesión y consolidación de configuración de TFA
  La pestaña User Management de la página Organizations Organization Policies tiene las siguientes mejoras:

  • Un nuevo botón de alternancia Enforce shorter idle session timeout permite acortar el tiempo después del cual se cerrará la sesión de los usuarios en el portal de Harmony, hasta un mínimo de 5 minutos. La cantidad máxima de tiempo (y el valor predeterminado existente cuando el botón de alternancia está deshabilitado) es de 4 horas.
  • Dos botones de alternancia de política de autenticación de dos factores (TFA) separados se han consolidado en un único botón de alternancia principal con dos subopciones: With token expiry (seleccionado por defecto) y At every login. La funcionalidad sigue siendo la misma.

Studio y Design Studio

• Variables de Jitterbit para preservar espacios en blanco en datos de origen XML y JSON
  Dos variables de Jitterbit existentes, jitterbit.source.xml.trim y jitterbit.source.json.trim, ahora se exponen en la pestaña Variables de la paleta de componentes de script de Studio y en la pestaña Data Elements del generador de scripts de Design Studio (11.59 o posterior). Estas variables se pueden establecer en false para evitar el recorte de espacios en blanco de datos de origen XML o JSON respectivamente.

Studio

• Compatibilidad con variables en campos de conector adicionales
  Los siguientes campos de actividad de conector ahora muestran un icono de variable y permiten usar variables globales, variables de proyecto y variables de Jitterbit. Además, los campos de conexión Clave privada para los conectores Cloud Firestore, DocuSign, Gmail, Google BigQuery, Google Docs, Google Drive, Google Pub/Sub, Google Sheets y Workday ahora también permiten usar variables.

  Conector	Actividad	Campo
  Amazon Bedrock	Prompt, Registrar herramientas	Prompt
  Amazon Lambda	Invocar función	Contexto del cliente
  Azure OpenAI	Prompt, Solicitar imagen	Texto del prompt
  BMC Helix Business Workflows	Buscar casos, Crear caso, Actualizar caso	Parámetros de búsqueda (en formato JSON), Parámetros de creación (en formato JSON) y Parámetros de actualización (en formato JSON)
  BMC Helix Operations Management	Crear evento, Buscar eventos, Actualizar evento	Entrada JSON
  Email	Enviar correo electrónico	Cuerpo del correo
  Gmail	Enviar correo electrónico	Mensaje
  Google BigQuery	Ejecutar consulta personalizada	Consulta SQL
  Google Gemini	Prompt, Registrar herramientas	Prompt
  OData	Actualizar	Encabezados de solicitud
  OpenAI	Crear imagen, Crear transcripción, Crear traducción, Prompt	Texto del prompt
  PGP	Cifrar	Clave pública del destinatario, Contenido del archivo, Clave pública del remitente

• Alternancia de autoselección de dependencias para transferencia selectiva
  La función de transferencia selectiva tiene una nueva alternancia Autoseleccionar dependencias (habilitada de forma predeterminada) que controla si las dependencias requeridas se incluyen automáticamente al seleccionar componentes. Desactívala para seleccionar componentes individualmente sin incluir sus dependencias.

• Rediseño de la experiencia de usuario de Publicar como API
  La opción Publicar como API ahora abre un panel Detalles de API con pasos basados en pestañas en la parte inferior del diseñador de proyectos en lugar de un modal de configuración separado.

Conectores

• Compatibilidad del conector HTTP v2 con servicios web REST de NetSuite mediante OAuth de 3 etapas
  Los servicios web REST de SuiteTalk de NetSuite ahora son compatibles usando el tipo de autenticación OAuth 2.0 de una conexión HTTP v2 con la opción Authorization Code Grant (OAuth de 3 etapas). Para obtener instrucciones de configuración, consulta Conectar a NetSuite con HTTP v2 para configurar el registro de integración de NetSuite y el registro de la aplicación de Management Console.

• Mejoras en Get Documents y List Transactions de EDI for Cloud v2
  El conector EDI for Cloud v2 tiene las siguientes mejoras:

  • La actividad Get Document tiene una nueva casilla Enable Max Documents para limitar la cantidad de documentos recuperados por ejecución de operación. Cuando está habilitada, especificas el límite en el campo Max documents.
  • La estructura de solicitud de la actividad List Transactions tiene un nuevo nodo additionalFields donde puedes especificar una lista de campos adicionales que deseas incluir en la respuesta. Consulta la lista de campos adicionales compatibles. Ten en cuenta que las actividades existentes devolverán una advertencia de subelemento adicional (que se puede ignorar) hasta que los esquemas se regeneren.

• Compatibilidad del conector MCP Client con OAuth de 3 etapas
  En una conexión MCP Client, el menú Authentication mechanism tiene una nueva opción Authorization Code Grant (OAuth de 3 etapas). Para obtener instrucciones de configuración, consulta Requisitos previos de MCP Client 3LO para configurar un registro de aplicación o integración y el registro de la aplicación de Management Console.

• Compatibilidad del conector OData con OData V2
  Una conexión OData ahora tiene un menú OData Version para seleccionar V4 (predeterminado existente) o V2 (recién compatible).

• Compatibilidad con la versión 45.1 de la API de Workday
  Una conexión Workday ahora tiene disponible la versión v45.1 de Workday Web Services (WWS) para seleccionar en su menú Version. Para nuevas conexiones, v45.1 se selecciona de forma predeterminada.

Cambios

Puerta de enlace de API

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

Correcciones

Agente

• Correcciones de PostgreSQL del agente privado de Windows
  Se han realizado dos correcciones para mejorar la estabilidad del servicio PostgreSQL en los agentes privados de Windows 11.59 y 12.3:

  • Al actualizar, ingresar una contraseña de cuenta de servicio PostgreSQL incorrecta en el mensaje del instalador ahora muestra un error de validación y permite reintentar. Anteriormente, esto podría causar que la actualización fallara sin revertir. Si ya has encontrado este problema, consulta pasos de recuperación.
  • Las instalaciones nuevas ahora establecen correctamente una dependencia en el servicio PostgreSQL para los servicios del agente, evitando que los servicios del agente se inicien antes de que PostgreSQL esté listo.

Administrador de API

• Los permisos de creación de API ahora reflejan el acceso del rol más alto
  Los permisos se evalúan ahora en todos los roles asignados a un usuario, aplicándose el nivel de acceso más alto. Anteriormente, los usuarios asignados a múltiples roles tenían sus permisos del Administrador de API restringidos al rol más restrictivo, lo que impedía la creación de API incluso cuando otro rol asignado otorgaba el acceso necesario.

Plataforma Harmony

• Ahora se pueden eliminar programaciones desde la Consola de Administración
  Las programaciones listadas en la pestaña Programaciones de la página Proyectos de la Consola de Administración ahora se pueden eliminar incluso si la programación fue removida previamente del proyecto en Studio o Design Studio. Anteriormente, intentar eliminar tales programaciones retornaba un error de excepción desconocida.

Studio

• Los puntos finales globales ya no fallan después de la eliminación del proyecto
  Eliminar un proyecto usando un punto final global ya no causa que las operaciones que usan el mismo punto final global en otros proyectos fallen hasta que se redeplieguen.

Conectores

• Codificación UTF-8 corregida en la actividad Enviar mensaje de Microsoft Teams
  La actividad Enviar mensaje de Microsoft Teams ahora codifica correctamente el contenido del mensaje usando UTF-8 cuando el contenido del mensaje se pasa a través de variables globales.

Avisos

Agente

• Retiro del versionado de agente privado 11.x
  Esta versión incluye la versión final del agente privado 11.x (11.59) y la primera versión disponible del agente privado 12.x (12.3). Toma en cuenta lo siguiente respecto a futuras versiones:

  • Versión final 11.x: 11.59 es la versión final planeada del agente privado 11.x. La siguiente versión después de 11.59 será 12.4, y todas las mejoras futuras, nuevas características y actualizaciones de seguridad se entregarán a través de agentes privados 12.x. Aunque los agentes 11.x pueden recibir raramente correcciones críticas para problemas que impacten la producción, no hay versiones futuras planeadas.

  • Recomendación: Recomendamos ampliamente actualizar a agentes privados 12.x, comenzando con 12.3, lo antes posible para beneficiarse de las mejoras más recientes en rendimiento, seguridad y características.

  • Ruta de actualización: Puedes actualizar directamente de 11.x a 12.3 (o versiones posteriores de 12.x) usando nuestras instrucciones de actualización documentadas: Windows, Linux, o Docker.

Agente y Design Studio

• Fin de vida para la versión 11.41
  A partir del 4 de abril de 2026, estas versiones de producto han alcanzado el fin de vida y ya no son compatibles:

  • Versión de agente privado 11.41
  • Versión de Design Studio 11.41

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

Plataforma Harmony

• Acción requerida: Retiro de URLs de redirección SSO heredadas
  Jitterbit retiró las URLs de redirección heredadas para inicio de sesión único (SSO) de Harmony con la versión 12.4. Desde nuestro anuncio de junio de 2024 (11.28) de que las URLs de SSO habían cambiado, las configuraciones de SSO nuevas y actualizadas requieren las nuevas URLs. Sin embargo, tu organización podría seguir usando URLs heredadas si configuraste SSO antes de junio de 2024 y su configuración aún no ha sido actualizada.

  Los administradores de la organización deben reconfigurar su configuración de SSO existente para usar las nuevas URLs, o los inicios de sesión de usuarios en Harmony comenzarán a fallar en las siguientes fechas:

  	12.4
  APAC	28 de abril de 2026 (12 AM AEST)
  EMEA	28 de abril de 2026 (9 PM CEST)
  NA	29 de abril de 2026 (12 PM PDT)

Cómo verificar si necesitas tomar medidas

Inicia sesión en el portal de Harmony, ve a Management Console > Organizations y selecciona tu organización. En la pestaña User Management bajo el botón de alternancia Enable SSO, haz clic en Configure SSO.

Tu organización requiere reconfiguración si alguno de estos campos contiene la cadena jitterbit-cloud-mgmt-console:

• OAuth 2.0: Los campos Client ID o Client Secret.
• SAML 2.0: Los campos Identity Provider Metadata o Service Provider Metadata.

Acción requerida

Si tu organización utiliza URLs de redirección heredadas, un administrador de la organización debe reconfigurarlas:

1. Bajo el botón de alternancia Enable SSO, cambia la selección a None para eliminar la configuración de SSO existente que utiliza las URLs de redirección heredadas.

2. Recrea la configuración de SSO utilizando las últimas URLs de redirección siguiendo la documentación. Esto debe hacerse tanto en Harmony como en tu proveedor de identidad:

   1. Bajo el botón de alternancia Enable SSO, selecciona el tipo de autenticación: OAuth 2.0 o SAML 2.0. Luego haz clic en Configure SSO.

   2. Actualiza las URLs de redirección / ACS en tu proveedor de identidad.

3. Prueba la autenticación para confirmar que el inicio de sesión es exitoso.

Para obtener ayuda, contacta al soporte de Jitterbit.

Plugins

• Acción requerida: Actualizaciones de plugins para agentes privados 12.x
  Las mejoras de rendimiento y seguridad para agentes privados 12.x son incompatibles con los siguientes plugins. Las nuevas versiones compatibles de estos plugins ya están disponibles:

  Nombre del plugin	Versiones incompatibles	Versión requerida
  Jitterbit Multipart Pipeline Plugin (deprecated)	1.0.9.0 1.0.8.0	1.0.10.0
  Jitterbit AWS S3 Create (deprecated)	1.0.1.0 1.0.0.0	1.0.2.0

  Impacto en agentes privados

  Antes de actualizar a agentes privados 12.x, debes completar la acción de usuario requerida, o las operaciones comenzarán a fallar en el momento de la actualización. Las nuevas versiones de plugins son compatibles hacia atrás con agentes 11.x, por lo que puedes actualizar los plugins en cualquier momento.

  Acción de usuario requerida

  Debes reemplazar cualquier uso existente de las versiones de plugins incompatibles con las nuevas versiones requeridas:

  1. (Solo agentes privados) Asocia la nueva versión del plugin al grupo de agentes privados en la página Customizations > Plugins de la Management Console.
  2. Desasigna el plugin incompatible de la actividad en tus proyectos de Studio o Design Studio.
  3. Asigna la nueva versión compatible.
  4. Prueba e implementa la operación.

Conectores

• Acción requerida: Próxima eliminación de la actividad Cloud Datastore Query Items obsoleta
  En una próxima versión, la actividad Query Items obsoleta en el conector Cloud Datastore (Beta) 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 hace que los campos individuales que defines en la página Cloud Datastore (Beta) de la Management Console se devuelvan directamente en el nivel superior de la respuesta.

  Importante

  Si utilizas la actividad Query Items obsoleta en cualquier operación, debes revisar el diseño de tu operación y reemplazarla con la actividad Query Items rediseñada lo antes posible, ya que la actividad obsoleta ya no es compatible y se eliminará en el futuro.