Professional Documents
Culture Documents
1 Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Technical Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.1 Additional Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2 Browsers and Browser Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3 Supported Data Centers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4 Onboarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
5 Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
5.1 Connecting to SAP EWM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Additional Requirements in SAP EWM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
7 Business Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
7.1 Configure Your Solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
General Configuration Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Configuration Steps for Integration Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
8 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
8.1 User Administration, Authentication, and Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
8.2 Session Security Protection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
8.3 Network and Communication Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
8.4 Data Storage Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Provides details about the changes made in each version of this document.
This administration guide describes the steps you need to perform as an administrator to set up and run SAP
Warehouse Robotics. It covers application-specific information only.
Depending on how you integrate your robots with SAP Warehouse Robotics, the following two integration
scenarios are available:
Before you start to use SAP Warehouse Robotics, check the requirements and recommendations in this
section.
If you want to connect your application to an on-premise system, you must have installed and configured the
Cloud Connector. For more information, see Cloud Connector.
For the UIs of SAP Warehouse Robotics, the following browsers are supported on Microsoft Windows PCs and,
where mentioned below, on macOS:
Browser Versions
SAP Warehouse Robotics supports the use of the following data centers:
Note
This data center is only available
for the integration with non-SAP
fleet management systems
We recommend that you choose the data center closest to where most users of the application are located.
Prerequisites
• You have set up your global account and subaccount. For more information, see Managing Global Accounts
Using the Cockpit and Managing Subaccounts Using the Cockpit.
• You are assigned the Administrator role for the global account.
For more information about the onboarding process, see the SAP BTP documentation under Subscribe to
Multitenant Applications Using the Cockpit.
For more information about the onboarding process for SAP Warehouse Robotics, see the relevant how-to
guide in SAP Note 3198030 .
You can connect SAP Warehouse Robotics to SAP Extended Warehouse Management (SAP EWM).
For more information about connectivity, see the SAP BTP documentation under Connectivity in the Cloud
Foundry Environment.
You can connect SAP Warehouse Robotics to SAP Extended Warehouse Management (SAP EWM) as a
standalone product, decentralized EWM based on SAP S/4HANA or EWM embedded in SAP S/4HANA. To
be brief on the product names, SAP EWM is used for references to these deployments in this guide.
Prerequisites
OData Service
OData is a standardized protocol for exposing and accessing information from various sources. OData is based
on core protocols, including HTTP, AtomPub (Atom Publishing Protocol), XML, and JSON (Java Script Object
Notation).
Ensure that you have activated the OData service /SCWM/WAREHOUSE_ROBOTICS for SAP Warehouse
Robotics.
For more information about activating OData services, see Activating OData Services.
Procedures
You need to perform the following actions to set up and operate the connections to the on-premise system:
Note
When you edit a resource, select the Path and All Sub-Paths access policy.
When you configure a destination, select the OnPremise proxy type and the BasicAuthentication
authentication.
The URL in the destination is a virtual host and a port that you have configured in your cloud connector.
For example, if you defined a virtual host my-virtual-host and port 8080, enter the URL http://
my-virtual-host:8080.
HTTP destinations are relevant for the destination service. For more information, see Managing
Destinations.
If you want to specify the client of the SAP EWM system, please create an additional property with the
property name sap-client. The value should be the SAP client from which you publish the SAP Gateway
Service. If you don’t create the sap-client property, the default client will be used for the integration.
Note
For support packages lower than SP11 for SAP EWM 9.5, implement the SAP Note 3147663 and
3247030 .
• EWM as part of SAP S/4HANA (SAP S/4HANA 2021 or higher) with the following deployment options:
• Decentralized EWM based on SAP S/4HANA
• EWM embedded in SAP S/4HANA
Note
For support packages lower than SP03 for SAP S/4HANA 2021, implement the SAP Note 3147663
and 3247030 .
In this section, you can find some additional settings in SAP EWM that you need to define before robots can
process warehouse orders in SAP Warehouse Robotics.
Ensure that the resources in SAP EWM can meet the following requirements:
Note
SAP Warehouse Robotics assigns warehouse orders to a robot regardless of the logon or logoff status of
the mapped resource in SAP EWM. We recommend that you keep your robot resources logged on.
For robots integrated via integration services, if you want to stop a robot from processing warehouse
orders, disable the robot for use in the Monitor Robots app.
Ensure that the warehouse orders in SAP EWM can meet the following requirements:
Note
If you update a warehouse order in SAP EWM after it is retrieved by SAP Warehouse Robotics, the
system can't synchronize the changes to SAP Warehouse Robotics.
But depending on the type of changes, the results can be different. See the following details:
• If you change the latest starting date or processor, or remove the warehouse order from the queue,
such changes won't affect the processing of warehouse orders by a robot.
Provide a dedicated queue for each warehouse in SAP EWM for exception handling for robots.
For robots integrated via integration services for SAP EWM, if you want to handle the exception for destination
bin errors, ensure that you have defined the following settings in SAP EWM:
Ensure that the robots can access the physical source and destination bins of the warehouse orders. Consider
the physical characteristics of your robots.
For robots integrated via fleet management systems, you want to use the robots to move HUs, for example,
carts, totes, and so on. When an HU becomes empty in the storage bins planned to be accessed by robots,
do not delete the empty HU. To stop the system from deleting the empty HUs automatically after unpacking,
deselect the Deleted checkbox in Customizing for Extended Warehouse Management under Goods Receipt
Process Slotting Influencing Parameters Packaging Material Determination Define Packaging Material
Types .
If you want to unpack an HU, we recommend that you first move the HU and the stock to a storage bin that
can’t be accessed by robots. If you really need to unpack the HU in a storage bin that’s accessible to robots,
ensure that SAP EWM creates warehouse tasks for moving the empty HU.
If you physically change the position of an HU, or you let the robot of your fleet management system change
the postion using a robot task not from SAP Warehouse Robotics, ensure that you update the correct stock
This section describes how to configure user management for your application. As a prerequisite, you have
created business users and user groups in your identity provider (IdP). SAP ID service is configured as the
default IdP, but you can also add your instance of SAP Cloud Identity Services - Identity Authentication or a
different IdP.
If you use the Identity Authentication service, you can find more information in the SAP BTP documentation
under Manually Establish Trust and Federation Between UAA and Identity Authentication.
If you use a different IdP, you can find more information under Establish Trust and Federation with UAA Using
Any SAML Identity Provider.
ROBOT_ADMIN • Assigned users can de Not applicable Onboard Robots - Integration
fine robots and set up Services, Onboard Robots -
the connections among Fleet Management
robots, edge nodes,
and SAP Warehouse
Robotics.
• Assigned users can de
fine robots and set
up the connection be
tween fleet manage
ment systems and SAP
Warehouse Robotics .
CONFIGURATION _EXPERT Assigned users can create Not applicable Configure Your Solution
warehouse numbers, upload
warehouse data, connect to
SAP EWM, and define facili
ties for robots.
WAREHOUSE_ CLERK Assigned users can define Not applicable Define Robot Settings
settings for robots and mon - Integration Services,
itor robot operations in a Monitor Robots, Define
warehouse. Robot Processes - Fleet
Management
If the role template doesn't have any attributes, then the corresponding roles are identical to the role templates
and are created automatically. If the role template has one or more attributes, you must create roles based on
the role templates and provide the attribute values.
You use the ROBOT_ADMIN, CONFIGURATION _EXPERT, and WAREHOUSE_ CLERK role templates to create
roles. Then you use the WAREHOUSE_ACCESS role template to give authorizations to these roles.
As a prerequisite for assigning roles to IdP users or user groups, you also need to configure role collections.
A role collection consists of one or more roles from one or more applications and can be used to bundle
authorizations within and across applications.
For more information about how to create roles and how to bundle them in role collections using the SAP BTP
cockpit, see Building Roles and Role Collections for Applications.
In the SAP BTP cockpit, you must define a role collection and add roles that are derived from role templates to
the role collection.
For more information about the existing role templates for SAP Warehouse Robotics, see Defining and Bundling
Roles [page 14].
For more information about adding roles to a role collection in the SAP BTP cockpit, see Add Roles to a Role
Collection.
In the SAP BTP cockpit, you must assign role collections to IdP users or user groups. As a prerequisite, users
and user groups must have been created in the Identity Authentication service or another IdP.
Note
If you use the SAP ID service, you assign role collections to individual users. If you use the Identity
Authentication service or another IdP, you assign them either to individual users or to user groups.
For more information about how to assign role collections to users or user groups using the SAP BTP cockpit,
see Assigning Role Collections.
A business configuration expert can define required settings before a warehouse clerk can use SAP Warehouse
Robotics.
With this app, you can make settings relevant to warehouse master data for robots.
For the integration via fleet management, you use the following configuration steps:
For integration services for SAP Warehouse Robotics, you use the following configuration steps:
With this configuration step, you can create, edit, and delete warehouse numbers.
Procedure
Note
If you purchased a test and demo license for SAP Warehouse Robotics, you can have a maximum of five
warehouse numbers.
With this configuration step, you can integrate SAP Warehouse Robotics with SAP Extended Warehouse
Management (SAP EWM) systems.
After a successful integration, SAP Warehouse Robotics can read and write relevant warehouse data from SAP
EWM.
Prerequisites
You’ve created a warehouse number using the Manage Warehouses configuration step.
Procedure
Note
The integration check doesn't include the integration with a logical system.
7. Define a time interval between data synchronizations. Specify the time frequency for SAP Warehouse
Robotics to retrieve open warehouse orders from SAP EWM. The time interval falls between five seconds
and 600 seconds.
Note
This step is only applicable for robots integrated via fleet management systems.
Integration Check
If the integration status check isn't successful, there can be the following reasons for an unsuccessful
integration:
With this configuration step, you can upload essential warehouse data for robots.
Prerequisites
• You’ve created a warehouse number using the Manage Warehouses configuration step.
• You have downloaded CSV files from the destination system, for example, SAP EWM. To download these
files from SAP EWM, implement the SAP Note 3200063 .
Procedure
Additional Information
File Names
You can use the following files from a destination warehouse management system, for example, an SAP EWM
system.
RSRC Resources
Note
• The uploaded files must contain the same file names listed above.
• You can view reports for upload details. If an upload is unsuccessful, you can view the error messages.
• If you upload warehouse data again for a warehouse number, the system overwrites the data with
duplicated keys and appends the data with new keys.
If there are keys that exist in the previous upload but not in the current upload, the system still keeps
these keys. If you want to start a new upload, first clear the history data of the previous upload.
Some files above aren’t mandatory, for example, the files TGWLOBJ, TDC_EDGE_R, TBIN_AT, and TBIN_AT_PR.
However, to improve data consistency, we highly recommend that you upload these files.
To upload files successfully, you must make sure that the following file settings are satisfied:
Required Fields
The following table lists the required fields for the corresponding CSV files:
X_CORD X Coordinate
Y_CORD Y Coordinate
Z_CORD Z Coordinate
QUEUE Queue
MAX_LENGTH Length
MAX_WIDTH Width
MAX_HEIGHT Height
QUEUE Queue
QUEUE Queue
PRIORITY Priority
ACT_TYPE Activity
PRIORITY Priority
With this configuration step, you can create charging point types and charging points.
Note
This step is only applicable for robots integrated via integration services for SAP Warehouse Robotics.
Activities
Charging Point Types
If you create a charging point type and specify dedicated robot types, only the specified robot types can use
the charging points of the charging point type.
Charging Points
You can create charging points and group them under different charging point types. Note that you must create
the same number of charging points as the number of robots.
Security has always been an important element for the complete product life cycle of all SAP products,
including product development, planning, and quality assurance. Like the other SAP products, SAP Warehouse
Robotics was designed to fulfill the highest security standards which guarantee the safety of your data from
attacks.
Note
For more information about security on SAP BTP, see the SAP BTP documentation under Security.
SAP Warehouse Robotics microservices use the User Account and Authentication (UAA) service for user
authentication and authorization provided in the Cloud Foundry environment by SAP BTP.
SAP Warehouse Robotics microservices are enabled for the OAuth 2.0 client credentials grant flow. OAuth 2.0
is a widely-adopted security protocol for the protection of resources over the Internet. It allows an application
to request authentication on behalf of users with third-party user accounts without requiring the users to grant
their credentials to the application themselves. Based on the OAuth 2.0 client credential grant specification,
the UAA service issues an access token based on client credentials without any user interaction. For more
information, see Authorization and Trust Management Overview.
Appropriate authorization is required for access to SAP Warehouse Robotics microservices and APIs.
APIs and services of SAP Warehouse Robotics are protected by the OAuth 2.0 authorization framework which
defines an authorization protocol for protected API resources. The supported credential type is the client
credentials grant.
The OAuth 2.0 authorization protocol focuses on simplicity by providing security through tokens. It uses
short-lived and specific bearer tokens, and longer-lived refresh tokens which are used to obtain bearer tokens.
Session security is ensured through the validation of these tokens in the APIs and services of SAP Warehouse
Robotics.
Your network infrastructure plays an important role in protecting your system. It supports the communication
necessary for your business needs and prevents unauthorized access to your resources. A well-defined
network topology eliminates many security threats based on software flaws (at operating system level and
application level) or network attacks, such as eavesdropping.
The network topology of SAP Warehouse Robotics is based on the topology used by SAP Cloud Foundry and
SAP BTP. Therefore, the security guidelines and recommendations described in the security guide of SAP BTP
also apply to SAP Warehouse Robotics.
Data storage security is about how SAP Warehouse Robotics protects its own database. Date storage security
is ensured by the isolated tenant that each customer receives. In SAP Warehouse Robotics, the customer data
isolation is based on database's schema level. Only tenant-specific requests can access the tenant data.
Hyperlinks
Some 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 an 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.
Example Code
Any 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.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
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.