sap business bydesign - smbsummit2019.com
TRANSCRIPT
SAP Business ByDesign
… by design an open solution
Knut Heusermann, SAP
April, 2019
Internal | SAP Employees and Partners OnlySMB Innovation Summit 2019
2Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
▪ How can I integrate and extend SAP Business ByDesign?
▪ Which APIs are available in SAP Business ByDesign?
▪ For which purpose shall I choose which API type?
▪ How can I access SAP Business ByDesign APIs?
▪ Where do I get more information?
Today I want to answer 5 questions:
How can I integrate and extend SAP Business ByDesign?
4Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Integrate and extend SAP Business ByDesign
SAP Cloud Applications
Studio
“Build-in extensions” (Add-ins)
running on
the SAP ByDesign Platform
SAP Cloud Platform
„Side-by-side“ cloud applications
running on the SAP Cloud Platform,
integrated with SAP ByDesign
SAP Cloud Platform
Integration
Process integration
across systems and applications
integrated with SAP ByDesign
Public Solution Model SAP ByDesign APIs
5Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Business
Object
UI ModelAnalytical Models
Process Component Process Component
Business
ObjectsAPIs
SAP ByDesign Platform
Extend SAP Business ByDesign
Public Solution Model
SAP Cloud Platform
Applications Internet
of
Things
Natural
Language
Interfaces
Machine
Learning
Blockchain
SAP ByDesign UIrenders SAP ByD and Partner Add-in models
Deploy Add-in to ByD Business
Object
UI ScreenReport
SAP Cloud Applications Studio
Custom API
Single Sign-On
SAP Mashups
and Partner Mashups
APIs
Integrate with ByD using
SAP APIs and Custom APIs
6Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Integrate SAP Business ByDesign
Cloud Applications
On-premise Applications
Public Authorities
Business Partners
Social Networks
SAP Cloud Platform
Integration
Pre-packaged content by SAP and Partners
- Integration Packages -
- Adapter SDK -
- Public APIs -
SAP API Business Hub
Public “shelf” of
Integration Packages and APIs
api.sap.com
Which APIs are available in SAP Business ByDesign?
8Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
SAP Business ByDesign – API Portfolio
Process Integration
➢ B2B Inbound and Outbound
Interfaces
➢ ByD Output Management
➢ A2A Inbound and Outbound
Interfaces
➢ Web Service APIs on
process trigger objects
➢ External API Consumption
(SAP Cloud Applications
Studio)
Analytical Integration
➢ OData for Reports
➢ OData for Data Sources
➢ Operational Data
Provisioning
(SAP Business Warehouse)
➢ Upload Cloud Data Sources
Data Integration
➢ Web Service APIs
➢ OData for Business Objects
➢ Custom Web Service APIs
(SAP Cloud Applications
Studio)
UI Integration
➢ URL Mashups
➢ HTML Mashups and Data
Mashups
➢ External Object-based
Navigation
➢ Launch ByD reports with
parameterized URLs
➢ Single sign-on (SAML2)
10Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Analytics Integration
SAP Business ByDesign Built-in Analytics
SAP Business ByDesign provides integrated and insight-driven business
processes with flexible analytics content as an integrated part of standard
processes out-of-the box.
Extend SAP ByDesign by external analytics solutions
Leverage external analytics solutions to extend the ByD built-in analytics
solution with additional visualizations, features and analytical scenarios:
➢ Advanced Visualizations and Dashboards
➢ Business Planning and Forecast
➢ Predictive Intelligence (e.g. Smart Discovery, Smart Grouping,…)
➢ Reporting across multiple applications and external Data
Find more details in the ByD Community blog post Extending
SAP ByDesign Analytics using SAP Analytics Cloud
Data Sources
Reports / Analysis Pattern
Report Cards
KPIs
OData for Reports
OData for Data Sources
SOAP API for Operational Data ProvisioningSAP Business Warehouse
SAP Analytics Cloud3rd-party Analytics Solutions
For which purpose shall I choose which API type?
12Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
API Usage Pattern
Process Integration
(7) Remote access to trigger a
business process in ByD
(8) ByD invokes a business
process task in a remote
system
(9) Subscribe to ByD events
Analytical Integration
(3) Mass data extraction of
analytical raw data
(4) Remote access to pre-
processed analytical data
(5) Live access to analytical
data
(6) Extend ByD built-in analytics
by external data sources
Data Integration
(1) Remote access to business
objects
(2) Interactive access to
business objects
UI Integration
(10) Navigation ByD UI to 3rd-
party UI
(11) Navigation 3rd-party UI to
ByD UI
(12) Embed 3rd-party screens
and information in ByD Uis
(13) Single Sign-On and Single
Log-Out
13Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
For which purpose shall I choose which API type?
1 2 3 4 5 6 7 8 9Remote access to
business objects
Interactive access to
business objects
Mass data extraction
of analytical raw data
Remote access to
pre-processed
analytical data
Live access to
analytical data
Extend ByD
built-in analytics by
external data sources
Remote access
to trigger a Business
Process in ByD
ByD invokes a
business process task
in a remote system
Subscribe to
ByD events
Soap APIs
Web Service APIs SOAP best fitcase-by-case
decisiongood fit
B2B Inbound Interfaces SOAP best fit
B2B Outbound Interfaces SOAP best fit
A2A Inbound Interfaces SOAP best fit
A2A Outbound Interfaces SOAP best fit
Operational Data Provisioning SOAP best fit (SAP BW)
Upload Cloud Data Sources SOAP best fit
OData APIs
OData for Business Objects REST/OData good fit best fitcase-by-case
decision
case-by-case
decision
OData for Data Sources REST/OData best fit
OData for Reports REST/OData good fit best fitcase-by-case
decision
Upload Cloud Data Sources REST/OData best fit
Custom APIs (SAP Cloud Applications Studio)
Custom Web Service APIs SOAP good fitcase-by-case
decision
case-by-case
decision
External API Consumption REST and SOAPcase-by-case
decisiongood fit
Data Integration Process IntegrationAnalytical Integration
How can I access SAP Business ByDesign APIs?
15Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Step 1:
Create a Communication System that represents
the remote system.
Each communication system generates a
technical communication user for authentication.
Step 3:
Create a Communication Arrangement using the
communication scenario and communication
system.
ByD assigns the authorization role to the
communication user.
The communication arrangement provides you
with access URL, WSDL and service
documentation.
Step 2:
Create a Communication Scenario and add
relevant web service APIs.
ByD generates an authorization role with access
to all selected services.
SAP pre-delivered communication scenarios can
be activated via business scoping.
Configure Web service APIs and A2A interfaces
16Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Step 1:
Activate the communication scenario in your
Business Configuration Scope.
Step 3:
Create a Communication Arrangement for the
communication between the business partner and
your company:
Inbound: Enter credentials and get access URL,
WSDL and service documentation.
Outbound: Enter external service access URL and
credentials.
Step 2:
Select “XML” as Output Channel in the
collaboration settings of your business partner.
ByD generates a technical communication user
associated to the business partner.
Configure business collaboration scenarios and B2B interfaces
17Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Configure OData access to
Business Objects
Step 1:
Add business object nodes, elements and
associations to your Custom OData Service.
Step 2:
Add query-functions and business object actions
to your Customer OData Service.
Step 3:
Assign your Custom OData Service to a work
center view.
As result users with access to this work center
view can access the OData service as well.
Step 4:
Activate your Custom OData Service and get the
service URL.
1
3
4
2
18Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Step 1:
Design report using the report wizard
▪ Characteristics and key figures
▪ Selection parameters
▪ Properties and default values
Step 3:
Build OData queries to get sample OData
requests
Step 2:
Assign the report to a work center view.
As result users with access to this work center
view can access the report via OData service as
well.
Configure OData access to reports
All reports provided by SAP, Partners and key users can be accessed using OData without any configuration.
19Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Step 1:
Activate the OData API for
analytical data sources in your
Business Configuration Scope.
Step 5:
Build OData queries to get sample
OData requests
Step 2 and 3:
Create a Communication System
that represents the remote system.
Create Communication
Arrangement for the
communication scenarios “Analytics
DataSources OData” and “Analytics
Data Upload”.
Step 4:
Externally expose data sources.
Configure OData access to data sources and cloud data sources
Where do I get more information?
21Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Looking for more Information?
SAP Business ByDesign
Product page:
www.sap.com/products/business-bydesign.html
Community:
www.sap.com/community/topics/business-
bydesign.html
SAP Cloud Platform
Product page:
cloudplatform.sap.com
Community:
www.sap.com/community/topics/cloud-platform.html
SAP Cloud Platform Integration
Product page:
www.sap.com/products/hana-cloud-integration.html
Community:
www.sap.com/community/topics/cloud-
integration.html
22Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Key Take-aways
Openness is an Invitation
Take the opportunity and become a
successful vendor of ByD Add-ins, SCP
Add-ons and CPI Integration Packages.
Pick your Battles
Pick your environment wisely
and decide on the right balance
between control and abstraction.
Use SAP Cloud Applications Studio
Add-Ins as “glue-code”.
The API Portfolio is a Buffet
Know the characteristics of each API
type and make a qualified choice.
Don’t hesitate to mix API types
if it makes your life easier.
Thank you.
Contact information:
Knut Heusermann
Product Management SAP Business ByDesign
SAP SE, Germany
Gamification Challenge Code
NIC5l7c
By entering this SAP Breakout Session
code you will be granted 10 points
5 5
25Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
200+ Standard Web Service APIs
Tailored to integrate systems using a minimal number of
roundtrips.
▪ Query and read business objects
▪ Write access to deeply structured business objects
Create Custom Web Service APIs using the
SAP Cloud Applications Studio
Enhance the ByD Standard Web service portfolio or
provide Partner Add-ins with integration capabilities.
▪ Wizard to create Soap APIs for read and write access
to standard and custom business objects
Web Service APIs
Find a list of SOAP APIs on SAP Help > Integration > Web Service APIs
and examples in the ByD Community
26Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
OData for Business Objects
Create Custom OData Services using the
OData Services Modeler
Designed for user centric applications to access ByD business
objects.
▪ Access Standard Business Objects and Custom Business
Objects deployed as part of SAP Cloud Applications Studio
solutions
▪ Access to business objects nodes, elements, queries and
actions that are released and published in the OData Public
Solution Model
▪ Customers decide which business objects, elements and
actions are exposed via OData and which authorizations
are needed to access the OData API
Find more details in the ByD Help Center searching for “OData Services“ and examples
in the ByD Community (i.e. blog post OData API Usage Samples)
27Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Analytical Data Upload into Cloud Data Sources
CSV
RACE;CAR;LAP;DURATION;
21;Car1;12;3.75;
21;Car2;12;4.02;
Cloud Data Sources can be used to
extend ByD built-in analytics by
external data sources
Upload via API
▪ SOAP service
▪ OData service
File Upload
▪ Upload CSV files via ByD UI
▪ Overwrite or modify existing data
Find more details in the ByD Help Center searching for “Cloud Data Sources“
28Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Process Integration
Company in ByD
ByD Financials Point of Sales System
Business Partner (Customer)
Create Point of Sales Transaction
Send Order
Send Invoice
Business Collaboration (B2B)
Automate communication with business partners and
public authorities
Application Integration (A2A)
Automate business processes
across system boundaries with systems, applications and
service provider
Find a list of integration scenarios on SAP Help > Integration Scenarios and an example
in the ByD Community, blog post Setup B2B Order Integration with SAP Business ByDesign
29Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Process integration is embedded in the ByD Output Management
Fax
Print Manager
Business Partner (B2B Integration)
Printer
File Share
External Output Management System
(A2A Integration)
30Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
Process Integration – External API Consumption
Consume external REST and SOAP Web Services
embedded in the ByD business logic using the SAP Cloud Applications Studio.
Configure
Service wizard to
▪ Upload WSDL or enter REST URL to
create a consumer proxy for the
external service
▪ Create communication scenario for
integration configuration
Use
ABSL library to
▪ Fill SOAP web service request
structures
▪ Set REST URL parameters
▪ Execute the web service call
▪ Get and process the web service
response
Code
Embed the external web service
consumption in the ByD business logic as
part of your Add-in.
31Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
UI Integration – ByD Mashups
Integrate ByD screens with online web services
and web applications.
➢ URL Mashups to navigate to external applications
➢ HTML Mashups to embed HTML or JavaScript based web pages in
ByD screens
➢ Data Mashups to integrate data provided by
3rd-party web services with ByD business data
➢ Mashup Port Bindings
Enable custom data exchange between mashups and ByD business
objects using the SAP Cloud Applications Studio
Find more information in the ByD Help Center searching for „Mashups“
32Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
UI Integration – External Object-based Navigation
Launch Standard ByD Screens and custom screens using
parameterized ByD URLs
URL parameter:
▪ Business object namespace
▪ Business object name
▪ Business object node
▪ Operation
▪ Object key
▪ Object key type
Logon with ByD user (with SSO or w/o SSO)
Example: Launch Overview of Supplier Miller&Son:
Find more details in the ByD Community blog post
Launch ByDesign UIs from External Applications
33Confidential: Released for Partners© 2019 SAP SE or an SAP affiliate company. All rights reserved. ǀ
UI Integration – Launch ByD Reports
Launch ByD Report in your browser using
parameterized URLs
URL Parameter:
▪ Report ID
▪ Report View ID
▪ Selection ID
▪ Selection Parameter
Example: Launch report Sales Order Volume
Launch ByD Report as Excel Workbook
Parameter:
▪ LINK (Report ID)
▪ VIEW (Report View ID)
▪ VARIANT (Selection ID)
Example: Launch report Sales Order Volume
Find more details in the ByD Community blog post Launch
SAP Business ByDesign Reports using Parameterized URLs