administration guide for sap warehouse insights

50
Administration Guide | PUBLIC SAP Warehouse Insights Document Version: 2108 – 2021-08-21 Administration Guide for SAP Warehouse Insights © 2021 SAP SE or an SAP affiliate company. All rights reserved. THE BEST RUN

Upload: others

Post on 18-Feb-2022

2 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Administration Guide for SAP Warehouse Insights

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

Page 2: Administration Guide for SAP Warehouse Insights

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

Page 3: Administration Guide for SAP Warehouse Insights

Accessing the Audit Log Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Administration Guide for SAP Warehouse InsightsContent PUBLIC 3

Page 4: Administration Guide for SAP Warehouse Insights

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 configu­ration 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

Page 5: Administration Guide for SAP Warehouse Insights

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 select­ing positions on a warehouse lay­out.

● Export Data [page 42]A new chapter

Administration Guide for SAP Warehouse InsightsDocument History PUBLIC 5

Page 6: Administration Guide for SAP Warehouse Insights

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 ware­house orders or tasks.

● Define Bin Coordinates [page 36]In this chapter, content was added for defining new coordinates with­out 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 resour­ces 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 ad­vanced 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

Page 7: Administration Guide for SAP Warehouse Insights

Document Version Date Comment

1.0 2019-11-25 Initial version

Administration Guide for SAP Warehouse InsightsDocument History PUBLIC 7

Page 8: Administration Guide for SAP Warehouse Insights

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

Page 9: Administration Guide for SAP Warehouse Insights

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

Page 10: Administration Guide for SAP Warehouse Insights

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

Page 11: Administration Guide for SAP Warehouse Insights

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

Page 12: Administration Guide for SAP Warehouse Insights

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

Page 13: Administration Guide for SAP Warehouse Insights

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

Page 14: Administration Guide for SAP Warehouse Insights

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

Page 15: Administration Guide for SAP Warehouse Insights

SAP Warehouse Insights Release Sup­ported by Destination System (SAP EWM)

SAP EWM Release

NoteThe following releases support a full integra­tion 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 be­low 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 inte­gration with SAP Warehouse Insights 2102 or higher, make sure that you've deactivated live optimization in the Define Optimization Settings app. Oth­erwise, 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

Page 16: Administration Guide for SAP Warehouse Insights

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 Posi­tioning 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

Page 17: Administration Guide for SAP Warehouse Insights

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

Page 18: Administration Guide for SAP Warehouse Insights

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 Launch­pad

CONFIGURATION _EXPERT Assigned users can make all essential configuration steps, for example, create ware­house numbers, upload warehouse data, define opti­mization settings, and spec­ify settings related to the vis­ualization 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

Page 19: Administration Guide for SAP Warehouse Insights

Role Template Description Available AttributesTiles on SAP Fiori Launch­pad

WAREHOUSE_ CLERK Assigned users can analyze the optimization results based on real-time and simu­lated optimization.

Not applicable Configure Your Solution

NoteYou can have access to the following configura­tion steps in this app:

● Upload Warehouse DataYou can upload only basic and transac­tion data.

● Define Optimization Settings

● Define Indoor Positioning SettingsYou can set a maxi­mum resource speed and a station­ary resource thresh­old.

,

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 ac­cess to specific warehouse numbers.

WAREHOUSE_NAME

NoteIf you want a business role to have access to all warehouse numbers, en­ter an asterisk (*) for this attribute value.

Not applicable

Administration Guide for SAP Warehouse InsightsUser Management PUBLIC 19

Page 20: Administration Guide for SAP Warehouse Insights

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

Page 21: Administration Guide for SAP Warehouse Insights

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

Page 22: Administration Guide for SAP Warehouse Insights

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

Page 23: Administration Guide for SAP Warehouse Insights

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

Page 24: Administration Guide for SAP Warehouse Insights

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 off­line 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

Page 25: Administration Guide for SAP Warehouse Insights

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

Page 26: Administration Guide for SAP Warehouse Insights

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

Page 27: Administration Guide for SAP Warehouse Insights

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 (OR­DIM_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

Page 28: Administration Guide for SAP Warehouse Insights

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

Page 29: Administration Guide for SAP Warehouse Insights

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

Page 30: Administration Guide for SAP Warehouse Insights

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 off­line and live optimization in your warehouse number.

30 PUBLICAdministration Guide for SAP Warehouse Insights

Business Configuration

Page 31: Administration Guide for SAP Warehouse Insights

You use off­line 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 Off­Line 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 off­line 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

Page 32: Administration Guide for SAP Warehouse Insights

7.1.5.2 Define Off-Line Optimization

Define optimization settings for off­line 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

Page 33: Administration Guide for SAP Warehouse Insights

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 off­line 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

Page 34: Administration Guide for SAP Warehouse Insights

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

Page 35: Administration Guide for SAP Warehouse Insights

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

Page 36: Administration Guide for SAP Warehouse Insights

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

Page 37: Administration Guide for SAP Warehouse Insights

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

Page 38: Administration Guide for SAP Warehouse Insights

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

Page 39: Administration Guide for SAP Warehouse Insights

● 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

Page 40: Administration Guide for SAP Warehouse Insights

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

Page 41: Administration Guide for SAP Warehouse Insights

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

Page 42: Administration Guide for SAP Warehouse Insights

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

Page 43: Administration Guide for SAP Warehouse Insights

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

Page 44: Administration Guide for SAP Warehouse Insights

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 Ware­house 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

Page 45: Administration Guide for SAP Warehouse Insights

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

Page 46: Administration Guide for SAP Warehouse Insights

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

Page 47: Administration Guide for SAP Warehouse Insights

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 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 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 tenant­specific 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

Page 48: Administration Guide for SAP Warehouse Insights

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

Page 49: Administration Guide for SAP Warehouse Insights

Important Disclaimers and Legal Information

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

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

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

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

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

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

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

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

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

Administration Guide for SAP Warehouse InsightsImportant Disclaimers and Legal Information PUBLIC 49

Page 50: Administration Guide for SAP Warehouse Insights

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