Contents. Oracle Oracle Integration Cloud Service, 17.3

Contents

Preface

Audience

Documentation Accessibility

Related Resources

Conventions

1

Getting Started with Oracle Integration Cloud Service

Running the Sample Integrations

Running the Echo Sample

Running the Hello World Sample

Running the Hello World Invoke Sample

Running the Hello World Data Map Invoke Sample

Running the File Transfer Sample

Running the Incident Details from Service Cloud Sample

About Oracle Integration Cloud Service

About Oracle Integration Cloud Service Concepts

About Oracle Integration Cloud Service Connections

Connection Creation

About Oracle Integration Cloud Service Integrations

Related Topics

About Mappings

Mapping Request Data Between Applications

Mapping Response Data Between Applications

About Mapping Multiple Sources to a Target

About Oracle Integration Cloud Service Enrichments

About Oracle Integration Cloud Service Lookups

About Oracle Integration Cloud Service Packages

About Agents and Integrations Between On-Premises Applications and Oracle

Integration Cloud Service

About Monitoring

About Error Management

About Business Identifiers for Tracking Fields in Messages

1-27

1-28

1-28

1-31

1-31

1-31

1-33

1-33

1-14

1-18

1-23

1-27

1-1

1-2

1-5

1-9

1-34

1-35

1-36

1-36

1-37

1-40

1-40

1-41

x

xii

x x

iii

Starting Oracle Integration Cloud Service

Navigating Oracle Integration Cloud Service

About Oracle Integration Cloud Service Roles and User Accounts

1-42

1-43

1-46

2

Developing Integrations with Oracle Integration Cloud Service

Typical Workflow for Creating Integrations with Oracle Integration Cloud Service

Creating Connections

Creating a Connection

Adding a Contact Email

Configuring Connection Properties

Configuring Connection Security

Testing the Connection

Editing a Connection

Cloning a Connection

Deleting a Connection

Unlocking a Connection

Refreshing Integration Metadata

Managing Security Certificates

Uploading an SSL Certificate

Updating or Deleting an SSL Certificate

Creating Integrations

Creating an Integration

Understanding Integration Patterns

Importing a Prebuilt Integration

Adding a Trigger (Source) Connection

Adding an Invoke (Target) Connection

Creating Orchestrated Integrations

Creating an Orchestrated Integration

Defining Inbound Triggers and Outbound Invokes

Defining Ad-Hoc Mappings

Importing a Map File into an Orchestrated Integration

Adding Actions to an Orchestrated Integration

Using XPath Axis and Wildcard Expressions in the Expression Builder

Using Lookups in Variable Assignments

Defining Fault Aggregation in Parallel Processing Scenarios

Assigning Business Identifiers for Tracking Fields

Displaying Errors and Warnings in an Integration

Creating an Integration to Publish Messages to Oracle Integration Cloud

Service

Creating an Integration to Subscribe to Oracle Integration Cloud Service

Adding Request and Response Enrichments

2-26

2-28

2-29

2-60

2-61

2-63

2-65

2-65

2-13

2-15

2-16

2-17

2-18

2-20

2-21

2-23

2-10

2-10

2-11

2-12

2-8

2-8

2-9

2-9

2-4

2-5

2-7

2-7

2-1

2-2

2-3

2-4

2-66

2-67

2-69

iv

Deleting Request and Response Enrichments

Creating Routing Paths for Two Different Invoke Endpoints in Integrations

Creating Routing Expression Logic in Both Expression Mode and Condition

Mode

Deleting Routing Paths

Editing the Endpoint Information in an Integration

Mapping Data

Creating Mappings

Modifying Mappings

Deleting All Mappings

Mapping Faults

Adding Customized Mappings to Prebuilt Integrations

Removing Customized Mappings from Prebuilt Integrations

Regenerating a WSDL File for Integrations

Creating Lookups

Creating a Lookup

Adding Adapters or Domain Names to a Lookup

Cloning a Lookup

Deleting a Lookup

Creating the lookupValue Function

Accessing the Build Lookup Function Wizard

Selecting the Lookup Table

What You Can Do from the Select Lookup Table Page

What You See on the Select Lookup Table Page

Selecting the Source and Target Columns

What You Can Do from the Source and Target Columns Page

What You See on the Source and Target Columns Page

Specifying the Default Value

What You Can Do from the Default Value Page

What You See on the Default Value Page

Reviewing Your Lookup Table Selections

What You Can Do from the Lookup Table Summary Page

What You See on the Lookup Table Summary Page

Importing Map Files

Importing a Map File into Oracle JDeveloper

Importing a Map File into Oracle Integration Cloud Service

Importing and Exporting Components

Exporting an Integration

Importing an Integration

Exporting a Lookup

Importing a Lookup

2-73

2-73

2-99

2-99

2-99

2-99

2-99

2-100

2-100

2-101

2-96

2-97

2-97

2-98

2-98

2-98

2-98

2-98

2-102

2-103

2-103

2-104

2-104

2-105

2-89

2-91

2-92

2-94

2-95

2-95

2-96

2-96

2-77

2-84

2-85

2-86

2-87

2-88

2-88

2-88

v

Assigning Business Identifiers for Tracking Fields in Messages

Assigning Business Identifiers

Deleting Business Identifiers

Managing Packages

Viewing the Integrations in a Package

Importing a Package

Exporting a Package

Updating a Package

Deleting a Package

Managing Agent Groups and the On-Premises Agent

Creating an Agent Group

Downloading and Running the On-Premises Agent Installer

Creating a Connection with an Agent Group

Viewing and Editing Agent Groups

Deleting an Agent Group

Updating Property Values

Upgrading the On-Premises Agent to Release 17.4.1

Scheduling Integration Runs

Creating an Integration Schedule

Creating Parameters in Scheduled Integrations

Starting and Pausing an Integration Schedule

Viewing Past and Present Integration Runs

Viewing Future Runs

Editing an Integration Schedule

Deleting an Integration Schedule

Monitoring Integration Runs

Creating Ad-Hoc Integration Runs Using the REST API

Using Libraries to Manage Functions for Integrations

Registering an API Library

Viewing Library Details

Editing Library Details

Determining Which Integrations Use a Library Function

Deleting a Library

Downloading a Library File

Using Library Functions in Orchestrations

Connecting to Oracle Mobile Cloud Service

Connecting to Oracle API Platform Cloud Service

3

Administering Oracle Integration Cloud Service

Monitoring Integrations

2-131

2-131

2-132

2-133

2-133

2-134

2-135

2-135

2-120

2-122

2-123

2-126

2-127

2-128

2-129

2-130

2-136

2-136

2-136

2-136

2-136

2-109

2-109

2-110

2-110

2-118

2-118

2-119

2-119

2-105

2-106

2-107

2-107

2-107

2-108

2-108

2-109

3-1

vi

Viewing the Dashboard

Viewing the Activity Stream

Viewing System Health

Viewing Design-Time Metrics

Monitoring Integrations

Monitoring Agents

Managing Integrations

Activating an Integration

Deactivating an Integration

Modifying an Integration

Viewing the Trigger, Invoke, and Enrichment Details of an Integration

Cloning an Integration

Creating a Draft of an Integration

Deleting an Integration

Unlocking an Integration

Downloading Generated Artifacts for an Integration

Viewing the Contents of an Incomplete Integration

Reactivating Integrations After Instance Upgrade to View the Latest Business

Identifier Tracking Behavior

Filtering the Display of Integrations By Type

Changing the Time Zone

Managing an Integration as an API with Oracle API Platform Cloud Service

Creating a New API in Oracle API Platform Cloud Service Using an

Integration

Grouping an Integration in an API in Oracle API Platform Cloud Service

Ungrouping an Integration from an API

Managing Errors

Managing Errors by Integration

Viewing Errors By Integration Name Over a Specific Time Period

Discarding Errors by Integration Name

Managing Errors by Connection

Viewing Errors By Connection Name or the Total Error Count Over a

Specific Time Period

Discarding Errors by Connection Name

Managing Errors by Integration Instance

Viewing Errors by Integration Name, Instance Identifier, Location, or Time of

Occurrence Over a Specific Time Period

Viewing the Integration Instance in Which Errors Occurred

Discarding Errors by Integration Instance

Viewing Specific Error Details

Viewing the Audit Trail of a Failed Integration Instance

Viewing Business Identifiers in Failed Integration Instances

3-16

3-16

3-16

3-17

3-17

3-18

3-19

3-20

3-21

3-21

3-22

3-22

3-23

3-23

3-24

3-25

3-26

3-27

3-28

3-29

3-30

3-11

3-12

3-13

3-13

3-14

3-14

3-15

3-15

3-15

3-7

3-8

3-9

3-9

3-1

3-3

3-4

3-6

vii

Viewing the Message Payload of a Failed Integration Instance

Resubmitting Failed Messages

Viewing the Status of Message Recovery

Managing Business Identifiers for Tracking Fields in Messages

Tracking Business Identifiers in Integrations During Runtime

Tracking Business Identifiers in Integrations in Which Routing Paths Are

Defined

Filtering the Display of Business Identifiers in Integrations

Viewing Preinstalled Adapters and Registering Custom Adapters

Sending Service Failure Alerts, System Status Reports, and Integration Error

Reports by Notification Emails

Setting Logging Levels and Downloading Diagnostic Logs

Reporting Incidents

Purging and Retaining Data in the Database

4

Adapter Configuration Reference

Configuring Basic Information Properties

What You Can Do from the Basic Info Page

What You See on the Basic Info Page

Configuring Salesforce Properties

Understanding Salesforce Constraints

Configuring Salesforce Trigger Outbound Messaging Properties

What You Can Do from the Salesforce Trigger Outbound Messaging Page

What You See on the Salesforce Trigger Outbound Messaging Page

Configuring Salesforce Trigger Response Properties

What You Can Do from the Salesforce Trigger Response Page

What You See on the Salesforce Trigger Response Page

Configuring Salesforce Trigger Callback Response Properties

What You Can Do from the Salesforce Trigger Callback Response Page

What You See on the Salesforce Trigger Callback Response Page

Configuring Salesforce Invoke Basic Information Properties

What You Can Do from the Salesforce Invoke Basic Info Page

What You See on the Salesforce Invoke Basic Info Page

Configuring Salesforce Invoke Operation Properties

What You Can Do from the Salesforce Invoke Operations Page

What You See on the Salesforce Invoke Operations Page

Configuring Salesforce Invoke Header Properties

What You Can Do from the Salesforce Invoke Headers Page

What You See on the Salesforce Invoke Headers Page

Configuring Salesforce Invoke Custom Operations Properties

What You Can Do from the Salesforce Invoke Custom Operations Page

4-5

4-5

4-6

4-6

4-4

4-4

4-4

4-5

4-3

4-3

4-3

4-3

4-1

4-1

4-2

4-2

4-10

4-10

4-10

4-13

4-13

4-7

4-7

4-7

4-9

3-31

3-32

3-34

3-35

3-35

3-37

3-38

3-39

3-41

3-43

3-44

3-44

viii

What You See on the Salesforce Invoke Custom Operations Page

Performing Salesforce Adapter Postconfiguration Tasks

Configuring Trigger Oracle Integration Cloud Service Messaging

What You Can Do from the Trigger Oracle Integration Cloud Service Messaging

Page

What You See on the Trigger Oracle Integration Cloud Service Messaging Page

Reviewing Configuration Values on the Summary Page

What You Can Do from the Summary Page

What You See on the Summary Page

5

Using On-Premises Oracle Integration Cloud Service

Downloading and Running the On-Premises Oracle Integration Cloud Service

Installer

Managing Users and Roles

Creating Users and Assigning Roles

Editing On-Premises Users

Deleting On-Premises Users

5-1

5-8

5-8

5-10

5-11

4-13

4-14

4-14

4-15

4-15

4-15

4-15

4-16

ix