10.82 / 11.20 Harmony Release Notes¶

10.82 / 11.20 Harmony Release¶

This page includes release notes for all generally available components being released as part of 10.82 / 11.20. Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and Private Agents are also available.

The 10.82 / 11.20 release is staggered based on the dates and times as listed below by component and region. You can subscribe to maintenance notifications for cloud-based components at Jitterbit Trust. Locally installed components are available from the Downloads page (except for the Docker Private Agent, which is available at Docker Hub). The end-of-life date for these components is one year after the release date.

New Features¶

Cloud Studio¶

• HTTP v2 connector general availability
  The HTTP v2 connector is no longer a beta version. It can be used to connect over HTTP or HTTPS protocol to a service such as a REST API, GraphQL API, or web form using the HTTP verbs GET, POST , PUT, DELETE, PATCH, HEAD, or OPTIONS. The HTTP v2 connector is generally recommended over the HTTP connector in cases where an application-specific connector is unavailable. High-level considerations and a comparison of capabilities for each connector type are documented for reference when choosing a connector for HTTP connectivity.

• Salesforce Commerce Cloud (Beta) connector public beta
  The Salesforce Commerce Cloud (Beta) connector is now available to all organizations. It can be used to retrieve object data based on ID, a set of criteria, or a custom query; or to create, update, or delete object data in Salesforce Commerce Cloud. To provide feedback on bugs and enhancements, contact your Customer Success Manager (CSM).

• Square v2 connector general availability
  The Square v2 connector is no longer a beta version. It can be used to read, query, create, update, or delete object data in Square. In addition to support for the Customers object (which the existing Square connector supports), the Square v2 connector adds support for the Catalog, Customers, Inventory, Invoices, Orders, Payments, Subscriptions, and Terminal objects.

Enhancements¶

API Gateway¶

• NGINX server upgrade
  The NGINX server used by the API Gateway has been upgraded to version 1.21.4.3 to improve security and performance.

Cloud Studio¶

• Automatic reference of array arguments by instance functions
  When using an instance function with an array argument, a hash symbol (#) is now automatically inserted in the data element’s reference path to return an array of data as opposed to a single field. This enhancement affects new uses only; it does not affect script locations where instance functions are already used.

• Expanded search results in the design component palette
  Searching in either tab in the design component palette now returns results from both tabs. The search results are organized into two categories: Local Endpoints and Connectors and Global Connection Endpoints.

• HTTP v2 connector UX improvements for OAuth 2.0
  When testing an HTTP v2 connection configured with OAuth 2.0 authorization, error messaging has been enhanced to provide more explicit information for troubleshooting. In addition, the Token Type field has been removed, as this is now handled automatically.

• JMS connector support for SSL/TLS authentication
  A JMS connection now supports JMS clients configured to use SSL/TLS when a certificate in PKCS format is added in the Jitterbit Java keystore. Additional configuration options for IBM MQ are available when Use SSL is selected in the connection, including SSL Cipher, Security Protocol, and CipherSuite Mapping.

• Magento API version 2.4.6 support and editable schemas
  Jitterbit has verified support for Adobe Commerce API version 2.4.6. In addition, the schemas generated for a Magento activity can now be edited to change the request and response structures as needed.

• NetSuite connector default WSDL updated
  The version of the WSDL Download URL that is prepopulated in new NetSuite connections is now version 2023.2. This change does not affect existing NetSuite connections.

• Additional verbose logging details for multiple connectors
  Enabling verbose logging with the Google Pub Sub and VTEX connectors results in the generation of additional log information beyond that already generated. To generate the additional log details, a new format of the configuration entry is required as documented on the linked pages.

Design Studio¶

• Salesforce API version 59 support
  The Salesforce connector supports using Salesforce API version 59 with the use of a minimum 10.80 / 11.18 agent and 10.82 version of Design Studio. When opening an existing Design Studio project that uses this connector and meets both version requirements, an API upgrade dialog is displayed.

EDI¶

• UX enhancements
  Several user experience enhancements have been made:

  • The Transactions page document direction labels have been updated to Inbound and Outbound for consistency. Previously, references to Incoming / Outgoing and To / From appeared.
  • The Admin page now has help text providing instruction for requesting a new trading partner, better visibility of long partner names, and labels clarifying the UI areas.

Jitterbit CRM REST Connector¶

• Microsoft Dynamics CRM connector support for updating a team owner
  When using the Cloud Studio or Design Studio Microsoft Dynamics CRM connector, you can now assign a team as the account owner by providing the ownerid in the format of team_{GUID}. Previously, the connector always assigned the systemuser role to the owner and didn't support the team owner role. Support for team owners requires version 1.0.4.0 of Jitterbit's separately installed Microsoft Dynamics 365 Cloud connector.

Fixes¶

Agent¶

• Invalid payload in child operations is now reported
  A child operation now fails with a descriptive error if the payload received in a transformation does not match the defined schema. Previously, the parent operation incorrectly reported an Unexpected Error and child operations remained in a Running status until canceled.

Cloud Studio¶

• Jitterbit variables are no longer displayed as global variables
  After referencing a Jitterbit variable in a script, the Jitterbit variable no longer becomes incorrectly identified as a global variable in the Cloud Studio UI.

• Transformation preview values are no longer off by one for joined tables
  When previewing a transformation where the target schema has joined database tables, the transformed preview values are no longer off by one, where the data associated with a source field is displayed for the following target field. This issue did not affect transformed data at runtime.

• Migrating a project with a promoted global connection no longer fails
  Migrating a project that uses a global connection promoted from a local endpoint in another migrated project now succeeds. Previously, attempting to migrate the project failed with the error Cannot read properties of undefined.

• Remote changes to schedules and project variables now sync with Cloud Studio
  A schedule or project variable that is edited through the Management Console Projects page no longer causes that component to be incorrectly identified in Cloud Studio as having an undeployed change. This issue began with the 10.79 / 11.17 release and was a visual bug only; the remote change still took effect immediately, as expected.

• Email connector intermittent runtime error on Cloud Agents no longer occurs
  When executing an Email activity on a Cloud Agent Group, an intermittent error reporting attempted duplicate class definition no longer occurs.

• HTTP connector duplication issue no longer occurs
  After duplicating an HTTP activity and then replacing the duplicated HTTP activity’s defined schemas, the schemas of the original HTTP activity that was duplicated are no longer affected.

• HTTP v2 configuration error with schema generation no longer occurs
  After providing a request or response schema during configuration of an HTTP v2 activity, an error no longer occurs while fetching data for the schema generation step. Previously, an error reported Cannot read properties of undefined.

• Magento connector now displays the object paths
  When selecting an object during Magento activity configuration, the new column Object Path lists the specific API operation for each object. This clarifies the difference between objects that have the same name and description.

Management Console¶

• Link to view logs from Private Agents now works
  When cloud logging is disabled, the View Log Messages from Agent link that is displayed in the Runtime Operations page Messages tab now works when accessing the link on a network configured to allow direct access to the agent.

Notices¶

Agent¶

• Jitterbit’s intention to stop distributing Private Agent 10.x
  Jitterbit intends to stop distributing a 10.x Private Agent version within the next several Harmony releases. Since Harmony release 10.63 / 11.1, both a 10.x and 11.x Private Agent version have been distributed with these differences:

  • 11.x versions: In 11.1 and later versions, the PostgreSQL database bundled with the Private Agent is now version 14.5-1.

  • 10.x versions: Current 10.x versions are packaged with the existing 9.6.24-1 PostgreSQL. The distributed 10.x versions will continue to be supported in accordance with Jitterbit’s end-of-life policy.

    Note

    Upgrading to an 11.x Windows Private Agent from 10.x requires a complete uninstall. Follow the documented instructions to complete the upgrade. Linux Private Agents can be upgraded as usual from any 10.x version.

NetSuite Connector, Cloud Studio, and Design Studio¶

• HMAC-SHA1 deprecation and removal from the Cloud Studio and Design Studio UI
  NetSuite is deprecating HMAC-SHA1 as a valid signature algorithm as previously announced (see NetSuite HMAC-SHA1 Deprecation). To support these changes, Jitterbit intends to remove the HMAC-SHA1 signature algorithm from the Cloud Studio and Design Studio UI in an upcoming Harmony release.

  Warning

  As the HMAC-SHA1 signature algorithm will no longer be supported by NetSuite or the Harmony NetSuite connectors, you should change any Harmony projects that are presently using HMAC-SHA1 as the signature algorithm to use HMAC-SHA256 as soon as possible to avoid issues with those integrations.

Related Resources¶

• Jitterbit Trust (includes the latest release dates and times, as the schedule is subject to change)
• Sandbox Cloud Agent Group releases, Production Cloud Agent Group releases, and Private Agent releases
• Release Schedule
• Known Issues
• Jitterbit End-of-Life Policy
• Jitterbit Community
• Jitterbit Support