IBM App Connect Enterprise 13.0 release notes

Before installing 13.0.3.0 and above on AIX

The following prerequisites for AIX have changed to

• GCC 12.0

• When creating a custom schema and mapping as part of Connector Discovery using 13.0.5.0, you are blocked from saving the deletion of an element (#32364)

  When using Connector Discovery, some action connector message flow nodes offer features that include the developer creating a custom schema to describe a data structure. For example, this kind of capability is part of the Azure Cosmos DB message flow node and the IBM Cloudant message flow node. When using this feature it is possible to create an element in the custom schema, and then map the value for the created element. If you then return to edit the properties of your custom schema and delete an element, the delete action will appear to have completed successfully but you will not be able to save the update. To workaround this issue, you must exit connector discovery, delete the message flow node, re-add a new message flow node of the same type, relaunch connector discovery, and you will then be able to re-create your custom schema with the correct properties and mapped values. The same problem is exhibited when connector discovery is launched from both Toolkit message flows and Designer message flows.

   
• When using Connector Discovery with a retrieve operation the value configured for the Maximum number of items to retrieve is ignored and limited to 50 (#32905)

  There is a known defect discovered in ACE version 13.0.5.0 but also applicable to earlier version 13 mod releases whereby the number of records returned on a retrieve is consistently limited to 50, even if you have requested a higher number. This issue is not connector specific, and has been reproduced in particular with both the Coupa and Google BigQuery connectors.

   
• When using the Designer Data Assist feature in 13.0.4.0 some fields are partially obscured

  IBM App Connect Enterprise 13.0.4.0 introduces an optional Data Assist feature in the Designer flow authoring experience. When you click Transform Data Format link, the panel that loads lets you express sample source and target values from which a JSONata expression is generated. This panel has a styling issue causing some of the fields to overlap and be partially obscured. Whilst clearly a product defect it is still possible to move between the fields and enter values and insert a transform.

   
• AdminSSL changes in 13.0.1.0 (#102333)

  IBM App Connect Enterprise 13.0.1.0 enables SSL transport security by default for the REST Admin Listener component of the product. This means that HTTPS connections are required when remotely connecting to the REST API (either by directly calling /apiv2 methods from a REST client, or through the Web User Interface or via commands). During installation of the product, a self-signed certificate (with a 10 year expiry) is generated that will be used by all future mod releases and fixpacks of 13.0. This default certificate is used by all components that start a REST administration port - including Integration Nodes, independent Integration Servers, Designer, and Dashboard. Migrated Integration Nodes and independent Integration Servers created in a prior ACE version that do not have an existing explicit configuration for the sslCertificate property of the RestAdminListener will inherit this new automatic default behaviour and be started with admin SSL enabled, even if they were previously not configured for HTTPS. Simple commands and configuration options are provided to disable administrative security if this change in behaviour is considered undesireable. Further detailed information is available in the product documentation but due to the potential wide impact of these changes we have chosen to also record this entry here.

   
• When launching the Toolkit you may receive an Eclipse pop-up reporting an internal error (#102307)

  The full text of the pop-up error states "An internal error occurred during: Re-resolve Target state after VM-install or EE change". If this occurs, it is safe to dismiss the pop-up and continue launching the Toolkit. The root cause of this benign exception has been located in Eclipse and a fix is likely to be included in a future maintenance release.  This issue is fixed in IBM App Connect Enterprise 13.0.2.0

   

• The Try It functionality of a Designer flow can receive a 500 Internal Server Error response (#102349)

  When using Designer and testing a Flow for API using the Try It functionality you may receive a 500 Internal Server Error stating "connect ECONNREFUSED". By default, the Try It functionality attempts to communicate with localhost. This works successfully in most environments but in some circumstances (most frequently on a MacOS or within a Virtual Machine) this feature attempts to use the IPv6 loopback address in preference to the IPv4 address. This is a problem because currently by default the HTTP(S)Connector does not listen on IPv6 addresses. There are two available workaround for this issue:

  1. Update the designer.conf.yaml file which by default is located at <the user's home directory>/IBM/ACEDesigner13/config/designer.conf.yaml Uncomment the listenerAddress property in the DesignerFlowListener section of the file and change the value of the property to '127.0.0.1' If you are using ACE 13.0.2.0 and are wanting to preserve the ability to invoke Designer flows remotely then you could also change the value of the property to '::'
  2. Modify your machine's network configuration to ensure the resolution of localhost to the address 127.0.0.1 You can do this on Linux platforms by editing the /etc/hosts file or on Windows platforms C:\Windows\System32\Drivers\etc\hosts

• When using certain XSLT stylesheets in conjunction with the XSLTransform node the generated namespace prefixes used in the output XML data increase numerically for every message (#102310)

  Consider the following snipped example extract from a stylesheet
  <xsl:template match="MyMatch">
  <xsl:element name="{name()}" namespace="http://www.ibm.com/example">
  <xsl:apply-templates select="node() | @*"/>
  </xsl:element>
  </xsl:template>
  The first processed message might contain an element similar to this:
  <ns1:MyMatch xmlns:ns1="http://www.ibm.com/example"> … </ns1:MyMatch>
  The second processed message might contain an element similar to this:
  <ns2:MyMatch xmlns:ns1="http://www.ibm.com/example"> … </ns2:MyMatch>
  … and so on.
  Whilst these output messages may be strictly speaking well-formed XML, over the course of many thousands of messages going through the message flow, having the namespace prefix constantly increment is obviously undesireable.  This problem has been investigated and reported to Xalan (https://issues.apache.org/jira/browse/XALANJ-2785).  The problem does not occur when using Xalan's interpreted engine, so until progress is made on the core issue, there is the potential for an IBM workaround to be supplied through a code fix. Please contact IBM Service for details.  This issue is fixed in IBM App Connect Enterprise 13.0.2.0

Copyright and trademark information

For more information about this topic, see the IBM Copyright and trademark information web page.

This information was developed for products and services offered in the US.

IBM might not offer the products, services, or features discussed in this information in other countries. For more information about the products and services currently available in your area, Consult your local IBM representative. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service can be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right can be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM might have patents or pending patent applications covering subject matter described in this information. The furnishing of this information does not give you any license to these patents. You can send license inquiries, in writing, to:

IBM Corporation
1 New Orchard Road
Armonk
New York
10504-1722
United States

For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM Japan Ltd
IP Licensing
19 - 21 Nihonbashi Hakozaki-cho
Chuo-ku 
Tokyo 103-8510
Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. This statement might not apply to you because some states do not allow disclaimer of express or implied warranties in certain transactions.

This information might include technical inaccuracies or typographical errors. Changes are periodically made to this information; these changes are incorporated in new editions of the information. IBM can make improvements to the products and programs described in this information, changes in the products and programs described in this information, or both, at any time without notice.

Any references in this information to non-IBM websites are provided for convenience only and do not in any manner serve as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk.

IBM can use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who want to have information about it for enabling: (i) the exchange of information between independently created programs and other programs (including this program) and (ii) the mutual use of the information that is exchanged, can contact:

IBM App Connect
IBM United Kingdom Laboratories
Hursley Park
Winchester
Hampshire
England
SO21 2JN

Such information might be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Programming License Agreement, or any equivalent agreement between us.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements, or other publicly available sources. IBM did not test those products and cannot confirm the accuracy of performance, compatibility, or any other claims related to non-IBM products. Address any questions on the capabilities of non-IBM products to the suppliers of those products.

This information includes examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

Copyright license:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You can copy, modify, and distribute these sample programs in any form without payment to IBM in the following circumstances: For the purposes of developing, using, marketing, or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples are not thoroughly tested under all conditions. Therefore, IBM cannot guarantee or imply reliability, serviceability, or function of these programs. You can copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle, its affiliates, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

The registered trademark Linux® is used in accordance with a sublicense from the Linux Foundation, the exclusive licensee of Linus Torvalds, owner of the mark on a world­wide basis.

Other company, product, or service names might be trademarks or service marks of others.

Useful websites

IBM App Connect Enterprise product documentation
https://www.ibm.com/docs/app-connect/13.0

IBM Integration Community
https://developer.ibm.com/integration/

IBM App Connect Enterprise Requirements
https://www.ibm.com/support/pages/node/7169815/

IBM Db2
https://www.ibm.com/analytics/db2

© Copyright IBM Corporation 2024.