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.

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 the gatewayconfig.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 key disable-hyphen-replacement automatically set to true.

• API Manager Log Service API (beta) additional query filters
  The following additional queryString 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, and apiname.

• 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 of dd/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 has gpt-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¶

• Base64Decode now works as expected with or without padding characters
  The Base64Decode function no longer returns a truncated or wrong value when the base64-encoded string does not end with = or ==.

• 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 error Resource 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 return 0 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 and tags) and two removed columns (utcTime and downloadPayloadEnabled).

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 reported Unable 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's convertCurrency() 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.