Chapter 2. Fuse Online
Fuse Online provides a web browser interface that lets a business expert integrate two or more different applications or services without writing code. It also provides features that allow the addition of code if it is needed for complex use cases.
Fuse Online runs an integration on OpenShift as a Spring Boot application that uses Apache Camel.
2.1. About Fuse Online distributions
Fuse Online is Red Hat’s web-based integration platform. Syndesis is the open source project for Fuse Online. Fuse Online runs in these OpenShift environments:
Host Environment | Installation |
OpenShift Dedicated | Red Hat installs and provisions Fuse Online on Red Hat infrastructure. |
OpenShift Container Platform | Customer installs and manages. |
2.2. New features in Fuse Online 7.9
Fuse Online 7.9 provides the following new features:
SOAP API client connector
You can add a custom SOAP API client connector and then add a connection for a SOAP API client to Fuse Online integrations. For more information, see Creating SOAP API client connectors.
This release of the SOAP API client connector has some limitations as described in the Fuse Online section of Important Notes for Fuse Online.
New data mapper features
- Support for a new conditional expression. For a collection with multiple fields, the data mapper can now filter the values in one source field based on the value of a different source field (in the same collection).
Support for two new transformations:
-
CopyTo
Copies the value of a source string field into a specified field of a target collection without splitting. -
Repeat
When mapping a simple type to an array type, fills multiple array fields with the value taken from the simple type.
-
- In the data mapper UI, XML attributes are now indicated by the @ symbol.
The Fuse Online 7.9 data mapper is upgraded from AtlasMap 2.0.0 to 2.2.2. For details about the bug fixes and minor enhancements in version 2.2.2, see the following upstream AtlasMap release notes:
https://github.com/atlasmap/atlasmap/releases/tag/atlasmap-2.1.1
https://github.com/atlasmap/atlasmap/releases/tag/atlasmap-2.1.2
https://github.com/atlasmap/atlasmap/releases/tag/atlasmap-2.2.0
https://github.com/atlasmap/atlasmap/releases/tag/atlasmap-2.2.1
https://github.com/atlasmap/atlasmap/releases/tag/atlasmap-2.2.2
FTP connector actions
In previous releases, the FTP connector had two actions (
Download
andUpload
). Starting with Fuse Online 7.9, there are two additional actions for an FTP server:DownloadNamedFile
andUploadNamedFile
. Also, for the file name expression, you now provide an Apache Camel File language expression to specify the file or files to download or upload.
2.3. Changes in Fuse Online 7.9
Fuse Online 7.9 changes Fuse Online 7.8 features as follows:
New option for enabling the sample PostgresDB database and connection
By default, when you deploy Fuse Online, the sample PostgresDB database and connector are disabled (not installed). To enable them, edit the syndesis CR by setting the
demoData
option totrue
. For more information, see the Adding sample data to a Fuse environment running on OCP in Installing and Operating Fuse Online on OpenShift Container Platform.Slack connector now uses the Bot User OAuth Access Token
When you create a Slack connector, you now specify the Bot User OAuth Access Token to authorize access to your Slack app. Slack has deprecated the legacy token authorization.
Updates to the Fuse Online custom resource are applied when saved
When you make changes in the
components.server
section of the Fuse Online custom resource, Fuse Online applies your updates after you save the custom resource. Starting with Fuse Online 7.9, you no longer need to manually delete thesyndesis-server
pod for the changes to take effect.
2.4. Upgrading Fuse Online integrations
To upgrade a Fuse Online environment that is running on OCP on-site, you must update Fuse Online by using the operator and then republish any running integrations as described in Upgrading Fuse Online.
Note that you should upgrade from Fuse Online 7.8 to 7.9 by using the OperatorHub, regardless of how you installed Fuse Online 7.8 (by using the install script or the OperatorHub).
2.5. Important notes for Fuse Online
Important notes for the Fuse 7.9 release of the Fuse Online distribution:
SOAP API Client connector features
The SOAP API client connector supports the following features:
- SOAP 1.1 and 1.2 message formats
- Both RPC and Document bindings only support Literal encoding.
- All Workday WSDLs use inline schemas, SOAP document literal binding, and WS Username Token text password authentication.
- Nested circular reference types.
- External schemas - Only URL-based WSDLs support external schemas based on the relative URLs from the WSDL’s base path. The WSDL URL must be available to the SOAP connector at runtime for parsing and validation. Therefore, make sure that the WSDL and schemas are hosted at a permanent URL.
- Multiple schemas - Both inline and external (WSDL URLs) support multiple schemas with unique namespaces.
Security-related features:
- WS_Basic profile and list combinations.
- For Basic Authentication, HTTPS username/password is supported.
- For Username Token profiles, both Text and Digest passwords are supported.
In this release, the SOAP API client connector does not include support for the following features:
- External schemas - Disk-based external schemas referenced in WSDL files directly imported into the connector (by using the File Upload form) are not supported. Uploaded WSDL files must use inline schemas. However, URL-based WSDLs support external schemas hosted with the WSDLs.
- SOAP encoding is not supported.
- For security, SAML is not supported.
Kafka broker URIs not auto-discovered for AMQ Streams
The CRD version for AMQ Streams has increased in Fuse Online to
v1beta2
as described in this AMQ release note. If you are using AMQ Streams, when you create a new Kafka Message Broker connection in Fuse Online, the Kafka Broker URI is not auto-discovered and not shown in the Kafka Broker URI drop-down list. Instead, you must type the URI.- Fuse Online no longer supports Camel K runtime or the KNative connector.
- When Fuse Online is installed and provisioned on Red Hat infrastructure, the account is limited to a specific number of integrations that can be running at one time. For details, see the pricing plan.
- An OpenAPI schema that you upload to Fuse Online might not define input/output types. When Fuse Online creates a custom API client from an OpenAPI schema that does not specify input/output types then it is not possible to create an integration that maps integration data to fields that the API client can process or from fields that the API client processed. If an integration requires data mapping to or from a custom API, then when you upload the OpenAPI schema, click Review/Edit to open API Designer, which is an API editing tool, and add input/output type specifications.
- Since Fuse 7.8, an OpenAPI document that you use for a custom API client connector or for an API provider integration cannot have cyclic schema references. For example, a JSON schema that specifies a request or response body cannot reference itself as a whole nor reference any part of itself through any number of intermediate schemas.
2.6. Obtaining technical support for Fuse Online
To obtain technical support, in the Fuse Online console, in the left navigation panel, click Support. Use the Support page to download diagnostic information for all integrations or for one or more integrations that you choose. The page also provides a link for opening a support ticket and providing the diagnostic information that you downloaded.
2.7. Technology Preview features in Fuse Online
This release includes the Technology Preview features that are listed below.
Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process. For more information, see Red Hat Technology Preview features support scope.
Fuse Online auditing
Fuse Online supports basic auditing for changes made by any user to the following Fuse Online components:
-
Connections - The
Name
and any other fields shown on the connector’s Details page in the Fuse Online web console. -
Connectors - The
Name
field. -
Integrations - The
Name
field.
-
Connections - The
Conditional expressions for mapping data fields
In the data mapper, you can specify a conditional expression and apply it to a data mapping. For example, a conditional expression can specify evaluation of a source field and how to populate the target field if the source field is empty. The limited set of expressions that you can specify are similar to Microsoft Excel expressions.
Document scope for user-defined properties in data mapper
In the data mapper, you can specify a scope for properties that you define for source and target mappings. In the Mapping Details panel, click Add (+) next to Properties. In the Create Property dialog. for the new Scope option, you can select the current message header, a message header from a previous step, or Camel Exchange Property for Camel-specific properties.
For a REST API client that uses OAuth, when you create an API client connector, you can change the default OAuth2 behavior of connections that you create from that connector. Fuse Online vendor extensions to the OpenAPI specification support the following:
- Providing client credentials as parameters.
- Obtaining a new access token based on HTTP response status codes.