11.48 Notas de la versión de Harmony

Versión 11.48 de Harmony

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

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

Mejoras

Agente

• Variable de entorno para el token de autorregistro
  El archivo de autorregistro del agente privado ahora tiene una variable de entorno equivalente para establecer el token de acceso del agente privado: AUTO_REGISTER_TOKEN.

Administrador de API

• Capacidad de desasignar roles de API
  Los administradores y usuarios con acceso de escritura al entorno ahora pueden asignar y desasignar roles de usuario a las API y desde ellas a través de la pestaña Roles de usuario en el cajón de detalles de API. Anteriormente, no se podían desasignar roles, lo que impedía que los administradores eliminaran roles que aún se referenciaban.

• Mejora del formato CSV de registros y análisis
  Los registros y análisis descargados como CSV desde las páginas API Logs y Analytics ahora son más consistentes con las especificaciones de CSV. Anteriormente, los valores null e undefined se convertían manualmente a cadenas vacías (""). Ahora, se serializan como valores vacíos, no como "null" o "undefined" entrecomillados.

• Mejoras en la experiencia del usuario
  Se han realizado las siguientes mejoras en la experiencia del usuario:

  • Las opciones de Filter by aplicadas por última vez ahora se conservan al regresar a la página API Logs en la misma sesión.
  • Al ordenar por versión, ahora se ordenan las APIs en orden ascendente, primero las que no tienen versión, luego por número y después por cadena de texto.

Portal Harmony

• Acceso mejorado a Jitterbit AI
  Jitterbit AI en el encabezado del portal Harmony ahora es accesible en todas las aplicaciones web de Harmony. El chatbot AskJB AI se abre de forma predeterminada. Las organizaciones cuya licencia incluye el APIM AI Assistant tienen un menú para cambiar entre tipos de bot de IA al acceder a API Manager o Integration Studio.

Integration Studio

• Capacidad de publicar una operación como API usando IA
  El menú de acciones de operación tiene una nueva opción para Publish as an API using AI, que abre el APIM AI Assistant en organizaciones con licencia para ello. El APIM AI Assistant te guía a través de la publicación de la operación como API mediante indicaciones interactivas.

• Notificación para colaboradores del proyecto durante la restauración del proyecto
  Cuando otro usuario que edita el mismo proyecto lo restaura a una versión anterior, los otros usuarios ahora reciben una notificación en tiempo real en el proyecto. Al cerrar la notificación, el proyecto se actualiza automáticamente para reflejar el estado del proyecto restaurado.

Conectores

• Autenticación predeterminada del conector Microsoft SharePoint 365
  Las selecciones del menú Authentication type de una conexión de Microsoft SharePoint 365 tienen estos cambios:

  • Microsoft Entra ID ha sido renombrado de Azure Active Directory y ahora está seleccionado de forma predeterminada para nuevas conexiones.
  • Azure Access Control Service (Deprecated) ha sido renombrado con una etiqueta (Deprecated) ya que Microsoft ha anunciado que Azure ACS se está retirando.

• Compatibilidad con API V2 del conector ShipStation y esquemas editables
  Una conexión de ShipStation ahora tiene un menú Version para seleccionar la versión de API V1 (predeterminada existente) o V2 (recién compatible). Además, la Create activity tiene un nuevo icono de edición encima del esquema de respuesta para editar la estructura de datos según sea necesario.

• Compatibilidad de autenticación del conector Snowflake para OAuth de clave de par y de 3 etapas
  Una conexión de Snowflake ahora tiene un menú Authentication donde puedes seleccionar Key-Pair (recién compatible), OAuth (recién compatible) o Password (Deprecated) (predeterminada existente). Para clave de par, debes proporcionar una clave privada cifrada o sin cifrar. Para OAuth, haces clic en Log in with Snowflake para autenticar la conexión usando una aplicación privada registrada. La opción OAuth requiere agentes en la nube o versión de agente privado 10.83 / 11.21 o posterior.

• Actualizaciones de conectores
  Los siguientes conectores tienen actualizaciones de rendimiento y estabilidad:

  • Active Directory v2
  • Amazon Marketplace v2
  • GraphQL v2
  • Microsoft Dataverse v2
  • Microsoft Dynamics 365
  • Microsoft Excel v2
  • Microsoft Exchange v2

Cambios

Agente

• Se requiere acción del usuario: Nuevas direcciones IP del agente en la nube de APAC
  Si utilizas agentes en la nube de la región APAC para acceder a puntos finales dentro de tu red detrás de un firewall, debes permitir tres direcciones IP adicionales antes del 26 de agosto de 2025:

  • 16.50.32.215
  • 16.51.140.139
  • 16.51.180.48

  Las nuevas direcciones IP entrarán en vigor con las actualizaciones del Grupo de Agentes en la Nube de Producción 11.48 y del Grupo de Agentes en la Nube de Sandbox 11.51. Si no añades estas direcciones IP antes del 26 de agosto de 2025 para el Grupo de Agentes en la Nube de Producción o antes del 21 de octubre de 2025 para el Grupo de Agentes en la Nube de Sandbox, las operaciones de integración dependientes dejarán de funcionar como se esperaba.

  El 21 de octubre de 2025, también puedes eliminar las siguientes direcciones IP, que se están dando de baja:

  • 3.0.141.187
  • 13.251.231.2
  • 52.220.155.2

  Para obtener información adicional, consulta Preguntas frecuentes sobre cambios de IP de APAC. Todas las direcciones IP que se deben añadir para garantizar la comunicación entrante a tu red desde agentes en la nube se encuentran en Información de lista de permitidos (whitelist) de Jitterbit.

Correcciones

API Manager

• Ahora se puede establecer la fecha y hora para desactivar el modo de depuración de API
  La opción Habilitar modo de depuración hasta de una API ahora te permite seleccionar una fecha y hora como se esperaba. Anteriormente, la interfaz de usuario te impedía establecer una fecha y hora futura en la que se desactivaría el modo de depuración de API.

Integration Studio

• El analizador de scripts ahora maneja nombres de variables globales con ciertos caracteres
  Cuando la configuración del proyecto Habilitar nuevo analizador de scripts de Jitterbit está habilitada, el script ahora se valida como se esperaba cuando una variable global utilizada para concatenación de cadenas tiene cualquiera de los siguientes caracteres en su nombre: @ # ? %. Anteriormente, se devolvía el error de validación no viable alternative at input.

• Mejoras de rendimiento en transformaciones
  Las transformaciones con esquemas grandes (muchos nodos y campos) tienen mejoras de rendimiento que resuelven problemas con doble clic y selección de texto.

Conectores

• Se corrigió el error de Cargar archivo de Microsoft SharePoint 365
  Una actividad de Cargar archivo de Microsoft SharePoint 365 ahora devuelve el campo ExistsWithException en su respuesta. Esto resuelve un error en tiempo de ejecución que reportaba un campo no reconocido.

Avisos

Agente, puerta de enlace de API y Design Studio

• Fin de vida útil de la versión 11.30
  A partir del 15 de agosto de 2025, estas versiones de producto han llegado al fin de su vida útil y ya no son compatibles:

  • Versión 11.30 del agente privado
  • Versión 11.30 de la puerta de enlace de API privada
  • Versión 11.30 de Design Studio

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

Design Studio e Integration Studio

• Se requiere acción del usuario: La propiedad TYPE del usuario de Snowflake debe actualizarse y futura depreciación de la autenticación de un solo factor
  Snowflake ha anunciado la próxima depreciación de la autenticación de un solo factor, que afecta a las integraciones de Integration Studio y Design Studio que se conectan a Snowflake usando una contraseña.

Para los afectados, se requiere acción del usuario en dos fases:

1. Antes del 31 de marzo de 2025, la propiedad TYPE de la cuenta de usuario que utilizas para conectarte a Snowflake debe establecerse en LEGACY_SERVICE para continuar usando autenticación basada en contraseña (consulta Types of users). Sin acción del usuario, se espera que las integraciones existentes que utilizan autenticación de contraseña de un solo factor en Snowflake comiencen a fallar en abril de 2025.

2. Antes de noviembre de 2025, debes actualizar el tipo de autenticación utilizado para conectarte a Snowflake a OAuth o autenticación de par de claves. En este momento, la autenticación basada en contraseña ya no será compatible. El conector de Snowflake de Integration Studio admite tanto OAuth como autenticación de par de claves a partir de esta versión 11.48.