11.31 Harmony release notes¶

11.31 Harmony release¶

This page includes release notes for all generally available components being released as part of 11.31. Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and private agents are also available.

The 11.31 release is staggered based on the dates and times as listed below by component and region. For a more detailed explanation of the release cadence by component category, see the release schedule.

You can subscribe to maintenance notifications for web-based components at Jitterbit Trust. Locally installed components are available from the Downloads page (except for the Docker private agent and Docker private API gateway, which are available at Docker Hub). The end-of-life date for these components is one year after the release date.

Enhancements¶

API gateway¶

• Ability to disable hyphen replacement in proxy API headers
  You can now prevent hyphens in proxy API headers from being replaced with underscores. When using an API gateway version 11.31 or later, in step 4 of proxy API configuration under Request Headers, set the key disable-hyphen-replacement to true. The default behavior (false) is to replace hyphens with underscores.

API Manager¶

• Warning when disabling SSL
  When clearing the checkbox SSL Only (selected by default) for an API, a message now warns users they are enabling HTTP and asks for confirmation that they understand the risks of switching to an unsecure protocol.

Cloud Studio¶

• Project history usability improvement
  The time range shown in the project history is now chronological, in the order of earliest to latest time.

• Project design UI (beta) improved selection and highlighting
  The redesigned project design UI (beta) has improved visual states of selected and highlighted components.

Cloud Studio SDK connectors¶

• Gzip connector support for tar.gz files
  The Gzip Decompress and Compress activities have these new Optional settings checkboxes: Decompress tar.gz file and Compress tar.gz file. Previously, only .gz files were supported.

• HTTP v2 connector enhancements
  The following enhancements have been made to the HTTP v2 connector:

  • In a connection under Optional settings, when the new checkbox Get response content in base64 string is selected, the responseContent returned from any HTTP v2 activity will be base64-encoded.

  • In a connection under Optional settings > Advanced HTTP Properties, a new Encode Request URL checkbox can be used to enable encoding of the URL path and query parameters.

  • In a PATCH, POST, or PUT activity, when Multipart is selected, the default request schema now includes a Content-Type field in the node of a specific plain-text part in the multipart.

  • In a HEAD, GET, PATCH, POST, PUT, DELETE, HEAD, or OPTIONS activity, when Continue on error is selected and an error status code is returned, the default response schema now includes a statusMessage field in the error node to record the error message from the API.

• Microsoft Azure Key Vault (beta) connector enhancements
  The following enhancements have been made to the Microsoft Azure Key Vault (beta) connector:

  • A new Certificate activity can be used to perform a certificate operation and can be used as a source or a target in an operation.

  • In a Key or Secret activity, when selecting from the table of vaults, the location and resource group of each vault are now displayed.

• Microsoft Teams connector ability to set scope
  A Microsoft Teams connection now has an Optional settings > Scope field to allow you to restrict access to the minimum set of permissions for your use case.

• OpenAI model GPT-4o support
  An OpenAI Prompt activity’s Model menu now has GPT-4o as a selection.

• SAP Concur support for API v4.0 and trailing slash
  An SAP Concur connection’s Version menu now has SAP Concur API v4.0 as a selection. In addition, the Host value can now have a trailing slash.

Management Console¶

• Agents page enhancements
  The following enhancements have been made to the Agents page:

  • The Agents tab now has an ID column that shows each agent’s ID.
  • An agent with Starting status can now be deleted.

• Runtime Operations page highlighting with wildcard search
  Search results on the Runtime Operations page from queries that include a wildcard now highlight the matching portion of the search result.

Changes¶

Agent¶

• General updates
  This agent version has general internal updates.

Fixes¶

Agent¶

• NetSuite connector issue resolved
  An issue with operations using the NetSuite connector has been resolved.

  Note

  This issue was resolved with agent version 11.31.1 (refer to the dates earlier on this page).

• Linux private agent Scheduler issue resolved
  A date library whose latest files introduced an issue where the Linux agent's Scheduler service failed to start is no longer automatically downloaded.

  Note

  This issue was resolved with agent version 11.31.2 (refer to the dates earlier on this page). We recommend upgrading Linux private agents to 11.31.2 or later to prevent this issue from occurring and, in cases where it is already occurring, to recover from it.

  Alternatively, if you are using an earlier agent version you can apply the following workaround or recovery steps to non-Docker agents:

  • Workaround: If a Linux private agent has not yet been restarted, to prevent this problem from occurring, edit the version file at /opt/jitterbit/TimeZoneDB/version and change its value to 2024b. This will prevent the version of the date library with the issue from being downloaded by the agent.

  • Recovery: If a Linux private agent is already experiencing this issue, to fix it, edit the northamerica file at /opt/jitterbit/TimeZoneDB/northamerica to replace the value April with Apr in any occurrences. Then restart the agent.

API gateway¶

• Self-test utility no longer fails
  The API created by the command line self-test utility now has values for the Service Name and Path fields. Previously, these required values were missing, resulting in the self-test failing with the message Failure, test call to API failed.

Cloud Studio¶

• Changes to mappings using duplicate nodes no longer fail to save
  When making changes to mappings in a transformation using a duplicated flat uploaded schema, the changes no longer intermittently fail to save when the save appears to be successful.

Cloud Studio SDK connectors¶

• SAP Concur Read operations now require a request transformation
  A transformation is now required preceding an SAP Concur Read activity in order for the operation to be valid. Previously, operations were allowed to be deployed but a runtime error would occur if a request transformation was not present.

• Shopify API access token value is now masked
  The user-provided value of a Shopify connection’s API access token field is now masked in the UI.

Notices¶

Agent and API gateway¶

• End of life for agent 10.75/11.13 and private API gateway 11.75
  As of August 24, 2024 these product versions have reached end of life and are no longer supported:

  • Private agent versions 10.75 and 11.13

  • Private API gateway version 10.75

  We recommend that all users of any of these versions upgrade to the latest version as soon as practicable.

Agent¶

• Private agent versions 10.x are no longer updated
  Private agent version 10.87 was the last 10.x agent version distributed by Jitterbit and is intended to be the final supported 10.x agent version.

  Since Harmony release 10.63 / 11.1, both a 10.x and 11.x private agent version had 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: Supported 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.

  Important

  To continue to receive private agent updates, including new features, enhancements, security patches, and fixes, upgrading to an 11.x private agent is required.

  Follow the instructions to upgrade from 10.x to 11.x agents:

  • Windows agent upgrade instructions (requires a complete uninstall)
  • Linux agent upgrade instructions

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 Jitterbit Harmony NetSuite connectors, you should change any Jitterbit 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.