Table of Contents

Open all
Close all
Foreword by Björn Goerke
17
Preface
19
Structure of the Book
20
Sample Applications
23
Who This Book Is For
24
Acknowledgments
27
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
Index
781