Integration

 View Only

Explore the new features in App Connect Enterprise 13.0.1.0

By Ben Thompson posted Fri September 27, 2024 12:30 PM

  
iStock_000020343379_XXXLarge


We are very pleased to announce the general availability of IBM App Connect Enterprise 13.0.1.0 software, the latest and greatest major engineering release of the product many know as ACE.  As usual, we intend to publish regular quarterly mod releases for ACE 13 which will contain both new features and regular maintenance.

  • IBM App Connect Enterprise 13.0.1.0 is released 27th September 2024 - more information below
  • IBM App Connect Enterprise 12.0.12.0 is the latest mod release of ACE 12 which came out in March 2024 - more information here.

This blog post summarizes all the latest and greatest capabilities which are made available in IBM App Connect Enterprise 13.0.1.0:

  • Installation and Product Editions
  • New Designer web-browser flow authoring tool
  • Toolkit Enhancements
    • 15 New Discovery Input Message Flow Nodes:
      • Businessmap, ClickSend, Eventbrite, Front, Greenhouse, IBM Maximo, IBM Targetprocess, Magento, Marketo, Slack, Toggl Track, Wrike, Zoho Books, Zoho CRM, Zoho Recruit
    • 15 New Discovery Request Message Flow Nodes:
      • Businessmap, ClickSend, Crystal Ball, Factorial HR, Front, Hunter, IBM Targetprocess, IBM watsonx.ai, Infobip, Toggl Track, Wrike, Zoho Books, Zoho CRM, Zoho Inventory, Zoho Recruit
    • New Patterns Gallery
    • New JSONata Mapping node
    • New External Directory Vault explorer for creating, reading, updating and deleting credentials
  • Java 17 is the default for ACE 13
  • Migration Improvements

Installation and Product Editions

Welcome to IBM App Connect Enterprise! If you're entirely new to ACE, it's really easy to get up and running and try out the software. First time users can download the ACE Evaluation Edition entirely free of charge (like many IBM websites, to get access you will need to register for an IBMid first, but that process is really fast and again doesn't cost you anything). ACE 13.0.1.0 Evaluation Edition isn't time limited so you can take your time trying out the product. ACE Evaluation Edition carries all the functions of the paid editions, but the flows you create are rate-limited so they won't process messages any faster than one message per second.

For those who are familiar with the product through its previous versions, you'll notice that we've simplified some of the names of the paid editions too. Once you have purchased entitlement and downloaded the single installation package from the IBM Passport Advantage website, you can use our unzip-and-go installation method on Linux platforms and for Windows we have an updated graphical installer that deals with license acceptance and offers a small number of further options.

Once the product is installed, you should run the ibmint set mode command. Several modes/editions are available. The table below shows all the details, but there shouldn't be too many surprises here - whilst some of the names have been changed slightly compared to ACE 12, the purpose of each edition and its operational restrictions remain the same. You should set an installation to have its mode/edition match the kind of environment it will be used for - ie Development, Non-Production, Production-Advanced or Production-Standard.

New Designer web-browser flow authoring tool

The App Connect Enterprise product has traditionally focussed on the requirements of Integration Specialists who create message flows in the Eclipse-based ACE Toolkit authoring tool. The ACE Toolkit continues to be strategic for us and in future releases it will continue to be enhanced and improved (more details below) and is updated in ACE 13 to run on Eclipse 4.31, launched using Java 17. ACE 13 also provides a new alternative tool for flow authoring (named App Connect Enterprise Designer) which is suitable for all users and aims to be especially accessible to those without coding experience. The Designer first appeared as part of our managed cloud iPaaS, and has subsequently also been provided in App Connect Enterprise container environments, but this is the first time the tool has been provided for local installation directly on a laptop or in a VM without the need for containers.

The Designer tool is powered by JSON schema. Designer connects to application endpoint systems (most commonly SaaS applications on the public web) and discovers the structured metadata required to communicate with them. These structures are easy for users to navigate graphically making it very straight forward to create integration flows that can transform and map data as it passes from one application to the next. The Designer's development experience makes it easy to refer back to data structures generated by nodes earlier in the flow. The Designer's data mapping feature (powered by the open source JSONata mapping language) provides a graphical way of defining transformations which can be more familiar for business users as it follows a “spreadsheet style” based around the target data structure, as opposed to dragging and dropping fields between a source and target.

Designer flows mainly use JSON data structures but the tool also provides rudimentary support for XML and CSV formats. For more advanced message modelling requirements, the Toolkit remains the best development choice. The message flows which are generated from both Designer and Toolkit can be deployed to run inside the same ACE Integration Server runtime processes that have been part of our product architecture for many many years. In future, we also expect to provide features to enable users to easily transition Designer authored flows into Toolkit flows making it really easy to start simple but then transition to a more specialist tool should you find a need to later.

Toolkit - 15 New Discovery Request Message Flow Nodes

Continuing our mission to rapidly expand the available Toolkit message flow nodes for easy connection to third party applications, this quarter ACE 13.0.1.0 has an expanded Toolkit palette offering an additional set of 15 new Discovery Request Message Flow nodes:

  • Businessmap Request node: Use the Businessmap Request to connect to Businessmap and issue requests to perform actions on objects such as workspaces, boards, teams, and users.
  • ClickSend Request node: Use the ClickSend Request to connect to ClickSend and issue requests to perform actions on objects such as accounts, contacts, and SMS campaigns.
  • Crystal Ball Request node: Use the Crystal Ball Request to connect to Crystal Ball and issue requests to create, retrieve, update, or delete annotations.
  • Factorial HR Request node: Use the Factorial HR Request to connect to Factorial HR and issue requests to perform actions on objects such as absences, attendances, employees, and tasks.
  • Front Request node: Use the Front Request to connect to Front and issue requests to perform actions on objects such as accounts, channels, contacts, messages, and conversations.
  • Hunter Request node: Use the Hunter Request to connect to Hunter and issue requests to perform actions on objects such as leads, campaigns, emails, and domains.
  • IBM Targetprocess Request node: Use the IBM Targetprocess Request to connect to Targetprocess and issue requests to perform actions on objects such as user stories, epics, projects, and tasks.
  • IBM watsonx.ai Request node: Use the IBM watsonx.ai Request to connect to IBM watsonx.ai and issue requests to perform actions on objects such as text, emails, summaries, and foundation models.
  • Infobip Request node: Use the Infobip Request to connect to Infobip and issue requests to perform actions on objects such as accounts, entities, WhatsApp templates, SMS messages, and voice messages.
  • Toggl Track Request node: Use the Toggl Track Request to connect to Toggl Track and issue requests to create, retrieve, update, or delete objects such as clients, workspaces, tags, and time entries.
  • Wrike Request node: Use the Wrike Request to connect to Wrike and issue requests to perform actions on objects such as approvals, comments, tasks, time logs, and work schedules.
  • Zoho Books Request node: Use the Zoho Books Request to connect to Zoho Books and issue requests to perform actions on objects such as customers, invoices, expenses, charts of accounts, items, and quotes.
  • Zoho CRM Request node: Use the Zoho CRM Request to connect to Zoho CRM and issue requests to create, retrieve, or convert objects such as accounts, campaigns, contacts, deals, and leads.
  • Zoho Inventory Request node: Use the Zoho Inventory Request to connect to Zoho Inventory and issue requests to perform actions on objects such as sales orders, contacts, purchase orders, and warehouses.
  • Zoho Recruit Request node: Use the Zoho Recruit Request to connect to Zoho Recruit and issue requests to perform actions on objects such as applications, candidates, job openings, users, and departments.

Each new type of connector also has a corresponding new policy type, which helps Toolkit users define configuration properties for easy connection to the applications. These policies also link to credential information that can be encrypted and stored in an ACE vault, enabling the ACE runtime to safely and securely connect to your applications.

Toolkit - 15 New Discovery Input Message Flow Nodes

From ACE 13.0.1.0 the Toolkit palette has been expanded to include 15 new Discovery Input Message Flow nodes:

  • Businessmap Input node: Use the Businessmap Input node to monitor and accept input from Businessmap.
  • ClickSend Input node: Use the ClickSend Input node to monitor and accept input from ClickSend.
  • Eventbrite Input node: Use the Eventbrite Input node to monitor and accept input from Eventbrite.
  • Front Input node: Use the Front Input node to monitor and accept input from Front.
  • Greenhouse Input node: Use the Greenhouse Input node to monitor and accept input from Greenhouse.
  • IBM Maximo Input node: Use the IBM Maximo Input node to monitor and accept input from  IBM Maximo.
  • IBM Targetprocess Input node: Use the IBM Targetprocess Input node to monitor and accept input from Targetprocess.
  • Magento Input node: Use the Magento Input node to monitor and accept input from Magento.
  • Marketo Input node: Use the Marketo Input node to monitor and accept input from Marketo.
  • Slack Input node: Use the Slack Input node tomonitor and accept input from Slack.
  • Toggl Track Input node: Use the Toggl Track Input node to monitor and accept input from Toggl Track. 
  • Wrike Input node: Use the Wrike Input node to monitor and accept input from Wrike.
  • Zoho Books Input node: Use the Zoho Books Input node to monitor and accept input from Zoho Books.
  • Zoho CRM Input node: Use the Zoho CRM Input node to monitor and accept input from Zoho CRM.
  • Zoho Recruit Input node: Use the Zoho Recruit Input node to monitor and accept input from Zoho Recruit.

Toolkit - New Patterns Gallery

Readers may be familiar with the Tutorials Gallery in the App Connect Enterprise Toolkit which has over 140 tutorials which provide simple guided instructions for users who are new to the Toolkit and which help you get simple example functionality up and running quickly. Typically each tutorial takes between 5 and 15 minutes to complete. New in 13.0.1.0 we have introduced a new restyled Patterns Gallery which has a very similar look and feel to the Tutorials. At first glance Patterns and Tutorials sometimes seem pretty similar. Both are helpful in particular for new users or those who would like to get a solution up and running fast by starting off from a working example. Where as a Tutorial provides a fixed set of resources to show a running example, a Pattern presents you a set of choices which allow the generated resources to be customized to fit the way you want to use them. As well as being a handy idea for getting to know ACE, patterns are also reusable solutions that encapsulate a tested approach to solving a common architecture, design, or deployment task in a particular context. Patterns are helpful because they:

  • Generate customized solutions to a recurring integration problem in an efficient way
  • Encourage adoption of preferred techniques in message flow design
  • Help guide developers who are new to the product
  • Provide consistency in the generated resources

At the time of this initial release we have added 92 patterns to the Pattern Gallery which have been categorized as:

  • Format Transformation Patterns
  • Protocol Transformation Patterns

Over the coming months we hope to add even more patterns to the gallery in the following categories:

  • Enterprise Integration Patterns
  • Messaging Patterns
  • Scatter-Gather Patterns

When you select a pattern from the Toolkit Patterns Gallery, it will be downloaded and added in to your Toolkit installation. You will then be guided to a screen which has a button to Create New Instance. Each pattern instance has a name to identify it, and the user experience will guide you through a set of choices before hitting a Generate button to create the project(s) and resources. If there's any choice that you regret later you can always go back later and regenerate the pattern instance.

For more experienced users, the Toolkit also offers the opportunity to author your own patterns so if you've never tried this before then why not give it a go?

Toolkit - New JSONata Mapping node

The ACE Toolkit now has a new JSONata Mapping node which provides a new alternative way of transforming messages in the middle of a flow.

JSONata is a lightweight query and transformation language specifically designed for interacting with JSON data. It has built in-operators and functions for manipulating and combining data. You can apply JSONata mapping to fields in the message that is being built. 

Toolkit - New External Directory Vault explorer

The Toolkit has a new enhancement in ACE 13, allowing you to create an external directory vault or connect to an existing one with menu options for you to create, update and delete credentials. This makes localised testing of flows that interact with third party applications much easier as you no longer have to leave the Toolkit experience.

Credentials are displayed with icons to represent the type of application they are used to connect to. For each kind of application, the required properties that are needed for each available method of authentication are displayed using a series of handy enumerated drop-down menus.

Java 17 is the default for ACE 13

By default the ACE 13.0.1.0 runtime uses IBM Semeru Java 17 as its default JRE version. To be very precise about things, ACE 13 actually ships with IBM Semeru Runtime Certified Edition 17.0.12.0 This means that no matter whether you're creating an independent integration server for development purposes from the Toolkit, or using the command console to create an integration node owned server using the ibmint create command, by default all servers will use Java 17 when they start. The ACE installation also still includes Java 1.8 (or very precisely, java version 1.8.0_421 build 8.0.8.30) as well, so users can separately select their chosen Java version for each integration server. You can do this using the ibmint specify jre command.

Not all features of ACE are supported with each Java version. If you are intending to use the Change DataCapture message flow node then this requires Java 17. There are also a handful of long-standing ACE functions which are not yet compatible with Java 17 and should you wish to use them you will need to still use Java 1.8. This is the situation with WS-Security, WS-Trust, TFIM integration, and message flows that use either the Global Cache or CORBA nodes. In terms of actually writing Java code yourself to be executed within a message flow under a Java Compute node, we still support the building of your ACE JCN projects with either Java 1.8 or Java 17. One final point worthy of mention is that whilst Java 1.8 is also included with ACE 13, we are expecting to pre-announce its removal from support before the end of the support cycle of ACE 13 - so watch this space if you are intending to stick with Java 1.8 for now.

Migration

As existing users will be very aware, IBM App Connect Enterprise has always taken the topic of migration as a high priority. We want to protect your existing investments in our platform and enable you to bring forward your resources from previous releases of the product in a process that we're keen to make as frictionless as possible. ACE 12 and ACE 13 are architecturally very, very similar. Both major versions have integration nodes and servers which are structured the same way, and the storage formats used on disk are the same This means that migrating between ACE versions is becoming easier with each release and is very much simpler than going from IIB to ACE. In this latest release we have modernized the mqsiextractcomponents command, replacing it with a new command but with similar options in the ibmint command family. Here's a quick example:

ibmint extract node --backup-file C:\temp\MigrationDemo\MyNode_240927_150001.zip --input-integration-node MyNode --output-integration-node MyNodeMigrated

We'll be publishing a full blog on the detailed topic of migration to the IBM Community soon, so watch this space!

And Finally ...

We'll be blogging in more detail on lots of ACE 13 topics over the coming weeks, but in the meantime, please check out the ACE 13 documentation here and this overview video!

4 comments
138 views

Permalink

Comments

Tue October 01, 2024 03:42 AM

@Abu Davis

That image is part of our operator offering and so will be updated once we have released the next CD operator. 

Mon September 30, 2024 02:36 PM

@Rob Convery Thank you for the answer. Could you please also get it published on 

"cp.icr.io/cp/appc/ace-server-prod" repo ? Coz thats what our CD pipeline uses to rollout the new versions on our cluster, we basically enrich the ACE image with database drivers, etc. We also follow this link, unsure if it is still valid - https://raw.githubusercontent.com/IBM/cloud-pak/master/repo/case/ibm-appconnect/index.yaml

Example images:

 "Repository": "cp.icr.io/cp/appc/ace-server-prod",

    "Tags": [

        "12.0.12-r1-20240605-022311-amd64",

        "12.0.12-r1-20240605-022311-ppc64le",

        "12.0.12-r1-20240605-022311-s390x",

        "12.0.12-r1-20240605-022311",

        "12.0.12-r2-20240719-151325-amd64",

        "12.0.12-r2-20240719-151325-ppc64le",

        "12.0.12-r2-20240719-151325-s390x",

        "12.0.12-r2-20240719-151325",

        "12.0.12-r3-20240815-092600-amd64",

        "12.0.12-r3-20240815-092600-ppc64le",

        "12.0.12-r3-20240815-092600-s390x",

        "12.0.12-r3-20240815-092600",

        "12.0.12-r4-20240918-144329-amd64",

        "12.0.12-r4-20240918-144329-ppc64le",

        "12.0.12-r4-20240918-144329-s390x",

        "12.0.12-r4-20240918-144329",

Mon September 30, 2024 12:20 PM

>Any idea when ACE v13 docker image would be available on the IBM Entitled Registry? Also will this be part of SC-2 release of CP4I 16.1.0 at some point in the future?

We have already shipped the “ace” image with a V13 base, this is available from https://www.ibm.com/docs/en/app-connect/13.0?topic=cacerid-building-sample-supported-app-connect-enterprise-image-using-docker

In terms of the operator releases. We are not looking to bring V13 to SC2 because this is a LTS release. Our CD operator will be picking up V13 in its next release - v12.4.0

Mon September 30, 2024 05:42 AM

Any idea when ACE v13 docker image would be available on the IBM Entitled Registry? Also will this be part of SC-2 release of CP4I 16.1.0 at some point in the future?