10.71 / 11.9 Harmony release notes
10.71 / 11.9 Harmony release
This page includes release notes for all generally available components being released as part of 10.71 / 11.9. Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and private agents are also available.
The 10.71 / 11.9 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.
11.9 Sandbox Cloud Agent Group Cloud platform and applications Cloud API gateway 10.71 private API gateway 10.71 Design Studio | 11.9 Production Cloud Agent Group 11.9 and 10.71 Windows and Linux private agents | Cloud Studio patch | 11.9 Docker private agent | |
---|---|---|---|---|
APAC | May 23, 2023 (12 - 4 AM AEST) | May 30, 2023 (2 - 8 PM AEST) | June 3, 2023 (~ 12:30 AM AEST) | June 3, 2023 (8 PM AEST) |
EMEA | May 23-24, 2023 (10 PM - 2 AM CEST) | June 2, 2023 (6 AM - 12 PM CEST) | June 2, 2023 (~ 4:30 PM CEST) | June 3, 2023 (12 PM CEST) |
NA | May 24, 2023 (1 - 5 PM PDT) | June 2-3, 2023 (9 PM - 3 AM PDT) | June 2, 2023 (~ 7:30 AM PDT) | June 3, 2023 (3 AM PDT) |
Note
As of June 6, 2023 private agent version 10.54 has reached end of life and is no longer supported. We recommend that all users of this version (and earlier) upgrade to the latest version as soon as practicable.
New features
Cloud Studio
-
New connectors
There are 10 new connectors available for use with private agents 10.1 or later:- Active Campaign: Query, create, update, or delete object data, or execute a procedure in Active Campaign.
- Azure Analysis Services: Query object data or execute a procedure in Azure Analysis Services.
- Google Campaign Manager 360: Query object data or execute a procedure in Google Campaign Manager 360.
- Google Directory: Query, create, update, or delete object data, or execute a procedure in Google Directory.
- Microsoft OneNote: Query or create object data, or execute a procedure in Microsoft OneNote.
- Microsoft Planner: Query, create, update, or delete object data, or execute a procedure in Microsoft Planner.
- monday.com: Query object data or execute a procedure at monday.com.
- PayPal: Query object data or execute a procedure in PayPal.
- YouTube Analytics: Query, create, update, or delete object data, or execute a procedure in YouTube Analytics.
- Zoho Projects: Query, create, update, or delete object data, or execute a procedure in Zoho Projects.
Changes
App Builder
- Unpublished and unused apps will be deleted after 37 days
If an unpublished app hasn’t been edited in the last 30 days, the Harmony user who created it will be notified via email that the app will be automatically deleted after an additional 7 days unless it is published or edited.
Cloud Studio
- Database connections no longer require a successful connection test
A Database connection can now be saved without first successfully testing the connection. Previously, a connection test was required in order to fetch information about the configuration of opening and closing quotes as used by the database. Now, if a connection test is not performed, this information will be fetched during activity configuration.
Enhancements
Agent
- New Jitterbit variable to enable Unicode support
The new Jitterbit variablejitterbit.scripting.hex.enable_unicode_support
can be set totrue
upstream of theHexToString
orStringToHex
functions for their conversions to use UTF-8.
Cloud Studio
-
Epicor Kinetic connector performance improvements
An Epicor Kinetic Get activity loading a large amount of data (on the order of 1 million records) has improved performance. -
Google Pub Sub connector support for setting an acknowledgement deadline
A Google Pub Sub Get Message activity now has the option to set an acknowledgement deadline (in seconds) for messages to be acknowledged before the server redelivers them. -
Jira connector on-premises v9 support and ability to choose the version
The Jira connector now supports version 9.4.3 of Jira Server and Jira Data Center. A Jira connection has a new field, Jira Server Version, for selecting the on-premises version to use. -
Jitterbit App Builder connector support for verbose logging
The Jitterbit App Builder connector now supports connector verbose logging by setting this specific configuration entry of logger name and level:<logger name="org.jitterbit.connector.primeapps" level="DEBUG"/>
. -
Microsoft Azure ESB connector enhancements
The Microsoft Azure ESB connector has multiple enhancements:-
The connection field Namespace has been renamed to Namespace / Hostname and can now be used to provide a complete namespace address (using a namespace name as the hostname).
-
In Get Queue message and Get Topic Message activities, the new Wait Time field can be used to specify the amount of time to wait to receive messages.
-
In a Send Message activity, the Choose Message Type selection has been removed, as the type is not necessary when providing the name of the queue or topic.
-
During activity configuration, labels on object selection screens now indicate whether the selected object is a subscription, queue, or topic.
-
-
Surfacing of project dependencies preventing deletion
When attempting to delete a project that has been migrated to another environment and is now a dependency of the migrated projects, the error message now includes the names and environments of the migrated projects preventing deletion.
Management Console
-
Audit logging of external user activity
The Audit Logging page now logs the activity of external users accessing the API Manager Portal page. -
Reporting of Message Queues usage
The Message Queues page now has a Usage tab where you can see your usage of inbound messages by day and cumulative messages by month. The usage table also reports when you have reached a month’s usage limits.
Jitterbit CRM REST connector
- Microsoft Dynamics CRM connector now uses the Microsoft Authentication Library (MSAL)
As recommended by Microsoft, the Microsoft Dynamics CRM connectors for Cloud Studio and for Design Studio now use the Microsoft Authentication Library (MSAL) beginning with version 1.3.0.43 of Jitterbit’s separately installed Microsoft Dynamics 365 cloud connector. This replaces the Azure Active Directory Authentication Library (ADAL) for authentication.
Fixes
Agent
- API Manager OData pagination URL no longer erroneously skips records
An API Manager OData service with server-side pagination now correctly sets the$skiptoken
parameter in its response. Previously, the pagination URL provided in the response was set one digit too high, causing a record to be inadvertently skipped on each run.
API gateway
- API Manager API logs can now be filtered by security profiles using API key authentication
API Manager security profiles using API key authentication now appear in the filters on the Analytics and API Logs pages.
Cloud Studio
-
User action required to fix error with duplicated nodes in transformation mappings
Executing a transformation that contains mappings within newly duplicated nodes no longer results in the following operation runtime error, where the node referenced in the error message is one that has been duplicated:Failed to initialize transformation "<Transformation Name>". Failed to expand the target tree for the path:<Node Path>. The node:<Node Name> cannot be created.
In existing transformations already experiencing this error, you must first remove the duplicated node and then duplicate it again to resolve the error.
Note
This fix was released as a patch after the initial release (see Cloud Studio patch in the table earlier on this page).
-
Projects deleted from the Harmony cloud can now also have their design deleted in Cloud Studio
A deployed project that is first deleted from the Harmony cloud through the Management Console Projects page can now also have its project design deleted from Cloud Studio. Previously, the errorINVALID_ENV_OR_PROJ_GUID
was returned on attempting to delete the project from Cloud Studio. -
Renaming a project in Cloud Studio now updates its name in the Harmony cloud
A deployed project that is renamed through Cloud Studio now immediately has its new name reflected in the Management Console Projects page without requiring a redeploy. -
BMC Helix ITSM connector fixes
The BMC Helix ITSM connector has these fixes:-
The Create and Update activities no longer return the error
["Status-History"] not found
. -
The Create activity can now create an incident.
-
Multiple Remedy tickets can now be executed by the same user.
-
-
Database global connection test is no longer required
A Database global connection no longer fails at runtime unless it is successfully tested from the Global Connections page. -
Jitterbit MQ (beta) connector fixes
The Jitterbit MQ (beta) connector has the following fixes. In existing operations, you must refresh schemas and redeploy affected operations, else a schema mismatch warning will be reported at runtime.-
The Get activity now returns the
messageCount
in its response, similar to the Get Bulk activity. -
The
priority
field is now an integer instead of a string in applicable activity schemas.
-
-
JMS Get activity message headers now return values
A JMS Get activity now returns the expected values within themessageHeaders
node for fields that were previously returning null values:JMSCorrelationID
,JMSReplyTo
, andJMSType
. -
Microsoft Teams Send Message activity now works with an account with a large number of groups
When a Microsoft Teams account has more than 999 groups, the Microsoft Teams Send message activity no longer results in an error. -
NetSuite Search configuration errors resolved
The errorsUnable to fetch data
andUnexpected end of file
are no longer unexpectedly returned during NetSuite Search activity configuration, and the configuration can now be completed. -
Snowflake Query now retains underscores in column names
A Snowflake Query activity no longer removes underscores from column names. This issue was unintentionally introduced by the 10.69 / 11.7 release and has since been resolved. -
WooCommerce Query request filters now work
Filter values provided in the request transformation preceding a WooCommerce Query activity, such as those fororder
,search
, andper_page
, now narrow the returned results in the response as expected.
Design Studio
- XSD generation error resolved
When generating an XSD structure from an XML sample file, this error no longer occurs:The XSD file could not be created: Unable to delete file
.
Jitterbit CRM REST connector
-
Microsoft Dynamics CRM connector fixes
Several fixes have been made to the Microsoft Dynamics CRM connectors for Cloud Studio and for Design Studio. These fixes require version 1.3.0.43 of Jitterbit’s separately installed Microsoft Dynamics 365 cloud connector.-
When a Microsoft Dynamics CRM activity is executed in an operation, it now sends one instead of two requests to the endpoint for an authentication token.
-
An Upsert activity now updates existing records as expected when using Online Federation as the Connection Type. Previously, with this authentication type, only new records were being created with an Upsert activity.
-
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.
-
Shopify connector, Cloud Studio
- Shopify Fulfillment API deprecation
Shopify has announced it is deprecating some endpoints on its Fulfillment API on June 30, 2023. Customers with Cloud Studio projects using the Shopify connector with deprecated Fulfillment API endpoints must reconfigure the connector as soon as possible, or operations using the deprecated API endpoints will begin failing after June 30, 2023. For additional information, see details on impacted projects and required user action.
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