11.26 Harmony release notes

11.26 Harmony release

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

The 11.26 release is staggered based on the dates and times as listed below by component and region. 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, which is available at Docker Hub). The end-of-life date for these components is one year after the release date.

New features

Agent, Cloud Studio, and Design Studio

• JWT functions
  The following new functions can be used with agents 11.26 or later to create, verify, and decode JSON Web Tokens. The new functions are listed in the JWT category of the Functions tab in the Cloud Studio script component palette and can also be used with Design Studio 11.26 or later.

  • CreateJwtToken
  • VerifyJwt
  • VerifyJwtClaims
  • DecodeJwtToken
  • GetJwtHeader
  • GetJwtPayload
  • GetJwtSignature

Cloud Studio SDK connectors

• SmartRecruiters (Beta) connector
  The SmartRecruiters (Beta) connector can be used to query, create, update, or delete object data in SmartRecruiters. This connector is supported on both cloud and private agents 10.1 or later. For beta access, contact your Customer Success Manager (CSM).

Enhancements

API Manager

• Ability for roles with Write environment access to create and publish APIs
  Harmony users whose role has Read permission can now create and publish APIs in an environment that their role has Write access in.

• Security profile API key and value character limit increased
  Security profiles configured with API key authentication can now be configured with Key and Value input up to 256 characters each, increased from 50 characters.

• API Manager Log Service API (Beta)
  The API Manager log service API (Beta) provides the ability to download API debug logs as an alternative to downloading them through the API Manager API Logs page. To provide feedback on this beta, contact your Customer Success Manager (CSM).

Cloud Studio

• UX improvements
  The following enhancements have been made to the user experience:

  • In the project pane’s Components tab, the new Icon view preferences menu provides you with control over the visibility of icons. The previous checkbox to show or hide endpoint activity types has also been consolidated into this menu.

  • Actions that can be taken on groups of components are now centralized in a Components tab actions menu. As part of this menu, you now have the option to delete unused components of any type in bulk. When deleting unused components, a new dialog provides the ability to de-select individual components.

  • During connector activity configuration, using the search box on an object selection step now searches all columns of the table and is no longer limited to the object’s Name. This enhancement affects all Connector SDK-based connectors using the List Object component.

Cloud Studio SDK connectors

• Google Drive connector ability to set content type for uploads
  When base64-encoded data is provided in the request of a Google Drive Create File or Update File activity, the MIME type is now detected automatically. This enhancement enables the use of Google Drive’s functionality to open files without downloading them. In addition, these activities have a new Content Type field in their Optional Settings and new contentType field in their request schemas to override the detected content type.

• Elasticsearch connection support for HTTP hosts
  The Host field in an Elasticsearch connection now supports and uses the HTTP scheme by default. Previously, using an HTTP host rather than HTTPS resulted in a Network is unreachable error.

• OpenAI connector Prompt activity enhancements
  Multiple enhancements have been made to the OpenAI Prompt activity:

  • The Model menu now has selections for GPT-3.5 Turbo models gpt-3.5-turbo, gpt-3.5-turbo-16k, gpt-3.5-turbo-instinct. Deprecated GPT-3.5 models text-davinci-002 and text-davinci-003 have been removed.

  • A new Role menu in Optional Settings allows you set the prompt’s role as Assistant, System, or User.

• ServiceNow connector operation speed improved
  The initial execution of an operation using a ServiceNow activity is now faster as a result of changing the default of the GetColumnsMetadata property to onUse. This property can be set back to its previous setting of onStart on private agents by providing the key-value pair in a ServiceNow connection’s Advanced Configurations.

• Shopify request header specification
  A Shopify connection’s Optional Settings now has a Request Headers table where you can provide additional headers for API requests.

• Workday connector API version support through 42.0
  Workday Web Services (WWS) API versions v41.0, v41.1, v41.2, and v42.0 are now available to select in the Version menu of a Workday connection.

EDI

• Options to save, copy, and print documents
  In the Document information tab of a selected transaction, the Views pane now shows an Actions column that includes the options to view, save, copy, or print the raw document. When viewing the raw document, options to save, copy, or print the document are also available.

Management Console

• Runtime Operations log expansion with a single click
  Selecting an operation on the Runtime Operations page now automatically expands all of its child operations.

• App Registration auth token expiration email recipients expanded
  When the Receive Expiration Notification setting on the App Registrations page is enabled, the email notification will now be sent to the last person to deploy the project, in addition to Harmony administrators, who are already sent the notification.

Changes

API gateway

• Major version number increased to 11.x
  The versioning of the API gateway has been increased from 10.x to 11.x. This is a change in version numbers only. API gateway 11.x is compatible with existing APIs.

Cloud Studio SDK connectors

• Release cadence for connectors changed
  Jitterbit-provided Cloud Studio Connector SDK-based connectors will now have a staggered release:

  • Sandbox Cloud Agent Group: Updated connectors will be released to Sandbox Cloud Agent Group environments at the time of the Sandbox Cloud Agent Group update.
  • Production Cloud Agent Group and private agents: Updated connectors will be released to environments using the Production Cloud Agent Group and private agents at the time of the Production Cloud Agent Group update.

  New Jitterbit-provided Cloud Studio Connector SDK-based connectors (appearing under the new Cloud Studio SDK connectors release notes component category) and updated native Cloud Studio connectors (continuing to appear under the Cloud Studio release notes component category) are released to the Sandbox Cloud Agent Group and the Production Cloud Agent Group at the first date set of the Harmony release and Sandbox Cloud Agent Group upgrade.

  At this time, updated native Cloud Studio connectors also become available to use with private agents. Some native Cloud Studio connectors may also have an independent agent version requirement, as indicated for each release note by a designation within the Agents component category.

  In environments using private agents, you can suspend Cloud Studio connector updates using the organization policy Disable Auto Connector Update.

  Whether a Jitterbit-provided connector is Connector SDK-based is indicated in the connectors list and in each connector's documentation.

  Updated May 31, 2024

  This release note was added on May 29, 2024 and corrected on May 31, 2024. The corresponding rearrangement of release notes to clarify which connectors were released on the staggered schedule occurred on May 29, 2024.

Design Studio

• Major version number increased to 11.x
  The versioning of Design Studio has been increased from 10.x to 11.x. This is a change in version numbers only. Design Studio 11.x is compatible with supported 10.x agents and projects created with 10.x Design Studio.

Fixes

API Manager

• OData service now supports ordering by multiple columns
  An API Manager OData service no longer returns an error and no data if more than one column is provided in the orderby parameter.

Agent

• Proxy passwords are now redacted on update
  After using the agent’s utility application JitterbitUtils to update existing proxy settings, the agent proxy password is now redacted as expected and no longer appears in plain text in the jitterbit-agent.log file.

Agent and Cloud Studio

• NetSuite Search response for CustomRecord fixed
  When a NetSuite Search activity is using the CustomRecord object and either an Expanded or Advanced search, the expected response is now returned. Previously, data was not being returned due to an issue in the response schema. This fix requires agent version 11.26 or later.

Agent and Cloud Studio SDK connectors

• Microsoft Azure ESB connector no longer generates excessive log entries
  When using the Microsoft Azure ESB connector and agent version 11.26 or later, only ERROR messages are now logged. For agent version 10.87 / 11.25 or earlier, an excessive number of INFO logs were being generated in a short time period, leading to disk space issues as a result of the size of the catalina.out file.

Cloud Studio SDK connectors

• BigCommerce Query for Get Webhooks no longer fails
  A BigCommerce Query activity configured for the Webhooks object > Get Webhooks sub-object no longer results in the error Connection pool shut down.

• Epicor Kinetic connector now supports sending null/empty values
  The Jitterbit variable jitterbit.target.xml.include_empty_xml now works as expected with the Epicor Kinetic connector. Previously, the empty value was being dropped from the payload.

• Salesforce activity transformation mappings now persist
  When the response from a Salesforce activity is used as the source schema in a transformation, and you then attempt to create mappings where loop nodes are created or updated in that transformation, the mappings no longer fail to persist after closing the transformation.

• Salesforce target activities can now be used with a Database source
  When a Database Query activity with Include the schema/owner in the table names selected is used as the source activity and a Salesforce Insert or Update activity is used as the target activity in the Transformation pattern, the runtime error Fail to find the node:[Salesforce:] for flat source structure no longer occurs.

• Shopify Query schema fields for Product_Variant now present
  A Shopify Query activity now has all expected parameters in the request and response schemas for the Products object > Product_Variant sub-object. In addition, error messaging has been improved to provide more meaningful information when the request is missing required fields.

EDI

• Harmony portal header updated
  When accessing the EDI application, the Harmony portal header now shows the EDI logo and links to the Transactions page instead of showing the Management Console logo and link.

Management Console

• Environment name fixes for allowed special characters
  Multiple fixes have been made to environment names when they contain allowed special characters (such as ó):

  • New environment names no longer have special characters unexpectedly converted to other characters when the new environment name is saved.

  • When an environment name has special characters, the table of environments no longer fails to populate, returning the error Failed to load environments - URIError: URI malformed.

Jitterbit CRM REST connector

• Microsoft Dynamics CRM connector support for updating a team owner
  The Cloud Studio or Design Studio Microsoft Dynamics CRM connector no longer results in an authorization error on testing the connector that was occurring since version 1.0.4.0 of Jitterbit’s connector installer. The error was occurring due to a required DLL file that was missing from the installation and is now included.

Notices

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.