administration guide for sap warehouse insights
TRANSCRIPT
Administration Guide | PUBLICSAP Warehouse InsightsDocument Version: 2108 – 2021-08-21
Administration Guide for SAP Warehouse Insights
© 2
021 S
AP S
E or
an
SAP affi
liate
com
pany
. All r
ight
s re
serv
ed.
THE BEST RUN
Content
1 Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3 Technical Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.1 Additional Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.2 Browsers and Browser Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.3 Supported Data Centers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4 Onboarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
5 Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125.1 Connecting to SAP EWM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125.2 Connecting to an IoT Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
6 User Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186.1 Defining and Bundling Roles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186.2 Assigning Role Collections to Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7 Business Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217.1 Configure Your Solution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Manage Warehouses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Define EWM Integration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22Upload Warehouse Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Manage Travel Distance Networks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Define Optimization Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Define Bin Coordinates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36Define IoT Integration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Define Indoor Positioning Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Define Geofences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7.2 Tools. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Export Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
8 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468.1 User Administration, Authentication, and Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468.2 Session Security Protection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .468.3 Network and Communication Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478.4 Data Storage Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478.5 Audit Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2 PUBLICAdministration Guide for SAP Warehouse Insights
Content
Accessing the Audit Log Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Administration Guide for SAP Warehouse InsightsContent PUBLIC 3
1 Document History
Provides details about the changes made in each version of this document.
Document Version Date Comment
1.5 2021-08-21 The following changes are made to this guide:
● Configure Your Solution [page 21]In this chapter, three new configuration steps were added for SAP Warehouse Insights 2108.
● Connectivity [page 12]In this chapter, changes were made to Connecting to SAP EWM [page 12], and a new chapter Connecting to an IoT Service [page 16] was added with two new IoT integration scenarios.
● Define Optimization Settings [page 30]In this chapter, content was added about defining a queue priority.
1.4 2021-2-20 The following changes are made to this guide:
● Connecting to SAP EWM [page 12]In this chapter, content was added about SAP Warehouse Insights 2102.
● Define EWM Integration Settings [page 22]In this chapter, content was added about entering a logical system and about new integration-based features in SAP Warehouse Insights 2102.
4 PUBLICAdministration Guide for SAP Warehouse Insights
Document History
Document Version Date Comment
1.3 2020-11-14 The following changes are made to this guide:
● Onboarding [page 11]A how-to guide and video link was added.
● Connecting to SAP EWM [page 12]Changes were made to version names of SAP Warehouse Insights.
● Defining and Bundling Roles [page 18]An app was added for business configuration experts.
● Define New Coordinates [page 36]Content was added about selecting positions on a warehouse layout.
● Export Data [page 42]A new chapter
Administration Guide for SAP Warehouse InsightsDocument History PUBLIC 5
Document Version Date Comment
1.2 2020-8-17 The following changes are made to this guide:
● Connecting to SAP EWM [page 12]In this chapter, content was added for version control.
● Define EWM Integration Settings [page 22]In this chapter, content was added for selection of releases supported by destination systems.
● Upload Warehouse Data [page 24]In this chapter, content was added for a note about confirmed warehouse orders or tasks.
● Define Bin Coordinates [page 36]In this chapter, content was added for defining new coordinates without PDF files and updating existing bin coordinates.
● Manage Travel Distance Networks [page 29]In this chapter, content was added for showing edge information based on aisles.
● Define Live Optimization [page 33]In this chapter, content was added for settings about including resources in live optimization based on resource groups.
1.1 2020-03-30 The following changes are made to this guide:
● Manage Warehouses [page 21]In this chapter, content about advanced management was added.
● Security [page 46]In this chapter, a note was added.
● The following new chapters were created:○ Define Bin Coordinates [page
36]○ Audit Logging [page 47]○ Accessing the Audit Log
Viewer [page 47]
6 PUBLICAdministration Guide for SAP Warehouse Insights
Document History
Document Version Date Comment
1.0 2019-11-25 Initial version
Administration Guide for SAP Warehouse InsightsDocument History PUBLIC 7
2 Overview
About This Guide
This administration guide describes the configuration and security information about SAP Warehouse Insights.
This guide addresses the following target audience:
● Business configuration experts● Key users
About SAP Warehouse Insights
For more information about the features provided by SAP Warehouse Insights, see the product assistance for SAP Warehouse Insights on SAP Help Portal at http://help.sap.com/wi. Under the Use tab, choose Application Help for SAP Warehouse Insights.
For a quick start guide about SAP Warehouse Insights, see the steps in SAP Note 2863221 .
8 PUBLICAdministration Guide for SAP Warehouse Insights
Overview
3 Technical Prerequisites
Before you start to use SAP Warehouse Insights, check the requirements and recommendations in this section.
3.1 Additional Software
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.
3.2 Browsers and Browser Settings
For UIs of SAP Warehouse Insights, the following browsers are supported on Microsoft Windows PCs and, where mentioned below, on macOS:
Browser Versions
Microsoft Edge Latest version
Mozilla Firefox Extended Support Release (ESR) and latest version
Google Chrome Latest version
Safari Latest version (for macOS only)
We highly recommend that you use the browser Google Chrome.
3.3 Supported Data Centers
SAP Warehouse Insights supports the use of the following data centers:
Region Infrastructure Provider Region Host
Europe (Frankfurt) Amazon Web Services (AWS) eu10.hana.ondemand.com
US West (WA) Microsoft Azure us20.hana.ondemand.com
Administration Guide for SAP Warehouse InsightsTechnical Prerequisites PUBLIC 9
Region Infrastructure Provider Region Host
China (Shanghai) Alibaba Cloud cn40.apps.platform.sapcloud.cn
We recommend that you choose the data center closest to where most users of the application are located.
10 PUBLICAdministration Guide for SAP Warehouse Insights
Technical Prerequisites
4 Onboarding
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 a how-to video, see help.sap.com/wi under Getting Started Video LibraryOnboarding .
For more information about configuration steps during onboarding, see the document in how-to guides .
Administration Guide for SAP Warehouse InsightsOnboarding PUBLIC 11
5 Connectivity
You can integrate SAP Warehouse Insights with SAP Extended Warehouse Management systems.
For more information about connectivity, see the SAP BTP documentation under Connectivity in the Cloud Foundry Environment.
5.1 Connecting to SAP EWM
You can connect SAP Warehouse Insights to SAP Extended Warehouse Management (SAP EWM) as a standalone product, decentralized EWM based on SAP S/4HANA or EWM as a part of SAP S/4HANA. To be brief on the product names, SAP EWM is used for references to these deployments in this guide.
If you want to check the daily average number of resources in SAP EWM that can be optimized, you can use a local report in SAP Note 2982094 .
Prerequisites
OData ServiceOData 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).
To upload confirmed warehouse orders and warehouse tasks directly from EWM, or to run live optimization, make sure that you activated the OData service /SCWM/WI_INTEGRATION for SAP Warehouse Insights.
For more information about activating OData services, see Activating OData Services.
To read resource execution data directly from EWM in the Resource Indoor Positioning app, make sure you published the following OData V4 service groups:
● API_WAREHOUSE_RESOURCE_2● API_WAREHOUSE_ORDER_TASK_2
For more information about all preprocessing steps, see Configure SAP EWM for Reading Resource Execution Information and Enable OData V4 Service Groups in an SAP EWM System in the How-To Guide section.
For more information about publishing OData V4 service groups, see Activating OData Services.
Work Processing Using Radio Frequency (RF) in SAP EWMYou can use the system-guided processing of warehouse orders using RF in SAP EWM. To enable it to use the optimized warehouse order assignments provided by SAP Warehouse Insights, implement the Business Add-In (BAdI) in SAP Note 2865034 .
12 PUBLICAdministration Guide for SAP Warehouse Insights
Connectivity
Customizing Settings
In SAP EWM, you’ve enabled the integration with SAP Warehouse Insights in Customizing for Extended Warehouse Management under Interfaces SAP Warehouse Insights Integration Enable SAP Warehouse Insights Integration .
This setting is dependent on the current release of your SAP EWM system, or whether you've implemented the SAP Notes listed under Additional Information Version Control in this document. If your system doesn't contain this Customizing setting, you can skip this prerequisite.
Optional Prerequisites
If you're using a release that is SAP Warehouse Insights 2102 or higher, and you want to enable the system to reassign warehouse orders based on resource changes during live optimization, you must first perform the following actions:
● For an SAP EWM system that doesn't support a full integration with SAP Warehouse Insights, you’ve applied the SAP Notes in the following section about version control.
● In SAP EWM, you’ve enabled the integration with SAP Warehouse Insights in Customizing for Extended Warehouse Management under Interfaces SAP Warehouse Insights Integration Enable SAP Warehouse Insights Integration .You've implemented BAdI: Notifying SAP Warehouse Insights of Resource Changes in Customizing for Extended Warehouse Management under Business Add-Ins (BAdIs) for Extended Warehouse Management Internal Warehouse Processes Resource Management .For more information about all preprocessing steps, see the document Configure SAP EWM for Notification of Resource Changes in the How-To Guides .
● In the SAP BTP cockpit, you’ve subscribed to the SAP Warehouse Insights Services and configured the services by following the instructions in the document Configure SAP Warehouse Insights Services in the How-To Guides .
● In the Define EWM Integration Settings configuration step, you’ve specified a logical system and the release SAP Warehouse Insights 2102 or higher.
● In the Define Optimization Settings configuration step, you’ve activated the live optimization.
Procedures
You need to perform the following actions to set up and operate the connections to the on-premise system:
● SAP Cloud ConnectorConfigure SAP Cloud Connector in the on-premise landscape.
NoteWhen you edit a resource, select the Path and All Sub-Paths access policy.
For more information, see Cloud Connector.● Destinations
Set up HTTP destinations in SAP BTP.
Administration Guide for SAP Warehouse InsightsConnectivity PUBLIC 13
NoteWhen 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 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.
Additional Information
Version ControlEnsure that SAP EWM can communicate properly with the connected SAP Warehouse Insights release. The connection determines whether the integration-dependent functions of SAP Warehouse Insights are to be used or not.
The following table shows the mapping relationship between SAP Warehouse Insights releases and SAP EWM releases.
Note● The version control affects only the integration-based features. The features that don't rely on the
integration are always available for use regardless of your SAP EWM release.● If your system belongs to an SAP EWM version in the second column of the table below, you can use
the integration-based features of SAP Warehouse Insights release in the first column without additional implementation about integration.
● If your system belongs to a lower feature pack stack or support package of an SAP EWM release, you can apply some SAP Notes for a full integration with SAP Warehouse Insights. Otherwise, some integration-based features aren't available.
14 PUBLICAdministration Guide for SAP Warehouse Insights
Connectivity
SAP Warehouse Insights Release Supported by Destination System (SAP EWM)
SAP EWM Release
NoteThe following releases support a full integration with the corresponding SAP Warehouse Insights release in the first column, and don't require implementation of SAP Notes.
SAP Notes for Lower SAP EWM Releases
SAP Warehouse Insights 2108 or higher
SAP S/4HANA 2021 FPS00
NoteThe release might not have been published yet.
NoteThe new integration-based features, for example viewing the execution data of a resource in the Resource Indoor Positioning app, are only available as of SAP S/4HANA 2021 FPS00. Please contact us if you would like to use this feature in a lower EWM release.
If you require a full integration of the live optimization, please refer to the below row for SAP Warehouse Insights 2102
SAP Warehouse Insights 2102
● SAP S/4HANA 2021 FPS00● SAP S/4HANA 2020 FPS02 or higher● SAP S/4HANA 1909 SP04 or higher● SAP S/4HANA 1809 SP06 or higher● SAP EWM 9.5 SP08 or higher● SAP EWM 9.4 SP14 or higher
NoteSome of the releases might not have been published yet.
NoteBefore applying notes to support integration with SAP Warehouse Insights 2102 or higher, make sure that you've deactivated live optimization in the Define Optimization Settings app. Otherwise, if your system is running live optimization, it is interrupted.
1. SAP Note 2770546
2. SAP Note 2927464
3. SAP Note 2984213
SAP Warehouse Insights 2008 or 2011
● SAP S/4HANA 2020 FPS00● SAP S/4HANA 1909 SP03 or higher● SAP S/4HANA 1809 SP05 or higher● SAP EWM 9.5 SP07 or higher● SAP EWM 9.4 SP13 or higher
1. SAP Note 2770546
2. SAP Note 2823691
3. SAP Note 2824049
4. SAP Note 2927464
SAP Warehouse Insights 2003
● SAP S/4HANA 1909 FPS01 or higher● SAP S/4HANA 1809 SP03 or higher● SAP EWM 9.5 SP05 or higher● SAP EWM 9.4 SP11 or higher
1. SAP Note 2770546
2. SAP Note 2823691
3. SAP Note 2824049
Administration Guide for SAP Warehouse InsightsConnectivity PUBLIC 15
Integration-Based Features
The following table shows a complete list of integration-based features in SAP Warehouse Insights. If your SAP EWM system isn't fully integrated with a release, for example, SAP Warehouse Insights 2008, you can't use the new integration-based features in this release.
Release New Integration-Based Features
SAP Warehouse Insights 2108 or Higher You can view the execution data of a resource in the Resource Indoor Positioning app.
NotePlease be aware that this new feature is only supported as of SAP S/4HANA 2021 FPS00.
SAP Warehouse Insights 2102 The system can reassign warehouse orders for live optimization in response to resource changes from a destination system.
SAP Warehouse Insights 2008 or 2011 ● The system includes resources in live optimization based on resource groups.
● You can upload confirmed warehouse orders or tasks from a destination warehouse number based on resource types.
● While viewing a heatmap, you can filter confirmed warehouse tasks by warehouse process type.
SAP Warehouse Insights 2003 ● The system includes resources in live optimization based on selection of resources.
● You can upload confirmed warehouse orders or tasks from a destination warehouse number based on a date range selection.
Related Information
Define EWM Integration Settings [page 22]
5.2 Connecting to an IoT Service
You can connect SAP Warehouse Insights to an IoT service.
The following IoT integration scenarios are available:
● IoT integration with SAP Internet of Things (SAP IoT)● IoT integration with IoT Platform from Alibaba Cloud
16 PUBLICAdministration Guide for SAP Warehouse Insights
Connectivity
Prerequisites
● You have set up an IoT instance.● You have made the recommended settings for the integration with SAP IoT or IoT Platform from Alibaba
Cloud.● You have set up destinations in SAP Business Technology Platform (SAP BTP) to connect to an IoT service.● The IoT devices are sending position messages with the following values to the IoT service:
Value Data Type Description
x float These values refer to the position of the device and must match the coordinates of the warehouse layout.
The unit of measure is meter.y
z
time long This value refers to the point in time at wich the device sends out the data.
(Unix time, represented in milliseconds since January 1, 1970)
For more information about the recommended settings, see the following documents in the How-To Guidessection:
● Recommended Settings for the Integration with SAP IoT● Recommended Settings for the Integration with IoT Platform from Alibaba Cloud
Key Features
With a successful integration, you can use all features of the Resource Indoor Positioning app, for example:
● Visualize resources on the warehouse layout● Monitor the status of resources● View geofences and geofence alerts
Additional Information
The following configuration steps in the Configure Your Solution app contain settings related to the use of the IoT integration in SAP Warehouse Insights:
● Define IoT Integration Settings [page 40]● Define Indoor Positioning Settings [page 41]● Define Geofences [page 42]
Version Control
For more information about SAP EWM releases that support IoT integration see the Version Control table in Connecting to SAP EWM [page 12].
Administration Guide for SAP Warehouse InsightsConnectivity PUBLIC 17
6 User Management
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.
6.1 Defining and Bundling Roles
SAP Warehouse Insights provides the following role templates:
Role Template Description Available AttributesTiles on SAP Fiori Launchpad
CONFIGURATION _EXPERT Assigned users can make all essential configuration steps, for example, create warehouse numbers, upload warehouse data, define optimization settings, and specify settings related to the visualization of real-time data.
Not applicable Configure Your Solution with the following configuration steps:
● Manage Warehouses● Define EWM Integration
Settings● Upload Warehouse Data● Manage Travel Distance
Networks● Define Optimization Set
tings● Define Bin Coordinates● Define IoT Integration
Settings● Define Indoor Position
ing Settings● Define Geofences
Export Data
18 PUBLICAdministration Guide for SAP Warehouse Insights
User Management
Role Template Description Available AttributesTiles on SAP Fiori Launchpad
WAREHOUSE_ CLERK Assigned users can analyze the optimization results based on real-time and simulated optimization.
Not applicable Configure Your Solution
NoteYou can have access to the following configuration steps in this app:
● Upload Warehouse DataYou can upload only basic and transaction data.
● Define Optimization Settings
● Define Indoor Positioning SettingsYou can set a maximum resource speed and a stationary resource threshold.
,
Warehouse Layout
Warehouse Operations Overview - Off-Line Data
Simulate Order Assignments - Off-Line Optimization
Monitor Live Optimization
Heatmap
Resource Indoor Positioning
WAREHOUSE_ACCESS Assigned users can have access to specific warehouse numbers.
WAREHOUSE_NAME
NoteIf you want a business role to have access to all warehouse numbers, enter an asterisk (*) for this attribute value.
Not applicable
Administration Guide for SAP Warehouse InsightsUser Management PUBLIC 19
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 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.
6.2 Assigning Role Collections to Users
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.
NoteIf 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.
20 PUBLICAdministration Guide for SAP Warehouse Insights
User Management
7 Business Configuration
You make all necessary configurations for other users, like warehouse clerks to use the features of SAP Warehouse Insights.
7.1 Configure Your Solution
You make necessary settings for optimization processes.
With this app, you can make settings using the following configuration steps:
● Manage Warehouses [page 21]● Define EWM Integration Settings [page 22]● Upload Warehouse Data [page 24]● Manage Travel Distance Networks [page 29]● Define Optimization Settings [page 30]● Define Bin Coordinates [page 36]
7.1.1 Manage Warehouses
With this configuration step, you can create, edit, and delete warehouse numbers. At the top, you can also view the number of resources that are included in live optimization (Number of Managed Resources). This number indicates the sum of the daily average numbers for all warehouses for a tenant.
Procedure
Creating a Warehouse Number
To create a warehouse number, perform the following actions:
1. Choose Create Warehouse Number.2. Enter a warehouse number and description.3. Select a time zone and unit of length for travel distance calculation.
All time displayed for a warehouse number is based on the time zone that you specified here.Make sure that you use the same unit of length throughout the warehouse, for example, when you upload data in the Upload Warehouse Data configuration step, you use the same unit of length for the storage bin coordinates, bin size, edge length, and edge coordinates.
4. Save your entries.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 21
NoteIf you purchased a test & demo license for SAP Warehouse Insights, you can have a maximum of five warehouse numbers.
Advanced Management
You can download application logs for the Simulate Order Assignments - Off-Line Data app and the Monitor Live Optimization app. Before exporting the file, make sure that there’s optimization data in the apps. To download the logs, perform the following actions:
1. Choose a warehouse number and then Advanced Management.2. Under the Exporting Trace Files for Warehouse Optimization tab, choose to export trace files for live or off
line optimization.3. Choose the relevant filters and then export the file.
The system automatically downloads a ZIP file. To find the file, check the downloads folder of your browser. For example, if you're using Google Chrome, choose Customize and control Google ChromeDownloads , or use the keyboard shortcut CTRL + J .
More Information
For more information, go to help.sap.com/wi, choose the Discover tab, and navigate to TroubleshootingFrequently Asked Questions for SAP Warehouse Insights .
7.1.2 Define EWM Integration Settings
With this configuration step, you can integrate SAP Warehouse Insights with SAP Extended Warehouse Management (SAP EWM) systems.
After a successful integration, SAP Warehouse Insights can read and write relevant warehouse data from SAP EWM.
Prerequisites
You’ve created a warehouse number using the Manage Warehouses configuration step.
Procedure
To integrate with a destination system, perform the following actions:
22 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
1. Edit an existing entry for a warehouse number.2. Select a destination system that you configured in the SAP BTP cockpit.3. Enter a destination warehouse number, for example, an SAP EWM warehouse number.4. Specify a logical system in the destination system.5. Save your entries.6. Check the release supported by your destination system.
On the Integration-Based Features tab, edit an entry and select an SAP Warehouse Insights release that is supported by your destination system. This selection determines which integration-based features are available. For more information about version control, see Connecting to SAP EWM [page 12].
7. Check the integration status.For this entry, choose Check to test whether SAP Warehouse Insights and the destination system are integrated successfully.
Note○ The integration check does not include the integration with a logical system.○ The integration check is based on the value that you choose under Release Supported by
Destination System.
Additional Information
Integration CheckIf the integration status check isn't successful, you can't use the integration-based features for this warehouse number, such as live optimization. There can be the following reasons for an unsuccessful integration:
● The destination system can't be connected.● The destination warehouse number doesn't exist.● The essential OData services aren't configured for a destination system.
The various OData services are used for different features. Please check if you need a full integration of these OData services. For a complete list of integration-based features, see Connecting to SAP EWM [page 12].
Integration-Based FeaturesYou can integrate with different versions of SAP EWM. However, not all SAP EWM versions are fully integrated with SAP Warehouse Insights. For those versions, you can apply some SAP Notes for a full integration. For more information about these SAP Notes, see Connecting to SAP EWM [page 12].
Reassignment of Warehouse Orders in Response to Resource ChangesIf there are changes to resources in SAP EWM and you’ve specified the release SAP Warehouse Insights 2102 or higher and a logical system, the system can automatically reassign open warehouse orders to your resources during live optimization. However, in SAP EWM, you must enable the integration with SAP Warehouse Insights in Customizing for Extended Warehouse Management under Interfaces SAP Warehouse Insights Integration Enable SAP Warehouse Insights Integration .
For more information, go to help.sap.com/wi, choose the Discover tab, and navigate to TroubleshootingFrequently Asked Questions for SAP Warehouse Insights .
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 23
Related Information
Manage Warehouses [page 21]Connecting to SAP EWM [page 12]
7.1.3 Upload Warehouse Data
With this configuration step, you can upload essential warehouse data for optimization processes and layout-based analysis.
Prerequisites
Make sure that you’ve performed the following actions:
● You’ve created a warehouse number using the Manage Warehouses configuration step.● If you want to upload confirmed warehouse orders and warehouse tasks from a destination system, make
sure that you’ve connected to a destination system and destination warehouse number using the Define Integration Settings 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 2722858 .
Note
You can also use the sample data in the SAP Note 2925984 .
Procedure
To upload data for a warehouse number, perform the following actions:
1. Choose a warehouse number.2. Upload data.
You can upload data in the following ways:○ Choose Upload Files to upload data using offline CSV files.○ Choose Upload from Destination Warehouse Number to upload confirmed warehouse orders and
warehouse tasks directly from an integrated destination system. You can also upload confirmed warehouse orders and warehouse tasks using CSV files.
NoteFor your warehouse, the total number of days containing confirmed orders or tasks can't exceed 90 days. If your uploaded data exceeds these days, you can clear data for some dates.
24 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
If you purchased a test & demo license for SAP Warehouse Insights, you can upload a maximum of 5 GB of data.
Additional Information
File Names
You can use the following files from a destination warehouse management system, for example, an SAP EWM system.
File Name Description
LAGP Storage Bins
ORDIM_C Confirmed Warehouse Tasks
RSRC Resources
T303 Storage Bin Types
T331 Storage Type Control
T333 Warehouse Process Type
T346 Queue Definitions
TBIN_AT Bin Access Types
TBIN_AT_PR Bin Access Type Priority per Resource Type
TDC_EDGE Edges for Travel Distance Calculation
TDC_EDGE_R Excluded Resource Type per Edge
TGWLOBJ GWL: Objects
TRSGR_Q_SQ Sequenced Queues per Resource Group
TRSRC_GRP Resource Groups
TRSRC_TYP Resource Types
WHO Confirmed Warehouse Orders
NotePay attention to the following points:
● 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.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 25
Required File Settings
To upload files successfully, you must make sure that the following file settings are satisfied:
● The file contains all required fields.● The file contains a header.● The file uses commas "," as separators● The file is less than 500 MB (megabytes) in size.
Required Fields
The following table lists the required fields for the corresponding CSV files:
File Name Required Field Field Name
Storage Bins (LAGP) LGNUM Warehouse Number
LGPLA Storage Bin
LGTYP Storage Type
LGBER Storage Section
LPTYP Storage Bin Type
AISLE Storage Bin Aisle
X_CORD X Coordinate
Y_CORD Y Coordinate
Z_CORD Z Coordinate
STACK Storage Bin Stack
LVL_V Storage Bin Level
ANGLE Angle for Alignment of a Storage Bin (Degrees)
BIN_AT Bin Access Type
Edges for Travel Distance Calculation (TDC_EDGE)
LGNUM Warehouse Number
LGTYP Storage Type
EDGE_ID Identification of an Edge
NODE_ID_START Identification of Start Node
NODE_ID_END Identification of End Node
X_CORD_START X Coordinate of Edge Start Node
X_CORD_END X Coordinate of Edge End Node
Y_CORD_START Y Coordinate of Edge Start Node
Y_CORD_END Y Coordinate of Edge End Node
DIRECTION Edge Direction
AISLE Storage Bin Aisle
Excluded Resource Type per Edge (TDC_EDGE_R)
LGNUM Warehouse Number
EDGE_ID Identification of an Edge
26 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
File Name Required Field Field Name
RSRC_TYPE Resource Type
Resources (RSRC) LGNUM Warehouse Number
RSRC Resource (Means of Transportation or User)
RSRC_TYPE Resource Type
RSRC_GRP Resource Group
QUEUE Queue
ACTUAL_BIN Current Storage Bin of a Resource
Resource Types (TRSRC_TYP) LGNUM Warehouse Number
RSRC_TYPE Resource Type
VELOCITY Resource Type Velocity in m/s
Confirmed Warehouse Orders (WHO) LGNUM Warehouse Number
WHO Warehouse Order Number
STATUS Warehouse Order Status
CREATED_AT Creation Time
STARTED_AT Start Time
CHANGED_AT Time of Change
QUEUE Queue
RSRC Resource (Means of Transportation or User)
LSD Latest Starting Date (LSD)
Confirmed Warehouse Tasks (ORDIM_C)
LGNUM Warehouse Number
TANUM Warehouse Task
TAPOS Warehouse Task Item
VLTYP Source Storage Type
VLBER Source Storage Section
VLPLA Source Storage Bin
NLTYP Destination Storage Type
NLBER Destination Storage Section
NLPLA Destination Storage Bin
CONFIRMED_AT Time of Confirmation
TRART Warehouse Process Category
EXCCODE Exception Code
WHO Warehouse Order Number
PROCTY Warehouse Process Type
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 27
File Name Required Field Field Name
Storage Bin Types (T303) LGNUM Warehouse Number
LPTYP Storage Bin Type
MAX_LENGTH Length
MAX_WIDTH Width
MAX_HEIGHT Height
Storage Type Control (T331) LGNUM Warehouse Number
LGTYP Storage Type
STGTYP_LVL Level of Storage Type
GWL: Objects (TGWLOBJ) LGNUM Warehouse Number
OBJID Unique Identifier for a GWL Object
OBJCAT Graphical Warehouse Layout Object Category
X0 X Coordinate of Lower Left Corner
Y0 Y Coordinate of Lower Left Corner
X1 X Coordinate of Lower Right Corner
Y1 Y Coordinate of Lower Right Corner
X2 X Coordinate of Upper Right Corner
Y2 Y Coordinate of Upper Right Corner
X3 X Coordinate of Upper Left Corner
Y3 Y Coordinate of Upper Left Corner
STGTYP_LVL Level of Storage Type
Resource Groups (TRSRC_GRP) LGNUM Warehouse Number
RSRC_GRP Resource Group
Queue Definitions (T346) LGNUM Warehouse Number
QUEUE Queue
Sequenced Queues per Resource Group (TRSGR_Q_SQ)
LGNUM Warehouse Number
RSRC_GRP Resource Group
SEQNO Sequence Number
QUEUE Queue
Bin Access Types (TBIN_AT) LGNUM Warehouse Number
BIN_AT Bin Access Type
Bin Access Type Priority per Resource Type (TBIN_AT_PR)
LGNUM Warehouse Number
RSRC_TYPE Resource Type
BIN_AT Bin Access Type
PRIORITY Priority
28 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
File Name Required Field Field Name
Warehouse Process Type (T333) PROCTY Warehouse Process Type
TRART Warehouse Process Category
ACT_TYPE Activity
For more information, go to help.sap.com/wi, choose the Discover tab, and navigate to TroubleshootingFrequently Asked Questions for SAP Warehouse Insights .
Related Information
Manage Warehouses [page 21]Define EWM Integration Settings [page 22]
7.1.4 Manage Travel Distance Networks
With this configuration step, you can build a network with connected nodes and passable resource travel paths. You can also connect nodes and travel paths.
Prerequisites
Make sure that you have made the following configurations:
● You’ve created a warehouse number using the Manage Warehouses configuration step.● You’ve uploaded the relevant data for your warehouse number using the Upload Warehouse Data
configuration step.
NoteTo build a network, upload the following data:
○ Storage bins○ Storage bin types○ Edges for travel distance calculation○ Excluded resource type per edge (optional)
Procedure
To build a travel distance network, perform the following actions:
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 29
1. Choose the radio button of a warehouse number.2. Choose Build.
The system calculates travel distances in the network. Make sure that the network is calculated successfully for your warehouse number. Otherwise, you can't use some functions in the other processes.Note that if you have a large amount of warehouse data, there can be some waiting time before the system successfully generates a network.
Additional Information
To show more information about edges in your warehouse number, choose the row of a warehouse number and then More Options. The following options are available:
● Edge InformationTo display edge details, choose a node in the warehouse layout. You can see all edges that are connected to this node. You can also see nodes in aisles.
● Edge AdjustmentYou can check the completeness of your travel distance network. You can edit the edges on a storage type view or a global warehouse layout view.If there are impassable paths in your network, you can create edges to connect those paths based on existing nodes. To do this, choose a node on the warehouse layout as a start node and then the other as an end node. Then, activate your changes.Note that you can only see the activated changes on edges in SAP Warehouse Insights, not in the destination system.
If there are impassable paths in your network, you can create edges based on existing nodes. To do this, choose More Options and then Edge Adjustment. However, you can't use this configuration step to create a new network.
More Information
For more information, go to help.sap.com/wi, choose the Discover tab, and navigate to TroubleshootingFrequently Asked Questions for SAP Warehouse Insights .
Related Information
Manage Warehouses [page 21]Upload Warehouse Data [page 24]
7.1.5 Define Optimization Settings
With this configuration step, you can define optimization settings for the offline and live optimization in your warehouse number.
30 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
You use offline optimization to improve the sequence of completed warehouse orders assigned to resources to minimize empty travel distance in a simulated way.
You use live optimization to improve the sequence of open warehouse orders assigned to resources in real time to minimize empty travel distance.
Prerequisites
Make sure that you have made the following configurations:
● You have created a warehouse number using the Manage Warehouses configuration step.● You have uploaded relevant warehouse data using the Upload Warehouse Data configuration step.
Additional Information
You can define the following settings using this configuration step:
● Define General Settings [page 31]● Define OffLine Optimization [page 32]● Define Live Optimization [page 33]
For more information, go to help.sap.com/wi, choose the Discover tab, and navigate to TroubleshootingFrequently Asked Questions for SAP Warehouse Insights .
Related Information
Manage Warehouses [page 21]Upload Warehouse Data [page 24]
7.1.5.1 Define General Settings
Define general settings for both offline and live optimization.
You can define the speed of your resources in the format of meters per second (m/s). This definition helps the system to estimate the travel time of resources during optimization.
You can specify virtual storage bins in your warehouse. A virtual storage bin doesn't exist physically in the warehouse and doesn't have a fixed location. You tell the system about those bins to help the system calculate the resource travel distances more accurately by skipping the virtual bins.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 31
7.1.5.2 Define Off-Line Optimization
Define optimization settings for offline optimization.
Procedure
Perform the following actions:
1. Group warehouse ordersGroup warehouse orders to apply the same optimization conditions to them, for example, the same optimization constraint. You can group the orders based on queues.Warehouse order groups help you determine the warehouse orders to be selected for optimization. SAP Warehouse Insights optimizes warehouse orders that are relevant to physical movements, for example, picking, putaway and replenishment.The following optimization constraints are available:○ Empty Travel Distance
If you want only to reduce empty travel distance for all warehouse orders, select this constraint.○ Latest Start Date
If some warehouse orders contain latest start dates, select this constraint.2. Define optimization factors
Optimization factors influence how the system optimizes warehouse order assignments in your warehouse. For example, you can put shortest travel distances on a higher priority than latest start dates of warehouse orders.You can define the factors based on your actual requirements or use the following default factor settings:○ DEFAULT_EMPTYDISTANCE
To minimize empty travel distances without consideration of latest start dates○ DEFAULT_LSD
To minimize empty travel distances and try satisfying latest start dates3. Define other settings
You can perform the following actions in this step:○ Define an optimization frequency
Define an interval to determine how often the system performs an optimization job in a simulated way. For example, you enter 20 minutes as an interval. That is, the system sorts the warehouse orders based on their confirmation, and splits them into different optimization jobs. Each optimization job contains the confirmed warehouse orders whose confirmation time was during the 20 minutes.
○ Define non-travel timeNon-travel time is a period when a resource is stationary in the middle of processing a warehouse order. It can be the situation, for example, when a warehouse worker is picking products from a storage bin.Non-travel time of resources helps the system determine how long a warehouse task takes to complete and better assign warehouse orders to resources to fulfill the latest start dates.You can specify that the system calculates non-travel time in one of following ways:○ Planned execution time minus actual travel time of warehouse orders
Planned execution time is in a destination system, for example, an SAP EWM system. Make sure that this time is correctly defined.
○ Non-travel time predefined for resource types
32 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
If you choose this option, enter the non-travel time for each warehouse task under the capacity planning. The system calculates the non-travel time of a warehouse order based on the sum of the non-travel time of its warehouse tasks.
○ No non-travel time4. Assign resources to warehouse orders
You can do the following in this step:○ Add a new warehouse order group.○ Define a queue priority (optional)
○ In the Queue Priority table, you can set one of the following values for each queue: Low, Medium, High, Very High.After you saved your entries, you can see your defined queue priority on the Resource Assignments tab.
The queue priority impacts the optimization planning in the following way: In each simulated interval in the Simulate Order Assignments app, the warehouse orders from queues of higher priorities are planned before the ones with lower priority. That means that at the time of planning, even a warehouse order with an impending latest start date (LSD) or a shorter empty travel distance will be planned after the orders with higher priority.
○ Add optimization factorsThe assigned resources are the ones that processed the warehouse orders in the selected warehouse order groups. Therefore, in the offline optimization settings, you don’t select resources manually.
7.1.5.3 Define Live Optimization
Define optimization settings for live optimization.
Procedure
Perform the following actions:
1. Group warehouse ordersGroup warehouse orders to apply the same optimization conditions to them, for example, the same optimization constraint. You can group the orders based on queues.Warehouse order groups help you determine the warehouse orders to be selected for optimization. SAP Warehouse Insights optimizes warehouse orders that are relevant to physical movements, for example, picking, putaway and replenishment.Note that if you select a queue for optimization, all warehouse orders in the queue will be optimized. Furthermore, the same queue can only be used in one warehouse order group at a time.The following optimization constraints are available:○ Empty Travel Distance
If you want only to reduce empty travel distance for all warehouse orders, select this constraint.○ Latest Start Date
If some warehouse orders contain latest start dates, select this constraint.2. Define optimization factors
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 33
Optimization factors influence how the system optimizes warehouse order assignments in your warehouse. For example, you can put shortest travel distances on a higher priority than latest start dates of warehouse orders.You can define the factors based on your actual requirements or use the following default factor settings:○ DEFAULT_EMPTYDISTANCE
To minimize empty travel distances without consideration of latest start dates○ DEFAULT_LSD
To minimize empty travel distances and try satisfying latest start dates3. Define other settings
You can perform the following actions in this step:○ Define an optimization frequency
Define an interval to determine how often the system gets open warehouse orders and active resources from an integrated warehouse management system.For example, you can enter 20 minutes as an interval. That is, in every 20 minutes, the system gets open warehouse orders and active resources from the integrated warehouse management system.You can set the intervals in the following ways:○ If you want the system to retrieve a greater number of warehouse orders so that more empty travel
distances can be reduced, set a relatively long interval, for example, 120 minutes.○ If you want to keep optimizing the latest updates about open warehouse orders, set a relatively
shorter interval, for example, 10 minutes.Then the system runs real-time optimization at intervals for each resource assignment, and retrieves and assigns open warehouse orders during the interval based on the predefined warehouse order groups and the capacity of the active resources.For each optimization job in an interval, the system retrieves warehouse orders from the destination system. Then, the system selects these orders for the current optimization job based on the queue sequence of the resource groups. If you select latest start dates as a constraint in the live optimization settings, the system sorts the selected warehouse orders in each queue by latest start dates.After the optimization of warehouse order assignments is completed, the system sends the results back to the destination system.
○ Define non-travel timeNon-travel time is a period when a resource is stationary in the middle of processing a warehouse order. It can be the situation, for example, when a warehouse worker is picking products from a storage bin.Non-travel time of resources helps the system determine how long a warehouse task can be completed and better assign warehouse orders to resources to fulfill the latest start dates.You can specify that the system calculates non-travel time in one of following ways:○ Planned execution time minus actual travel time of warehouse orders
Planned execution time is in a destination system, for example, an SAP EWM system. Make sure that this time is correctly defined.
○ Non-travel time predefined for resource typesIf you choose this option, enter the non-travel time for each warehouse task under the capacity planning. The system calculates the non-travel time of a warehouse order based on the sum of the non-travel time of its warehouse tasks.
○ No non-travel time4. Assign resources to warehouse orders
To do this, create an assignment by specifying warehouse order groups, a queue priority, resources, and optimization factors. If there are multiple resource assignments in your warehouse, you can use a warehouse order group, a queue priority, a resource, or a resource group in only one of the assignments.Warehouse Order Group and Queue Priority
34 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
The system determines which warehouse orders to be optimized in the next interval by considering the queue sequence defined for the resource groups. You select the queues at the creation of a warehouse order group.If you want to use queue priorities as a hard constraint during the optimization planning, you can define a queue priority in SAP Warehouse Insights for each resource assignment. With an existing queue priority, the queue sequence per resource group information from EWM is ignored. Example: If there are warehouse orders with a very high queue priority, the warehouse orders with a lower priority or without a priority will not be planned by the optimizer until all the warehouse orders with a very high priority are planned. This means that during planning, even warehouse order in a queue with an impending latest start date (LSD) will be planned after all queues with a high priority are planned.To define a queue priority, use the switch Define Queue Priority in the WAREHOUSE ORDER GROUPS section of the Resource Assignments step and choose a value from the drop-down list for your queues.ResourcesYou can select the resources to participate into the optimization by resources or resource groups.○ If you select By Resource, the system assigns warehouse orders to fixed resources.○ If you select By Resource Group, the system assigns warehouse orders to resources based on resource
groups. Once a resource is added to or removed from a resource group, the system also adds the resource to or removes it from the optimization in the next optimization interval.
Recommendation○ If you want to assign specific resources to perform tasks in a fixed area, then for each fixed area,
you create separate resource assignments.○ When you add a warehouse order group to a resource assignment, select the resources that are
assigned to the queues of the warehouse order group. You can check the queue assignment in the destination system.Make sure that you select all resources that are working for the queues in the warehouse order group. If a resource in the queue isn’t selected, the optimized warehouse order sequence can be disturbed because this resource can still perform warehouse orders from the queue assigned to it by the destination system.
○ Make sure that all warehouse orders can be assigned to and performed by the selected resources.
5. Activate optimizationTo implement the real-time optimization in your warehouse, you must activate the optimization settings.
NoteIf you purchased a test & demo license for SAP Warehouse Insights, the system stops running live optimization for a warehouse number after 12 consecutive intervals. Afterwards, you need to activate live optimization again.
Example
In your warehouse, the resources FORKLIFT1 and FORKLIFT2 are responsible for warehouse tasks of both inbound and outbound processes. For the warehouse tasks of outbound process, you want to meet the latest start dates. For the warehouse tasks of inbound process, you want to cut off unnecessary empty travel distances.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 35
In this situation, you create 2 warehouse order groups, one with the latest start date as a constraint, one with the empty travel distance as a constraint.
When you create a resource assignment, you add these two warehouse order groups and these two resources.
For the optimization factors, you select the default optimization factor setting DEFAULT_LSD or create a set of new ones based on your requirements.
7.1.6 Define Bin Coordinates
With this configuration step, you can define coordinates for the storage bins in your warehouse. For example, you can create and update coordinates for storage bins of a rack storage type. For more information, see the following documents:
● Define New Coordinates [page 36]● Update Existing Coordinates [page 39]
7.1.6.1 Define New Coordinates
You can define new coordinates for storage bins in your warehouse.
Prerequisites
You’ve uploaded the following files using the Upload Warehouse Data configuration step:
● The LAGP file for storage bins● The T303 file for storage bin types● The T331 file for storage type control
You’ve prepared the following information about your warehouse:
● At least two sets of coordinates for the physical position of a rack in the warehouse.To help the system calculate the origin of the warehouse layout, provide these two sets of reference coordinates based on your warehouse.
● A PDF file of warehouse layout● Aisle width● Space between racks● Space between stacks● Length, width, and height of storage bins
36 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
Procedure
General StepsTo create bin coordinates, perform the following actions:
1. Choose a warehouse number.2. Use the switch Define Coordinates Based on PDF File to decide whether to import a warehouse layout.3. Choose a rack on the imported warehouse layout, or specify a rack position.
If you specify a rack position, you can choose Select Rack Position on Layout to enable selection of a position on the warehouse layout.If you're defining coordinates with a PDF file, the first time you define the bin coordinates, the system asks you to enter two sets of reference coordinates.
4. Provide required details in the Defining New Coordinates tab. For more information, see the detailed steps.5. Choose Define Coordinates.
In the Defined Aisles tab, you can see the aisles with defined coordinates.6. After you’ve defined bin coordinates for all racks in your warehouse, choose Finish.
If you want to delete defined bin coordinates along an aisle, before finishing the definition, delete the coordinates along the aisle under the Defined Aisles tab.Once the definition is complete, you can export the defined bin coordinates and upload them using the Upload Warehouse Data configuration step. Or you can directly activate them. Then you can use these coordinates in other apps, for example, the Simulate Order Assignments - Off-Line Data app.
Detailed StepsPerform the following actions on the Defining New Coordinates tab:
1. Specify the rack position.If you're defining coordinates with a PDF file, the system calculates the coordinates based on the reference coordinates and uses the coordinates of a specific point on the rack layout as the rack position.
2. Choose an aisle layout.If you're defining coordinates with a PDF file, use the layout based on the way that an aisle is oriented on the imported warehouse layout. For example, if an aisle is horizontal on the imported warehouse layout, choose a horizontal layout.If you select a rack, you must define bin coordinates for all racks along its aisle.Start with the rack based on the order indicated by the direction on the template. For example, the direction for starting definition is from left to right, and the selected rack is in an aisle with racks at both sides. Then, select the rack on the left side of the aisle to start.
3. Choose how to sort the stack numbers.4. Specify aisles and storage types.
This action helps the system to select the corresponding storage bins along the aisles. Ensure that you also select all storage types for these storage bins.To define bin coordinates for more aisles, choose Add Aisles. If you're defining coordinates with a PDF file, add the number of aisles based on the imported warehouse layout. For example, if you select a rack that is oriented from left to right, and there are four aisles above this rack, add no more than four aisles.
NoteIf an aisle contains racks on both sides, define bin coordinates for both racks at the same time.
If there are aisles of the same name on the warehouse layout, choose storage types only for the corresponding aisle, that is, to define bin coordinates separately for these aisles.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 37
5. Specify space dimensions.6. Choose Define Coordinates.
Additional Information
File SettingsYou can define coordinates for storage bins in the LAGP file that contains values for the following attributes:
● Storage bin type● Aisle, stack, and level● Storage type
You can define coordinates for storage bins in the T303 file that contains values for length, width, and height.
Example of Warehouse LayoutThe following image displays an example of an imported warehouse layout:
The warehouse layout in the image contains the following elements:
● Reference coordinatesYou can choose any one of the racks to enter the reference coordinates. On this warehouse layout, the reference coordinates are the two highlighted points beside Aisle 01.
38 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
● OriginThe system calculates the origin based on reference coordinates.
● Aisles, racks, stacks, and storage bins
Additionally, the red circle beside Aisle 04 indicates the position of the storage bin T010-04-08-D. The system uses the position of this red circle to calculate the X and Y coordinates of the bin. The Z coordinate of a bin is calculated based on the bin height and the number of levels on a rack.
Defining Coordinates Using a TableUnder the All Coordinates tab, choose the bins without coordinates. Then, you can specify coordinates directly in a list. You can use the bin angle to specify whether the bin layout is oriented from left to right or from bottom to top. If the bin orientation is from left to right, you specify a bin angle of 0. If the bin orientation is from bottom to top, you specify a bin angle of 90.
Related Information
Upload Warehouse Data [page 24]
7.1.6.2 Update Existing Coordinates
You can update existing coordinates for storage bins in your warehouse.
Prerequisites
You’ve uploaded the following files using the Upload Warehouse Data configuration step:
● The LAGP file for storage bins● The T303 file for storage bin types● The T331 file for storage type control
For more information about the file settings, see the file settings in Define New Coordinates [page 36].
Procedure
To update existing coordinates, perform the following actions:
1. Choose an aisle and its corresponding storage type.The system highlights the selected area on the layout.
2. Specify a new rack position.The system moves the whole highlighted area based on the new coordinates of the rack. The position for the set of coordinates is also highlighted on the layout.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 39
3. Choose Update Coordinates.
Additional Information
Updating Coordinates Using a Table On the tab All Bins you can update bin coordinates for all bins in a table format. With the bin angle you can specify the bin orientation. If the bin orientation is from bottom to top, you specify a bin angle of 90. If the bin orientation is from left to right, you specify a bin angle of 0.
7.1.7 Define IoT Integration Settings
With this configuration step, you can manage your IoT integration and assign IoT services to warehouse numbers.
After a successful integration, you can view real-time information for connected resources, for example the real-time position and geofence alerts.
Prerequisites
You have set up the integration with an IoT service. For more information, see the following documents in the How-To Guides section:
● Recommended Settings for the Integration with SAP IoT● Recommended Settings for the Integration with IoT Platform from Alibaba Cloud
Procedure
1. Manage IoT Integration1. On the Manage IoT Integration tab, choose Add IoT Service and enter a destination system.
The destination contains the technical connection information for the IoT service you want to connect to.
2. Save your entries and check the Connection Status.3. If you change your IoT service later on, use Synchronize Binding Data to update your binding data.4. If you update the properties in the destination, delete the IoT service and add it again. This enables the
system to set up the connection with the latest properties.2. Assign IoT Service
1. On the Assign IoT Service tab, select the warehouse number that you set up for the IoT integration and choose the pencil icon.
2. Enter the IoT service that you want to assign to your warehouse number.
40 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
3. Save your entries.3. Choose Refresh to update the value in column No. of Position Messages in the Past Minute.
Additional information
For more information about setting up and using SAP IoT, see SAP Internet of Things (SAP IoT).
7.1.8 Define Indoor Positioning Settings
With this configuration step, you can set the maximum resource speed and the stationary resource threshold per resource type on the same screen. The settings that you specify in this configuration step are the basis for receiving alerts in the Resource Indoor Positioning app.
Procedure
Choose the warehouse number for which you want to specify the settings.
1. Set a maximum resource speed.1. In the Maximum Resource Speed section, choose Edit and enter a value for the Maximum Horizontal
Speed.2. Save your entries.
2. Set the stationary resource threshold.1. In the Stationary Resource Threshold section, choose Edit and enter a value (in minutes) for the
Stationary Time.You can enter a time between 1 and 1440 minutes (24 h).
2. Save your entries.The stationary time does not consider vertical movements, for example, the movement of the fork of a forklift.
NoteIf a resource exceeds either one of these limits, it will be shown with the status Traveling Over Speed or Stationary in the Resource Indoor Positioning app.
Additional Information
For more information about the visualization of resources, see Resource Indoor Positioning.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 41
7.1.9 Define Geofences
With this configuration step, you can create geofences in your warehouse and specify which resources must not leave or enter a particular geofenced zone.
Prerequisites
You have previously integrated your system with an IoT service and set up a binding between the warehouse business master data and the IoT logical devices. With a successful IoT integration and data binding, SAP Warehouse Insights can receive real-time positioning information for connected resources and trigger geofence alerts.
Procedure
To create and set up a geofence, perform the following actions:
1. Choose the warehouse number for which you want to define a geofence.2. Create a new geofence, enter a name, and draw the geofence on the layout by choosing at least three
different positions.3. Choose Save to confirm the shape of your geofence.4. Choose the Settings tab to specify which resources must not leave or enter the geofenced zone.
Additional Information
The settings that you specify in this configuration step are the basis for receiving geofence alerts in the Resource Indoor Positioning app.
For more information, see Resource Indoor Positioning.
7.2 Tools
Some additional applications
7.2.1 Export Data
With this app, you can export data defined in or uploaded using SAP Warehouse Insights.
42 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
Prerequisites
You must have performed at least one of the following actions before you can export data using this app:
● You've subscribed to SAP Warehouse Insights on Amazon Web Services (AWS) or Microsoft Azure. If you subscribed via Alibaba Cloud, please refer to SAP Note 3088460 .
● You’ve created and changed a warehouse number using the Manage Warehouses configuration step.● You've defined integration settings using the Define Integration Settings configuration step.● You've uploaded data using the Upload Warehouse Data configuration step.● You've edited travel distance networks using the Manage Travel Distance Networks configuration step.● You've defined bin coordinates using the Define Bin Coordinates configuration step.
Procedure
1. Choose to export all data or select data for export.When selecting data for export, specify selection criteria to filter the data.
2. Choose Export.3. Download the exported file.
NoteWe recommended that you use an up-to-date zip tool (for example, 7zip or WinRAR) to open the exported file.
Additional Information
Exported FileThe system exports the following data using a ZIP file that contains multiple Comma-Separated Values (CSV) files.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 43
If you choose to select data for export, the system exports data for the relevant data types in the following table:
Data Uploaded from Destination System, for Example, EWM
Export Data Type Exported File
Basic Data and Configuration Data ● LAGP (Storage Bins)● RSRC (Resources)● T303 (Storage Bin Types)● T331 (Storage Type Control)● T333 (Warehouse Process Type)● T346 (Queue Definitions)● TBIN_AT (Bin Access Types)● TBIN_AT_PR (Bin Access Type Priority per Resource
Type)● TDC_EDGE (Edges for Travel Distance Calculation)● TDC_EDGE_R (Excluded Resource Type per Edge)● TGWLOBJ (GWL: Objects)● TRSGR_Q_SQ (Sequenced Queues per Resource
Group)● TRSRC_GRP (Resource Groups)● TRSRC_TYP (Resource Types)
Confirmed Warehouse Orders and Tasks ● ORDIM_C (Confirmed Warehouse Tasks)● WHO (Confirmed Warehouse Orders)
Open Warehouse Orders and Tasks ● WAREHOUSE_ORDER_INTEGRATION (Open Warehouse Orders)
● ORDIM_O (Open Warehouse Tasks)
If you choose to export all data, besides the data listed in the previous table, the system also exports the following data for you:
Data Defined in SAP Warehouse Insights
File Name Description
CREATED_EDGES Created Edges
DEFINED_BIN_COORDINATES Defined Bin Coordinates
INTEGRATION_SETTINGS Defined Integration Settings
OPTIMIZATION_FACTORS Defined Optimization Factors
OPTIMIZATION_OTHER_SETTINGS Defined Other Settings for Optimization
RSRC_TYPE_CAPACITY_PLANNING Capacity Planning for Resource Type
RSRC_ASSIGNMENT Created Resource Assignments
RESOURCE_ASSIGNMENT_WO_GROUP Defined Warehouse Order Groups in Resource Assignments
RSRC GROUP_OF_RSRC_ASSIGNMENT Defined Resource Groups in Resource Assignments
RESOURCE_TYPE_SPEED Defined Speed for Resource Types
RSRC_OF_ RSRC_ASSIGNMENT Defined Resources in Resource Assignments
44 PUBLICAdministration Guide for SAP Warehouse Insights
Business Configuration
File Name Description
VIRTUAL_BINS Virtual Bins
WAREHOUSE_NUMBERS Warehouse Numbers
WO_GROUP_QUEUES Defined Queues in Warehouse Order Groups
WO_GROUP Created Warehouse Order Groups
Note● For the data defined and activated in SAP Warehouse Insights, for example, edges for travel distance
networks and bin coordinates, such data exists in both data files: the file uploaded from a destination system and the file defined in SAP Warehouse Insights.
● The naming convention for files is different in a destination system and in SAP Warehouse Insights. However, the fields in the files can be the same, for example, the file LAGP and DEFINED_BIN_COORDINATES.
NoteOnce you unsubscribe from SAP Warehouse Insights, the system deletes exported data immediately. Therefore, we recommend that you download the exported data before unsubscribing from SAP Warehouse Insights.
Administration Guide for SAP Warehouse InsightsBusiness Configuration PUBLIC 45
8 Security
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 Insights was designed to fulfill the highest security standards which guarantee the safety of your data from attacks.
NoteThere is no personal data stored in SAP Warehouse Insights.
SAP Warehouse Insights uses the audit-log service to write important events in the audit log. For more information, see Audit Logging [page 47].
For more information about security on SAP BTP, see the SAP BTP documentation under Security.
8.1 User Administration, Authentication, and Authorizations
SAP Warehouse Insights 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 Insights 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 Insights microservices and APIs.
8.2 Session Security Protection
APIs and services of SAP Warehouse Insights 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 Insights.
46 PUBLICAdministration Guide for SAP Warehouse Insights
Security
8.3 Network and Communication Security
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 welldefined 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 Insights 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 Insights.
For more information, see the security guide under Security on SAP BTP at https://help.sap.com/CP.
8.4 Data Storage Security
Data storage security is about how SAP Warehouse Insights protects its own database. Date storage security is ensured by the isolated tenant that each customer receives. In SAP Warehouse Insights, the customer data isolation is based on database's schema level. Only tenantspecific requests can access the tenant data.
8.5 Audit Logging
You can use audit logging to track some key actions that are performed in SAP Warehouse Insights apps, for example, deleting a warehouse number in the Manage Warehouses app.
8.5.1 Accessing the Audit Log Viewer
Context
Prerequisites
To access the audit log viewer, you must be assigned to the following roles:
● Role AuditLog_Auditor with Application Identifier auditlog-management● Role AuditLog_Auditor with Application Identifier auditlog-viewer
Administration Guide for SAP Warehouse InsightsSecurity PUBLIC 47
Procedure
1. Log on to the SAP BTP cockpit.2. Choose your global account and cloud foundry subaccount.3. Choose Subscriptions.4. Find the tile, Audit Log Viewer, and click Go to Application.5. Fill in your account information and log in.6. Select the Time Range and click Reload. You can see the audit logs for your selected time range.7. To view the information for all users, navigate to the Users list.
Results
You can see the audit logs for your selected time range. Depending on your authorization, the list displays all users from either the solution participant or solution owner.
NoteThe list includes blocked users but not deleted users.
For more information on the Audit Log Viewer, see the Audit Log Viewer for the Cloud Foundry Environment.
48 PUBLICAdministration Guide for SAP Warehouse Insights
Security
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 genderspecific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.
Administration Guide for SAP Warehouse InsightsImportant Disclaimers and Legal Information PUBLIC 49
www.sap.com/contactsap
© 2021 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.
Material Number:
**
THE BEST RUN