Skip to Content

10.2 Harmony release notes

10.2 Harmony release

Harmony portal, Design Studio, private API gateway, and private agents released June 5, 6, and 10, 2019

The 10.2 release date is by region:

  • APAC: Released June 5, 2019

  • EMEA: Released June 6, 2019

  • NA: Released June 10, 2019

Included in this release are updates to these Harmony components:

Design Studio, private agent, and private API gateway installers are available as of June 10, 2019.

New features

API Manager and private API gateway

API Manager

  • Ability to override URLs during OAuth 2.0 configuration
    When configuring Google or Salesforce OAuth 2.0 authentication from the Security Profiles page of the API Manager to use with a custom API or proxy API, you now have the ability to override the default URLs used for authorization, token, and user information by replacing the defaults in these new fields.

Cloud Studio

  • Snowflake and Square connectors
    New Cloud Studio connectors for Snowflake and Square are now available to use with agents version 10.1 or higher. The new connectors can be accessed on the right side of the project designer from the design component palette.

Harmony portal

  • Private API gateway installer is now available from the Harmony portal
    The installer file for a private API gateway is now available from the Downloads page of the Harmony portal, and is available to all Harmony subscribers.


Design Studio

  • Java distribution changed for macOS
    The Java distribution included with the macOS version of Design Studio has been changed from Oracle JRE to AdoptOpenJDK JRE and from Oracle JFX to Zulu with OpenJFX. (A similar change to use AdoptOpenJDK JRE was made for the Windows version of Design Studio in version 9.8.)


API Manager

  • API documentation editor now accepts OpenAPI 3.0 documentation
    You can now copy OpenAPI 3.0 documentation into the Portal Manager, where you can edit, save, and publish the documentation.
  • Content type is now auto-detected in OpenAPI definitions
    The content type is now automatically detected when generating OpenAPI documentation through the Portal Manager, and is based on the content type of the request and response schemas being used in the Cloud Studio or Design Studio operation. Previously, the content type defaulted to application/json, requiring manual intervention to test the API in cases where the content type was actually application/xml.

Cloud Studio

  • UI for NetSuite Search activity improved
    When configuring a NetSuite Search activity, the UI now has a checkbox to select all sub-types of an object at once, in addition to being able to select each sub-type individually.
  • UI for HTTP activities improved
    When configuring an HTTP activity, the UI is improved for appending a path or query parameters to the base URL, showing a preview of the concatenated base URL and path.

Harmony portal

  • Harmony Quick Start wizard is now specific to Cloud Studio or Design Studio
    On the Harmony portal landing page within the Support & Learning section, the link to Harmony Quick Start now displays steps that are tailored for the Cloud Studio web-based project design application. On the first step of the wizard, you can use the link at the bottom to switch between steps specific to Design Studio or Cloud Studio.
  • Harmony authentication security enhanced
    When navigating between applications within the Harmony portal, the Harmony authentication token is now passed in a cookie that is read and then destroyed, rather than being passed as a parameter within the URL.

private API gateway

  • Private API gateway testing improvements
    The private API gateway installer's self-testing option, accessed by running --test, has been enhanced with additional automatic tests, additional error checking, and improved usability with color and user-friendly error messages. After a successful login, the test now automatically imports a project and API, then calls the API through the gateway to ensure proper configuration.



  • SAP RFC multi-layer structures are now supported
    You can now use RFC multi-layer structures (nested tables) with the Design Studio SAP connector (both ECC and HANA) using an agent version 10.2 or higher. Previously, the structure was displayed in the transformation, but the operation would fail at runtime.

API Manager

  • UI adjustments to Portal Manager and Portal
    Minor fixes to the Portal Manager and Portal pages affect the user interface only. These include updating the label on the button for regenerating documents to indicate that this action also publishes the API, always displaying a lock icon next to APIs where authentication is required (previously missing in some areas), adding an informational tooltip on environment selection, and cleaning up display issues around the custom logo and header.

Cloud Studio

  • Connector Builder connectors with anonymous authentication now work
    End users can now use Connector Builder connectors that use anonymous authentication. Previously, although the connector could be created successfully, when an end user tried to configure a connection, they would get an error upon testing and would not be able to save the connection.
  • Global variable dependencies are now reported accurately
    When referencing a global variable in a transformation mapping, dependencies are now reported accurately. Previously, global variables were not being recognized as having been used within a transformation and were incorrectly being displayed in the project pane's Components tab as orphaned components.
  • Previewing a transformation with a custom flat source schema now works
    When previewing a transformation that uses a custom flat schema as the source, sample data now loads without issue. Previously, an error would occur and the source data would not be loaded into the transformation preview.
  • FindByPos() function now works properly
    When using the FindByPos() function in a transformation mapping, a solid black iterator line that indicates the presence of a loop node is now generated in the appropriate location. To handle this fix, when using this function, a hash symbol (#) indicating an instance is now automatically inserted into the source field reference path.
  • Mapping to XML value nodes now works properly
    In a transformation with a mapping of an XML node that has a value and zero or more attributes, as represented by a field with a hash symbol (#), target data is now properly generated. Previously, the generated XML file incorrectly changed the XML tag instead of the value within the tags, making the output of the transformation mapping unusable.
  • Database functions now reference a connection instead of an activity
    When using any Jitterbit Script database functions that require a databaseId, this parameter now takes a string reference path to a Database connection instead of a Database activity. Note that if you have used a reference to a Database activity, it will continue to work.
  • Overwriting large projects during migration now works
    Large projects can now successfully be migrated to an environment where they already exist, overwriting the project in the target environment. Previously, migration would fail with a generic error due to timeout.
  • Existing Salesforce Query activities now show selected related objects
    When editing an existing Salesforce Query activity that uses parent and/or child objects, those selected related objects are now displayed. Previously, related object selections weren't being displayed although the selections were still preserved and the query unaffected.

Design Studio

  • Harmony OAuth 2.0 authentication now works on macOS
    Those using Harmony accounts where single sign-on (SSO) is configured for you to log in using Google or Autodesk credentials are now able to log in to macOS Design Studio as expected. Previously, an error or blank login window appeared when trying to log in using SSO.

Harmony portal

  • Cloud Studio menu option is always displayed
    In the top left of the Harmony portal, the Harmony portal menu now shows the Cloud Studio menu option where appropriate. Previously, the Cloud Studio menu option was missing in some circumstances, although it was still possible to navigate to Cloud Studio from the Harmony landing page.
  • You now stay logged in when expected
    While accessing the Cloud Studio application, after being inactive in the Harmony portal for 18 minutes, then receiving a 2-minute countdown and choosing Stay Signed In, you will no longer occasionally be automatically logged out of the Harmony portal anyway.

Management Console

  • Cloud Studio API operations are now displayed
    On the Management Console Projects page, Cloud Studio operations that contain both an API request and an API Response activity are now displayed in the Operations tab. Previously, Cloud Studio API operations would appear only if they contained only a single API Request or Response activity.