what's new for oracle integration cloud services new for oracle integration cloud service ......

Oracle® CloudWhat's New for Oracle Integration CloudService

Release 18.2.3E55706-22May 2018

Oracle Cloud What's New for Oracle Integration Cloud Service, Release 18.2.3

E55706-22

Copyright © 2016, 2018, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify,license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means.Reverse engineering, disassembly, or decompilation of this software, unless required by law forinteroperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it onbehalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of theprograms, including any operating system, integrated software, any programs installed on the hardware,and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications.It is not developed or intended for use in any inherently dangerous applications, including applications thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced MicroDevices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,and services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services unless otherwiseset forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not beresponsible for any loss, costs, or damages incurred due to your access to or use of third-party content,products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

1 What’s New for Oracle Integration Cloud Service

iii

1What’s New for Oracle Integration CloudService

Learn about the new and changed features of Oracle Integration Cloud Service.

Releases

• May 2018 (18.2.3)

• February 2018 (18.1.3)

• November 2017 (17.4.3)

• October 2017 (17.4.1)

• August 2017 (17.3.3)

• June 2017 (17.2.5)

• February 2017 (17.1.3)

• December 2016 (16.4.5)

• October 2016 (16.4.1)

• August 2016 (16.3.3)

• June 2016 (16.2.5)

May 2018

Feature Description

Oracle Integration CloudService to OracleAutonomous IntegrationCloud migration

You can export your Oracle Integration Cloud Service data objectsas an archive and import that archive into Oracle AutonomousIntegration Cloud. You do not need to manually configureconnection endpoints and passwords and then activate theexported integrations in Oracle Autonomous Integration Cloud.Integration activations occur automatically.

See Using Oracle Integration Cloud Service.

Bug fixes This release of Oracle Integration Cloud Service includes a numberof bug fixes. For details about specific bug fixes, log in to support.oracle.com and search for document ID 2391173.1.

February 2018

Feature Description

Workday Adapter Workday is a SAAS-based human capital management system thatalso supports financial management systems for organizations.Workday can be the one system for all your organizational activitiessuch as recruiting, payroll, finance, inventory, and so on.

See Using the Workday Adapter.

1-1

HTTPS://SUPPORT.ORACLE.COM/

Feature Description

Encoding and decodingfile attachment content

The virtual file system (VFS) enables you to store files and usereferences to these files in the message payload internally. Thismethod enables you to map the content of a staged file attachmentto a string element by converting the content to a base64 string.You can also store the base64 string as an attachment andgenerate a VFS reference.


REST Adapter -application/octet-stream support

A MIME attachment with the content type application/octet-stream is a binary file. Typically, it is an application or a documentthat is opened in an application such as a spreadsheet or wordprocessor. If the attachment has a filename extension associatedwith it, you may be able to determine what type of file it is. Forexample, a .exe extension indicates a Windows or DOS program(executable), while a file ending in .doc is probably meant to beopened in Microsoft Word.

See Using the REST Adapter.

Bug fixes This release of Oracle Integration Cloud Service includes a numberof bug fixes. For details about specific bug fixes, log in to support.oracle.com and search for document ID 2353669.1.

November 2017

This release of Oracle Integration Cloud Service consists of bug fixes. For detailsabout specific bug fixes, log in to support.oracle.com and search for document ID2320989.1.

October 2017


August 2017


June 2017

Feature Description

“Guide me” visualoverlays

When you initially log in to Oracle Integration Cloud Service,overlays are provided on many of the main pages. The overlaysguide you on how to perform tasks such as getting started, creatingconnections, creating integrations, and so on. Click Got it todismiss the overlays. To enable the overlays again, select Help >Guide Me from the username main menu at the top of the page.


Chapter 1

1-2





Feature Description

Preseeded samples When you provision a new instance of Oracle Integration CloudService, several sample integrations are automatically included.These fully designed samples help you get up and running quicklyand show you how easy it is to activate, invoke, and monitor anintegration between endpoints.


OracleRecommendationsEngine for faster datamapping

You can accept the target element recommendations of therecommendations engine when creating mappings. This eliminatesthe need to analyze and perform each individual source-to-targetmapping. You must enable the Oracle Recommendations Engine touse this feature.

See Using the Oracle Mapper.

On-premises connectivityagent enhancements

The following agent enhancements are provided:

• Installation is supported on Linux Server release OEL7.• Authentication support is provided for outbound proxy access.• Agent automatically stops polling decommissioned instances. A

24 hour period of inactivity occurs with the agent stoppingpolling altogether on the decommissioned instance.

• Notification emails can capture agent status.• Performance and resiliency improvements are provided around

quiescing endpoints when Oracle Integration Cloud Service isunavailable. Automatic unquiescing is provided when OracleIntegration Cloud Service becomes available.


Chapter 1

1-3

Feature Description

Orchestrated integrationenhancements

The following orchestration enhancements are provided:

• The stage file action is provided to read (and remove anytrailer), write, zip, unzip, and list files in a staged locationknown to Oracle Integration Cloud Service (for example,process each file downloaded by the FTP Adapter). This actionis only for scheduled orchestrations. See Using OracleIntegration Cloud Service.

• The Read File in Segments option of the stage file actionenables you to specify a file chunking size. Chunking filesenables large files to be processed, one logical chunk at atime. This option is only for scheduled orchestrations. See Using Oracle Integration Cloud Service.

• The scope action is provided to manage a group of actionswith a scope action. The scope action is essentially a collectionof child actions and invokes that can have their own faulthandlers. You can also catch faults in scopes. See UsingOracle Integration Cloud Service.

• The raise error action is provided to throw an error and sendfailed messages to the error hospital for further analysis. Thisaction is only available inside a fault handler. See Using OracleIntegration Cloud Service.

• The logger action is provided to log messages to the activitystream and diagnostic logs by adding the logger action at anypoint in the integration. See Using Oracle Integration CloudService.

• The for-each action is enhanced to include a Process itemsin parallel option that enables you to concurrently processdata in scheduled orchestrated integrations. See Using OracleIntegration Cloud Service.

• Updates to variables declared outside of the for-each actionProcess items in parallel option and the stage file actionRead File in Segments operation are provided.

• The function call action is provided to add JavaScriptfunctions to an integration. See Using Libraries to ManageFunctions for Integrations and Adding a Function Call Action ofUsing Oracle Integration Cloud Service.

• Tracking support has been enhanced:

– Tracking support is provided for actions and global faultson the instance tracking pages and in the audit trail.

– Tracking support is provided for customizable fields.– Tracking variables can be accessed and updated inside

orchestrations.– The activity stream is viewable on the Tracking Details

page.– The Tracking page shows tracking variables and the

starting and ending times of an instance.See Using Oracle Integration Cloud Service.

• Visual repositioning (move) of nodes in orchestratedintegrations is provided. See Using Oracle Integration CloudService.

• Ability to define fault handlers for named business faults thatare defined by any one of the invoked endpoints in the scopeor globally. When you add invokes to a scope, the named faultsassociated with the invokes are added for selection to the Fault

Chapter 1

1-4

Feature Description

Handler section of the scope. These are faults that the invokecan handle. See Using Oracle Integration Cloud Service.

• Aggregation and sending of errors to external services isprovided. Oracle Integration Cloud Service includes apredefined fault object for fault aggregation. This objectenables you to catch and aggregate faults in the context ofparallel processing in scheduled orchestrated integrations andto send these faults to an external service to define moregranular error handling. See Using Oracle Integration CloudService.


Scheduler orchestrationenhancements

The following scheduler enhancements are provided:

• Set schedule parameters that determine how to batch and readdata received from a source location. You then use theseparameter values downstream in the integration.

• Show the reason why a scheduled flow is not running (forexample, blocked, waiting, ready, paused, or cancelling).

• Support multiple schedule frequencies for running integrations.• Past and current runs are viewable from the Monitoring page.See Using Oracle Integration Cloud Service.

FTP Adapterenhancements

The following FTP Adapter enhancements are provided:

• Support for public key authentication.• The following operations to perform on files when configuring

the FTP Adapter in an orchestrated integration:

– Download File: Specify a directory to use for stagedactivity. Use this directory to stage large files forprocessing.

– List Files: List the names of the files in the input directory.See Configuring Connection Security and Configuring FTP AdapterInvoke Operations Properties of Using the FTP Adapter.

SOAP Adapter The following SOAP Adapter enhancements are provided:

• SAML token-based authentication support for protectinginbound SOAP endpoints. The SAML security policy is used toconfigure the SOAP Adapter as a trigger to enableasynchronous invocation and callback authentication fromERP/DOO services primarily.

• Exposure of asynchronous SOAP endpoints with callbacksupport. This enables you to invoke SOAP web services thathave an asynchronous interface - (request with anasynchronous callback).

See Using the SOAP Adapter.

Oracle HCM CloudAdapter

Oracle Global Human Resources Cloud delivers representationalstate transfer (REST) APIs to support your integrationrequirements. These REST APIs enable easy integration of datainto new and existing business process flows. These are intendedas user-friendly web services involving transactions of a smallervolume. The Oracle HCM Cloud Adapter now has native support forconsuming these REST APIs. You can model Oracle IntegrationCloud Service integrations to use Oracle HCM Cloud Adapter tocreate, update, delete, query, and perform various high-valuedactions on a wide range of Oracle HCM resources.

See Using the Oracle HCM Cloud Adapter.

Chapter 1

1-5

Feature Description

Oracle ERP CloudAdapter

The Oracle ERP Cloud Adapter now uses External Data IntegrationServices for Oracle Cloud to load data into Oracle Fusion ERPCloud and Supply Chain Management applications. This enablescustomers to build integrations to load data from external sources,such as legacy systems and third-party applications into OracleFusion Applications. Based on simple configuration done by theintegration developer, the Oracle ERP Cloud Adapter has the nativecapability to automatically upload the data file to Oracle FusionApplications for loading the data files into interface tables andtriggering the application-specific data import processes to transferdata from interface tables into application tables in your OracleFusion Applications. The Oracle ERP Cloud Adapter enables you tomodel integrations to receive notifications and process the outcomeupon completion of the bulk data import.

See Using Oracle ERP Cloud Adapter.

Oracle CPQ CloudAdapter - REST CatalogURL support

Oracle Configure, Price, and Quote (CPQ) Cloud supports acomplete quote-to-cash process from customer inquiry to orderfulfillment. It helps you optimize product options and configurationsfrom simple to complex, automatically applying discounts andrelevant up-sell and cross-sell opportunities. Oracle CPQ Cloudexposes business objects and data through REST APIs. Byexposing objects and data through REST APIs, Oracle CPQ Cloudpromotes simpler API calls and more robust integration using HTTPstandards. The Oracle CPQ Cloud Adapter now has native supportfor consuming these REST APIs. You can model integrations to usethe Oracle CPQ Cloud Adapter to create, update, delete, query aswell as perform various high valued actions on a variety of CPQResources.

The Oracle CPQ Cloud Adapter also has support for regeneratingthe artifacts, thereby providing an option for you to retrieve any datamodel changes done to CPQ (including customizations) since theintegration was built.

See Using Oracle CPQ Cloud Adapter.

SuccessFactors Adapter The SuccessFactors Adapter provides support for server-sidepagination in a query operation for retrieving larger data setsthrough a SFQL-based query across several iterations within asingle integration flow instance using simple modeling constructs.You can use this feature to model a scheduled orchestration,pattern-based integration to retrieve the employees/jobs/anybusiness object that match the criteria specified in the SFQL query,and synchronize them with downstream systems.

See Using the SuccessFactors Adapter.

Oracle Field ServiceCloud Adapter

When configuring the adapter as an invoke connection, the SearchActivity operation is now available for selection under the Activitybusiness object.

See Using the Oracle Field Service Cloud Adapter.

Oracle Logistics Adapter The Oracle Logistics Adapter to enables you to upload a WSDLduring connection configuration.

See Using the Oracle Logistics Adapter.

JMS Adapter The JMS Adapter is supported in the trigger (inbound) direction withthe on-premises agent.

See Using the JMS Adapter.

Chapter 1

1-6

Feature Description

Oracle Database Adapter The Oracle Database Adapter supports fault propagation forruntime errors when modeling integrations.

See Using the Oracle Database Adapter.

ServiceNow Adapter The ServiceNow Adapter is certified to run on the Istanbul release.

See Using the ServiceNow Adapter.

Salesforce Adapter The Salesforce Adapter provides support for server-side paginationin query operations for retrieving larger data sent through SOQL-based queries across several iterations within a single OracleIntegration Cloud Service flow instance using simple modelingconstructs. You can use this feature to model a scheduledorchestration, pattern-based Oracle Integration Cloud Service flowto retrieve the customers/opportunities/any business object thatmatches the criteria specified in the SOQL query, and synchronizethem with downstream systems.

See Using the Salesforce Adapter.

getFlowId functionsupport in the mapperand Expression Builder

You can correlate an integration flow ID to the Oracle BAM dataobject (DO) store with ora:getFlowId (available with theOrchestration integration pattern) and insQr:getFlowId (availablewith the Map Data integration pattern). This function is available inboth the mapper and Expression Builder under Functions > ICS.

getFaultAsString,getFaultAsXML, andgetFaultName functionsupport

The getFaultAsString, getFaultAsXML, and getFaultNamefunctions are available in the Expression Builder to use in the catchall part of scope level fault handling.

More XSLT 1.0 functionsupport in the mapperand Expression Builder

The following XSLT 1.0 functions are supported in the mapper.These functions are useful in Oracle Commerce Cloud Adapter toOracle Order Management Cloud integrations in which complexmapping is required.

• Functions > Advanced > String > format-number• Functions > Node-set > document• Functions > Advanced > element-available• Functions > Advanced > function-available• Functions > Node-set > key• Functions > Advanced > System-property• Functions > Advanced > unparsed-entity-uri

Integration designerusability enhancements

The following integration designer usability enhancements areprovided:

• View the design time audit added to track changes to designtime artifacts (under Monitoring > Dashboard > Design TimeMetrics).

• View imported integrations with connections in a draft state.• Unlock integrations that are locked.• Unlock connections that are locked.• Download artifacts of an integration as a ZIP file for viewing

and analysis.See Using Oracle Integration Cloud Service.

Chapter 1

1-7

Feature Description

File system spacemanagement

You can manage the size of your file system. The warning thresholdis 85%, at which time you can receive an email notification if youhave configured a notification email address. When usage reaches90%, Oracle Integration Cloud Service enters into a read-only state.During this state, you cannot perform certain integration tasks untilyou have reduced file system usage below 90%.


Database spacemanagement

You can determine when to purge the data in your database. Youcan also view the notification and quiesced thresholds for yourdatabase and the percentage of the database that has been used.


Tracking page link innotification email

The notification email that you can configured for system status anderrors includes a link to the integration instance diagram thatappears under the Tracking page for a specific instance.


Integration with OracleAPI Platform CloudService

You can publish Oracle Integration Cloud Service endpoints toOracle API Platform Cloud Service.


REST API enhancements The following REST API enhancements are provided:

• Download log files for a specific time window• Get integration monitoring data based on a time window• Pause/resume all scheduled runs on an instance• Resubmit/discard failed instances (for the V2 version of the

REST API)• Query activity stream overlay through the V2 REST API to

make visualization of activities easier• Upload SSL certificatesSee Oracle Integration Cloud Service REST API version 1 and Oracle Integration Cloud Service REST API version 1.2.

On-premises OracleIntegration Cloud Servicecluster installationsupport

You can add additional managed servers for high availability to anon-premises Oracle Integration Cloud Service cluster. You mustinstall the Oracle Integration Cloud Service execution agent to useon-premises Oracle Integration Cloud Service.


February 2017

Feature Description

Certification of on-premises connectivityagent on RHEL andSUSE

On-premises connectivity agent installation is supported on Red HatEnterprise Linux Server release 6.6 (Santiago) and SUSE LinuxEnterprise Server 12 SP1.


On-premises connectivityagent enhancements

This release brings major enhancements in the communicationmechanism and performance between Oracle Integration CloudService and on-premises connectivity agents.

Important: Upgrade any existing on-premises connectivity agentsto 17.1.3 immediately.


Chapter 1

1-8

Feature Description

REST Adapter -uploading attachments inoutbound invocations andresponse messageattachments

When using the mapper in integrations with the REST Adapter, afile input field is provided for uploading attachments in outboundinvocations and response message attachments. This featureenables you to specify the attachment file name (using thefileInputHtmlFieldName element under the source nodeAttachmentProperties) in the mapper for multipart attachments.


SOAP Adapter - two-waySSL outboundcommunication support

Two-way SSL for outbound communication is supported. You canalso upload identity certifications to use in two-way SSLcommunication.

See Using the SOAP Adapter and Using Oracle Integrated CloudService.

Oracle E-Business SuiteAdapter - support forconcurrent programs asinvokes (targets) inOracle E-Business SuiteRelease 12.2

The Oracle E-Business Suite Adapter supports outboundintegrations with concurrent programs from Oracle Integration CloudService when adding the Oracle E-Business Suite Adapter as aninvoke (target) connection.

In addition to PL/SQL REST services, concurrent programs are nowavailable as REST services for invocation from Oracle IntegrationCloud Service.

Note: This feature was initially available in Oracle E-Business SuiteRelease 12.1.3, and it is now available in both Oracle E-BusinessSuite Release 12.1.3 and Release 12.2.

See Using the Oracle E-Business Suite Adapter.

While action inorchestrated integrations

You can create while actions in orchestrated integrations. The whileaction enables you to loop over actions or invoke connections aslong as a specific condition is met.


Notification action inorchestrated integrations

You can send a notification email to relevant users at specific pointsin the execution of an integration.


Wait action inorchestrated integrations

You can create wait actions in orchestrated integrations. The waitaction enables you to delay the execution of an integration for aspecified period of time.


Email notifications afteran integration failure

You can send a detailed report every five minutes if an error occursin an integration flow.


Chapter 1

1-9

Feature Description

REST API enhancements The following enhancements are provided:• Set the retention period in days. At this time, there is no

retention period limit.

Note:

Although there is no maximum retention period limit,the underlying database tablespace is limited in size.As a result, the system may be quiesced if thedatabase tablespace fills up. Be aware of thisconstraint when selecting a retention limit for thetracking data.

• Execute the purge of instances based on the retention periodsupplied. The space of the purged data is reclaimed.

• Get error instances (with REST API version 2).

See Oracle Integration Cloud Service REST API version 1 and Oracle Integration Cloud Service REST API version 1.2.

Tracking information forfor-each actions

Tracking information and audit trail details are visible in the OracleIntegration Cloud Service for for-each actions.


Mapper and ExpressionBuilder - base 64 encodeand decode functionsupport

The mapper and Expression Builder both provide support for base64 encode and decode functions. This enables data sent into theservice as base 64–encoded data in attachments or in a payload tobe decoded and processed in the orchestrated integration.

See Using the Oracle Mapper and Using Oracle Integration CloudService.

Mapper - deep copyingcomplex parent nodes

You can copy a complex parent node from the source to the targetusing one drag and drop action without having to map everyindividual leaf node.


Global fault handling inorchestrated integrations

Global fault handling in orchestrated integrations is supported. Thisfunctionality enables you to direct business faults back to the calleror apply business logic before sending faults to the error handlingframework.

See Using Oracle Integrated Cloud Service.

Trigger editing in existingorchestrated integrations

You can edit triggers in existing orchestrated integrations (forexample, when a SOAP endpoint changes) and revalidate theintegration flow downstream.


OWSM keystoremessage protectioncertificate

Keystore certificates with SAML tokens are supported. Create, read,update, and delete (CRUD) operations are supported on this type ofcertificate.


Chapter 1

1-10

Feature Description

On-premises executionagent for OracleIntegration Cloud Service- expanded domain andfront end host gateway

A single installation path is now provided for the on-premisesexecution agent for Oracle Integration Cloud Service. When youperform the installation, you automatically receive an expandeddomain (one administration server and one managed server on thesame virtual machine). The expanded domain helps you easilyexpand your setup to a cluster. Also if you want to use a gateway infront of your server. you can set the front end host to use duringinstallation.


Switch actions - nestedswitch support

Nested switches within switch actions in orchestrated integrationsare supported.


Performing actions onlocked connections andintegrations

You can perform the following actions on locked connections andintegrations:

• Clone a connection. See Using Oracle Integration CloudService.

• Clone an integration. See Using Oracle Integration CloudService.

• Create a draft of an integration. See Using Oracle IntegrationCloud Service.

• Export an integration. See Using Oracle Integration CloudService.

December 2016

Feature Description

Oracle DB2 Adapter The DB2 Adapter enables you to run stored procedures or SQLstatements against an IBM DB2 database. Distributed pollingand multithreading support are also provided.

See Using the DB2 Adapter.

Oracle Logistics Adapter The Oracle Logistics Adapter enables you to create an OracleIntegration Cloud Service connection to a specific OracleLogistics Cloud (Transportation Management and Global TradeManagement) instance. The connection can then be used tocreate an integration that calls Oracle Logistics Cloud webservices and exposes a web service that Oracle LogisticsCloud can call.

See Using the Oracle Logistics Adapter.

REST Adapter - Patch verbsupport

You can select the Patch verb (HTTP action) for the endpoint toperform. This action partially updates existing resources (forexample, when you only need to update one attribute of theresource).


REST Adapter - multipartresponse support

Multipart/form-data and multipart/mixed responses aresupported. This feature enables the REST Adapter to downloadartifacts from RESTful web services that return a multipartresponse. Support is implemented on the request and responsemessages for triggers and invokes.


Chapter 1

1-11

Feature Description

REST Adapter - TLS support Transport Layer Security (TLS) version selection for the targetserver is supported. The TLS protocol provides privacy anddata integrity between two communicating computerapplications.


REST Adapter - inboundinvocation in Swagger format

You can view the metadata of an activated REST integrationand then append /swagger to the metadata URL to view theswagger format for the integration. The inbound RESTintegration can then be exposed as a swagger connection.


SOAP Adapter - custom andstandard HTTP and SOAPheader support

You can add SOAP and/or HTTP headers to outbound andinbound requests and handle the responses with headers topropagate back to the user. You can configure standard and/orcustom SOAP/HTTP headers on the SOAP Adapter. Thisenables header configuration for the inbound service andheader propagation to the outbound service. All headerinformation and body elements are encapsulated under a singleelement so that the mapper can display all information.


SOAP Adapter - multiple partmessages in document-styleWSDLs support

Multiple part messages in document-style WSDLs aresupported. The support is provided for both inbound andoutbound adapter configurations.


FTP Adapter When creating the schema file to use from a comma-separatedvalue (CSV) file, you can select to make all elements optional inthe schema file.

See Using the FTP Adapter.

Salesforce Adapter -AllOrNoneHeader parameterenhancements

The AllOrNoneHeader parameter behaves differently based onthe integration flow version. For version 16.4.1 and later, if setto true (that is, selected and there are error elements), it mapsto UnexpectedErrorFault. If set to false (that is, unselected),the adapter returns the whole response even if it contains errorelements along with success elements in the response.

See Using the Salesforce Adapter.

Orchestrated orchestrations • Application event or business object: uses an event or abusiness object to trigger the integration.

• Schedule: uses a schedule to trigger the integrationinstead of an adapter.


for-each actions inorchestrated integrations

You can loop over a repeating element and execute one ormore actions within the scope of the for-each action. Thenumber of loop iterations is based on a user-selected repeatingelement.


Expression Builder XPathenhancements

You can include XPath axis and wildcard expressions in theExpression Builder.


BPEL XPath extensionfunctions support

You can include BPEL XPath extension functions in your datamappings.


Chapter 1

1-12

Feature Description

Exported integration withlookups referenced using thelookupValue function

You can export integrations that include lookups referencedusing the lookupValue function in the Expression Builder.When you import the integration, the referenced lookups arealso imported and are visible in the Expression Builder.


Instance name in the staticlog header

You can obtain the impacted instance name from the diagnosticlogs.


iCal expression support You can schedule integration runs with iCal expressions.


Display of errors andwarnings in orchestratedintegrations

If there are errors or warnings in an orchestrated integration, anERRORS section is displayed on the left side. These errors andwarnings prevent you from activating an integration. You mustfirst resolve these issues to activate an integration.


REST API monitoring anderror enhancements

The REST API provides support for monitoring and errors withthe ability to set start and end times in a query and providedetails for failed instances.

See Oracle Integration Cloud Service REST API.

Compliance with RESTVersion 1.2

REST Version 1.2 is also supported. This version uses adifferent URL.

See Oracle Integration Cloud Service REST API.

Importing map files intoorchestrated integrations

You can import a map file that was previously exported fromthe same integration. This action overwrites the existingmapping file. For example, you can export the map from aspecific integration, edit the XSL file as per a user requirement,save it, and import it back into the same integration.


Creating drafts of integrations You can create a draft of an integration. This provides an easierway to create a copy of an integration. During draft creation,you must update the version of the integration and optionallyupdate the package and description. However, unlike a clonedintegration, you cannot update the integration name oridentifier.


Custom adapter upload andregistration

You can upload and register user-created, custom adapters inOracle Integration Cloud Service. This action makes theadapter visible in the Oracle Public Cloud.


New orchestration video This video shows you how to orchestrate data from a secureFTP endpoint to Oracle ERP Cloud by using the neworchestration pattern in Oracle Integration Cloud Service.

See File-based Integration for ERP Cloud with OracleIntegration Cloud Service on the Oracle Help Center Videostab.

Chapter 1

1-13

http://docs.oracle.com/cloud/latest/intcs_gs/intcs_videos.htm

October 2016

Feature Description

Oracle Utilities Adapter The Oracle Utilities Adapter lets you integrate the OracleUtilities application suite with other Oracle applications such asOracle Enterprise Resource Planning (ERP). You can integrate:

• On-premise Oracle Utilities applications with Oracle Cloudapplications.

• Oracle Utilities Customer Care and Billing with Oracle ERPCloud.

• Oracle Utilities Meter Data Management with OracleOpower.

See Using the Oracle Utilities Adapter.

Oracle Eloqua Cloud Adapter- trigger support

Trigger (inbound) support is provided for the Oracle EloquaCloud Adapter. This enables Oracle Eloqua Cloud to trigger anintegration in Oracle Integration Cloud Service.

See Using the Oracle Eloqua Cloud Adapter.

SOAP Adapter - outboundinvocation of asynchronousservices with WS-addressing

Asynchronous callback response support is provided in theinvoke (outbound) direction. This feature is supported if yourWSDL includes a port type with Callback or Response in theportType value and an operation with Response in theoperation name value. You must design another integrationflow to receive the callback response.

See Using the SOAP Adapter

SOAP Adapter over JCA -default transfer mode

SOAP over JCA is the default transport mode for the SOAPadapter, replacing the HTTP transport mode. All inbound andoutbound SOAP sources in Oracle Integration Cloud Service(for example, enrichments, target and routing points, and so on)use the JCA transport protocol.


REST APIs /status and /usage

The /status API can be queried for system health status(runtime, storage, messaging, and security services). The /usage API returns metrics for system design-time (adapters,agent, application instances, lookups, integrations, packages,and runtime - messages and messaging system).

See REST API for Integration Cloud Service.

Cloud Adapter Guides The cloud adapters that previously appeared in Using OracleIntegration Cloud Service have been moved to their ownseparate guides:

• Using the NetSuite Adapter• Using the Oracle CPQ Cloud Adapter• Using the Oracle Eloqua Cloud Adapter• Using the Oracle ERP Cloud Adapter• Using the Oracle HCM Cloud Adapter• Using the Oracle Messaging Cloud Service Adapter• Using the Oracle RightNow Cloud Adapter• Using the Oracle Sales Cloud Adapter• Using the REST Adapter• Using the Salesforce Adapter• Using the SOAP Adapter

Chapter 1

1-14

Feature Description

New orchestration video A new video describing orchestrated integrations is available inthe Videos tab of the Oracle Help Center.

See Working with Orchestrated Integrations in OracleIntegration Cloud Service on the Oracle Help Center Videostab.

August 2016

Feature Description

Scalar variable support You can assign values to scalar variables in orchestratedintegrations using the Expression Builder. Variableassignments can be of great complexity, such as usingassignments in switch activities and in maps.

See Creating an Orchestrated Integration of Using OracleIntegration Cloud Service.

Design-time incident reports You can report and download incidents for problematicissues that occur during design time (for example, beingunable to open an integration, the failure of connectiontesting, or the failure of artifact regeneration).

See Reporting Incidents of Using Oracle Integration CloudService.

Trace logging level tuning You can set logging levels to more granular trace levels todebug issues.

See Setting Logging Levels of Using Oracle IntegrationCloud Service.

Oracle JD Edwards EnterpriseOneAdapter- outbound integrationsupport

Oracle JD Edwards EnterpriseOne Adapter supports JavaEE Connector Architecture (JCA) and web servicestandards for creation of open and reusable service-oriented applications (SOA). The Oracle JD EdwardsEnterpriseOne Adapter uses the JD Edwards Gen JavaAPI to synchronously invoke JD Edwards transactions. Theadapter listener asynchronously receives business eventsfrom the JD Edwards application system. Requests areplaced in the JDE interface tables and pushed to theadapter listener.

See Using the Oracle JD Edwards EnterpriseOne Adapter.

Oracle Advanced Queuing (AQ)Adapter - inbound integrationsupport

The Oracle AQ Adapter provides a mechanism forbidirectional, asynchronous communication betweenparticipating applications. The Oracle AQ Adapterproduces Oracle Advanced AQ messages. The dequeueoperation is exposed as a JCA inbound interaction. TheOracle AQ Adapter supports normalized properties fordequeue operations.

See Using the Oracle Advanced Queuing (AQ) Adapter.

SAP Ariba Adapter - outboundintegration support

SAP Ariba is a cloud-based B2B application that connectsbuyers and sellers. The application allows sellers tomanage their catalogs, bids, purchases, and invoices andprovides buyers with the ability to search for suppliers,negotiate savings, procure goods and services, and trackspending.

See Using the SAP Ariba Adapter.

Chapter 1

1-15

http://docs.oracle.com/cloud/latest/intcs_gs/intcs_videos.htm

Feature Description

Concur Adapter - outboundintegration support

The Concur Adapter allows you to quickly import expensecategories, employee data, customers, classes, and jobs.Use the Concur Adapter to eliminate duplicate manual dataentry and achieve faster data synchronization.

See Using the Concur Adapter.

Oracle FTP Adapterenhancements

The following enhancements are provided:

• You can now upload the Pretty Good Privacy (PGP)public keys for encrypting and decrypting the payloadfrom the Connections page.

See Configuring Connection Security of Using the FTPAdapter.

• The delete and read file operations are supported inorchestrated integrations.

See Adding the FTP Adapter Connection to anOrchestrated Integration of Using the FTP Adapter.

Oracle E-Business Suite Adapter -support for concurrent programsas invokes (targets)

The Oracle E-Business Suite Adapter supports outboundintegrations with concurrent programs from OracleIntegration Cloud Service when adding the Oracle E-Business Suite Adapter as invoke (target) connections.

In addition to PL/SQL REST services, concurrent programsare now available as REST services for invocation fromOracle Integration Cloud Service.


Lookup function support You can create variable assignments in orchestratedintegrations that use lookups and the lookupValuefunction.

See subsection Using Lookups in Variable Assignments of Creating an Orchestrated Integration of Using OracleIntegration Cloud Service.

REST API enhancements REST APIs are provided for the following:

• Error pages• Message resubmission and discardingSee REST API for Integration Cloud Service.

Email notifications You can notify users by email when a service failureoccurs (for example, the runtime or storage service isdown) or with hourly or daily reports about the totalmessages received, total messages processed, successfulmessages, failed messages, and successful message rate.

See Sending System Status Reports and Service FailureAlerts by Email of Using Oracle Integration Cloud Service.

Error resubmission, messageaborts, and payload access inorchestrated integrations

You can resubmit errors, abort messages, and accesspayloads in orchestrated integrations.

See Managing Errors of Using Oracle Integration CloudService.

Multiple selection filtering in theOracle Mapper and ExpressionBuilder

When using the filter utility in the Oracle Mapper or theExpression Builder, you can select to filter both requiredand custom fields together.

See Using the Oracle Mapper and Using Oracle IntegrationCloud Service.

Chapter 1

1-16

Feature Description

Build Lookup Function wizardsupport in the Oracle Mapper

The Build Lookup Function wizard can be invoked in theOracle Mapper. In previous releases, this wizard was onlysupported in the Expression Builder.


Adapter endpoint edits do notnecessarily delete maps

When editing adapter endpoint information in anintegration, the mappings are not necessarily deleted. Forexample, minor edits such as changing the endpointdescription do not delete the existing mappings. Majoredits such as changing the selected business objects oroperations do delete the mappings. In either case, you arealways prompted to confirm before this action occurs.

See Editing the Endpoint Information in an Integration ofUsing Oracle Integration Cloud Service.

REST Adapter enhancements The following enhancements are provided:

• Asynchronous inbound support• Trigger role-related changes in the Connections pageSee Oracle REST Adapter Capabilities of Using OracleIntegration Cloud Service.

Oracle Sales Cloud Adapter The Oracle Sales Cloud Adapter inbound endpoint WSDLinterface supports the use of concrete values for custombusiness objects in the WSDL in place of xsd:anyTypeparameters. This feature enables you to use the groovyscript editor to create scripts to invoke integrations.

See Oracle Sales Cloud Capabilities of Using OracleIntegration Cloud Service.

Oracle SOAP Adapter The following enhancements are provided:

• Support for the Transport Layer Security (TLS) versionof the target server. The TLS protocol provides privacyand data integrity between two communicatingcomputer applications.

• Support for suppressing the version of the timestampin the WS-Security header. If you select No, clientsare expected to send a timestamp in the WS headerwith the request.

• Support for utilizing 16.3.3 SOAP Adapter runtimefunctionality or 16.2.5 SOAP Adapter runtimefunctionality in an integration. You configure thisoption on the Basic Info page of the Adapter EndpointConfiguration Wizard.

• Support for disabling SOAP action validation forinbound requests on the Operations page of theAdapter Endpoint Configuration Wizard. This is usefulfor environments in which your WSDL includes customcode and you want to bypass validation.

Oracle Database Adapter The Oracle Database Adapter is certified to connect toOracle Database Cloud Service through the on-premisesagent. You install the on-premises agent on the OracleDatabase Cloud Service instance, then provide OracleDatabase Cloud Service instance-specific connectionparameters on the Connections page.

See About Oracle Database Adapter Capabilities of UsingOracle Database Adapter.

Chapter 1

1-17

Feature Description

Designer landing page updates The landing pages in Oracle Integration Cloud Servicehave been updated with a new look and feel.

June 2016

Feature Description

Orchestration enhancements You can create synchronous, asynchronous, and fire-and-forget (no response) orchestrated integrations inOracle Integration Cloud Service that use Oracle BPELProcess Manager orchestration capabilities. The followingenhancements are provided with this release:• End-to-end support for asynchronous and fire-and-

forget triggers.• Support for callback activities (to end an integration

and respond back to the trigger) and end activities (toend an integration without responding back to thetrigger) in asynchronous integrations.

• Tracking Details page support.• Enhancements for adjusting the layout of the

integration in the canvas.

See Creating an Orchestrated Integration and TrackingBusiness Identifiers in Integrations During Runtime ofUsing Oracle Integration Cloud Service.

Scheduler Submit Now URL link You can create ad-hoc runs of integrations on which aschedule has been defined from the Integrations page.This is useful for when you want to test a scheduledintegration.

See Creating Ad-Hoc Integration Runs of Using OracleIntegration Cloud Service.

Connection role Select the role (direction) in which to use a connection(trigger, invoke, or both). Only the roles supported by theselected adapter are displayed for selection. When youselect a role, only the connection properties and securitypolicies appropriate to that role are displayed on theConnections page.

See Creating a Connection of Using Oracle IntegrationCloud Service.

On-premises Oracle IntegrationCloud Service

The following enhancements are provided:• Activating and running scheduled integrations.• Using the Oracle Database, MySQL, and Microsoft

SQL Server Adapters.

See Using On-Premises Integration Cloud Service ofUsing Oracle Integration Cloud Service.

Chapter 1

1-18

Feature Description

Diagnostics enhancements The following diagnostic enhancements are provided:• Viewing integrations by their adapter types on the

Dashboard page.• Improved Dashboard page monitoring.• Diagnostic log downloads on the Dashboard page,

Runtime Health page, and Integrations page whenintegration activation fails.

See Monitoring Integration Cloud Services of UsingOracle Integration Cloud Service.

Lookup creation – domain namesupport

You can now specify a domain name when designing alookup to create reusable tables that map the differentterms used to describe the same item across yourapplications.

See Adding Adapters or Domain Names to a Lookup ofUsing Oracle Integration Cloud Service.

User interface improvements The following user interface enhancements are provided:• Integration activation and deactivation progress bar.• Maintenance mode message to indicate that an

instance is currently undergoing maintenance (suchas an upgrade to a new release).

• Reusable source tree filter when creating businessidentifiers for tracking.

• Web Console toolbar look and feel improvementsand enhanced search filtering patterns.

Oracle RightNow Cloud Adapter -custom attributes support

Support is provided for custom attributes in businessobjects to make use of the Oracle RightNow application’ssupport for custom attributes.

See Oracle RightNow Cloud of Using Oracle IntegrationCloud Service.

REST Adapter enhancements The following enhancements are provided:• Extensibility support for multiple OAuth providers:

Use the extensibility framework of the REST Adapterto access the OAuth-protected resources ofendpoints. This framework enables you to accessendpoints that have implemented their own variationsof OAuth.

• Outbound support for Swagger and RESTful APIModeling Language (RAML) endpoints.

• Support for integrating on-premises REST APIs withOracle Integration Cloud Service through use of theon-premises agent.

• Support for multipart attachments for invoke(outbound) requests.

See REST Adapter of Using Oracle Integration CloudService.

Oracle Responsys Adapter -outbound integration support

Use the Oracle Responsys Adapter to collect andorganize customer data from disparate sources, distributemarketing information to specific audiences, and interactwith customers in real time. You can orchestrate andcommunicate offers to customers through web sites,mobile devices, social media, direct mail, and email.

See Using the Oracle Responsys Adapter.

Chapter 1

1-19

Feature Description

Twilio Adapter - outboundintegration support

The Twilio Adapter provides the following benefits:• Enables developers to embed voice, messaging, and

video into software applications.• Brings voice, video, SMS, MMS, and real-time IP

communications together into a single platform,available from one common API.

• Removes the requirement for separate equipment,protocols, and software and enables developers tofocus on building solutions for the task.

• Provides a range of developer tools, helper libraries,documentation, and support services to help resolveissues quickly.

See Using the Twilio Adapter.

Oracle E-Business Suite Adapter -support for business events andXML Gateway messages astriggers

The Oracle E-Business Suite Adapter enables you tointegrate with business events and XML Gatewaymessages as inbound integrations in Oracle IntegrationCloud Service when adding the Oracle E-Business SuiteAdapter as a trigger connection.

When a business event is raised in Oracle E-BusinessSuite at runtime, the Oracle E-Business Suite Adapterpropagates the event details from Oracle E-BusinessSuite to Oracle Integration Cloud Service.

When an XML Gateway outbound transaction occurs inOracle E-Business Suite at runtime, this message isenqueued to the ECX_OUTBOUND queue as an existingXML Gateway process. Oracle Transport Agent (OTA)from Oracle XML Gateway fetches the message from thequeue and posts it to Oracle Integration Cloud Service.


ServiceNow Adapter - inboundintegration support

Support is provided for configuring the ServiceNowAdapter as a trigger in an integration.

See Using the ServiceNow Adapter.

MySQL Adapter - inboundintegration support

Support is provided for configuring the MySQL Adapter asa trigger in an integration. Distributed polling andmultithreading support are also provided.

See Using the MySQL Adapter.

Oracle Siebel Adapterenhancements

The following enhancements are provided:• IP 215 certification• TLS support

See Using the Oracle Siebel Adapter.

Oracle Database Adapterenhancements

Support is provided for distributed polling andmultithreading, on-premises agent certification, andOracle WebLogic Server Work Manager configuration.

See Using the Oracle Database Adapter.

Microsoft SQL Server Adapterenhancements

Support is provided for distributed polling andmultithreading.See Using the Microsoft SQL Server Adapter.

Chapter 1

1-20

Feature Description

On-premises agent upgrade Upgrade patching is enhanced, including automaticallydownloading the upgrade patch when performing theupgrade.

See Upgrading the On-Premises Agent from Release16.2.1 to Release 16.2.5 of Using Oracle IntegrationCloud Service.

Expression Builder and Mapperenhancements

The following enhancements are provided:• Using the Source tree filter to search for required

fields in the Expression Builder, Mapper, andBusiness Identifier Tracker.

• Support for substitution groups in schemas.• Support for loading multiple tree nodes.

See Creating Routing Expression Logic in BothExpression Mode and Condition Mode and AssigningBusiness Identifiers of Using Oracle Integration CloudService and About Mapping of Using the Oracle Mapper.

lookupValue Build Lookup Functionwizard in the Expression Builder

You can create the parameter values for the lookupValuefunction in the Expression Builder with the Build LookupFunction wizard. This wizard enables you to define thelookup table, source column, target column, and defaultvalue to use in the function.

See Creating the lookupValue Function in the ExpressionBuilder of Using Oracle Integration Cloud Service.

Error handling - message recoverystatus

You can search for and view the status of failedmessages that have been submitted for recovery.

See Viewing the Status of Message Recovery of UsingOracle Integration Cloud Service.

Chapter 1

1-21

what's new for oracle integration cloud services new for oracle integration cloud service ......

Documents