12.4 Notas de la versión de Harmony

Versión 12.4 de Harmony

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

App Builder 4.60 y Wevo iPaaS tienen notas de la versión independientes.

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 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 de 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 de estos componentes (excepto App Builder) es un año después de la fecha de lanzamiento.

Nuevas funciones

Conectores

• Conector WebCrawler
  El conector WebCrawler se puede usar con agentes en la nube o privados para rastrear sitios web.

Mejoras

Agente

• Actualización de PostgreSQL
  La versión de PostgreSQL incluida con el agente se ha actualizado para mejorar la seguridad y el rendimiento.

• Actualización del controlador JDBC de SQLite
  El controlador JDBC de SQLite que se incluye con el agente y se utiliza por el conector de base de datos de Studio, o un origen de base de datos de Design Studio o destino, se ha actualizado.

• Compatibilidad con caracteres multibyte en URLEncode
  La función URLEncode en Studio y Design Studio ahora admite caracteres alfabéticos multibyte como entrada, incluyendo caracteres latinos extendidos utilizados en idiomas como portugués y alemán, así como caracteres no latinos utilizados en idiomas como ruso y chino.

Agent y Studio

• Compatibilidad con OAuth 2.0 para conectores ServiceMax y Salesforce Service Cloud
  Las conexiones ServiceMax y Salesforce Service Cloud cuentan con un nuevo menú Tipo de autenticación donde se selecciona Autenticación básica (predeterminada existente) u Credenciales de cliente OAuth 2.0 (compatibilidad nueva). OAuth 2.0 requiere versión de agente 11.59 para agentes 11.x o 12.4 para agentes 12.x. Consulta los requisitos previos de OAuth 2.0 de Salesforce.

API Manager

• Documentación OpenAPI para APIs individuales
  El panel Detalles de API en la página APIs ahora incluye una pestaña Documentación para APIs personalizadas, proxy y OData publicadas, donde se puede ver, editar, regenerar y publicar documentación OpenAPI para una sola API. Anteriormente, solo se podía editar y publicar documentación de API en lote para todas las APIs en un entorno.

• Página de registros de API rediseñada
  La página Registros de API cuenta con una interfaz rediseñada, continuando el despliegue gradual anunciado en 11.59 / 12.3. Las organizaciones ya actualizadas a la nueva interfaz de página Analytics reciben esta actualización con 12.4; las que aún no se han actualizado reciben ambas interfaces juntas cuando el despliegue las alcance. Si te interesa acceso anticipado, contacta al soporte de Jitterbit. Hasta entonces, la interfaz anterior sigue disponible como la interfaz Registros de API heredados. La nueva interfaz incluye:

  • Registros de API y operaciones unificados: Los registros de operaciones para operaciones activadas por API ahora aparecen junto con los registros de API, proporcionando visibilidad de extremo a extremo en el procesamiento de llamadas de API.

  • Registro de acceso no autorizado: Los intentos de acceso 401 No autorizado a través de una puerta de enlace de API privada ahora se reportan con el código de estado correspondiente.

  • Nueva búsqueda: Compatibilidad expandida de operadores (=, !=) y coincidencia de patrones con comodín, con múltiples criterios combinables usando punto y coma.

  • Consultas guardadas: Las consultas se pueden guardar, reutilizar, editar y eliminar.

  • 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.

  • Nuevas columnas: Puerta de enlace de API y Tipo de puerta de enlace muestran el nombre de dominio y el tipo (Pública o Privada) de la puerta de enlace que procesó la solicitud. Las columnas Agente, Entorno y Proyecto también están disponibles.

  • Filtrar columnas: La visibilidad y el orden de las columnas se pueden personalizar.

  • Vista de árbol de ejecución: Alterna para mostrar entradas de registro como una jerarquía anidada de operaciones principales y secundarias.

  • Alternar para mostrar cargas útiles de solicitud y respuesta: Un nuevo alternador en la pestaña Configuración de la configuración de API personalizada y API OData determina si se muestran las cargas útiles de solicitud y respuesta.

  • Panel de detalles de registro: Haz clic en cualquier entrada de registro para ver información de API, encabezados de llamada y carga útil de solicitud/respuesta (cuando el nuevo alternador está habilitado), así como información de seguimiento de depuración (cuando el registro de depuración está habilitado).

• Vista de tarjeta actualizada reemplaza la vista de mosaicos heredada
  La vista de mosaicos heredada en la página APIs ha sido reemplazada con una vista de tarjeta actualizada. Las tarjetas ahora muestran todos los detalles de la API sin necesidad de interacción al pasar el cursor, y cada tarjeta incluye un conteo de Servicios que no se mostraba anteriormente en la vista de mosaicos.

API Manager y Management Console

• Distintivo de conteo de filtros en el icono de filtro
  El icono Filtro en la página APIs en API Manager y las páginas Proyectos, Certificados de cliente y Colas de mensajes en Management Console ahora muestran un distintivo numérico que indica el conteo total de filtros activos cuando el panel de filtros está contraído.

Conectores

• Actividad Snowflake Query v2
  La nueva actividad Snowflake Query v2 permite consultar múltiples tablas en diferentes esquemas utilizando múltiples uniones. El esquema de respuesta se genera automáticamente según los campos seleccionados durante la configuración de la actividad.

• Compatibilidad con API v3 del conector Workday Prism Analytics
  Una conexión de Workday Prism Analytics ahora tiene un menú Versión de API para seleccionar la versión de API REST de Workday Prism Analytics v2 (predeterminada existente) o v3 (recién compatible).

EDI

• Reportes de análisis mejorados
  El reporte de volumen de transacciones de la página Analytics tiene nuevas opciones de visualización y agrupación:

  • Un menú desplegable Ver por permite mostrar conteos totales de transacciones o agrupar datos por socio comercial, tipo de documento o estado, con gráficos de barras apiladas y leyendas codificadas por color para cada agrupación.

  • Los botones de tipo de gráfico y cambian entre vistas de barras y líneas.

  • La agrupación Estado incluye un filtro Todos los estados y muestra tendencias de transacciones en estados de transacción definidos por el sistema y por el usuario.

• Filtro de tipos de mensaje en la página Mensajería
  El panel Filtros de la página Mensajería ahora incluye una sección Tipos de mensaje, permitiendo filtrar mensajes por categorías de nivel superior como Comunicación y Transacción.

Management Console

• Configuración de subdominio de API de autoservicio
  Los administradores de la organización ahora pueden configurar el subdominio de API de una organización directamente en la página Organizaciones. El subdominio de API define la porción de subdominio de la URL base de la API utilizada por la puerta de enlace de API. Una vista previa de URL base de API de solo lectura muestra la URL resultante, y un diálogo de confirmación advierte que las integraciones existentes que utilizan la URL actual pueden necesitar actualizarse después de guardar.

• Etiquetas del eje Y del gráfico de la página Métricas del agente
  La página Métricas del agente ahora muestra etiquetas del eje Y en todos los gráficos, indicando la unidad de medida para cada gráfico. Los gráficos basados en estado muestran Estado de salud en el eje Y, y los gráficos de capacidad y actividad muestran la unidad relevante, como % de uso del grupo de subprocesos, Número de operaciones o Número de registros.

• Mejoras en la página Runtime
  La página Runtime tiene las siguientes mejoras:

  • Paginación: Las páginas ahora contienen aproximadamente 100 operaciones. Para mantener intactas las cadenas de operaciones vinculadas, todas las operaciones secundarias del último elemento principal en una página se incluyen en esa página, incluso si el total excede 100.

  • Consultas: Compatibilidad expandida de operadores (=, !=) y coincidencia de patrones con caracteres comodín, con múltiples criterios combinables usando puntos y comas. Para resultados precisos de !=, desactiva el botón de alternancia Vista de árbol de ejecución.

Marketplace

• La vista de tarjetas actualizada reemplaza la vista de mosaicos heredada
  La vista de mosaicos heredada en Marketplace ha sido reemplazada por una vista de tarjetas actualizada. Al hacer clic en una tarjeta, se abre un panel de Detalles que incluye una descripción del activo junto con otra información del activo.

Studio y Management Console

• Visibilidad de proyectos basada en roles
  Los proyectos de Studio ahora se pueden configurar para controlar qué roles de la organización pueden ver el proyecto. Esto se puede configurar desde las siguientes ubicaciones:

  • Management Console: Utiliza la nueva pestaña Roles de usuario en la página Proyectos de Management Console, accesible después de seleccionar un proyecto.

  • Studio: Utiliza la nueva pestaña Roles de usuario en la pantalla de configuración del proyecto, accesible desde la configuración del proyecto o la acción Roles de usuario en la página Proyectos de Studio.

  Cuando se crea un nuevo proyecto, es visible de forma predeterminada para todos los miembros de los roles a los que pertenece el usuario que lo crea, y siempre para todos los miembros del rol Administrador. Para proyectos que existían antes de esta versión, todos los roles con acceso al entorno están habilitados de forma predeterminada.

Studio

• Opción de operación para ejecutarse en un agente dedicado
  Una nueva opción Ejecutar en agente dedicado en la pestaña Opciones de la configuración de operación te permite dirigir una operación para que se ejecute en un agente específico dentro de un grupo de agentes privados cuya Clase de grupo de agentes está configurada como Alta disponibilidad. Esta opción está destinada a escenarios de solución de problemas, como reproducir una falla en un agente específico o omitir temporalmente un agente problemático mientras se mantiene el resto del grupo operativo.

• Alternancia de selección automática de dependencias para importación de proyectos
  La función de importación de proyectos tiene una nueva alternancia Seleccionar dependencias automáticamente (habilitada de forma predeterminada) que controla si las dependencias requeridas se incluyen automáticamente al seleccionar componentes para importar. Desactívala para seleccionar componentes individuales sin incluir automáticamente sus dependencias.

• Compatibilidad con la versión 65 de la API de Salesforce
  Los conectores Salesforce, ServiceMax y Salesforce Service Cloud ahora utilizan automáticamente la versión 65 de la API de Salesforce cuando sus respectivas conexiones se configuran con Credenciales de cliente OAuth 2.0 (consulta los requisitos previos de OAuth 2.0 de Salesforce). Las conexiones configuradas con Autenticación básica continúan utilizando la versión 64 de la API de Salesforce.

• Modo de concurrencia de actividad Bulk de Salesforce
  Las actividades Salesforce Inserción masiva, Actualización masiva, Upsert masivo, Eliminación masiva y Eliminación dura masiva tienen una nueva configuración Modo de concurrencia bajo Configuración opcional. Selecciona Paralelo (predeterminado existente) o Serie (recién compatible) para controlar cómo Salesforce procesa el trabajo de carga de datos masivos.

• Compatibilidad con contraseñas multibyte en conexiones de Salesforce
  Las conexiones de Salesforce, Salesforce Service Cloud y ServiceMax ahora admiten caracteres alfabéticos multibyte, incluidos caracteres latinos extendidos utilizados en idiomas como portugués y alemán, así como caracteres no latinos utilizados en idiomas como ruso y chino, en contraseñas.

Cambios

Plataforma Harmony

• Acción requerida: Descontinuación de URLs de redirección de SSO heredadas
  Jitterbit está retirando las URLs de redirección heredadas para inicio de sesión único (SSO) de Harmony con esta versión 12.4. Desde nuestro anuncio de junio de 2024 (11.28) en el que se indicó que las URLs de SSO habían cambiado, las configuraciones de SSO nuevas y actualizadas requieren las nuevas URLs. Sin embargo, es posible que tu organización aún esté utilizando URLs heredadas si configuraste SSO antes de junio de 2024 y su configuración aún no se ha actualizado.

  Los administradores de la organización deben reconfigurar su configuración de SSO existente para utilizar las nuevas URLs, o los inicios de sesión de los 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 está utilizando 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 un inicio de sesión exitoso.

  Para obtener ayuda, contacta al soporte de Jitterbit.

Correcciones

Agent

• El archivo credentials.txt obsoleto ya no bloquea los reinicios del contenedor Docker
  Cuando deregisterAgentOnDrainstop=true, reiniciar el contenedor ahora anula automáticamente el registro del agente existente y registra uno nuevo, sin requerir la eliminación manual de credentials.txt. Para más detalles, consulta Comportamiento del agente al reiniciar.

• Instalación del agente de Linux corregida para usuarios con permiso de instalación de Agent
  Los usuarios que solo tienen el permiso de instalación de Agent ahora pueden instalar exitosamente un agente de Linux cuando tienen acceso de escritura a al menos un entorno. Anteriormente, estos usuarios recibían un error de autenticación 401 durante la instalación del agente de Linux independientemente de su acceso al entorno.

Agent y Design Studio

• La actualización de transformación de NetSuite ya no falla
  Al intentar actualizar una transformación de NetSuite, ya no se devuelve un error 500. Este problema se limitaba a la versión de macOS de Design Studio.

Conectores

• Corrección de seguridad del conector de Microsoft Dynamics 365
  Las actividades del conector de Microsoft Dynamics 365 ya no exponen credenciales en mensajes de error cuando una actividad falla.

Portal de Harmony

• El vencimiento de la sesión de SSO ya no causa un bucle de redirección
  Cuando vence la sesión de un usuario de Harmony SSO, el portal de Harmony ahora completa totalmente el proceso de cierre de sesión al borrar las cookies de sesión, lo que evita un bucle de redirección infinita entre las páginas de inicio de sesión y de destino. Se redirige a los usuarios a la página de inicio de sesión y pueden volver a iniciar sesión correctamente.

Consola de administración

• Se resolvió el error de Cloud Datastore al editar registros con campos personalizados en blanco
  Al modificar un registro en la página Cloud Datastore, ya no se devuelve un error Failed to create storage register cuando se dejan en blanco campos personalizados no requeridos.

Studio

• Las ramas de condición de la herramienta de decisión ahora se representan correctamente después de la importación del proyecto
  Los flujos de trabajo que contienen la herramienta Decision ahora muestran correctamente las conexiones de rama de condición en el lienzo de diseño después de importar un proyecto. Anteriormente, faltaban las conexiones aunque la herramienta de decisión y las operaciones estuvieran presentes.

• Los cambios de esquema ya no causan inestabilidad en Studio
  Al intentar guardar un esquema modificado con nodos duplicados, ya no se puede hacer que Studio deje de responder.

Avisos

Agente

• Retiro 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 con respecto a futuras versiones:

  • Versión final 11.x: La versión del agente privado 11.x ha llegado al final de su desarrollo planificado. 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 raras para problemas que afecten la producción, no hay versiones futuras planificadas.

  • Recomendación: Se recomienda encarecidamente actualizar a agentes privados 12.x lo antes posible para beneficiarse de las últimas mejoras de rendimiento, seguridad y funciones.

  • Ruta de actualización: Puedes actualizar directamente de 11.x a cualquier versión 12.x usando nuestras instrucciones de actualización documentadas: 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 las instrucciones de actualizació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 utilizan esos conectores comenzarán a fallar en el momento de la actualización.

Agente y Design Studio

• Fin de vida útil para la versión 11.42
  A partir del 24 de abril de 2026, estas versiones de producto han llegado al fin de vida útil y ya no son compatibles:

  • Versión del agente privado 11.42
  • Versión de Design Studio 11.42

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

Conectores

• Acción requerida: Retiro de autenticación IDCRL del conector Microsoft SharePoint Server
  Microsoft está retirando la autenticación IDCRL el 1 de mayo de 2026. Después de esta fecha, las operaciones que dependan de conexiones que utilicen el esquema SOAP de SharePoint Online comenzarán a fallar. La migración requiere crear una nueva conexión utilizando el esquema REST, reasignar las actividades existentes a la nueva conexión e implementar nuevamente las operaciones dependientes. Para ver los pasos completos de migración, consulta la página Conexión Microsoft SharePoint Server.

  Importante

  Si te estás conectando a SharePoint Online utilizando el esquema SOAP, debes migrar al esquema REST antes del 1 de mayo de 2026 para evitar fallos en las operaciones.

• 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 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 de la Consola de Administración se devuelvan directamente en el nivel superior de la respuesta.

  Importante

  Si estás utilizando 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 será eliminada en el futuro.