Guide (SAP S/4HANA Cloud) SAP Supply Base Optimization ...

Integration Guide | PUBLICSAP Supply Base Optimization2019-03-18

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)

© 2

020

SAP

SE o

r an

SAP affi

liate

com

pany

. All r

ight

s re

serv

ed.

THE BEST RUN

Content

1 Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53.1 Steps in Supply Base Optimization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53.2 Configuration for SAP S/4HANA Cloud. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

4 Configuration for SAP Cloud Platform Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74.1 Deployment of Credentials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Deploy Certificates in Keystore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Deploy Technical Communication User Data with a Credential Artifact. . . . . . . . . . . . . . . . . . . . . 8

4.2 Deployment and Configuration of the Integration Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Create a Copy of the Pre-Packaged Integration Scenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Configuration of the Integration Flows – Fetch Token. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Configuration of the Integration Flows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

5 Troubleshooting and Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

6 Error Email Notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

7 Scheduled System Downtimes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

8 Data Protection and Privacy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168.1 Deletion of Suppliers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168.2 Blocking of Suppliers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

9 Relevant Components for Customer Incidents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2 PUBLICSAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)

Content

1 Purpose

The scope of this integration guide covers the integration between SAP Supply Base Optimization and SAP S/4HANA Cloud, using SAP Cloud Platform Integration as a middleware.

The integration package SAP Supply Base Optimization Integration with SAP S/4HANA Cloud runs on the SAP Cloud Platform Integration service tenant and connects to the SAP Supply Base Optimization using REST services.

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Purpose PUBLIC 3

2 Overview

The integration package SAP Supply Base Optimization Integration with SAP S/4HANA Cloud enables you to integrate business processes between SAP Supply Base Optimization and SAP S/4HANA Cloud. The integration scope includes replication of master data such as Material and Supplier. The integraton allows you to replicate material and supplier from SAP S/4HANA Cloud to SAP Supply Base Optimization.

NoteThe replication of MPN materials are currently not supported.


Overview

3 Preparation

The preparatory steps explained in the following sections are prerequisites for the integration between SAP Supply Base Optimization and SAP S/4HANA Cloud.

3.1 Steps in Supply Base Optimization

For communication with the SAP Supply Base Optimization REST web services, a technical user needs to be created in SAP Supply Base Optimization. This user needs to subscribe to SAP Supply Base Optimization services and create a service instance. The user must then create client credentials for this service instance through which the authentication URL, client_id, and client_secret, are obtained. These are required to fetch OAuth token to establish connection to the SAP Supply Base Optimization services.

3.2 Configuration for SAP S/4HANA Cloud

Creating Communication Arrangements and Calling the APIs

1. Log on to the cloud system with business role SAP_CORE_BC_COM.2. Navigate to the Maintain Communication Users app and create a new user.

Enter the username, description, and password and choose Create3. Navigate to the Communication Systems app and create a new system.

1. Enter the URL of the SAP Cloud Platform Integration as host name2. Enter any logical system (DUMMY)3. Add the user created in step 2 to Users for Inbound and Outbound Communication4. Choose Save

4. Navigate to the Communication Arrangements app1. Select the scenario.

NoteThe scenario can be found in the API hub → Download Specification for the APIs being used

○ SAP_COM_0008 - Business Partner, Customer, and Supplier Integration (API for Material: API_PRODUCT_SRV)

○ SAP_COM_0009 - Product Integration (API for Business Partner: API_BUSINESS_PARTNER)

2. Enter a name for the arrangement3. Select the communication system created in Step 34. Deactivate the service status of outbound APIs if not required by deselecting the Service Status

checkbox

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Preparation PUBLIC 5

5. Choose Save.

Configuring Cloud Connector

1. Log on to the Cloud connector and add subaccount as described in SAP Cloud Connector2. In the subaccount, navigate to the Cloud to On-Premise tab3. Add a system mapping by providing the following details:

○ Back-end type : ABAP System○ Protocol : HTTP○ Internal Host: Internal port of your ABAP system.○ Principal Type : None

4. Add a resource:In the URL Path enter / and select path and all sub-paths as per the access policy.


Preparation

https://help.sap.com/viewer/00f68c2e08b941f081002fd3691d86a7/release/en-US/8d8511532794429caa243b6fb7c79989.html

4 Configuration for SAP Cloud Platform Integration

The pre-packaged integration scenario contains integration flows for material and supplier, These integration flows can be configured for the replication of material and supplier from SAP S/4HANA Cloud to SAP Supply Base Optimization.

The configuration is structured in the following order:

● Deployment of credentials● Configuration and deployment of the integration flows

4.1 Deployment of Credentials

Context

To establish the communication with the source S/4HANA Cloud system and the SAP Supply Base Optimization, it is required to deploy the required credentials. For deploying mail credentials, follow the same steps as in Deploy Technical Communication User Data with a Credential Artifact chapter by using the user name and password of sender.

4.1.1 Deploy Certificates in Keystore

For connecting sender or receiver systems, the tenant administrator needs to maintain keys and certificates in different systems, sender, receiver and the Cloud integration tenant. The Keystore Monitor available in Cloud integration tenant can be used for this purpose.

The monitor is available in Operations View in Web. In the Manage Security section, you find the Keystore tile, which directly informs you about the number of keys and certificate available in the tenant keystore.

Certificates required for accessing the application include the following:

● SSO Certificate: Server-side certificate for accessing SAP Supply Base Optimization endpoints● SMTP Certificate: Relevant service certificate must be configured.

You must deploy certificates in the SAP Cloud Platform Integration tenant, under Monitor Manage SecurityKeystore Add Browse . Then select the updated keystore, enter the pass-phrase, and choose Deploy.

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Configuration for SAP Cloud Platform Integration PUBLIC 7

4.1.2 Deploy Technical Communication User Data with a Credential Artifact

Context

User credentials of the technical user of your SAP Sourcing Simulation and Optimization for Industries system need to be deployed in your SAP Cloud Platform Integration tenant. For more information, see Configuration of the Integration Flows – Fetch Token [page 9].

Procedure

1. Open your SAP Cloud Platform Integration tenant’s web UI.2. On the Tenant menu, choose Monitor.3. Select the Security Material tile in the Manage Security Material section.4. Choose Add.5. Select User Credentials.6. Enter the following values in the Add Users Credential dialog box window:

○ Name: <credential_name>○ Description (optional)○ User: <Client_ID>○ Password: <Client_Secret>

7. Choose OK to save the user credentials.

4.2 Deployment and Configuration of the Integration Package

To work with the integration flows of this package, the pre-packaged integration flow scenario must be copied to your workspace. Constituent integration flows need to be configured next. Finally, to activate the integration flows, they must be deployed. The configuration and deployment must be processed for each integration flow.


Configuration for SAP Cloud Platform Integration

4.2.1 Create a Copy of the Pre-Packaged Integration Scenario

Context

To create a copy of the pre-packaged integration scenario, proceed as follows:

Procedure

1. In your preferred web browser, open the web UI of your SAP Cloud Platform Integration tenant: <https://your_tenant_URL/itspaces> .

2. On the Discover page, select All to navigate through the available pre-packaged integration scenarios.3. Enter <data load> in the Search field and choose Enter.

4. To copy the integration package from the catalog to your customer workspace, move your cursor over the integration package tile and choose Copy to workspace.

5. The message Integration package copied confirms that the package was copied to your workspace.

NoteIn case the integration scenario is already available in the workspace, a copy with a different name can be created, or the existing package can be overwritten. In case of overwriting, all previous configurations will be lost.

6. Choose the pen icon to choose the Design page to work with the copied package and its integration flows.

4.2.2 Configuration of the Integration Flows – Fetch Token

Proceed as follows:

1. On the Design page, select the package SAP Supply Base Optimization Integration with SAP S/4HANA Cloud, which contains the integration content.An overview of the artifacts available in the selected integration package is displayed.

2. To configure an integration flow, choose Configure in the Actions column for the integration flow.3. On the Sender tab, select the address.


4. On the Receiver tab, provide the relevant details as follows:

Field Value

Landscape <landscape>

Datacenter

Authentication us10

Credential Name <OAuth Credentials> (This must be a basic username/password credential with client_id as the username and client_secret as the password) as mentioned in Deploy Technical Communication User Data with a Credential Artifact chapter.

For more information, refer to Creating Service Keys.

5. Save the settings and deploy as required.

4.2.3 Configuration of the Integration Flows

The following integration flow must be configured based on the type of their integrations:

● Replicate Business Master from S4HANA Cloud● Replicate Product Master from S4HANA Cloud

Replicating Master Data from SAP S/4HANA Cloud to SAP Supply Base Optimization

For configuring an integration flow to replicate master data from SAP S/4HANA Cloud to SAP Supply Base Optimization, proceed as follows:

1. On the Design page of SAP Cloud Platform Integration, select the package SAP Supply Base Optimization Integration with SAP S/4HANA Cloud , which contains the integration content. Proceed to the Artifacts tab page.An overview of the artifacts available in the selected integration package is shown.

2. To configure an integration flow, choose Configure from the Actions icon for the integration flow.3. On the Timer tab, select how often you would like to carry out the data replication. Save your changes.4. Provide the relevant details on the Receiver tab page as follows:

○ In Receiver field, select either Mail_Success, Mail_Exception, or Mail_Error. All three options are configured with the same mailing parameters.

Adapter Type - Mail

Field Value

Address SMTP address of your email

Credential Name Name of the mail credentials added in the security material of CPI



https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/4514a14ab6424d9f84f1b8650df609ce.html

Field Value

From Email of the sender

To Email of the receiver

Other Fields Enter the text as required in the mails

○ In Receiver field, select S4Cloud and provide the relevant details:

Adapter Type - HCIOData

Field Value

Host Host of SAP S/4HANA Cloud System

Port Port of SAP S/4HANA Cloud System

proxy type internet or on-premise

If proxy type is internet, then no location ID is required. If proxy type is on-premise, then location ID is required.

Location ID Location ID of your cloud connector subaccount created

Credential Name Credential name of the communication user created and added in the security material of CPI.

○ In Receiver field, select either SBO_Material , SBO_Supplier , or SBO_Contact. Provide the relevant details:

Adapter Type - HTTP

Field Value

Tenant production

Datacenter us10

○ In Receiver field, for the integration flow Fetch-Token, provide the relevant details as follows:

Adapter Type - ProcessDirect

Field Value

Address Endpint of Fetch Token integration flow


5. Provide the relevant details on the More tab page as follows:

Material

Field Value

SyncDate Date from which you want to extract data from SAP S/4HANA Cloud

SyncTime Time from which you want to extract data from SAP S/4HANA Cloud

MaterialGroup Material Group of the products THAT you want to extract data from SAP S/4HANA Cloud (In case of Product Master)

MaterialType Type in which the products were created (In case of Product Master)

Plant Plant of required products (In case of Product Master)

Business Partner

Field Value

Sync Date Date from which you want to extract data from SAP S/4HANA Cloud

Sync Time Time from which you want to extract data from SAP S/4HANA Cloud

Supplier Exclusion List Comma separated list of suppliers to be excluded from reaching SAP Supply Base Optimization application.

6. Save and deploy the integration flow.



5 Troubleshooting and Log

Context

In the SAP Cloud Platform Integration web UI, you can analyze the deployed integration flows in the Monitoring section as follows:

Procedure

1. To carry out the activity, open your SAP Cloud Platform Integration tenant web UI, for example, https://<your SAP Cloud Platform Integration tenant URL>/itspaces

2. In the Tenant menu, choose Monitor, then Monitor Message Processing.3. On the Overview screen, choose the tile with the message status you wish to analyze4. On the left, select the integration flow you wish to analyze.5. Access the Message Processing Log from the Log tabs.

Related Information

https://help.sap.com/viewer/product/CLOUD_INTEGRATION/Cloud/en-US

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Troubleshooting and Log PUBLIC 13

https://help.sap.com/viewer/product/CLOUD_INTEGRATION/Cloud/en-US

6 Error Email Notification

All integration flows in the SAP Supply Base Optimization Integration with SAP S/4HANA Cloud integration package provide the facility of sending error mail notifications for errors that occur during processing in the SAP Cloud Platform Integration tenant, or in SAP Supply Base Optimization application.

For this, the SMTP server to be used as well as the email IDs from and to which the error message is to be sent can be configured in the mail adapter connected to the exception sub-process present in each integration flow in the package.


Error Email Notification

7 Scheduled System Downtimes

In case of a scheduled system downtime of SAP Supply Base Optimization, you should prevent data from being transferred in advance to avoid Failed messages.

In case of downtime of SAP Supply Base Optimization, all artifacts for replication are affected.

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Scheduled System Downtimes PUBLIC 15

8 Data Protection and Privacy

Data protection is associated with numerous legal requirements and privacy concerns. In addition to compliance with general data privacy regulation, it is necessary to consider compliance with industry-specific legislation in different countries. SAP provides specific features and functions to support compliance with regards to relevant legal requirements, including data protection. SAP does not give any advice on whether these features and functions are the best method to support company, industry, regional, or country-specific requirements. Furthermore, this information does not give any advice or recommendation in regards to additional features that would be required in particular IT environments; decisions related to data protection must be made on a case-by-case basis, under consideration of the given system landscape and the applicable legal requirements.

NoteIn most cases, compliance with applicable data protection and privacy laws will not be covered by a product feature. SAP software supports data protection compliance by providing security features and specific data protection-relevant functions, such as simplified blocking and deletion of personal data. SAP does not provide legal advice in any form. Definitions and other terms used in this document are not taken from any given legal source.

Data Protection and Privacy in Integration with SAP Supply Base Optimization

The SAP Supply Base Optimization application works with personal data of suppliers and supplier contacts. This data can be sent to SAP Supply Base Optimization, as well as changed using integration flows for suppliers and contacts, or even deleted.

● Consent: SAP S/4HANA Cloud system belong to the same legal entity as SAP Supply Base Optimization application. Therefore, explicit consent is not required to transfer data to SAP Supply Base Optimization.You can also refer to the User Consent section in the SAP Supply Base Optimization - Administrator's Guide.

● Change Logging: All changes made in SAP Supply Base Optimization using the integration flows are recorded in the application's Audit Log.If any personal data (which is relevant to SAP Supply Base Optimization application) in SAP S/4HANA Cloud system, the changes are transferred to SAP Supply Base Optimization and are also captured in the application's Audit Log.

For more information, refer to the SAP Supply Base Optimization - Administrator's Guide.

8.1 Deletion of Suppliers

This section explains the process of deletion of suppliers and contacts in SAP Supply Base Optimization. You must implement this section prior to carrying out integration with SAP S/4HANA Cloud.

Integration flows allow you to delete personal information of suppliers and supplier contacts completely from the SAP Supply Base Optimization application. These deletions are also logged in the application's Audit Log.


Data Protection and Privacy

https://help.sap.com/viewer/eaddaeeea0b941a7952e6f31b32ca7fd/1808/en-US



● End of business purpose of suppliers or contacts in SAP Supply Base Optimization application When the purpose of specific suppliers or contacts ends in the SAP Supply Base Optimization application, a supplier exclusion list is maintained to ensure that the data of these deleted suppliers do not flow from the SAP S/4HANA Cloud system to SAP Supply Base Optimization application. For more information, see Supplier Exclusion List field specified in step 5 of Configuration of the Integration Flows [page 10].

8.2 Blocking of Suppliers

This section explains how the blocking of a supplier and contacts in the SAP S/4HANA Cloud system impacts negotiations in SAP Supply Base Optimization application.

When a supplier is blocked in SAP S/4HANA Cloud, the 'Active' status of a supplier is set from true to false in SAP Supply Base Optimization. As a result:

● The blocked supplier is not considered for any new negotiations in SAP Supply Base Optimization application

● Any existing negotiations with the blocked supplier remain unaffected in SAP Supply Base Optimization application

For more information, see Blocking Business Partner, Customer and Supplier Master Data.

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Data Protection and Privacy PUBLIC 17

https://help.sap.com/viewer/05a5505cc81943fb9d01e84cb2e135ef/1909.000/en-US/99c05853b2dc7425e10000000a44176d.html

9 Relevant Components for Customer Incidents

In case of errors with the integration content, open a customer ticket in component LOD-SBO-INT.

In case of any resource-related issues (for example, out of memory exceptions), open a ticket on component LOD-HCI-PI-OPS.


Relevant Components for Customer Incidents

Important Disclaimers and Legal Information

HyperlinksSome links are classified by an icon and/or a mouseover text. These links provide additional information.About the icons:

● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements with SAP) to this:

● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any

damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.

Videos Hosted on External PlatformsSome videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within the control or responsibility of SAP.

Beta and Other Experimental FeaturesExperimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use the experimental features in a live operating environment or with data that has not been sufficiently backed up.The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example CodeAny software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example code unless damages have been caused by SAP's gross negligence or willful misconduct.

Gender-Related LanguageWe try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.

SAP Supply Base Optimization - Integration Guide (SAP S/4HANA Cloud)Important Disclaimers and Legal Information PUBLIC 19

www.sap.com/contactsap

© 2020 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. The information contained herein may be changed without prior notice.

Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies.

Please see https://www.sap.com/about/legal/trademark.html for additional trademark information and notices.

THE BEST RUN

https://www.sap.com/about/legal/trademark.html

Guide (SAP S/4HANA Cloud) SAP Supply Base Optimization ...

Documents

Transcript of Guide (SAP S/4HANA Cloud) SAP Supply Base Optimization ...