Unit 1: Introduction and Overview
Unit 1: Introduction and Overview
Open APIs
events
SAP
API Business Hub
Governments
Discover process blueprints,
one domain model, APIs,
events, integration packs
BUSINESS NETWORK
2 Open Integration
APPLICATIONS
PARTNER Non-SAP
INTELLIGENT SUITE
SOLUTIONS SOLUTIONS
Al-Driven
SAP ONE DOMAIN MODEL
BUSINESS TECHNOLOGY PLATFORM
4 Integration
SAP BUSINESS TECHNOLOGY PLATFORM
SAP INTEGRATION SUITE
Integration Suite
Cloud Integration API Management Integration Advisor Versatile, enterprise-
Business End-to-end process Expose your data as APIs, AI-based integration and grade
users integration manage API lifecycle e2e metadata mgmt integration PaaS
… with simple
Data Intelligence Event Mesh Open Connectors
consumption-based
Data integration, Sense and respond to Accelerate connectivity
Developers/ pricing
orchestration, and AI business events to non-SAP apps
experts
Create simple connected digital experiences for your SAP Integration Solution Advisory Methodology
consumers, partners, and employees with full lifecycle with strong customer focus to make our customers
management of your APIs run better
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 5
Introduction and overview
Gartner Magic Quadrant for Enterprise Integration Platform as a Service
Prepackaged content
▪ Prepackaged integration content to jump-start integration projects and get Mobile Social
productive quickly apps networks
▪ Extension of pre-delivered content to include custom requirements
Ecosystem
▪ Ability to integrate with business networks
▪ Open to partners for developing integration content and adapters
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 7
Introduction and overview
Integration Advisor
APIs are digital building blocks for modern apps and open
integrations. SAP API Management supports full lifecycle
management of your APIs
Design your APIs Develop your APIs Protect your APIs Monitor and Engage with
based on open by exposing and from security threats, analyze your API application
standards like composing backend manage traffic, cache usage, developers and
Open API interfaces from apps your data on the edge performance, and monetize your
specification and or middleware with 40+ in-built errors digital assets
OData policies through APIs
Key capabilities
▪ Out-of-the-box connectors to 170+ non-SAP
applications
▪ Select connectors you need and authenticate through
providers
▪ Build your own connector with normalized features
including authentication, pagination, errors, and
search
Benefits
▪ Easily connect to top SaaS applications in use
▪ Open RESTful APIs and JSON data format easily
embeddable within any product
▪ Power your business agility incorporating real-time
data from non-SAP applications
[email protected]
Follow all of SAP
www.sap.com/contactsap
Multi-
Neo
Cloud
Available on multiple
Available only
hyperscaler data centers
on SAP data center
(e.g. AWS, Azure, GCP)
Global Account
Admin
Cloud Integration PI_Business_Expert ▪ Monitor integration flows and the status of integration artifacts
▪ Read the message payload and attachments
API Management APIPortal.Administrator Access the API portal user interface (UI) and services
Open Connectors OpenConnectors_User View the Open Connectors capability tile on the SAP Integration
Suite launchpad
[email protected]
Follow all of SAP
www.sap.com/contactsap
Load Balancer R
R HTTPS R HTTPS
HTTPS
Infrastructure Provider Application Customer Tenant
(Multi-Tenant-Capable)
R R Worker Runtime Store
Worker
Provides infrastructure
for customer Operations
Store
SAP BTP, Cloud Foundry
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 2
Exploring Cloud Integration tooling and creating a first integration flow
Security aspects
▪ Design your integration flows to define how messages can be processed and
exchanged between sender and receiver systems.
▪ You specify the desired integration pattern by adding a dedicated integration
flow step or a combination of various integration flow steps to an integration flow.
▪ You have the option to specify which technical protocols should be used to
connect a sender or a receiver to the tenant.
Channel Channel
Sender Step 1 Step 2 Step 3 Receiver
Channel
Receiver
An integration process is an
executable, cross-system
process for processing
messages.
Note:
▪ You can use an End Message event to wrap the
exception as a fault message in the payload and
send it back to the sender.
▪ The following steps are not supported in an exception
subprocess: Start Message, Terminate Message,
Timer Start, Start Event, End Event, Router.
▪ Start Message
First step of an integration process if the process is triggered by the Sender and not scheduled (with Timer)
▪ End Message
Last step of an integration process before the message is delivered to the Receiver
▪ Terminate Message
Used to terminate the process without sending the message to the Receiver
▪ Error Start Event
Used only in the exception subprocess and acts as the starting point, if any exception occurs in the integration process
▪ Error End Event
Used to throw the exception back to exception handlers
▪ Escalation
Does not abort the integration flow processing as a whole but only throws the Escalation Event and sets the MPL status to
“Escalated”. For synchronous messages, an error message is sent to the sender
▪ Start Event
Start of local integration process
▪ End Event
End of local integration process
▪ Timer
Used to configure a process to automatically start on a particular schedule
[email protected]
Follow all of SAP
www.sap.com/contactsap
IDOC
XI Elster Mail
JDBC OpenConnectors
Ariba
AS4 ODC
ProcessDirect
LDAP AS2 Twitter
FTP
SFTP RFC
AMQP OData
Facebook
Kafka JMS SOAP
SuccessFactors HTTPS
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 2
Connecting cloud and on-premise applications with out-of-the-box adapters
Pushing vs. polling integrations
Pushing sender adapters provide an endpoint that can be called by external senders.
▪ Parallel executions possible
▪ Execution schedule not configurable but controlled by incoming messages
Polling sender adapters run at scheduled times and pick up the data from the source system.
▪ Only one execution at a time
▪ Configurable execution schedule
Why a retry?
▪ Connections to external endpoints and even whole integration scenarios can fail due to temporary issues.
▪ Some senders cannot retry the message.
▪ A direct retry on the Cloud Integration side could solve the problem.
Why?
▪ Integration scenarios are designed for a certain size of incoming messages
– Can the receiver handle that amount of data?
– Can my storage keep that amount of data
– Is the memory of my tenant capable of processing that amount of data?
▪ External senders cannot be controlled
▪ How to prevent senders from exceeding the expected size?
How?
▪ Body and attachment size restriction in the sender adapter
▪ Sender will receive an exception with HTTP response code 413
▪ HTTP ▪ XI
▪ SOAP ▪ AS4
▪ IDOC
{ “parameter1”: “ABC” }
SOAP
Integration Flow External Receiver
1.x
Why?
Using the Internet for flow-to-flow communication is bad
▪ Network latency
▪ Error-prone due to network failures
▪ Add load on network infrastructure devices
▪ Limited call duration
How?
ProcessDirect adapter for flow-to-flow communication
▪ No network infrastructure involved
▪ Synchronous connection
▪ Payload will be transferred
▪ Headers will be transferred but need to be allowed
▪ Properties will not be transferred
▪ Call duration not limited
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 7
Connecting cloud and on-premise applications with out-of-the-box adapters
Additional adapters
▪ Salesforce*
▪ Amazon WS*
▪ Microsoft Dynamics*
▪ SugarCRM*
▪ ServiceNow**
▪ Workday**
▪ Other partner adapters
* Free with all Cloud Integration editions
** Free with SAP Integration Suite
Standard or Premium edition
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 8
Connecting cloud and on-premise applications with out-of-the-box adapters
Connecting to on-premise applications ▪ HTTP
▪ SOAP
▪ IDOC
Why? ▪ XI
▪ Endpoints behind firewalls are not reachable from Cloud Integration by default ▪ FTP
Cloud Integration
Cloud Connector
<Data Center>
a1b2c3
mySubAccount
S123456789
*******
myLocationID
Cloud Integration
mySubAccount
a1b2c3
[email protected]
Follow all of SAP
www.sap.com/contactsap
Message transformers enable you to convert messages from one format to another.
Below are the message transformers available in Cloud Integration.
➢ Mapping
➢ Encoder
➢ Decoder
➢ EDI Extractor
➢ Filter
➢ Content Modifier
➢ Converter
➢ Message Digest
➢ Script
Note: The Mapping Editor works in a similar way to the Mapping Editor in Enterprise Services Repository (ES Repository).
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 4
Transforming and converting messages
Operation mapping
Operation mapping is used to relate an outbound service interface operation with an inbound
service interface operation.
Advantages:
1. Encapsulates the used mapping program
2. Using multi-mapping in an operation mapping helps to perform several mapping programs for the transformation
in a series
Note: Operation mapping can be imported from ES Repository only and cannot be created in Cloud Integration.
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 5
Transforming and converting messages
XSLT mapping
Advantages
1. XSLT is most powerful for XML-to-XML mappings.
2. Eases complicated transformation, like mapping a large
IDoc to a deeply nested XML structure.
3. Stylesheets can be stored in a version control system
like Git.
Value Mapping
Definition
Cloud Integration offers a broad palette of flow steps to support you in realizing your integration scenarios.
But there may still be use cases where you need additional functionality. For this, you can use the Script step.
It allows you to run custom coding written in JavaScript or Groovy.
Capabilities
1. Access all message elements (message body,
headers, properties, attachments)
2. Add custom headers to the message processing log
(MPL)
3. Store own documents as MPL attachments
4. Access tenant artifacts like certificates or user
credentials via an API
5. Access value mappings
6. Access partner directory artifacts
Note: Script runtimes like Groovy are open source and can therefore change in future.
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 8
Transforming and converting messages
Content modifier
A content modifier can be used to modify the incoming message or payload by changing the content that is
involved in message processing.
Note: The order of message processing is as follows: Message Header, Exchange Property, Message Body.
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 9
Transforming and converting messages
Converter
An input message can be converted from one format to another so it can be used in the subsequent steps of
the integration flow. You can use the converter steps to achieve this message transformation.
The following converters are available in Cloud Integration:
➢ Base64 Encoder
➢ GZIP Compression
➢ ZIP Compression
➢ MIME Multipart Encoder
Input Output
Base64 Encoder PG1lc3NhZ2U+DQoJSW5w
<message> Input for dXQgZm9yIGVuY29kZXINCj
encoder</message> wvbWVzc2FnZT4NCg==
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 11
Transforming and converting messages
Decoder
➢ Base64 Decoder
➢ GZIP Decompression
➢ ZIP Decompression
➢ MIME Multipart Decoder
Input Output
This integration flow step is used to calculate a digest (hash value) of the payload or parts of it and store
the result in a message header. The following steps are involved:
A filter step is used to extract information from an incoming message. It can be leveraged to use the
capabilities of XPath 3.1 Enterprise Edition for extracting information from an incoming XML message.
Input Output
XPath- /Message/orders/order
[email protected]
Follow all of SAP
www.sap.com/contactsap
?
?
Merges the control of all multicast branches back into one branch
▪ Without the Join step, all modeled flow steps will be executed by every branch
▪ Message content after the Join is defined by the last modeled branch
p
m nqmp
n o
ro
q
r
S Integration Flow R
▪ Enhance an integration flow with information from external sources
▪ Send intermediate messages to external targets
▪ Continue flow processing after the external call R’
▪ Send
Send a message to a receiver and continue processing; no response
▪ Request-Reply
Send a message to a receiver and continue processing the response
▪ Content Enricher
Retrieve information from external sources and merge it into the current message
▪ Poll Enrich
Retrieve an (S)FTP file and merge it into the current message
Note: When doing intermediate calls, all headers will be transferred to the external receivers and might be changed on
return. Properties will not be transferred and therefore should always be preferred for controlling the flow logic.
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 10
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC
Demo
11
Routing and controlling messages
Summary
[email protected]
Follow all of SAP
www.sap.com/contactsap
Manage Security
Manage
Integration Content Manage Stores
Monitoring Capabilities
Monitoring in Cloud Integration
Message Processing Manage Locks
* In read-only mode
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 3
Monitoring and running integration flows
Integration
Enhanced filtering options of processed messages Developer
Manage
Integration Content ▪ Deployment info including status of deployed artifacts
▪ Actions on an artifact as restart, un-deploy, or download
▪ Endpoint URLs exposed
▪ Artifact details (depending on artifact type)
– Access the monitor message processing
– View deployed artifact
– Navigation to artifact editor
– Navigation to the value mapping design
▪ Configuration of log level as, e.g. Trace
– Information level recorded during message processing
– Number of retained messages
▪ Maintain tenant’s security-related materials as credentials, PGP keyrings, SSH known hosts
▪ Manage the keystore material as certificates/key pairs owned by customers or SAP
– Create private keys
– Upload external certificates and handle certificate signing requests
– Restore certificates and key pairs
– Back up customer’s entries
▪ Access policies to protect subsets of artifacts and business data*
▪ Manage JDBC access
▪ Manage user roles*
▪ Test outbound connectivity (TLS, SSH, FTP, SMTP, IMAP, POP3, Cloud Connector, Kafka)
* In multi-cloud env
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 7
Monitoring and running integration flows
Business
Data stores to temporarily persist data during message processing Expert
Integration
Developer
Manage Stores
Tenant
Admin
Tenant
Admin
▪ Message locks
– AS2, JMS, Mail, SFTP, or XI adapters write
locks to avoid messages being processed
multiple times in parallel Manage Locks
– Manage locks for reprocessing messages
▪ Design-time locks
– Integration artifacts, REST APIs, and packages might
be locked by users
– Self-service capability to unlock design-time artifacts
24 hours after the lock
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 9
© 2021 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC
Demo
10
Monitoring and running integration flows
Summary
[email protected]
Follow all of SAP
www.sap.com/contactsap