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 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.
11.26 Sandbox Cloud Agent Group 11.26 API Gateway 11.26 Design Studio 1.0.4.1 Jitterbit Microsoft Dynamics 365 Cloud Connector Cloud Platform and Applications | 11.26 Production Cloud Agent Group 11.26 Windows and Linux Private Agents | 11.26 Docker Private Agent | |
---|---|---|---|
APAC | May 14, 2024 (12 - 4 AM AEST) | May 21, 2024 (2 - 8 PM AEST) | May 23, 2024 (8 PM AEST) |
EMEA | May 14-15, 2024 (9 PM - 1 AM CEST) | May 22, 2024 (6 AM - 12 PM CEST) | May 23, 2024 (12 PM CEST) |
NA | May 15, 2024 (12 - 4 PM PDT) | May 22-23, 2024 (9 PM - 3 AM PDT) | May 23, 2024 (3 AM PDT) |
Note
As of May 11, 2024 these product versions have reached end of life and are no longer supported:
- Private Agent versions 10.70 / 11.8
- Design Studio version 10.70
- Private API Gateway version 10.70
We recommend that all users of any of these versions upgrade to the latest version as soon as practicable.
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.
Cloud Studio¶
- 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.
-
-
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 newcontentType
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 aNetwork 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 modelstext-davinci-002
andtext-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 toonUse
. This property can be set back to its previous setting ofonStart
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.
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¶
Agent¶
- Proxy passwords are now redacted on update
After using the agent’s utility applicationJitterbitUtils
to update existing proxy settings, the agent proxy password is now redacted as expected and no longer appears in plain text in thejitterbit-agent.log
file.
Agent and Cloud Studio¶
-
Microsoft Azure ESB connector verbose logging no longer generates excessive entries
When verbose logging is enabled for the Microsoft Azure ESB connector, onlyERROR
messages are now logged. Previously, an excessive number ofINFO
logs were being generated in a short time period, leading to disk space issues as a result of the size of thecatalina.out
file. This fix requires agent version 11.26 or later. -
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.
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 theorderby
parameter.
Cloud Studio¶
-
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 errorConnection pool shut down
. -
Epicor Kinetic connector now supports sending null/empty values
The Jitterbit variablejitterbit.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 errorFail 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.