10.72 / 11.10 Harmony Release Notes¶

10.72 / 11.10 Harmony Release¶

This page includes release notes for all generally available components being released as part of 10.72 / 11.10. Compilations of release notes for Production Cloud Agent Groups, Sandbox Cloud Agent Groups, and Private Agents are also available.

The 10.72 / 11.10 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).

New Features¶

Cloud Studio¶

• OpenAI (Beta) connector
  The OpenAI (Beta) connector can be used to generate text or an image based on a provided text prompt, or can transcribe or translate audio into text. This connector is available for use with both Cloud and Private Agents version 10.1 or later. For beta access, contact your Customer Success Manager (CSM).

Enhancements¶

Agent¶

• New Jitterbit variable to exclude empty data from target XML
  The new Jitterbit variable jitterbit.target.xml.exclude_empty_data can be set to true upstream of a transformation mapping that returns an empty data value to exclude the value from being written to the target XML for that field mapping. This variable is recommended over jitterbit.target.xml.include_empty_xml for use with boolean values. For a true value of jitterbit.target.xml.exclude_empty_data to take effect, jitterbit.target.xml.include_null_xml must be set to false and jitterbit.target.xml.include_empty_xml must also be false (its default).

Cloud Studio¶

• Auto-selection of new and renamed variables for migration
  When migrating a project that has already been migrated, any newly added or renamed project variables will be pre-selected by default in the project migration Include list, while variables whose values who have been modified will remain excluded by default.

• Amazon SQS Receive Message (Beta) activity
  The Amazon SQS Receive Message (Beta) activity listens for and retrieves messages from an Amazon SQS queue. This activity requires a Private Agent with event listening enabled.

• JMS Send activity reply destination
  You can now specify the reply destination in a JMS Send activity using its new replyTo request schema field.

• LDAP connector editable response schema
  The response schema generated from an LDAP Search Entry activity can now be edited to change its structure as needed.

• Salesforce Events (Beta) default API version update
  The default Salesforce REST API version for a new Salesforce Events (Beta) connection is now version 57.

• Verbose logging support for additional connectors
  The Epicor Prophet 21, Jenkins, MS Azure AD, Salesforce Events (Beta), and SAP SuccessFactors connectors now support connector verbose logging. The specific configuration entry of logger name and level is documented on the linked pages.

• Additional verbose logging details for multiple connectors
  Enabling verbose logging with the BigCommerce, HubSpot, Microsoft SharePoint 365, Microsoft Teams, ShipStation, and WooCommerce connectors results in the generation of additional log information beyond that already generated. To generate the additional log details, a new format of the configuration entry is required as documented on the linked pages.

Fixes¶

Agent¶

• Operations with chunking enabled now output the expected content type
  When an operation has chunking enabled, transformations configured with JSON output are no longer unexpectedly converted to XML output.

• Error writing Salesforce bulk query results to a file no longer occurs
  When the type of encoding differs between a Cloud Studio Salesforce Bulk Query activity or a Design Studio Salesforce Bulk Process Query action source and its target, a fatal error writing the result to a file no longer occurs. The former error had indicated: Reason: The process cannot access the file because it is being used by another process.

API Manager¶

• Proxy API 405 error after deleting and re-publishing no longer occurs
  After exporting and deleting a published proxy API that uses a custom method, and then re-importing and publishing the proxy API, it now works as expected. Previously, when the proxy API was called, the error 405 Method Not Allowed was returned.

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.

• Private Agent-only connectors are now prevented from being imported or migrated to Cloud Agents
  You can no longer import or migrate projects that use Private Agent-only connectors to environments associated with Cloud Agents. Previously, when a Private Agent-only endpoint was imported or migrated to Cloud Agents, its connection was unable to be tested and its activities were invalid.

• Active Directory Update activity now works with user account and password fields
  Using an Active Directory Update activity to update the UserAccountControl and UserPassword fields now works as expected.

• Google BigQuery connector now supports the record data type
  Google BigQuery Query, Update Record, and Insert Record activities now treat the record data type as expected instead of interpreting it as a string.

• Jira connector fixes for on-premises instances
  When an on-premises instance type is selected in a Jira connection, these issues are now resolved:

  • Jira Create, Update, and Delete activities no longer unexpectedly return duplicate occurrences of information in their responses.

  • When configured with the Get Transition operation, a Jira Transition activity now returns the field opsbarSequence in its response.

  • The selection of 8.2.3 for the Jira server version has been corrected to 8.22.3. This was an error in display only.

• JMS connection no longer requires a password
  When the Use Authentication checkbox in a JMS connection is selected, entering a Password is no longer required. This enables the use case where the JMS server has only a username with no password. Previously, when an empty variable was used as the password, activities failed to return a response.

• OData Query activity now supports enumerated fields
  Fields with an enum data type are now displayed for selection in an OData Query activity. This enables querying App Builder dropdown fields using the App Builder OData API.

• Temporary Storage Write activity edits no longer clear its schema in adjacent transformations
  Editing a Temporary Storage Write activity that is used in multiple operations no longer causes its schema to be cleared from adjacent transformations that are inheriting that schema.

Harmony Portal¶

• New users can now register in organizations using two-factor authentication
  When a new user is invited to an organization that has two-factor authentication enabled, the user is now able to complete the registration. Previously, an authorization error occurred.

Management Console¶

• Error when saving organization policies no longer occurs
  A generic exception is no longer returned when saving updated organization policies.

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