Release notes for the latest release

Review these release notes for information about supported versions, new features and enhancements, and known issues and workarounds.

Version information

This release relates to the IBM® App Connect Operator 3.0.0.

About Continuous Delivery: This version of the Operator is considered a Continuous Delivery release. Continuous Delivery releases undergo continuous testing, integration, and deployment to rapidly deliver new features, fixes, and security updates typically at quarterly intervals.

The support requirements for the IBM App Connect Operator 3.0.0 are as follows:

Option Supported requirement
Deployment platforms
  • Red Hat OpenShift Container Platform 4.6 or later
  • Kubernetes 1.19.x, 1.20.x, or 1.21.x
Certified container Based on IBM App Connect Enterprise certified container 6.0.0
Image Contains an image of IBM App Connect Enterprise 12.0.2.0
Installation
  • Supported on IBM Cloud Pak for Integration 2021.4.1
  • Supported as an independent deployment of IBM App Connect Enterprise certified container to a cluster

This documentation relates to the release for these listed versions. Documentation for the previous releases is available in PDF format at Documentation for previous releases.

New features and enhancements

Support for a new IBM App Connect Operator channel and custom resource (or operand) version

IBM App Connect Operator 3.0.0 is delivered on a new v3.0 Operator channel, which must be selected to install 3.0.x versions of the Operator, or to initialize an upgrade from a 2.1.0 or earlier Operator.

Accompanying versions and licenses are provided for the App Connect Dashboard, App Connect Designer Authoring, Switch Server, and Integration Server custom resources (or operands). To create an instance or upgrade to a 3.0.0-specific version of a custom resource, you must choose both of these options:
  • Subscribe to the 12.0 or 12.0.2 channel for custom resources, or specify a fully qualified version of 12.0.2.0-r2.
  • Select a 3.0.0-specific license for approval.
Support for App Connect Designer on Linux® on IBM Z (s390x architecture)

You can now create App Connect Designer instances on Linux on Z.

Restriction: The Mapping Assist component (including the Incremental learning feature) is not supported.

More information: Supported platforms

Additional export options for API flows in App Connect Designer

When you export an API flow from the App Connect Designer dashboard, the following additional options are provided:

  • An option to export the flow to a ZIP archive that contains the following contents: an OpenAPI document that conforms to the OpenAPI Specification Version 3.0 (YAML format), and a BAR file that can be deployed to an App Connect Dashboard instance.
  • Options to export the flow as an OpenAPI document that conforms to the OpenAPI Specification Version 3.0, in either JSON or YAML format.
Artificial intelligence (AI) support for generating event-driven flows in App Connect Designer

To accelerate flow creation, we've introduced the ability to generate an event-driven flow in App Connect Designer by describing an integration scenario in English natural language. This feature is available only if you are using App Connect Designer in IBM Cloud Pak for Integration and have access to an IBM Automation Foundation assets instance in which Designer AI features are enabled. When you describe your scenario, a flow-generation AI service parses the text and then attempts to construct a flow with the identified connectors, event, and actions. You can preview the generated flow and then open it in the flow editor for further editing.

Restriction: The ability to generate flows is an experimental feature, and certain restrictions apply.
Revised behavior for mappings that evaluate to null or undefined in fields for an action in App Connect Designer

If a source mapping in a target field of type string or date-time evaluates to a null or undefined value (equivalent to having no value) when a flow runs, the null or undefined input value is now retained and reflected in the resulting output.

Previously, the output of such mappings was set to "" (that is, an empty string). If there's a need to retain this earlier behavior in a flow, you can update the mapping in the target field by using two new Boolean (JSONata) functions: isNull(sourceMapping) and isUndefined(sourceMapping).

More information: Behavior of mappings that evaluate to null or undefined in fields of type string or date-time

Improved access to logs for App Connect Designer and associated integration server deployments

To help diagnose or debug issues in Designer Authoring and Designer Authoring integration server pods, user and Operator logs (including logs for when a pod crashes with a CrashLoopBackOff status) are now written to standard output (stdout). The logs are written in plain text.

You can view these logs from the Red Hat OpenShift web console by accessing Workloads > Pods, and then clicking the pod name and Logs tab. Or from the Red Hat OpenShift CLI, you can use the oc logs command.

Support for user and service tracing on integration servers

To help with problem determination and troubleshooting, a Trace custom resource (CR) has been added, which enables you to collect and manage user or service trace for a deployed integration server:

  • From the Red Hat OpenShift web console or CLI, or the CLI for a Kubernetes environment, you can start (or enable) a trace by creating a trace object, and stop (or disable) a trace by deleting the trace object.
  • From an App Connect Dashboard instance, you can start a trace, stop a trace, download the trace log files, and clear the trace information from the logs.
OpenAPI connector enhancements in App Connect Designer and App Connect Dashboard

The OpenAPI local connector has been enhanced to support OAuth 2.0 Password and OAuth 2.0 Credentials authentication when connecting to an API to call operations. These authorization methods can be used when authoring flows in an App Connect Designer instance, or when deploying integration servers to an App Connect Dashboard instance.

More information: Connecting to your imported API from App Connect Designer 12.0.1.0-r4 or later

Extended support for local connectors in App Connect Designer and App Connect Dashboard

A new local connector has been added for authoring flows in an App Connect Designer instance, or for deploying integration servers to an App Connect Dashboard instance: Oracle E-Business Suite.

More information:
Terminology changes in the documentation

References related to accessing the Platform Navigator have mostly been replaced with IBM Cloud Pak Platform UI (or Platform UI) to match the home page that opens when you click the generated URL for a deployed Platform Navigator instance in IBM Cloud Pak for Integration.

IBM Cloud Pak Platform UI home page

Deprecated or removed features

Removed operand channels and versions

An operand channel and a fully qualified version that were deprecated in IBM App Connect Operator 2.0.0 have been removed from IBM App Connect Operator 3.0.0. The related licenses have also been removed.

  • Removed channel: 11.0.0.11
  • Removed version: 11.0.0.11-r2

After you upgrade to version 3.0.0 of the Operator, existing App Connect Designer, App Connect Dashboard, switch server, or integration server instances that resolve to a removed version will no longer be supported and cannot be reconciled by the Operator.

  • You can upgrade the instance to a supported version by updating the spec.version value and accepting the appropriate licence.
  • You can delete the instance if it's no longer required.
  • You will not be able to save modifications to the custom resource settings if the instance is at an unsupported version. If you require an instance at a version that is unsupported in Operator 3.0.0, you must install an Operator version from the v2.1 or earlier channel, and then create an instance at the version that you require.

Deprecated operand versions and channels

A number of operand versions and channels are deprecated for the IBM App Connect Operator 3.0.0 and might no longer be reconciled by future versions of the Operator. A deprecation notice will be displayed if you attempt to save a new or existing Dashboard, Designer, switch server, or integration server custom resource whose spec.version value resolves to a deprecated version.

More information: spec.version values

Removed connectors

The following deprecated connectors have now been removed and can no longer be used in flows or integration servers in App Connect Designer or App Connect Dashboard: IBM Watson Personality Insights and IBM Watson Visual Recognition.

Deprecated connectors

The following connectors are deprecated in App Connect Designer and App Connect Dashboard:

  • Microsoft 365 (Deprecated in IBM App Connect Operator 3.0.0)
  • IBM Watson Natural Language Classifier (Deprecated in IBM App Connect Operator 2.0.0 or later)