Release 10.12 Preview

The Integration v10.12 highlights are a high-level preview of the enhancements and updates for the upcoming v10.12 release and are subject to changes when the release becomes generally available.


New features and enhancements Description
External Messaging Providers The Messaging feature in Integration now supports publishing and consumption of messages through external Messaging Providers. Currently, Integration supports Universal Messaging in the webMethods Cloud Container as an external messaging provider. A new connector, JMS, has been added to publish messages to the external provider. Like any other connector, you must create a JMS account to connect to the external messaging provider and use them in JMS connectors and subscribers.

The JMS connector is in addition to the existing Integration Messaging connector that connects to the internal messaging provider.

Note: Currently, you can subscribe for messages from External Messaging Providers with FlowServices only.
Subscriber Error Management New error handling options have been added to configure the subscriber’s behaviour if they encounter any errors while processing messages. These options are available on the Subscriber settings page, which is accessible from the New subscriber or Update subscriber pages.

Based on the type of error encountered, you can configure the subscriber to suspend, retry, or recover the message.

Note: Error handling options are applicable only if the invocation target is a FlowService.

Downloading Workflow Execution Logs You can now download workflow execution logs (all or filtered records) in either JSON or CSV format to your local machine.
To do this, click the Download logs option located on the upper-right corner of the Workflow Executions section on the Monitor page.
Earlier, you could download execution logs of FlowServices only.

Salesforce listener enhancements The Salesforce listener now supports ‘Last received’ replay option which replays all events that occurred after the most recently saved replay ID.
Set custom transaction time limit for tenants You can now set a custom transaction time limit for your tenant. Contact Software AG Global Support if you want to set a custom transaction time limit.
The supported values for custom transaction time limits are:
  • Seconds: 15 seconds, 180 seconds (3 minutes), 7200 seconds (2 hours).
  • No restriction: No restriction on the transaction time.
Enhanced Password Encryption The password provided in the Actions Input log of the workflow execution history page is now encrypted and displayed as ***** instead of plain text for enhanced security. This is applicable for workflows created using the REST connector or when setting up credentials for dynamic accounts.

Support for Custom Values Dropdown lists on the Workflow Mapping page now accept custom values. You can specify custom values if the dropdown list does not have the values you are looking for.
Earlier, you could select the values available only in the dropdown list.

Note: This feature is supported by dropdown lists that have the configuration field_usereditable set to true.
Optimization of Workflow Execution Logs Workflow execution logs are now not maintained by default for webhook or trigger executions. You can view the detailed execution logs by selecting the Maintain workflow execution logs when executed via webhook or trigger option in the workflow settings. The execution logs are stored for the failed or timed out workflow events and for the workflows that are manually run from the canvas, even if this checkbox is cleared.

Note: The Maintain workflow execution logs when executed via webhook or trigger option will be automatically disabled after the defined log retention period is reached.

Optimization of FlowService execution logs Performance of FlowService execution history data loading on the Monitor page has been optimized in this release. This has been achieved by caching the FlowService execution history summary data and removing unwanted columns from the Execution History table.
Earlier, the data loaded quite slowly on the Monitoring page, especially when you selected multiple weeks.
Trigger Resource Monitoring A new option Trigger Resource Monitoring has been added in the Choose Specification dropdown list in the Define input and output fields dialog box, which allows you to create FlowServices with this specification.
Import and Export of Custom CloudStreams Connectors FlowServices and Workflows that contain custom CloudStreams connectors can now be exported and imported across multiple environments.
Earlier versions did not offer this capability. You can now reuse your custom CloudStreams connectors in multiple environments.

The behavior is as follows:
  • Whenever you attempt to import a workflow or a FlowService that contains custom CloudStreams connectors, ensure that the connector is installed in the destination environment. If not, an error message appears and you cannot import the workflow or FlowService containing the custom CloudStreams connector.
  • Whenever you attempt to export a workflow or a FlowService that contains custom CloudStreams connectors, a warning message appears.
  • Similarly, whenever you publish or deploy a project that contains custom CloudStreams connectors, error and warning messages appear.
New APIs New APIs have been introduced in the following domains:

  • Project APIs: Allows you to retrieve a list of project assets, publish a project, deploy a project, create a project parameter, delete a project parameter, update a project parameter, list project parameters, and retrieve a project parameter.

  • Role Management APIs: Allows you to create a role for a particular tenant, update an existing role, delete a role, retrieve details of a particular role, and list a collection of roles associated with a particular tenant.

  • User Management APIs: Allows you to retrieve a list of users associated with a particular tenant and assign roles to a user.

  • Themes APIs: Allows you to create a theme, manage themes, retrieve theme details, list themes, and retrieve default values for the current theme.

  • Webhook APIs: Allows you to retrieve details of workflows that are webhook-enabled, regenerate webhook URL for an existing workflow in a particular tenant, and add an authentication mechanism to a webhook in a particular tenant.

  • Recipes APIs: Allows you to create a recipe, delete a recipe, retrieve recipe details, and retrieve all recipes for a tenant.
Deprecation notification - Public API requests The following URL path for all public APIs that were introduced in Release 10.11 are deprecated and will be removed in a later release:

Deprecated URL: <domain>/enterprise/v1/rest/...

New URL: <domain>/apis/v1/rest/...

  • In this release, both the deprecated URL and the new URL are supported for the following public APIs:
    • Workflow APIs - Exporting, importing, deleting, executing a workflow, and retrieving workflow execution status.
    • FlowService APIs - Exporting, importing, deleting, and executing a FlowService.
    • Project APIs - Creating, updating, deleting, retrieving a project, and retrieving a list of projects.
  • In this release, deprecated URLs are supported only for backward compatibility and will become obsolete in a later release.
  • It is strongly recommended that you review the current deployment and change the implementation to utilize the new URL format provided.
  • This will be a minor revision and the API version will not be impacted.
New services The following new services have been added in this release in the Document, Flow, and Schema categories:
  • Document
    • removeNullFields: Removes null fields from the given document. Optionally, by specifying trimStringFields and removeEmptyStringFields, you can trim leading and trailing spaces in a string field, and after trimming the fields, if the string field length is zero, they can be removed. For array fields, it reduces the size of the array by the number of null fields. After removing all the null fields, if the size is zero, the array field is removed from the given document.
  • Flow
    • getRetryCount: Retrieves the retry count and the maximum retry count for a service.
    • throwExceptionForRetry: Throws an ISRuntimeException and instructs to re-execute a service using the original service input.
  • Schema
    • validate: Validates an object using an IS document type, XML document type, or an IS schema.
    • validatePipeline: Validates the pipeline against a document type.
Monitor Page Enhancements The following enhancements are now available in the Workflow Execution and FlowService Execution features:

  • A new column Duration is included in the Executions table. This column displays the duration of a particular workflow or a FlowService execution.

  • The new Settings option is added in the upper-right corner of the page beside the Download Logs option. This option, when clicked, displays a list of column names and allows you to select the columns you want to view in the Executions table based on your requirements. Column names that are not selected will be hidden in the Executions table.

  • In the FlowService Execution page, a Sort by provision is added beside the column names in the Executions table that allows you to view a list of execution details in an ascending or descending order based on the following criteria:
    • Name: Sorts the list based on the FlowService name.
    • Start Time: Sorts the list based on the FlowService start time.
    • Duration: Sorts the list based on the length of the FlowService execution duration.

  • In the Running Executions table on the FlowService Execution page, you can now select one, multiple, or all running FlowService executions to terminate in just one click. In earlier releases, you could terminate only one running FlowService execution at a time.

  • On the detailed execution page of a particular FlowService, a new detail Transaction count is added. It displays the total number of transactions consumed by that particular FlowService during an execution.

SAP® ERP enhancements Transaction Store
SAP® ERP now provides a transaction store that allows you to monitor the transaction state of messages. The transaction ID uniquely identifies the transaction.

ALE Listener notification
The ALE listener notification works in conjunction with a listener to filter and process the IDocs in a synchronous manner.

Prioritize Listener notifications in SAP® ERP
You can rearrange and change the priority of the listener notifications in SAP® ERP.

New built-in services
SAP® ERP now provides the following built-in services to simplify and accelerate user interaction with the system:

  • clientConnect
  • clientLockSession
  • clientReleaseSession
  • clientInvoke
  • clientInvokeTransaction
  • clientCreateTID
  • clientConfirmTID
  • clientGetAttributes
  • clientGetFunctionInterface
  • clientGetStructureDefinition
  • clientGetThroughput
  • clientSendIDoc
  • clientSendIDocLists
  • clientPing
  • RFCdecode
  • RFCencode
  • RFCcreateTemplate
  • IDocDecodeSDATA
  • IDocDecodeString
  • documentToIDoc
  • IDocEncodeSDATA
  • IDocEncodeString
  • IDocToDocument
  • IDocToTables
  • tablesToIDoc
  • IDocEncode
  • IDocDecode
  • IDocTrace
  • swapSenderReceiverLS
  • SYSTAT01report
  • BAPIdecode
  • BAPIencode
  • BAPIcreateTemplate
  • BAPIcommit
  • BAPIrollback
  • listTransactions
  • getTransaction
  • getTransactionMessageBody
  • getTransactionLog
  • setTransactionCacheParameter
  • storeTransactionConfig
  • deleteTransaction
  • deleteAllTransactions
  • sweepTransactions
  • ALEinboundProcess
  • ALEoutboundProcess
  • ALEgetRoutingInfo_Default
  • ISinboundProcess
  • RFCinboundProcess
  • RFCoutboundProcess
  • XMLinboundProcess
  • XMLoutboundProcess
  • BAPIinboundProcess
  • BAPIoutboundProcess

    Built-in Services Specifications:
  • ALE Routing Info Default
  • ALE Routing Info
  • ALE Mapping Info
  • ALE Mapping Info Default
  • XML Routing Info

    Enable and disable Listeners for SAP® ERP
    You can now view a more detailed listener status such as Pending enabled, Pending disabled, Enabled, and Disabled.

  • Enhancements in errors, warnings, and information messages Error and warning messages for the following functionalities have been revised for enhanced usability:

    • Exporting or importing workflows or FlowServices containing custom CloudStreams connectors.
    • Publishing or deploying projects containing custom CloudStreams connectors.
    • Importing FlowServices.
    Stability and Performance Improvements The following stability and performance improvements have been implemented in this release:

    • Auto Scaling is added for a few components in the execution platform for paid users to improve their tps (transactions per second) success rate. Your systems are now monitored and their capacity is automatically adjusted to maintain a steady and predictable performance at the lowest possible cost.
      Earlier, if the resources were fully utilized, users had to wait until the resources became available before they could proceed with their work.

    • Execution logs are now directly stored into the database using an efficient log collector.
      Earlier, logs were initially stored in flat files and then transferred to databases, causing performance issues.
    Copy Field Names A new option, Copy field name, has been added in the Pipeline tasks that allows you to copy any field name in the Pipeline panel. You could use this option if you would like to extract field names only, instead of the complete metadata of the node as using Copy fields.
    Message Retention Period Messages are now retained by the internal messaging providers for 30 days instead of seven days. In case your messaging provider is external, you can specify the retention period through the timeToLive parameter according to your needs.
    Tutorials In this release, new tutorials were added to assist you in understanding the features of Integration.
    New and updated Connectors Explore new and updated connectors released each month in Integration.
    Asset Support Matrix View the list of functions supported for various assets in the current version of Integration.

    Usage Notes

    This section provides any additional information that you need to work with Integration.