Preface

19

Structure of the Book

20

Sample Applications

23

Who This Book Is For

24

1 Introduction to SAP Cloud Platform Integration

31

1.1 The Role of SAP Cloud Platform Integration in a Cloud-Based Strategy

32

1.2 Use Cases

35

1.2.1 Point-to-Point versus Mediated Communication

36

1.2.2 Message-Based Process Integration

36

1.2.3 Cloud-to-Cloud Integration

38

1.2.4 Cloud-to-On-Premise Integration

39

1.2.5 On-Premise-To-On-Premise Integration

40

1.2.6 Hybrid Usage of Cloud and On-Premise Integration Solutions

41

1.3 Capabilities

42

1.3.1 Integration Platform-as-a-Service

43

1.3.2 Message Processing Step Types (Integration Capabilities)

44

1.3.3 Connectivity Options

45

1.3.4 Prepackaged Integration Content

48

1.3.5 Security Features

48

1.3.6 High Availability

49

1.3.7 Integration Design and Monitoring Tools

50

1.4 Editions

50

1.5 Summary

51

2 Getting Started

53

2.1 Architecture Overview

53

2.1.1 Virtual and Clustered Integration Platform

54

2.1.2 Detailed Structure of a Cluster

59

2.1.3 Secure Communication

63

2.1.4 Implementation of Message Flows

63

2.1.5 Architecture Summary

68

2.2 Tools and Processes

71

2.2.1 Tools

71

2.2.2 Processes

78

2.3 Running Your First Integration Scenario

80

2.3.1 Demo Scenario and Landscape

80

2.3.2 Prerequisites

81

2.3.3 Set Up the Landscape and the Technical Connections

81

2.3.4 Develop the Integration Flow

84

2.3.5 Creating and Deploying a User Credentials Artifact

99

2.3.6 Import Certificate Required by the Mail Server into Keystore

101

2.3.7 Send the SOAP Message

103

2.3.8 Monitor the Message

106

2.4 Summary

111

3 Integration Content Catalog

113

3.1 Introduction to the Integration Content Catalog

113

3.2 Terms and Conditions of Using Prepackaged Integration Content

117

3.2.1 Quick Configure versus Content Edit

117

3.2.2 Notify about Update (Manual Update)

118

3.2.3 Automatic Update

120

3.3 Consuming Prepackaged Content

121

3.3.1 Search in the Integration Content Catalog

122

3.3.2 Import Prepackaged Integration Content

127

3.3.3 Modify or Configure the Integration Package

129

3.3.4 Deploy Content

136

3.4 Prepackaged Content Provided by SAP

137

3.4.1 Content for SAP SuccessFactors

138

3.4.2 Content for SAP Cloud for Customer

140

3.4.3 Content for Integrating with SAP C/4HANA

141

3.4.4 Content for Integrating with the Ariba Network

144

3.4.5 Content for Globalization Scenarios

146

3.5 Creating Your Own Content Package

147

3.6 Summary

150

4 Basic Integration Scenarios

153

4.1 Working with SAP Cloud Platform Integration’s Data Model

153

4.1.1 Message Processing: The Apache Camel Framework

155

4.1.2 Exercise: Working with Camel’s Message Model

158

4.1.3 Connecting and Configuring a Sender with an Integration Flow

161

4.1.4 Adding and Configuring Steps in the Integration Flow

164

4.1.5 Checking Configuration Using the Problems View

168

4.1.6 Running the Integration Flow

170

4.1.7 Troubleshooting

173

4.2 Using Externalization to Enable Easy Reuse of the Integration Flow

175

4.2.1 Externalize

176

4.2.2 Configure and Run the Scenario

181

4.3 Content Enrichment by Invoking an OData Service

183

4.3.1 The Target Scenario

184

4.3.2 Invoking an OData Service

185

4.3.3 Configuring the OData Connection

187

4.3.4 Creating the Resource Path Using the Query Editor

190

4.3.5 Using the Content Enricher Step

195

4.4 Working with Mappings

201

4.4.1 The Scenario

203

4.4.2 Adding and Using Resources via the Resources View

205

4.4.3 Applying the Mapping Step in the Message Processing Chain

210

4.4.4 Using Value Mapping to Enhance Your Scenario

218

4.5 Defining and Providing an OData Service

224

4.5.1 The Target Scenario

224

4.5.2 Providing an OData Service

225

4.6 Working with an Aggregator

238

4.6.1 Sample Scenario

240

4.6.2 Sending Messages via SoapUI

243

4.6.3 Viewing the Aggregated Message

249

4.7 Summary

250

5 Advanced Integration Scenarios

251

5.1 Message Routing

251

5.1.1 The Scenario

252

5.1.2 Configuration of the Content-Based Router

254

5.1.3 Running the Content-Based Router Scenario

259

5.2 Working with Lists

262

5.2.1 The Scenario

262

5.2.2 Configuring the Integration Flow

264

5.2.3 Running the Integration Flow

275

5.2.4 Enriching Individual Messages with Additional Data

279

5.3 Asynchronous Message Handling

281

5.3.1 Synchronous versus Asynchronous Communication from SAP Cloud Platform Integration’s Perspective

283

5.3.2 Adding an Asynchronous Receiver

295

5.3.3 Routing a Message to Multiple Receivers Using the Multicast Pattern

299

5.4 Reliable Messaging Using the JMS Adapter

308

5.4.1 Asynchronous Decoupling of Inbound Communication

308

5.4.2 Configure Retry for Multiple Receivers

322

5.4.3 Configure Explicit Retry with Alternative Processing

330

5.5 Summary

338

6 Special Topics in Integration Development

341

6.1 Timer-Based Message Transfer

341

6.1.1 The Scenario

342

6.1.2 Configuring a Timer-Based Integration Flow

343

6.1.3 Running the Integration Flow

348

6.2 Using Dynamic Configuration via Headers or Properties

349

6.2.1 An Integration Flow with a Dynamically Configured Attribute

351

6.2.2 Monitoring Dynamically Configured Attributes at Runtime

356

6.2.3 Using Predefined Headers and Properties to Retrieve Specific Data Provided by the Integration Framework

360

6.3 Structuring Large Integration Flows Using Local Processes

365

6.3.1 Taking Hold of Complexity by Modularization

366

6.3.2 Configuring the Collaboration between Parent and Child Processes

368

6.3.3 Using Exception Subprocesses

375

6.4 Connecting Integration Flows Using the ProcessDirect Adapter

378

6.4.1 Use Cases for the ProcessDirect Adapter

380

6.4.2 A Simple Example

381

6.4.3 Dynamic Endpoint Configuration with the ProcessDirect Adapter

383

6.5 Versioning and Migration of Integration Flows

388

6.5.1 Integration Flow Component Versions

388

6.5.2 Upgrading an Integration Flow Component

391

6.5.3 Downgrading Integration Content for SAP Process Orchestration

395

6.6 Transporting Integration Packages to Another Tenant

403

6.6.1 Manually Transporting Integration Packages

403

6.6.2 Transporting Integration Packages Using CTS+

405

6.6.3 Transporting Integration Packages Using the Cloud-Based Transport Management Service

405

6.7 Using the Adapter Development Kit

411

6.7.1 The Adapter Development Kit (ADK)

411

6.7.2 Installing the Adapter Development Kit

412

6.7.3 Developing a Sample Adapter

415

6.8 Best Practices for Integration Flow Development

427

6.9 Summary

429

7 B2B Integration with SAP Cloud Platform Integration

431

7.1 B2B Capabilities in SAP Cloud Platform Integration: Overview

432

7.2 Defining Interfaces and Mappings in the Integration Content Advisor

434

7.2.1 Create Message Implementation Guidelines

435

7.2.2 Configure Mapping Guidelines

447

7.2.3 Generate the Runtime Content

450

7.3 Configure a B2B Scenario with AS2 Sender and IDoc Receiver Adapters

451

7.3.1 Create an Integration Flow Using a Template

451

7.3.2 Configure AS2 Sender Channel to Receive EDI Messages

460

7.3.3 Add an IDoc Receiver

466

7.3.4 Configure Acknowledgement Handling

471

7.4 Using the Partner Directory for Partner-Specific Configuration Data

482

7.4.1 Concept of Partner Directory

482

7.4.2 Use a Receiver Endpoint URL Dynamically in the Integration Flow

484

7.4.3 Store the Partner-Specific Endpoint URL in Partner Directory

488

7.5 Summary

492

8 SAP Cloud Platform Integration Operations

493

8.1 Operations: Overview

494

8.2 Monitoring Integration Content and Message Processing

496

8.2.1 Manage Integration Content

498

8.2.2 Log Configuration

502

8.2.3 Monitor Message Processing

503

8.2.4 Managing Tiles

519

8.3 Manage Security

522

8.3.1 Maintain Security Material

524

8.3.2 Manage the Keystore

527

8.3.3 Maintain Certificate-to-User Mappings

536

8.3.4 Test Outbound Connectivity

538

8.4 Manage Temporary Data

549

8.4.1 Monitor Data Stores

550

8.4.2 Monitor Variables

553

8.4.3 Maintain Message Queues

555

8.4.4 Maintain Number Ranges

563

8.5 Access Logs

565

8.5.1 Monitor Audit Log

566

8.5.2 Check System Log Files

568

8.6 Manage Locks

570

8.7 Summary

573

9 Application Programming Interfaces

575

9.1 Introduction

575

9.2 Java APIs Provided by SAP Cloud Platform Integration

576

9.3 Using the Java API in a User-Defined function

579

9.4 Using the Script Step

584

9.4.1 Target Scenario

585

9.4.2 Enhancing the Integration Flow

586

9.5 OData API

590

9.5.1 SAP API Business Hub

594

9.5.2 Cross-Site Request Forgery Token Handling

602

9.5.3 Monitoring Message Flows Using the API

605

9.5.4 Managing Deployed Integration Content Using the API

611

9.5.5 Managing Log Files Using the APIs

614

9.5.6 Managing Message Store Entries Using APIs

616

9.5.7 Managing Security Material Using the API

620

9.5.8 Managing the Partner Directory Using the API

621

9.6 Using SAP Cloud Platform Integration with SAP Cloud Platform API Management

623

9.6.1 Establish a Connection between SAP Cloud Platform Integration and SAP API Management

625

9.6.2 Provision Application Programming Interfaces

629

9.6.3 Consume the Application Programming Interface

638

9.7 Summary

641

10 SAP Cloud Platform Integration Security

643

10.1 Technical System Landscape

644

10.1.1 Architecture

644

10.1.2 Network Infrastructure

648

10.1.3 Data Storage Security

650

10.1.4 Data Protection and Privacy

651

10.1.5 Physical Data Security

654

10.2 Processes

655

10.2.1 Software Development Process

655

10.2.2 Provisioning and Operating SAP Cloud Platform Integration Clusters by SAP

656

10.2.3 Setting Up Secure Connections between the Tenant and Remote Systems

657

10.3 User Administration and Authorization

657

10.3.1 Technical Aspects of User Management

658

10.3.2 Personas, Roles, and Permissions

658

10.3.3 Managing Users and Authorizations for a SAP Cloud Platform Integration Subaccount

660

10.4 Data and Data Flow Security

665

10.4.1 Basic Cryptography in a Nutshell

666

10.4.2 Transport-Level Security Options

671

10.4.3 Authentication and Authorization

673

10.4.4 Securely Connecting a Customer System to SAP Cloud Platform Integration (through HTTPS)

683

10.4.5 Setting Up a Scenario Using OAuth with the Twitter Adapter

692

10.4.6 Message-Level Security Options

699

10.4.7 Designing Message-Level Security Options in an Integration Flow

703

10.5 Keystore Management

721

10.5.1 Using X.509 Security Material for SAP Cloud Platform Integration

722

10.5.2 Managing Security Material in the Tenant Keystore

725

10.5.3 Managing the Lifecycle of Keys Provided by SAP

729

10.6 Summary

736

11 Productive Scenarios Using SAP Cloud Platform Integration

737

11.1 Integration of SAP Cloud for Customer and SAP ERP

737

11.1.1 Technical Landscape

738

11.1.2 Example Adapter Configurations

740

11.2 Integration of SAP Cloud for Customer with SAP S/4HANA Cloud

743

11.3 Integration of SAP Marketing Cloud and Various Applications

744

11.4 Integration of SAP SuccessFactors and SAP ERP

745

11.4.1 Technical Landscape

746

11.4.2 SAP SuccessFactors Adapter

747

11.5 Integration of SAP Applications with the Ariba Network

750

11.5.1 Technical Landscape

752

11.6 Summary

752

12 Summary and Outlook

755

12.1 Multi-Cloud Support

756

12.2 Integration Content Management

758

12.3 Predefined Integration Content

759

12.4 New Connectivity Options

759

12.5 Business-to-Business Support

760

12.5.1 Further Adapters

760

12.5.2 Enhancements of the Integration Content Advisor

760

12.5.3 Trading Partner Management

761

12.6 SAP Cloud Platform Integration API

761

12.7 Connectivity

762

12.8 Security

762

12.8.1 Tenant Keystore Management

762

12.8.2 Compliance with Security Standards

763

12.9 Harmonization of SAP Cloud Platform Integration with Other Services

763

12.10 Summary

764

Appendices

765

A Abbreviations

767

B Literature

775

B.1 Books

775

B.2 SAP Cloud Platform Integration Related Links

775

B.3 General Online Sources

776

B.4 SAP Communities

778

C The Authors

779