11.59 / 12.3 Notas de la versión de Harmony

11.59 / 12.3 Versión de Harmony

La versión 11.59 / 12.3 de Harmony se lanza de manera escalonada según las fechas y horas que se enumeran a continuación por componente y región. Para una explicación más detallada sobre la cadencia de lanzamiento por categoría de componente, consulte el calendario de lanzamientos.

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

Las compilaciones de notas de versión para Grupos de Agentes de Nube de Producción, Grupos de Agentes de Nube de Sandbox y agentes privados también están disponibles.

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

Nuevas características

Agentes de IA

• Agente de Contacto CRM
  El Agente de Contacto CRM, accesible desde la categoría Agente de IA en el Marketplace , utiliza IA para gestionar registros de contacto para sistemas CRM como Salesforce a través de una interfaz conversacional, ayudando a los equipos de ventas a encontrar, crear y actualizar contactos de manera más eficiente. Para agregarlo a tu licencia, contáctanos.

• Agente de Inteligencia Competitiva
  El Agente de Inteligencia Competitiva, accesible desde la categoría Agente de IA en el Marketplace , automatiza la recopilación de inteligencia de mercado utilizando búsqueda web impulsada por IA para identificar, resumir y entregar noticias relevantes de la industria y actualizaciones de competidores a tu equipo. Para agregarlo a tu licencia, contáctanos.

EDI

• Asistente de IA EDI
  El Asistente de IA EDI se puede utilizar para gestionar y configurar Jitterbit EDI interactuando con un asistente de IA utilizando lenguaje natural. Puedes acceder a él utilizando el ícono Jitterbit IA 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 SDK de Studio

• Conector Chroma
  El Conector Chroma ya está disponible de manera general. Se puede utilizar con agentes en la nube o privados para buscar, insertar o eliminar registros en una colección de base de datos de Chroma.

• Conector Wikipedia
  El Conector Wikipedia ya está disponible de manera general. Se puede utilizar con agentes en la nube o privados para recuperar objetos de Wikipedia.

Mejoras

Agente

• Mejoras en rendimiento y seguridad
  La versión 12.3 de agentes privados incluye mejoras en rendimiento y seguridad. Estas mejoras no están incluidas en la versión 11.59, que es la última versión planificada para agentes privados 11.x. Puedes actualizar directamente de un agente privado 11.x a 12.3 (o versiones posteriores de 12.x) utilizando nuestras instrucciones de actualización (Windows, Linux, o Docker).

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

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

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

• Configuraciones de agente privado para enmascarar encabezados de solicitud personalizados en los registros
  Una nueva sección [Masking] en el archivo de configuración del agente privado (jitterbit.conf) le permite enmascarar encabezados de solicitud personalizados en actividades HTTP de Studio y fuentes HTTP de Design Studio y destinos dentro de los registros de ejecución. Aplica tanto a agentes privados 11.59 como 12.3.

• Soporte de proxy para uso de endpoints
  La página de Uso de Endpoints en la Consola de Administración ahora informa sobre el uso de endpoints para agentes privados que se comunican a través de un servidor proxy. Aplica tanto a agentes privados 11.59 como 12.3.

• Mejor manejo de errores de sincronización de agentes
  Los agentes ahora manejan errores durante las operaciones de sincronización de manera más confiable, previniendo conflictos en la base de datos que podrían resultar en bloqueos. Aplica tanto a agentes privados 11.59 como 12.3.

Agente, Studio y Design Studio

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

• Soporte del conector de Salesforce para OAuth 2.0
  Los conectores de Salesforce de Jitterbit ahora soportan el uso de OAuth 2.0 de 2 patas:

• Studio: Una conexión de Salesforce tiene un nuevo menú de Tipo de autenticación donde se selecciona Autenticación básica (predeterminado existente) o Credenciales de cliente OAuth 2.0 (nueva opción soportada con la versión del agente 11.59 / 12.3 o posterior). Consulta los requisitos previos de OAuth 2.0.

• Design Studio: Un Org de Salesforce tiene una nueva casilla de verificación Seleccionar credenciales de cliente OAuth 2.0 que requiere tanto la versión 11.59 o posterior de Design Studio como la versión 11.59 / 12.3 o posterior del agente. Consulta los requisitos previos de OAuth 2.0.

Agente y Design Studio

• Soporte para la versión 65 de la API de Salesforce
  El conector de Design Studio Salesforce ahora es compatible con la versión 65 de la API de Salesforce con el uso de ambas, la versión 11.59 o posterior de Design Studio y la versión 11.59 / 12.3 o posterior del agente. Cuando se cumplen estos requisitos de versión, se muestra un diálogo de actualización de API al abrir proyectos existentes que utilizan este conector. Los nuevos proyectos utilizan automáticamente la versión 65 de la API de Salesforce y deben configurarse con autenticación OAuth 2.0.

  Salesforce ya no admite la autenticación básica

  A partir de la versión 65 de la API de Salesforce, Salesforce ya no admite el inicio de sesión mediante SOAP API (autenticación básica). Para garantizar la continuidad del funcionamiento de Design Studio Salesforce Orgs configuradas para usar autenticación básica, no acepte la solicitud de actualización de sus proyectos de Design Studio existentes a la versión 65 de la API de Salesforce. Antes de actualizar proyectos a la versión 65 de la API de Salesforce, debe reconfigurar sus endpoints de Salesforce con la nueva opción de configuración Seleccionar credenciales de cliente OAuth 2.0 o sus operaciones fallarán.

API Manager, Consola de Gestión y Studio

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

  Interfaz de análisis rediseñada

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

  • Nuevas vistas de análisis: Desglose de errores por códigos de estado (éxito vs. error), utilización del límite de tasa a nivel de organización (llamadas promedio por minuto), seguimiento de violaciones de políticas y conocimientos a nivel de método. Los gráficos existentes ahora también incluyen el tiempo de respuesta mínimo/máximo y datos del 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 una insignia 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 utilizando las nuevas pestañas de Relativo y Absoluto.
  • Corrección: Se resuelven errores de tiempo de espera 504 en organizaciones con grandes cantidades de APIs, particularmente cuando se aplican filtros.

  Hasta que tu organización sea actualizada, la interfaz anterior permanece disponible como la interfaz de Análisis legado.

  Importante

  Cuando se habilite la nueva interfaz para tu organización, el período de retención de datos de análisis y registros de API cambia de 90 días a 30 días.

  Datos de solicitudes de API en registros de operación

  Cuando una operación es activada por una API personalizada de API Manager o una API OData, ahora puedes ver qué API activó la operación directamente en la vista de registro de operaciones del Studio y en la página de Tiempo de Ejecución de la Consola de Gestión. Los registros de operaciones para operaciones activadas por API ahora incluyen:

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

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

EDI

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

Consola de administración

• Política de organización para acortar el tiempo de espera de sesión y consolidación de configuraciones de TFA
  La pestaña de Gestión de usuarios de la página de Organizaciones Políticas de organización tiene las siguientes mejoras:

  • Un nuevo interruptor Habilitar tiempo de espera de sesión inactiva más corto permite acortar el tiempo después del cual los usuarios serán desconectados del portal Harmony, hasta un mínimo de 5 minutos. La cantidad máxima de tiempo (y el valor predeterminado existente cuando el interruptor está deshabilitado) es de 4 horas.
  • Dos interruptores de política de autenticación de dos factores (TFA) separados se han consolidado en un solo interruptor principal con dos subopciones: Con expiración de token (seleccionado por defecto) y En cada inicio de sesión. La funcionalidad sigue siendo la misma.

Estudio y Estudio de diseño

• Variables de Jitterbit para preservar espacios en blanco en datos de origen XML y JSON
  Dos variables existentes de Jitterbit, jitterbit.source.xml.trim y jitterbit.source.json.trim, ahora están expuestas en la pestaña Variables del componente de script del Estudio y en la pestaña Elementos de datos del generador de scripts del Estudio de diseño (11.59 o posterior). Estas variables se pueden establecer en false para evitar el recorte de espacios en blanco de los datos de origen XML o JSON, respectivamente.

Studio

• Soporte de variables en campos adicionales de conectores
  Los siguientes campos de actividad de conector ahora muestran un ícono de variable y admiten el uso de variables globales, variables de proyecto, y variables de Jitterbit. Además, los campos de conexión de Clave Privada para los conectores de Cloud Firestore, DocuSign, Gmail, Google BigQuery, Google Docs, Google Drive, Google Pub/Sub, Google Sheets, y Workday también ahora admiten 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

• Interruptor de autoselección de dependencias para transferencia selectiva
  La función de transferencia selectiva ahora cuenta con un nuevo interruptor de Autoselección de dependencias (activado por defecto) que controla si las dependencias requeridas se incluyen automáticamente al seleccionar componentes. Desactívalo para seleccionar componentes de forma individual sin incluir sus dependencias.

• Rediseño de la opción Publicar como API
  La opción de Publicar como API ahora abre un panel de 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 del SDK de Studio

• Soporte del conector HTTP v2 para servicios web REST de NetSuite a través de OAuth de 3 patas
  Los servicios web REST de SuiteTalk de NetSuite ahora son compatibles utilizando el tipo de autenticación de conexión OAuth 2.0 de una conexión HTTP v2 con la opción de Authorization Code Grant (OAuth de 3 patas). Para 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 la Consola de Gestión.

• Mejoras en EDI para Cloud v2 Obtener Documentos y Listar Transacciones
  El conector EDI para Cloud v2 tiene las siguientes mejoras:

  • La actividad de Obtener Documento ahora cuenta con una nueva casilla de verificación Habilitar Máximo de Documentos para limitar el número de documentos recuperados por ejecución de operación. Cuando está habilitada, puedes especificar el límite en el campo Máximo de documentos.
  • La estructura de solicitud de la actividad de Listar Transacciones 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 extra (que se puede ignorar) hasta que los esquemas sean regenerados.

• Soporte del conector MCP Client para OAuth de 3 patas
  En una conexión de MCP Client, el menú de Mecanismo de autenticación tiene una nueva opción de Código de autorización (OAuth de 3 patas). Para instrucciones de configuración, consulta prerrequisitos de MCP Client 3LO para configurar un registro de aplicación o integración y el registro de la aplicación en la Consola de Administración.

• Soporte del conector OData para OData V2
  Una conexión OData ahora tiene un menú de Versión de OData para seleccionar V4 (predeterminado existente) o V2 (nuevo soporte).

• Soporte de la versión 45.1 de la API del conector Workday
  Una conexión Workday ahora tiene disponible la versión v45.1 de los Servicios Web de Workday (WWS) para seleccionar en su menú de Versión. Para nuevas conexiones, v45.1 se selecciona por defecto.

Cambios

Puerta de enlace API

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

Soluciones

Agente

• Soluciones de PostgreSQL para el agente privado de Windows
  Se han realizado dos soluciones para mejorar la estabilidad del servicio de PostgreSQL en los agentes privados de Windows tanto en 11.59 como en 12.3:

  • Al actualizar, ingresar una contraseña incorrecta de la cuenta del servicio de PostgreSQL en el aviso del instalador ahora muestra un error de validación y permite volver a ingresarla. Anteriormente, esto podí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 de 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 ahora se evalúan en todos los roles asignados a un usuario, aplicando el nivel más alto de acceso. Anteriormente, los usuarios asignados a múltiples roles tenían sus permisos del Administrador de API restringidos al rol más restrictivo, impidiendo la creación de API incluso cuando otro rol asignado otorgaba el acceso necesario.

Plataforma

• Los horarios ahora se pueden eliminar desde la Consola de Administración
  Los horarios listados en la pestaña Horarios de la página Proyectos de la Consola de Administración ahora se pueden eliminar incluso si el horario fue eliminado previamente del proyecto en Studio o Design Studio. Anteriormente, intentar eliminar tales horarios devolvía un error de excepción desconocida.

Studio

• Los endpoints globales ya no fallan después de la eliminación del proyecto
  Eliminar un proyecto utilizando un endpoint global ya no causa que las operaciones que utilizan el mismo endpoint global en otros proyectos fallen hasta que se vuelvan a implementar.

Conectores del SDK de Studio

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

Avisos

Agente

• Retiro de la versionación de agente privado 11.x
  Esta versión incluye la última versión de agente privado 11.x (11.59) y la primera versión de agente privado 12.x disponible (12.3). Tenga en cuenta lo siguiente respecto a futuras versiones:

  • Última versión 11.x: 11.59 es la última versión planificada de 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. Si bien los agentes 11.x pueden recibir correcciones críticas raras para problemas que impactan en la producción, no se planean lanzamientos continuos.

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

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

Agente y Estudio de Diseño

• Fin de vida para la versión 11.41
  A partir del 4 de abril de 2026, estas versiones de producto han llegado al fin de su vida útil y ya no están soportadas:

  • Agente privado versión 11.41
  • Estudio de Diseño versión 11.41

  Recomendamos que los usuarios de estas versiones actualicen a la última versión tan pronto como sea posible.

Plataforma Harmony

• Acción requerida: Próximo retiro de las URL de redirección SSO heredadas
  Jitterbit está retirando las URL de redirección heredadas para inicio de sesión único (SSO) de Harmony en la próxima versión 12.4. Desde nuestro anuncio de junio de 2024 (11.28) que las URL de SSO habían cambiado, las nuevas y actualizadas configuraciones de SSO requieren las nuevas URL. Sin embargo, su organización puede seguir utilizando URL heredadas si configuró 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 URL, o los inicios de sesión de usuario en Harmony comenzarán a fallar en las siguientes fechas:

  	12.4
  APAC	28 de abril de 2026 (12 a.m. AEST)
  EMEA	28 de abril de 2026 (9 p.m. CEST)
  NA	29 de abril de 2026 (12 p.m. PDT)

  Cómo verificar si necesita tomar acción

  Inicie sesión en el portal de Harmony, navegue a Consola de Administración > Organizaciones, y seleccione su organización. En la pestaña Gestión de Usuarios bajo el interruptor Habilitar SSO, haga clic en Configurar SSO.

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

  • OAuth 2.0: Los campos ID de Cliente o Secreto de Cliente.
  • SAML 2.0: Los campos Metadatos del Proveedor de Identidad o Metadatos del Proveedor de Servicios.

  Acción requerida

  Si su organización está utilizando URL de redirección heredadas, un administrador de la organización debe reconfigurarlas:

  1. Bajo el interruptor Habilitar SSO, cambie la selección a Ninguno para eliminar la configuración SSO existente utilizando las URL de redirección heredadas.

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

     1. Bajo el interruptor Habilitar SSO, seleccione el tipo de autenticación: OAuth 2.0 o SAML 2.0. Luego haga clic en Configurar SSO.

     2. Actualice las URL de redirección / ACS en su proveedor de identidad.

  3. Pruebe la autenticación para confirmar un inicio de sesión exitoso.

  Para obtener asistencia, comuníquese con el soporte de Jitterbit.

Plugins

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

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

  Impacto en el agente privado

  Antes de actualizar a los agentes privados 12.x, debe 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 los plugins son compatibles hacia atrás con los agentes 11.x, por lo que puede actualizar los plugins en cualquier momento.

  Acción de usuario requerida

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

  1. (Agentes privados solamente) Asocie la nueva versión del plugin al grupo de agentes privados en la consola de administración Personalizaciones > Plugins página.
  2. Desasigne el plugin incompatible de la actividad en sus proyectos de Studio o Design Studio.
  3. Asigne la nueva versión compatible.
  4. Pruebe y despliegue la operación.

Conectores de SDK de Studio

• Acción requerida: Eliminación próxima de la actividad de elementos de consulta de Cloud Datastore obsoleta
  En una próxima versión, la actividad de elementos de consulta obsoleta en el conector de Cloud Datastore (Beta) será eliminada permanentemente. Esta actividad fue reemplazada en la versión 11.47 por la rediseñada actividad de elementos de consulta, cuya estructura de respuesta aplanada hace que los campos individuales que defina en la consola de administración página de Cloud Datastore (Beta) se devuelvan directamente en el nivel superior de la respuesta.

  Importante

  Si está utilizando la actividad de elementos de consulta obsoleta en alguna operación, debe revisar el diseño de su operación y reemplazarla con la rediseñada actividad de elementos de consulta lo antes posible, ya que la actividad obsoleta ya no es compatible y será eliminada en el futuro.