11.32 Harmony release notes¶
11.32 Harmony release¶
The 11.32 Harmony 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.
11.32 Sandbox Cloud Agent Group (SCAG) SDK connectors on 11.32 SCAG 11.32 cloud and private API gateway Cloud platform and applications | 11.32 Production Cloud Agent Group (PCAG) SDK connectors on private agents and 11.32 PCAG 11.32 Windows and Linux private agents | 11.32 Docker private agent 11.32 Docker private API gateway | |
---|---|---|---|
APAC | September 17, 2024 (12 - 4 AM AEST) | September 24, 2024 (2 - 8 PM AEST) | September 26, 2024 (8 PM AEST) |
EMEA | September 17-18, 2024 (9 PM - 1 AM CEST) | September 25, 2024 (6 AM - 12 PM CEST) | September 26, 2024 (12 PM CEST) |
NA | September 18, 2024 (12 - 4 PM PDT) | September 25-26, 2024 (9 PM - 3 AM PDT) | September 26, 2024 (3 AM PDT) |
The 11.32 Harmony release also includes the release of App Builder 4.0, whose release notes are provided separately.
Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and private agents are also available.
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.
New features¶
Cloud Studio SDK connectors¶
- JWT connector
The JWT connector is no longer a beta version. It can be used with cloud or private agents to generate, decode, or validate JSON Web Tokens (JWT).
Enhancements¶
API gateway¶
- Ability to use existing gateway user credentials
A new API gateway user is no longer automatically created each time you reconfigure a private API gateway. Instead, the configuration utility now asks whether you would like to create a new user and overwrite existing credentials in thegatewayconfig.yml
file or use existing gateway user credentials.
API Manager¶
-
Default retention of request header hyphens in new proxy APIs
Hyphens (-
) that are used in the request headers of a new proxy API are no longer replaced with underscores (_
) by default. This is reflected in the API's configuration once it is published, with the request header keydisable-hyphen-replacement
automatically set totrue
. -
API Manager Log Service API (beta) additional query filters
The following additionalqueryString
conditions used for filtering log entries can be provided when retrieving API logs asynchronously using the API Manager Log Service API (beta):statuscode
,requestmethod
,envname
,authprofile
, andapiname
. -
Improved user experience
The following enhancements improve the user experience in API Manager:-
Dropdown menus in configuration screens now have type-ahead functionality. Begin typing in a dropdown field to filter the available selections.
-
API Manager pages are now accessible in the Harmony portal menu when you are already accessing an API Manager page.
-
An API's Last edited date on the My APIs page is now shown in the format of
mm/dd/yy
instead ofdd/mm/yy
.
-
App Builder¶
- Rename of Vinyl to App Builder
Jitterbit's low-code application for creating and launching web and mobile apps has been renamed to App Builder (formerly Vinyl) with its 4.0 release. The new name is reflected on the Harmony portal menu and tile used for accessing the App Builder application.
Cloud Studio¶
-
Ability to rename duplicated nodes
In a transformation, target nodes that have been duplicated now have the option to Rename duplicated node in their actions menu. The new name is for display purposes during design time only. -
Project history enhancements
The following enhancements have been made to the project history:-
Data is now stored for a maximum of 180 days and can be accessed by applying the new filter Last 180 days in the timeframe menu.
-
Data is able to be downloaded as a CSV file using the new Download option.
-
-
Single click to edit or remove transformation mappings
Mappings can be now be edited or deleted with a single click by hovering over a field and clicking the Edit or Remove mapping icons. -
Project design UI (beta) improved flow lines
The redesigned project design UI (beta) has improved positioning of visual flow lines. In addition, collapsed operations now show an open circle at the start of an outgoing flow line to visually indicate the script calling the linked operation originates from a collapsed component.
Cloud Studio SDK connectors¶
-
Epicor Kinetic connector 11.3.200 support
The Epicor Kinetic connector has been verified to be compatible with Epicor Kinetic 11.3.200. -
Coupa connector R40 support
The Coupa connector now uses version R40 of the Coupa Core Platform API. To use new objects introduced in R40 with existing activities, refresh the schema. -
OpenAI connector removal of deprecated model
An OpenAI Prompt activity's Model menu no longer hasgpt-3.5-turbo-16k
available to select. Any existing activities will not have their runtime execution affected if already using this model. -
Jira connector support for additional on-premise versions
The Jira connector now supports on-premise versions 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, and 9.12.7, which are new selections in a Jira connection's Jira Server version menu. -
JMS connector settings for handling queue lookup and creation
A JMS connection has a new Use JNDI Lookup checkbox in its Optional settings that can be used to specify that an activity should interact only with existing specified queues. When unselected (default), and the queue specified in an activity does not exist, a new queue with the specified name is created. -
Shopify connector support for 2024-07 and resource-specific metafields
The following enhancements have been made to the Shopify connector:-
A connection's API Version menu now has REST Admin API version 2024-07 as a selection.
-
During configuration of a Query, Create, Update, or Delete activity, after selecting the Metafield object, you can now select the metafields of specific resources, such as Products Metafield, as the sub-object.
-
EDI¶
- Validation of outgoing transactions
A new Validation toggle on workflows that use EDIXml map processing checks that outgoing transactions are valid EDI documents.
Management Console¶
- Ability to download private agent software
On the Agents page, the new option Download Jitterbit Agent is available in the Agents tab's Actions column. You can choose whether to download the latest stable version or the latest version of any registered agent in the group.
Fixes¶
Agent¶
-
Gzip-encoded HTTP responses no longer result in an error
Windows private agents now process Gzip-encoded HTTP responses correctly when using the Cloud Studio HTTP connection setting HTTP Accept Encoding Gzip or the Design Studio HTTP source/target setting Set Accept-Encoding to GZip. -
Better handling for OData service requests
When calling an OData service, the errorResource not found for the segment
is no longer returned in the following situations:-
When using the
$count
query parameter and there are no records to return, you can now append$noErrorOnZeroCount=true
to have the service return0
records instead of the above error. -
When using a pagination query parameter and the number of results is less than the provided upper limit, the service no longer returns a next link reporting the above error.
-
-
Schedules now run at the correct start time and for the expected duration on the day of daylight saving time change
The following defects, which occurred only when Override schedule agent time zone is enabled and the override time zone is a selection other than Etc/UTC, have been resolved:-
A schedule whose start time is on the day of daylight saving time change now starts at the configured time.
-
A schedule whose end date is on the day of daylight saving time change now runs for the expected duration.
-
API Manager¶
- API logs CSV download is now properly formatted
The CSV file downloaded using the Download as CSV option is now properly formatted so that data is displayed in the correct column. Along with this fix, there are two new columns (name
andtags
) and two removed columns (utcTime
anddownloadPayloadEnabled
).
Cloud Studio¶
-
Mapping input outside
<trans>
tags is no longer cleared
Input entered outside a transformation script's<trans>
</trans>
tags is no longer cleared when the script is saved. This enables the use of functions such as<SQLIDENTITY>
outside the tags. -
Operation log screen now displays up to 1,000 matching logs
When viewing operation logs, up to 1,000 of the most recent parent and child logs that match the date and time filters are now displayed. -
JSON without key names can no longer be uploaded
A JSON sample file schema that has empty names of nodes or fields is now prevented from being uploaded. Previously, uploading such a file would cause the project to become unusable. -
Error message improved when agents are unregistered
A clearer error message is provided in the Cloud Studio UI when all agents in the agent group associated with the environment are currently in Unregistered status and therefore no agents are ready to execute operations. Previously, the error had incorrectly reportedUnable to resolve the version of the agent group
. -
BMC Helix ITSM Query search filter now works
The search box in BMC Helix ITSM Query activity configuration step 1 is now functional. This fix is automatic and does not require the latest version of the connector. -
Salesforce Query can now be reconfigured when
convertCurrency
is used
When reopening an existing Salesforce Query activity that uses Salesforce'sconvertCurrency()
function in its SOQL statement, activity configuration step 2 no longer shows a blank screen and cannot be reconfigured.
Cloud Studio SDK connectors¶
- Amazon Redshift Upsert activity flow of data corrected
An Amazon Redshift Upsert activity now updates or inserts data as expected. Previously, it was staging, deleting, and then inserting data.
Harmony portal¶
- External user password reset now asks the correct secret question
When external users reset their password, they are now prompted to answer the secret question they configured at registration rather than the default What is your pet's name?.
Management Console¶
- Empty values in the agent configuration file are no longer replaced
In the Agents page, editing any value in the Jitterbit Configuration Configuration tab no longer inadvertently results in all empty values being replaced with three hyphens (---
).
Notices¶
Agent and Design Studio¶
-
End of life for agent 10.76/11.14 and Design Studio 10.76
As of September 14, 2024 these product versions have reached end of life and are no longer supported:-
Private agent versions 10.76 and 11.14
-
Design Studio version 10.76
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.