SAP Cloud Administration Guide
SAP Cloud Administration Guide
PUBLIC
2024-09-20
Administration Guide
1 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
2 Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3 Technical Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.1 Minimum Hardware Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.2 Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.3 Internet Connection and Network Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.4 Browsers and Browser Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4 Onboarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.1 Subscribing to the SaaS Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Subscription Tips: Integrated SaaS Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Moving from SAP Enterprise Product Development to SAP Product Lifecycle Management
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.2 Migrating from SAML to OpenID Connect Protocol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
4.3 Configuring the Identity Provider for Product Data Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
4.4 Onboarding the Design to Manufacturing Scenario with SAP S/4HANA Cloud. . . . . . . . . . . . . . . . . 36
5 User Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.1 Default Role Collections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
5.2 Role Templates for SAP Product Lifecycle Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
Role Templates for Collaboration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Role Templates for Common Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Role Templates for Configuration Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
Role Templates for Engineering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Role Templates for Enterprise Product Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Role Templates for Formulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Role Templates for Insights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Role Templates for Intelligent Handover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Role Templates for Product Innovation Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Role Templates for Specification Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Role Templates for Visualization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Role Templates for Manage Statuses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Role Templates for Product Data Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6 Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.1 How to Configure Destinations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.2 Using the Cloud Connector to Connect to On-Premise Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Administration Guide
2 PUBLIC Content
6.3 Destination for Storing Data in Object Store. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
6.4 Connectivity Using PLM System Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Destination for Connecting to SAP ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Destination for Connecting to SAP S/4HANA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Destination for Connecting to SAP S/4HANA Cloud . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
6.5 Configuring Connectivity for Collaboration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Destination for Identity Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Destination for Email Notifications Using SMTP APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Destination for Email Notifications Using Microsoft Graph. . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
Destination for Using Microsoft Teams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Destination for Connecting to SAP Ariba APIs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Destination for Collaborating on Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Destination for Updating Workflow Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Destination for User Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Destination for Model Object Assignments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Destination for SAP Document Center, desktop client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Destination for Custom Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
Destination for Management Workflows using Process Variants. . . . . . . . . . . . . . . . . . . . . . . . .131
6.6 Configuring Connectivity for Common Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
6.7 Configuring Connectivity for Configuration Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Destination for Connecting to On-Premise Content Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
6.8 Configuring Connectivity for Engineering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Configuring Connectivity for Test Management Apps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Configuring Connectivity for Requirements Management and Systems Modeling. . . . . . . . . . . . 141
6.9 Configuring Connectivity for Enterprise Product Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Destination for Connecting to On-Premise Content Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
6.10 Configuring Connectivity for Intelligent Handover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
6.11 Configuring Connectivity for Insights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
Connecting SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Connecting SAP S/4HANA for Change Management Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Connecting to the Enterprise Product Structure API for Images. . . . . . . . . . . . . . . . . . . . . . . . 155
Connecting to the Visualization API for Thumbnails. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
6.12 Configuring Connectivity for Specification Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
6.13 Configuring Connectivity for Visualization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Connecting to SAP S/4HANA On-Premise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
6.14 Configuring Connectivity for Product Innovation Management. . . . . . . . . . . . . . . . . . . . . . . . . . . .162
Configuring Integration with Requirements Management and Systems Modeling. . . . . . . . . . . . .162
Connecting to Jira. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Configuring Connectivity for SAP Build Process Automation. . . . . . . . . . . . . . . . . . . . . . . . . . .165
6.15 Configuring Connectivity for Product Data Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Administration Guide
Content PUBLIC 3
Destination for Identity Authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Destination for Object Store service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Administration Guide
4 PUBLIC Content
Configuring Visualization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
Configuring Product Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
Troubleshooting and Common Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353
8.7 Business Configuration for Formulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .357
Using Recipe Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Configuring Component Types for Formulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Configuring Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Synchronization of Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Translation of Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Cross-Product Features used in Formulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
8.8 Business Configuration for Intelligent Handover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Configuring Handover. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .373
Configuring Visualizations for Handovers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
Configuring Authorization Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Troubleshooting and Common Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
8.9 Business Configuration for Specification Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Overview of Process Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Overview of Data Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Using Specification Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Defining a Composition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Handling Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
Managing Product Categories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
Handling Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Synchronization of Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
Translation of Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Cross-Product Features used in Specification Management. . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
8.10 Business Configuration for Insights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
8.11 Business Configuration for Product Innovation Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Defining Evaluation Questionnaires. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
Defining Phases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Defining Tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Defining Status Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Defining Additional Idea Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Configuring Email Notifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
8.12 Business Configuration for Visualization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Access Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Security Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
System Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433
Collaboration and Markup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
8.13 Business Configuration for Product Data Integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .451
Administration Guide
Content PUBLIC 5
Configuring Design Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Configuring Product Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
12 Offboarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
12.1 Data Export and Data Deletion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
Collaboration: Deletion of Personal Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Collaboration: Data Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Collaboration: Data Delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Provisional Specifications: Data Export and Anonymization. . . . . . . . . . . . . . . . . . . . . . . . . . . 465
Common Functions: Data Deletion and Anonymization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Configuration Management: Data Export and Data Anonymization. . . . . . . . . . . . . . . . . . . . . . 467
Engineering: Data Export, Deletion, and Anonymization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .468
Enterprise Product Structure: Data Export and Data Anonymization. . . . . . . . . . . . . . . . . . . . . 469
Formulation: Data Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
Product Innovation Management: Data Export, Deletion, and Anonymization. . . . . . . . . . . . . . .470
Insights: Content Deletion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Intelligent Handover: Data Export and Data Anonymization. . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Specification Management: Data Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .472
Visualization: Data Export and Deletion of Personal Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Product Data Integration: Data Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Administration Guide
6 PUBLIC Content
1 Overview
This administration guide describes the steps you need to perform as an administrator to set up and
run SAP Product Lifecycle Management. It covers information specific to the cloud solution only. For
general information about SAP Business Technology Platform, see the SAP Business Technology Platform
documentation on SAP Help Portal.
• System administrators
• Key users
Administration Guide
Overview PUBLIC 7
SAP Product Lifecycle Management is available in the Cloud Foundry environment of SAP Business Technology
Platform, and consists of the following SaaS applications:
• Collaboration
• Common Functions
• Configuration Management
• Engineering
• Enterprise Product Structure
• Formulation
• Insights
• Intelligent Handover
• Product Data Integration
• Product Innovation Management
• Specification Management
• Visualization
Note
The functional scope of your global account depends on your organization’s license arrangement with SAP.
The administrative activities that you must perform to set up the solution are explained in further chapters.
To access the different apps provided by the SaaS applications for SAP Product Lifecycle Management in one
place, we recommend that you use the SAP Build Work Zone, standard edition.
However, if you use only one SaaS application, it is also possible to use the individual SAP Fiori launchpad
provided for that SaaS application.
Caution
If you use the Collaboration SaaS application, we recommend that you always use SAP Build Work Zone,
standard edition instead of the individual SAP Fiori launchpad. The Collaboration SaaS application re-uses
apps that are part of other SAP BTP services. You cannot control the access to these SAP BTP apps on the
Administration Guide
8 PUBLIC Overview
individual SAP Fiori launchpad. The apps will appear on the individual SAP Fiori launchpad for users who
cannot open them.
For more information about setting up the different entry points, see Entry Point for App Access [page 171].
Launchpad Themes
To support various color and vision preferences, the following themes are provided for SAP Product Lifecycle
Management:
The default delivered theme is SAP Horizon. For information about how to change the theme, see Managing
Your Settings in the user assistances for the SAP Fiori launchpad for SAP S/4HANA Cloud.
Supported Languages
The user interfaces of the solution and in-app help (where available) are provided in the following languages:
• English
• German
• Arabic
• Bulgarian
• Chinese (simplified)
• Chinese (traditional)
• Croatian
• Czech
• Danish
• Dutch
• Finnish
• French
• Greek
• Hebrew
• Hungarian
• Italian
Administration Guide
Overview PUBLIC 9
• Japanese
• Kazakh
• Korean
• Malay
• Norwegian
• Polish
• Brazilian Portuguese
• Romanian
• Russian
• Serbian
• Slovak
• Slovenian
• Spanish
• Swedish
• Thai
• Turkish
• Ukrainian
The What's New information on the SAP Help Portal is available in English and German. You can access the
information in the guides (such as this Administration Guide, the Security Guide, and the User Guide) in the
following languages using machine translation on-the-fly:
• German
• French
• Spanish
• Portuguese
• Japanese
• Simplified Chinese
• Italian
• Korean
Use the value help next to the title of a document to translate it into the language of your choice.
Related Information
Administration Guide
10 PUBLIC Overview
2 Document History
2024-09-20 General A document that explains how to monitor the usage of Monitoring Usage [page
your production plan was added. 458]
2024-08-16 Common Information about a new concept for controlling user ac- • Managing Authoriza-
Functions cess, authorizations concepts, was added. This includes tion Contexts [page
configuration information, role template information, 294]
and data anonymization and deletion information. • Role Templates for
Common Functions
[page 62]
• Common Functions:
Data Deletion and
Anonymization [page
466]
2024-08-16 Enterprise • Information about additional permission that is re- • Configuring Visualiza-
Product quired to configure Visualization tion [page 350]
Structure
, was added. • Role Templates for
Enterprise Product
• Information about a new concept for controlling
Structure [page 70]
user access, authorizations concepts, was added
2024-08-16 Formulation A chapter on the newly introduced Configure Component Configuring Component
Types for Formulation app has been added. Types for Formulation
[page 359]
2024-08-16 Intelligent A chapter on integrating Design to Manufacturing sce- Onboarding the Design
Handover
nario with SAP S/4HANA for Intelligent Handover has to Manufacturing Scenario
been added. with SAP S/4HANA Cloud
[page 36]
2024-08-16 Intelligent Information about a new concept for controlling user ac- Configuring Authorization
Handover
cess, authorizations concepts, was added. Access [page 375]
Administration Guide
Document History PUBLIC 11
Date [YYYY-MM- Link to Changed or Added
DD] Area Short Description Topic
2024-06-14 Formulation Information was added to this guide for this new SaaS • Role Templates for
application in the relevant sections. Formulation [page 72]
• Using Recipe Types
[page 358]
• Configuring Calcula-
tions [page 361]
• Synchronization of
Data [page 369]
• Translation of Data
[page 371]
• Cross-Product Fea-
tures used in Formula-
tion [page 371]
2024-05-29 Authentica- Information about how to migrate from SAML to the Migrating from SAML to
tion and Au- OpenID Connect protocol was added. OpenID Connect Protocol
thorization [page 33]
2024-05-29 Product Information was added to this guide for this new SaaS • Configuring the Iden-
Data application in the relevant sections. tity Provider for Prod-
Integration uct Data Integration
[page 34]
• Role Templates for
Product Data Integra-
tion [page 100]
• Configuring Connec-
tivity for Product Data
Integration [page 168]
• Business Configura-
tion for Product Data
Integration [page 451]
• Product Data Integra-
tion: Data Export
[page 475]
2024-05-18 Collaboratio Information about configuring supplier data was moved Configure Supplier Data
n to a different place in the guide. [page 210]
2024-05-18 Collaboratio The Business Configuration for Status Management Managing Statuses [page
n document was renamed to Manage Statuses. 182]
The Configuring Status Management for Collaboration Managing Statuses for Col-
document was renamed to Managing Statuses for laboration [page 195]
Collaboration.
Administration Guide
12 PUBLIC Document History
Date [YYYY-MM- Link to Changed or Added
DD] Area Short Description Topic
2024-05-18 Authentica- The following changes were made: • Onboarding [page 19]
tion and Au-
• In the Onboarding document, information and corre-
• User Management
thorization [page 43]
sponding links to the SAP BTP documentation were
added in the step about establishing trust. • Role Templates for
SAP Product Lifecy-
• In the User Management document, links to the cor-
cle Management [page
responding SAP BTP documentation were added or
50]
updated.
• The Defining and Bundling Roles document was re-
named. The new name is Role Templates for SAP
Product Lifecycle Management.
• The Assigning Role Collections to Users section was
removed. The User Management document provides
links to the relevant SAP BTP documentation.
2024-05-18 Enterprise A new topic has been added that contains information Configuring Product Struc-
Product about setting up default values. ture [page 345]
Structure
2024-04-19 Collaboratio The topic has been updated with the information about Working with Reference
n the new Keys and Non-Keys tabs on the Reference Objects [page 214]
Objects tab.
2024-04-19 Collaboratio The topic has been updated with the information about Working with Collaboration
n deleting a collaboration type on Collaboration Type tab. Types [page 200]
2024-04-19 Collaboratio The topic has been updated with the information about Configure Supplier Data
n downloading a CSV file on Supplier Data tab. [page 210]
2024-04-19 Intelligent Information on routing and task monitoring was added. Configuring Connectivity
Handover
for Intelligent Handover
[page 146]
2024-03-15 General A document with information about the delivery dates Delivery Schedule and
for 2024 was added. Dates [page 460]
2024-03-15 General A document was added to explain the steps that exist- Moving from SAP Enter-
ing customers need to follow to migrate from SAP En- prise Product Development
terprise Product Development to SAP Product Lifecycle to SAP Product Lifecycle
Management. Management [page 30]
Administration Guide
Document History PUBLIC 13
Date [YYYY-MM- Link to Changed or Added
DD] Area Short Description Topic
2024-02-05 Connected The information for Connected Products, which is only Information for Adminis-
Products valid for customers who subscribed to the SaaS applica- trators about Connected
tion before February 5, 2024, was moved to a separate Products
guide.
2024-02-05 Product The information for Product Cockpit, which is only valid Information for Administra-
Cockpit for customers who subscribed to the SaaS application tors about Product Cockpit
before February 5, 2024, was moved to a separate guide.
Administration Guide
14 PUBLIC Document History
3 Technical Prerequisites
Before you start to use SAP Product Lifecycle Management, check the requirements and recommendations in
this section.
Software Details
Cloud Connector Some of the applications in the solution allow you to access
data from an on-premise system. For these features to work,
you must have installed the cloud connector. For more infor-
mation, see Cloud Connector.
Object Store This service enables your business users to work with
custom file storage in SAP Product Lifecycle Management
Product Data Integration.
Administration Guide
Technical Prerequisites PUBLIC 15
3.3 Internet Connection and Network Requirements
An internet connection is required to access the application and its functionalities. To work with the
Collaboration cloud service for SAP Product Lifecycle Management, a network connection with a speed of
32 Mbps or higher is recommended for a smooth experience.
The applications for SAP Product Lifecycle Management run in the latest versions of the following browsers:
• Google Chrome
Recommendation
• Firefox
• Safari
• Microsoft Edge
Note
There are a number of known display issues when using Microsoft Edge.
Mobile Browsers
Note
The Requirements Management and System Modeling app, which is provided by the Engineering SaaS
application, is only supported for desktop use.
Recommendation
We recommend that you use Google Chrome for Android and Safari for iOS as your browser on mobile
devices.
Administration Guide
16 PUBLIC Technical Prerequisites
Web Browser Settings: Cross-Site Cookies
Applications that are accessed using SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced
edition are affected by web browser settings relating to cross-site cookies. Restrictions that apply to such
cookies may result in applications failing to load. This can occur in the following cases:
The following table shows the web browser settings that are required to use SAP Product Lifecycle
Management applications with SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced
edition in the supported web browsers.
Google Chrome Changes to the default Google Chrome browser settings To allow usage in Incognito mode on macOS
are required to use affected applications in an Incognito or Microsoft Windows:
tab or window.
1. Enter chrome://settings/
cookies into your Google Chrome
browser address bar.
settings .
3. Ensure Allow all cookies is selected.
party cookies
3. Ensure Allow third-party cookies is se-
lected.
Administration Guide
Technical Prerequisites PUBLIC 17
Web Browser Background Information Settings
Safari On macOS, changes to the default Safari browser set- To allow usage in Normal or Private mode on
tings are required to use affected applications in a Nor- macOS:
mal or Private tab or window.
1. Open the Safari menu and select
On iOS, changes to the default Safari browser settings Preferences....
are required to use affected applications (regardless of 2. Navigate to Privacy.
whether a Private tab is used). 3. Ensure Prevent cross-site tracking is dis-
abled.
Microsoft Edge Changes to the default Microsoft Edge browser settings To allow usage in InPrivate mode on macOS
are required to use the affected applications in an InPri- or Microsoft Windows:
vate tab or window.
1. Enter edge://settings/
content/cookies into your Micro-
soft Edge browser address bar.
2. Ensure Block third-party cookies is disa-
bled.
Note
Applications that are used on the SaaS application-specific launchpads that are provided by SAP Product
Lifecycle Management subscriptions are not affected by these cross-site cookie restrictions.
Administration Guide
18 PUBLIC Technical Prerequisites
4 Onboarding
To get started working with SAP Product Lifecycle Management, follow these onboarding steps.
Prerequisites
• You have reviewed your welcome email with the details of your purchase and a link for accessing the SAP
Business Technology Platform. If you are new to SAP, the welcome email also has the information about
your SAP user ID (S user ID).
• You have used the link to log on to the SAP Business Technology Platform with your S user ID.
• You have set up your global account on SAP Business Technology Platform.
• You are assigned the Administrator role for the global account.
• You have set up your subaccount in one of the available regions.
The detailed setup steps are available here: Create a Subaccount. To know which feature set you're using,
see Cloud Management Tools — Feature Set Overview.
Note
If you want to use SAP S/4HANA Cloud with SAP Product Lifecycle Management to support the Design
to Manufacturing scenario, then a booster is available to assist you in your onboarding.
For more information, see Onboarding the Design to Manufacturing Scenario with SAP S/4HANA
Cloud [page 36].
Tip
Europe (Netherlands) eu20 Microsoft Azure Available for all SaaS applications
Europe (Frankfurt) eu10 Amazon Web Services Available for all SaaS applications
Administration Guide
Onboarding PUBLIC 19
Region Name Region IaaS Provider Availability per SaaS Application
Europe (Frankfurt) eu11 Amazon Web Services Not available for the Formulation
SaaS application
Note
EU Access is
available for
this region.
US East (VA) us10 Amazon Web Services Available for all SaaS applications
• Note
If you are using SAP S/4HANA Cloud with SAP Product Lifecycle Management to support the Design to
Manufacturing scenario, then a booster is available to assist you in your onboarding.
Context
1. You set up the basic SAP BTP configuration for your entitlement and subscriptions.
2. You set up identity authentication for your subaccount on SAP BTP.
3. You set up your user roles for SAP Product Lifecycle Management.
4. You make the configuration settings for connectivity on SAP BTP.
5. Recommended: You set up the central SAP Build Work Zone, standard edition and its corresponding user
roles.
6. You make the necessary business configuration settings for your SaaS applications to meet your business
requirements.
7. Optional: You set up the integration to other applications and systems as needed.
The following procedure explains the steps in more detail and provides links to more detailed descriptions in
this administration guide and other resources on the SAP Help Portal.
Procedure
1. Subscribe to the SaaS applications that you need. The detailed steps for subscribing are explained here:
Subscribing to the SaaS Applications [page 23].
You use your SAP BTP subaccount to subscribe to all the SaaS applications that you plan to use. Subscribe
to Common Functions to use default role collections for easier user management. For information on which
Administration Guide
20 PUBLIC Onboarding
SaaS applications are integrated and should be subscribed to at the same time, see Subscription Tips:
Integrated SaaS Applications [page 25].
Recommendation
Don't launch the application until you have finished setting up the cloud solution. The Go to Application
link becomes available once the subscription is activated, but you should work through all onboarding
steps before you launch the application.
2. If you use external identity providers, you must configure the trust relationship using the SAP BTP cockpit.
The respective subaccount must have a trust relationship with the identity provider. Using the SAP BTP
cockpit, the administrator of your Cloud Foundry environment must establish this trust relationship.
Recommendation
We recommend that you always use SAP Cloud Identity Service - Identity Authentication as the single
identity provider for SAP BTP. If you use corporate identity providers, connect them to your Identity
Authentication tenant, which then acts as a hub. We especially recommend this if you are using
multiple corporate identity providers. For platform users, the use of SAP Cloud Identity Service -
Identity Authentication is mandatory.
For more information, see Establish Trust and Federation Between SAP Authorization and Trust
Management Service and Identity Authentication.
3. Define and map users based on groups or other attributes to role collections on SAP BTP for SAP Product
Lifecycle Management.
Roles are assigned to role collections that are, in turn, assigned to users or user groups. The various
roles are bundled into role collections, depending on the level of access that you want the user to have
in SAP Product Lifecycle Management SaaS applications. Access can be based on application feature
access, for example, to collaborations or requirements, or based on the personas that you define. You can
use the default role collections that are provided with SAP Product Lifecycle Management (see Default
Role Collections [page 44]). If the default role collections don’t meet your requirements, you can create
your own role collections. For more detailed information, see Role Templates for SAP Product Lifecycle
Management [page 50].
4. Establish a connection between the different services in play using SAP BTP Connectivity: Cloud
Connector, the SAP BTP Destination service, and other predefined protocols for the solution.
The Cloud Connector provides a connectivity proxy to access on-premise resources. The Destination
service lets you retrieve and store the technical information about the target resource (destination) that
you need to connect your application to a remote service or system.
For more detailed information about the connectivity that is needed for each SaaS application, see
Connectivity [page 102].
5. Set up the entry point for your users to open the SAP Fiori apps that are delivered with SAP Product
Lifecycle Management.
Information about the different alternatives with links to more detailed setup information is available here:
Entry Point for App Access [page 171].
6. Make the required business configuration settings for each of your SaaS applications.
For detailed information about the settings that are needed for each SaaS application, see Business
Configuration [page 182].
Administration Guide
Onboarding PUBLIC 21
7. Optional: When needed, set up the integration to other applications and systems.
The Integration tab on the SAP Help Portal page for SAP Product Lifecycle Management provides
integration guides with detailed procedures. Here is a direct link: Integrate.
For information on how to implement APIs that are published on the SAP Business Accelerator Hub for
SAP Product Lifecycle Management, see the Develop tab. Here is a direct link: Develop.
Check SAP Note 3109501 . This contains answers to questions you might have when setting up SAP Product
Lifecycle Management.
Next Steps
Onboarding Users
To onboard your users, share the information that is provided in our User Guide with them. Here is a link to the
relevant section on the SAP Help Portal page: Use.
The SAP Fiori apps that are delivered for the different SaaS applications also have in-app help in SAP
Companion. Users can access the in-app help by choosing the Open Help in the upper right corner of
the launchpad screen. This in-app help has direct links to the relevant sections in the User Guide and, where
needed, more explanation at field level. For more information on how to set this up for SAP Build Work Zone,
standard edition, see SAP Build Work Zone, standard edition with Multiple SaaS Applications [page 172].
Administration Guide
22 PUBLIC Onboarding
4.1 Subscribing to the SaaS Applications
Prerequisites
Context
The following SaaS applications are available for SAP Product Lifecycle Management:
• Collaboration
• Common Functions
• Configuration Management
• Engineering
• Enterprise Product Structure
• Formulation
• Insights
• Intelligent Handover
• Product Data Integration
• Product Innovation Management
• Specification Management
• Visualization
For each SaaS application to which you want to subscribe, you have to add the associated service plan as an
entitlement for your subaccount and create an application instance. You may also need to subscribe to other
integrated SaaS applications for all functions in a SaaS application to work properly. To get an overview of the
SaaS applications that should be subscribed to and used together per SAP BTP subaccount, see Subscription
Tips: Integrated SaaS Applications [page 25].
Note
To get access to the default role collections that can be used for user management, you must add an
entitlement for Common Functions.
Procedure
1. In the SAP BTP Cockpit, open your subaccount and navigate to Entitlements.
Administration Guide
Onboarding PUBLIC 23
2. Search for the SaaS application that you need. If an entitlement for the SaaS application is already
available, proceed to the next step. If it isn't available, follow these steps:
Note
Two plans are available for SAP Product Lifecycle Management: production and test. Use the
production plan for your actual business activities. The test plan is only available for test and
development purposes, and use of this plan is metered differently. For more information about the
metering, see Supplement Terms and Conditions .
7. Navigate to Services Instances and Subscription . You can now see the SaaS application under
Subscriptions.
For more detailed information about subscribing to applications on the SAP Business Technology Platform,
see Subscribe to Multitenant Applications Using the Cockpit.
Results
The Go to Application link becomes available once the subscription is activated. However, we recommend that
you work through all onboarding steps before you choose the button to launch the application.
Note
For the Insights SaaS application, you will use your instance of SAP Build Work Zone, standard edition or
SAP Build Work Zone, advanced edition as your entry point. For more information, see SAP Build Work
Zone, standard edition with Multiple SaaS Applications [page 172] or SAP Build Work Zone, advanced
edition [page 176].
Since your SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition instance is
managed separately, the Go to Application link activated for your Insights subscription cannot forward you
to your SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition instance. Instead,
you need to use the direct link for the instance.
Administration Guide
24 PUBLIC Onboarding
4.1.1 Subscription Tips: Integrated SaaS Applications
When you subscribe to a SaaS application in SAP Product Lifecycle Management, you may also need to
subscribe to other integrated SaaS applications for all functions to work properly.
The following table gives you an overview of the SaaS applications that should be subscribed to and used
together per SAP BTP subaccount. The values shown in the table are as follows:
• yes: The two SaaS applications are tightly integrated. It is mandatory that you subscribe to both SaaS
applications. If you don't, expected functions won't work properly.
• optional: The integrated SaaS application is needed for certain optional functions to work. You can
decide if you also subscribe to it or not.
• not required: The two SaaS applications aren't integrated.
Tip
Here's a short explanation of how to use this table: In the first column, look for the SaaS application that
you would like to subscribe to. Then, in that row, check the information for the other SaaS applications
to find what you need in addition. For example, if you want to use the Collaboration SaaS application,
you see in the second column that you must also subscribe to the Common Functions. A subscription to
some SaaS applications is optional and allows the use of integrated features. SaaS applications with "not
required" aren't integrated with the SaaS application.
Administration Guide
Onboarding PUBLIC 25
Integration Between SaaS Applications
To use
the
SaaS
appli-
cation
below,
you Enterpr Produc
must ise t
also Comm Config Produc Intellig Produc Innovat Specifi
sub- on uration t ent t Data ion cation
scribe Functio Collab Manag Engine Struct Formul Insight Hando Integra Manag Manag Visuali
to... ns oration ement ering ure ation s ver tion ement ement zation
Collab yes –– not re- op- not re- Op- not re- not re- not re- not re- not re- op-
oration
quired tional quired tional quired quired quired quired quired tional
(if you (to
need
the in-
tegra-
tion
func-
tion be-
tween
SAP EA
De-
signer
and
Collab-
ora-
tion)
Engine yes op- not re- –– not re- not re- op- not re- not re- not re- not re- not re-
ering
tional quired quired quired tional quired quired quired quired quired
(if you (to use
need cards
the in- for
tegra- quick
tion access
func- to re-
tion be- quire-
tween ments
SAP EA mod-
De- els)
signer
and
Collab-
ora-
tion)
Administration Guide
26 PUBLIC Onboarding
To use
the
SaaS
appli-
cation
below,
you Enterpr Produc
must ise t
also Comm Config Produc Intellig Produc Innovat Specifi
sub- on uration t ent t Data ion cation
scribe Functio Collab Manag Engine Struct Formul Insight Hando Integra Manag Manag Visuali
to... ns oration ement ering ure ation s ver tion ement ement zation
Visuali yes op- not re- yes (if not re- not re- op- not re- not re- not re- not re- ––
zation
tional quired you quired quired tional quired quired quired quired
(if you need (to use
need data cards
data sources for
sources and quick
and marker access
marker intent to visu-
intent naviga- aliza-
naviga- tion) tions)
tion)
Enterpr yes not re- op- not re- –– not re- op- not re- not re- not re- not re- not re-
ise tional
quired quired quired tional quired quired quired quired quired
Produc
(to use
t
Struct cards
ure for
quick
access
to
prod-
ucts)
Intellig yes not re- op- not re- not re- not re- not re- –– not re- not re- not re- not re-
ent tional
quired quired quired quired quired quired quired quired quired
Hando
ver
Administration Guide
Onboarding PUBLIC 27
To use
the
SaaS
appli-
cation
below,
you Enterpr Produc
must ise t
also Comm Config Produc Intellig Produc Innovat Specifi
sub- on uration t ent t Data ion cation
scribe Functio Collab Manag Engine Struct Formul Insight Hando Integra Manag Manag Visuali
to... ns oration ement ering ure ation s ver tion ement ement zation
Config yes Op- –– not re- yes not re- not re- Op- not re- not re- not re- Op-
uration
tional quired quired quired tional quired quired quired tional
Manag
to use to use to use
ement
inte- inte- inte-
grated grated grated
fea- fea- fea-
tures tures tures
from from from
Collabo Intelli- Visuali-
ration gent zation
Hand-
over
Produc yes not re- not re- not re- not re- not re- op- not re- not re- –– not re- not re-
t
quired quired quired quired quired tional quired quired quired quired
Innovat
(to use
ion
Manag cards
ement for
quick
access
to cam-
paigns
and
ideas)
Specifi yes not re- not re- not re- not re- re- not re- not re- not re- not re- –– not re-
cation
quired quired quired quired quired quired quired quired quired quired
Manag
ement
Administration Guide
28 PUBLIC Onboarding
To use
the
SaaS
appli-
cation
below,
you Enterpr Produc
must ise t
also Comm Config Produc Intellig Produc Innovat Specifi
sub- on uration t ent t Data ion cation
scribe Functio Collab Manag Engine Struct Formul Insight Hando Integra Manag Manag Visuali
to... ns oration ement ering ure ation s ver tion ement ement zation
Insight yes re- not re- re- re- not re- –– not re- not re- re- not re- re-
s
quired quired quired quired quired quired quired quired quired quired
to use to use to use to use to use
the the the the the
cards in cards cards cards cards
the for re- for for for
Insights quire- prod- ideas ideas
: ments ucts in and and
Collabo models the cam- cam-
ration in the Insights paigns paigns
content Insights : in the in the
pack- : Define Develo Insights Insights
age Product p : Define :
s con- Product Product Deliver
tent s con- s con- Product
pack- tent tent s con-
age pack- pack- tent
age age pack-
age
Formul yes op- not re- not re- not re- –– not re- not re- not re- not re- yes not re-
ation quired quired quired quired quired quired quired quired
tional
(to as-
sign
recipes
to col-
labora-
tions)
Produc yes (re- not re- not re- not re- yes not re- not re- not re- –––– not re- not re- yes
t Data quired quired quired quired quired quired quired quired quired
Integra for au-
tion thenti-
cation
from
the au-
thoring
system
plugin)
Administration Guide
Onboarding PUBLIC 29
Related Information
To switch from SAP Enterprise Product Development to SAP Product Lifecycle Management and continue
using the features and functions that you are accustomed to, follow the steps in this document.
Prerequisites
• You received notification that your license for SAP Enteprise Product Development is going to expire.
• You are not using the Enterprise Product Development SaaS application. You are subscribed to the
individual SaaS applications as needed. These include the following:
• Collaboration
• Common Functions
• Configuration Management
• Engineering
• Enterprise Product Structure
• Formulation
• Insights
• Intelligent Handover
• Product Data Integration
• Product Innovation Management
• Specification Management
• Visualization
If you have not migrated to the individual SaaS applications, follow the steps in the migration guide
here:Migrating to Individual SaaS Applications.
• You have contacted your account executive and made the arrangements to receive a new entitlement for
SAP Product Lifecycle Management, and you have received the welcome mail with a link to the SAP BTP
Cockpit.
• You have read and understood all of the steps below. If you have any concerns, before proceeding open an
incident with your questions under PLM-CLOUD-OPS.
Administration Guide
30 PUBLIC Onboarding
Context
In February 2024, we rebranded our solution from SAP Enterprise Product Development to SAP Product
Lifecycle Management. Subscriptions to SAP Enterprise Product Development remained unchanged, that is,
the scope and services for existing customers continue seamlessly until the end of the subscription period.
However, this change means that SAP Enterprise Product Development is no longer available for new
subscriptions. If your license for SAP Enterprise Product Development is going to expire, you need to follow the
steps in this document to move to SAP Product Lifecycle Management. Your existing data will be available after
you complete the steps, and you can continue to use the SaaS applications that you have subscribed to.
Caution
It is important that you complete the following steps in the order described. Do not delete your existing
subscriptions for the SAP Enterprise Product Development SaaS applications. This would result in the loss
of existing data and cannot be reversed.
Procedure
1. In the SAP BTP Cockpit, check that the entitlement for the production plan of each SaaS application is
now available in the global account that you used for SAP Enterprise Product Development.
2. Assign the new entitlement for SAP Product Lifecycle Management to the subaccount that you used for
SAP Enterprise Product Development.
3. In that subaccount, update all subscriptions that you had for SAP Enterprise Product Development from
the standard plan to the production plan. Do not unsubscribe and subscribe. Use the update feature as
follows:
a. Choose the Update option as shown in this sample screenshot:
b. Select production as the plan type and then choose Update Subscription as shown here:
Administration Guide
Onboarding PUBLIC 31
Note
During the migration, you might notice that the entitlements of the old standard plan no longer show
up for your global account. This is the expected behavior. These entitlements for the standard plan
remain in your subaccount and must be updated as described in this step.
Administration Guide
32 PUBLIC Onboarding
4.2 Migrating from SAML to OpenID Connect Protocol
Follow these steps to use the tool specific to SAP Product Lifecycle Management to migrate your SAML trust to
OpenID Connect trust.
Context
It is mandatory for you to use SAP Cloud Identity Service - Identity Authentication as your identity provider for
SAP Product Lifecycle Management. In the past, it was possible to create a SAML trust configuration. However,
a new method for establishing trust has been introduced: the OpenID Connect protocol.
Note
To use the Product Data Integration SaaS application for connecting external non-SAP authoring systems,
such as mechanical CAD, you must use OpenID Connect.
OpenID Connect is also a prerequisite for using Joule. More information is available here: the Next Steps
section in Onboarding [page 19].
To migrate from SAML to OpenID Connect trust, you have two options:
Procedure
1. Before you decide which option to follow, carefully read the documentation that is provided by
SAP Business Technology Platform to understand why the migration is needed and how it can
be accomplished manually, especially if you have third-party IdP software. That information is
available here: https://help.sap.com/docs/btp/sap-business-technology-platform/migration-from-saml-
trust-to-openid-connect-trust-with-identity-authentication.
Note
If you still have questions after reading the documentation, create an incident with your questions
under PLM-CLOUD-PDI.
2. After you read the SAP Business Technology Platform documentation and you decide to use the migration
tool specific to SAP Product Lifecycle Management, ensure that you have a subscription to the Common
Functions SaaS application and that you have configured the necessary destination for APIs of the SAP
Authorization and Trust Management service. If you use the Collaboration, Specification Management,
or Visualization SaaS application, it is mandatory to set up this EPD_XSUAA_API destination. For more
information, see Configuring Connectivity for Common Functions [page 132].
3. Access SAP Note 3468581 to get the URL for the migration tool.
Administration Guide
Onboarding PUBLIC 33
4. Open the tool and paste your credentials from the destination from step 2 for the connection to the APIs
of the SAP Authorization and Trust Management service into the respective input field and choose Set
Credentials.
The tool calls GET /sap/rest/identity-providers from Identity Provider Management API to get
your current trust configuration lists. It then displays different options depending on the information that
is returned. For example, if the tool finds multiple IAS with the SAML2 configuration, then it allows you to
select one for the migration.
If the tool detects a problem, an error message is displayed. Follow the instructions in the message.
For more information about the Identity Provider Management API, see https://api.sap.com/api/
TrustConfigurationAPI/overview the API documentation on the SAP Business Accelerator Hub.
5. Select the custom identity provider candidate for which the trust should be migrated.
If you have only one provider using SAML, the name of that provider is already displayed here. If you have
multiple candidates, you must select one.
6. Optional: Enter a description for the trust configuration to be displayed to your business users.
7. Optional: Enter a link text to be displayed.
8. Start the migration.
Results
When the migration is complete, the tool has created trust with OpenID Connect for the selected tenant. The
original SAML2 trust is now inactive. The origin key value is oidc-migration-backup. If necessary, you can
restore the original setup from it.
You must now complete the follow-on steps that are described here: Configuration of Identity Authentication
After Migration from SAML to OIDC.
Configure the SAP Cloud Identity Services tenant to integrate authoring systems with SAP Product Lifecycle
Management.
To integrate authoring systems with SAP Product Lifecycle Management, a plugin for the authoring system is
required that consumes the Product Data Integration API. For more information about the API see Business
Accelerator Hub: Product Data Integration API .
The authoring system plugin uses an OAuth 2.0 authorization code flow (interactive sign-in through a web
browser) to authenticate with the Product Data Integration API.
Administration Guide
34 PUBLIC Onboarding
Context
The SAP Cloud Identity Services tenant needs to be configured for authentication.
If you want to use a third-party or corporate identity provider with SAP Cloud Identity Services, refer to
3080900 .
1. The API client (authoring system plugin) performs an OAuth 2.0 authorization code flow against the SAP
Cloud Identity Services tenant and receives an ID token (JWT).
2. The ID token needs to be exchanged for a Product Data Integration API access token such that the API
client can access the Product Data Integration API. The common functions SaaS application provides an
API endpoint to perform the token exchange.
• An OpenID Connect (OIDC) trust relationship needs to be established between the subaccount and the
SAP Cloud Identity Services tenant.
Note
If you have an existing SAML protocol for your trust relationship, you must migrate that trust
relationship to an Open ID Connect protocol. The steps for the migration are explained here: Migrating
from SAML to OpenID Connect Protocol [page 33].
If you still have questions after reading the documentation, create an incident with your questions
under PLM-CLOUD-PDI.
• A destination needs to be created in the subaccount that points to the SAP Cloud Identity Services tenant.
It is used by the common functions SaaS application to perform the token exchange. See Configuring
Connectivity for Product Data Integration [page 168] .
• Create user groups in the SAP Cloud Identity Services tenant and add users to these groups. Map the user
groups to the role collections in the subaccount. See Managing Groups.
Prerequisites
• You have set up the SAP Cloud Identity Services tenant. See Get Your Tenant .
• You must be subscribed to the common functions SaaS application. For more details, see Subscribing to
the SaaS Applications.
• You must be subscribed to the Enterprise Product Structure SaaS application. For more details, see
Subscribing to the SaaS Applications.
• You must be subscribed to the Visualization SaaS application. For more details, see Subscribing to the
SaaS Applications..
Administration Guide
Onboarding PUBLIC 35
Procedure
• Open the SAP Business Technology Platform cockpit and navigate to your subaccount. Establish an OIDC
trust relationship between your subaccount and the SAP Cloud Identity Service - Identity Authentication
tenant. See Establish Trust and Federation Between SAP Authorization and Trust Management Service and
Identity Authentication.
• Open the administration console of the SAP Cloud Identity Service - Identity Authentication tenant
SeeAccess Admin Console.
• From the navigation menu, choose Applications & Resources > Applications. In the list of
applications under Bundled Applications, select the application named "SAP BTP Subaccount
<subaccount_name>". It was created automatically when the trust relationship was established.
• Choose Trust Single Sign-On OpenID Connect Configuration .
• Under Redirect URIs, add the URI http://localhost:53230. The redirect URI is used by
the authoring system plugin to receive the authorization code as part of the OAuth 2.0
authorization code flow.
• Under Grant Types, make sure that at least the following grant types are enabled:
Authorization Code, JWT Bearer, Refresh, Token Exchange (RFC 8693).
• Save your changes.
• Application APIs Client Authentication
• Make a note of the Client ID. It is required for configuring the destination in a subsequent step.
• Under Secrets, add a new secret. Make sure to make a note of the secret. It is required for
configuring the destination in a subsequent step.
• Property Value
Expire in Never
• Check (enable) the option Enable Public Client Flows. It is required for the OAuth 2.0
authorization code flow to not require a client secret.
• Save your changes.
With the Design to Manufacturing scenario, you can tightly integrate SAP Product Lifecycle Management with
SAP S/4HANA Cloud to support an end-to-end handover process. You can create MBOMs in SAP Product
Lifecycle Management and easily hand them over to SAP S/4HANA Cloud and vice versa.
Administration Guide
36 PUBLIC Onboarding
Note
The integration also requires that you make certain settings in SAP S/4HANA Cloud. For example, you
must enable scope item 6U3. For more details, see Activating Scope Item 6U3.
In this integration documentation, we use the product name "SAP S/4HANA Cloud" to refer to the SAP
S/4HANA Cloud Public Edition.
Business Process
• Provide a fully harmonized and seamless integrated scenario between SAP Product Lifecycle Management
and SAP S/4HANA Cloud.
• One common launchpad for accessing SAP S/4HANA Cloud apps and SAP Product Lifecycle Management
SaaS applications for the users with the role of production engineer.
• Search for engineering structures created in Enterprise Product Structure SaaS application directly from
an external authoring system using the Product Data Integration (PDI) SaaS application.
• Initiate the process of creating a handover of the PDI-based engineering structure to derive a target BOM in
the Intelligent Handover SaaS application.
• Seamlessly navigate between the Intelligent Handover SaaS application and SAP S/4HANA Cloud apps
such as Manage Product, Maintain Bills of Material (Version 2), and Manage Routings.
The following graphic gives you an overview of the applications and their connection in the integration scenario:
1. The integration process starts with the design engineers working with a non-SAP authoring system and
saving their evolving design into SAP Product Lifecycle Management. Using the API from the Product
Data Integration SaaS application, the plugin in the external authoring system sends files, structure data,
and metadata to SAP Product Lifecycle Management. Product Data Integration manages these files (file
storage), structures, and metadata as so-called design items.
2. To re-load a design item back into the authoring system, SAP Product Lifecycle Management explodes its
structure and provides the required files. As the design matures, the design engineer derives the product
Administration Guide
Onboarding PUBLIC 37
structure in SAP Product Lifecycle Managementvia Product Data Integration. Both services maintain the
links between the objects from the Product Data Integration SaaS application and the Enterprise Product
Structure SaaS application.
3. The Enterprise Product Structure invokes the generation of the visualizations based on the non-SAP
authoring system's files and metadata managed by Product Data Integration.
The visualization models are stored in the file storage and then are converted into visualizations in the
Visualization SaaS application. The SAP Product Lifecycle Management now has access to the structure
representation along with the visualization.
4. The production engineer references the engineering product structure to derive a target manufacturing
bill of materials (MBOM) by searching and initiating a handover activity in the Intelligent Handover SaaS
application. The production engineer plans and restructures the target MBOM according to the way the
product will be manufactured. After finalizing the target MBOM, the production engineer publishes or
synchronizes the information to the connected external data sources, SAP S/4HANA Cloud systems.
The production engineer modifies or creates MBOMS in the apps on the SAP S/4HANA Cloud Fiori
launchpad.
A booster is a set of guided interactive steps that enable you to select, configure, and consume services on SAP
BTP to achieve a specific technical goal. Boosters automate processes that otherwise require a high number
of manual steps, such as onboarding integration scenarios like Design to Manufacturing Process – Discrete
Industries. The booster helps you onboard a SAP Product Lifecycle Management tenant in a new or existing
subaccount.
Caution
Before you start the booster configuration, you must decide whether you want to add the Intelligent
Handover SaaS application in a new subaccount or an existing subaccount. If you make the wrong
selection for your use case during the configuration, you may run into issues further in the onboarding
process.
Follow the steps provided in the procedure section to integrate the service using booster automation.
• You need to set up the connectivity between SAP Product Lifecycle Management and SAP S/4HANA
Cloud by defining destinations in SAP BTP. To manage destinations, you must be the Global Account
Administrator of the SAP BTP global account.
• You must register the SAP S/4HANA Cloud system in SAP BTP. These steps are described in detail here:
Register an SAP S/4HANA Cloud System in a Global Account in SAP BTP.
• You must enable the SAP S/4HANA Cloud scope item 6U3 that activates the communication scenario
SAP_COM_0937 Product Lifecycle Management - EPD Integration for the customer. This is the prerequisite
communication scenario for SAP Product Lifecycle Management integration with SAP S/4HANA Cloud.
See also, Activating Scope Item 6U3.
Administration Guide
38 PUBLIC Onboarding
Procedure for Running the Booster Automation
To start the onboarding of Design to Manufacturing Process – Discrete Industries integration scenario, follow
these step-by-step instructions.
Tip
Throughout the booster configuration, choose Next to get to the next selection screen or Previous to adjust
settings you made in the previous screen.
Step Task
1. Log on to the SAP BTP Cockpit using either of these URLs depending on your region:
• EMEA: https://emea.cockpit.btp.cloud.sap
• Americas: https://amer.cockpit.btp.cloud.sap
• EU Access: https://eu-access.cockpit.btp.cloud.sap
• A logon URL in the region closest to you (to avoid latency). See Regions and API Endpoints Available for the
Cloud Foundry Environment in the SAP BTP documentation.
2. Open the global account that is used for your SAP Product Lifecycle Management entitlement.
Note
If you don’t see this entry in the navigation panel, you need to have the Global Account Administrator role
assigned to your user.
Administration Guide
Onboarding PUBLIC 39
Step Task
4. Select the tile Set Up Design to Manufacturing Process – Discrete Industries from the Boosters overview page
and choose Start.
The booster checks the necessary prerequisites including required authorizations and entitlements.
6. Decide whether you want to create a new subaccount for Design to Manufacturing Process – Discrete Industries
or add the Intelligent Handover subscription to an existing subaccount.
Once you have decided, select either Create Subaccount or Select Subaccount and choose Next. Continue with
step 6a. or 6b.
Administration Guide
40 PUBLIC Onboarding
Step Task
To create the subscription in a new subaccount, enter the required information and choose Next. The booster
prefills the fields with suggestions you can partially change:
• Entitlements: Depending on your use case, you can delete optional entitlements of applications that you
don’t want to subscribe to.
You can choose either the Production or Test Plan based on your requirements. You can choose Test if you
plan to test the configurations.
• Subaccount Name: You can change the generated name to something more relevant to your use case.
• Region: Change the region if the prefilled region is not suitable.
• Subdomain: This will be the name of your SAP Product Lifecycle Management tenant.
You can deselect optional applications in this step by choosing the Delete action.
To choose an existing subaccount for this booster, select the relevant subaccount from the list under
Subaccount.
Entitlements: Depending on your use case, you can delete optional entitlements of applications that you don’t
want to subscribe.
7. Review the configuration settings that you made, especially regarding the subaccount mode. When you are
satisfied with your choices, choose Finish.
The booster assigns the role collection to the user who is executing the booster.
Administration Guide
Onboarding PUBLIC 41
Step Task
8. In case of issues during the configuration, open a ticket to SAP Support: https://launchpad.support.sap.com/#/
incident/create for the component PLM-CLOUD-IH.
Next Steps
Set up your user management. See User Management [page 43] and Role Templates for Intelligent Handover
[page 79].
Note
Additionaly, you can set up authorization contexts to manage who can access specific business objects,
whether it's individual users or teams. You can control which apps a user can use by assigning business
catalogs to a role and then linking that role to the user. After that, define how they can access the data by
adding authorization values in the restriction fields. The objects that you restrict the access are BOM usage
and plant. You can restrict the access to read and write to the objects to users or user groups.
For the Intelligent Handover SaaS application, you need to set up authorization access in both the SAP
S/4HANA Cloud system and SAP Product Lifecycle Management. Make sure the assigned restrictions are
identical in both systems to avoid any authorization issues for the business role. Check out the following
links for the procedures:
• For maintaining the authorization restriction in the SAP S/4HANA Cloud systems:
• Identity Access Management
• Business Roles, Business Catalogs and Restrictions
• For maintaining the authorization restriction in the SAP Product Lifecycle Management systems:
• Configuring Authorization Access [page 375]
Administration Guide
42 PUBLIC Onboarding
5 User Management
Prerequisites
• You use SAP Cloud Identity Service - Identity Authentication as the single identity provider for SAP BTP
• If you use external identity providers, you have configured the trust relationship using the SAP BTP cockpit.
The respective subaccount must have a trust relationship with the identity provider
For more information, see Trust and Federation with Identity Providers.
Procedure
A role collection comprises several roles and is assigned to users or user groups. The roles that you bundle into
a role collection for SAP Product Lifecycle Management depend on the level of access that you want a user to
have to different apps for working on, for example, collaborations, requirements, and so on.
1. Check out the default role collections that are delivered as part of the Common Functions SaaS application
for SAP Product Lifecycle Management.
These default role collections for SAP Product Lifecycle Management were created based on typical
personas in the product lifecycle management process and are updated regularly. They provide access
to the SAP Product Lifecycle Management apps that are most often needed by your different users to
complete their daily work tasks.
Details about the available default role collections, the tasks that each collection covers, and how to use
them is available here: Default Role Collections [page 44]
Note
To be able to use the default role collections, you must also subscribe to the Common Functions SaaS
application. For more information, see Subscribing to the SaaS Applications [page 23].
Caution
Once you use default role collections and assign them to your users, you can't delete them.
2. If the default role collections that are delivered with SAP Product Lifecycle Management do not meet your
requirements, you can create your own roles, which you then bundle into your own role collections and
assign to your users. For more information on the steps, see Working with Role Collections.
SAP Product Lifecycle Management provides role templates for you to base your own custom roles on. For
more information about the apps are bundled into the different role templates, see Role Templates for SAP
Product Lifecycle Management [page 50].
Administration Guide
User Management PUBLIC 43
5.1 Default Role Collections
These role collections are available once you have subscribed to the Common Functions SaaS application as
described in Subscribing to the SaaS Applications [page 23]. The default role collections cannot be deleted.
They reflect typical user scenarios. If they don't meet your requirements, you can, of course, build your
own role collections. For more information on how to do that, see Role Templates for SAP Product Lifecycle
Management [page 50].
Which role templates are available in any one of the default role collections is dependent on the SaaS
applications you have subscribed to.
Example
After you have subscribed to the Common Functions SaaS application, the EPD-Administrator default
role collection includes only the Team_Editor role template. If you also subscribe to the Collaboration
SaaS application, you'll see that the EPD-Administrator default role collection now also includes the
CollaborationDPPAdministrator role template.
For more information about the role templates for each SaaS application, see the respective document under
Role Templates for SAP Product Lifecycle Management [page 50].
We recommend that you use SAP Build Work Zone, standard edition as the entry point for your business users
to access apps. If you use the default role collections that are provided with Common Functions, you must also
create equivalent default role collections for SAP Build Work Zone, standard edition. If you build your own role
collections, you can use them for the app access for both SAP Product Lifecycle Management and for SAP
Build Work Zone, standard edition. For more information on the steps you need to follow in both scenarios, see
SAP Build Work Zone, standard edition with Multiple SaaS Applications [page 172].
The following table shows the default role collections and task information to help you map them to your
business users:
Administration Guide
44 PUBLIC User Management
Name Description Tasks
EPD-Quality-Manager Enables users to perform the tasks required to Tasks include the following:
lead a team of quality engineers that are working
• Defining the testing scope
to meet project quality criteria and requirements
based on the requirements
through test planning, test execution, quality as-
surance and issue tracking
• Defining test plans, strat-
egies, and executions for as-
signed projects
• Defining linkage between re-
quirements and test cases
• Estimating the testing effort
required by calculating the
sizing needed for the given
release
• Monitoring all the QA ac-
tivities, test results, leaked
defects, root cause analy-
sis, gathering and presenting
testing metrics and testing
activities for the projects to
key stakeholders
• Defining areas of improve-
ment and implementing
steps required to improve the
processes
• View data on cards that are
provided by the Insights SaaS
application
Administration Guide
User Management PUBLIC 45
Name Description Tasks
EPD-Quality-Engineer Enables users to perform the tasks required to Tasks include the following:
test the product or system to ensure it functions
• Reading all the documents
properly and meets the business needs
and understanding what
needs to be tested
• Determining resource and
equipment needs for con-
ducting testing
• Determining timing and cost
required to execute test pro-
grams
• Setting up test environments
and executing all the test
case and logging test results
• Analyzing and tracking de-
fects identified in testing and
recommending product de-
sign revisions based on test
data to meet expected results
• View data on cards that are
provided by the Insights SaaS
application
EPD-Systems-Engineer Enables users to define the architecture and the Tasks include the following:
behavior of the product
• Guide the engineering of me-
chatronic products, that is,
products that contain me-
chanical and electronic parts
as well as software
• Review requirements and
configure review rules
• View data on cards that are
provided by the Insights SaaS
application
EPD-Requirements-Engineer Enables users to elicit, document, manage, and Tasks include the following:
validate requirements
• Manage needs
• Review requirements and
configure review rules
• View data on cards that are
provided by the Insights SaaS
application
Administration Guide
46 PUBLIC User Management
Name Description Tasks
EPD-Product-Manager Enables users to define new products and to mon- Tasks include the following:
itor the progress of product development and the
• View needs
performance on the market
• Review requirements and
configure review rules
• Manage innovation cam-
paigns in Product Innovation
Management
• View data on cards that are
provided by the Insights SaaS
application
EPD-Product-Manager- Enables users to define new products, define tech- Tasks include the following:
nical product packages, work with suppliers and
•
Extended
View needs
contract manufacturers to review their responses,
and monitor the progress of product development
• Review requirements and
configure review rules
and the performance on the market
• Manage innovation cam-
paigns in Product Innovation
Management
• View data on cards that are
provided by the Insights SaaS
application
Administration Guide
User Management PUBLIC 47
Name Description Tasks
EPD-Administrator Enables users to configure all specialist project Tasks include the following:
and application settings and to control sensitive
• Create and maintain visuali-
security parameters
zation data sources
• Create and maintain visuali-
zation viewer and card tem-
plates
• Create and maintain usage ID
definitions and categories
• Manage visualizations and
folders
• Transfer ownership of folders
and visualizations, for exam-
ple, if an existing owner has
left a project or left the com-
pany
• Control the folders that are
enabled for anonymous ac-
cess. Anonymous access pro-
vides unauthenticated users
with read access to the vis-
ualisations contained in the
folder.
• Define malware scanning pol-
icies for visualization uploads
• Define content caching poli-
cies for visualization viewing
or editing
• Control the source of
allowable requests to
theVisualization service. This
controls security on program-
matic access to Visualization.
• Define group management
policies for user groups. This
simplifies user administration
in Visualization
• Manage teams and rules for
Common Functions
• Configure the BOM attrib-
utes required for working or
planning the handovers in
Intelligent Handover
Administration Guide
48 PUBLIC User Management
Name Description Tasks
EPD-Idea-Contributor Enables users to provide product idea or feedback Tasks include the following:
EPD-Design-Engineer Enables users to perform tasks relating to the de- Tasks include the following:
sign of certain components of a product, including
• Create and edit baselines
taking various sources of input into account. and configuration plans in
Configuration Management
• View data on cards that are
provided by the Insights SaaS
application
EPD-Service-Engineer Enables users to perform tasks related to Tasks include the following:
Administration Guide
User Management PUBLIC 49
Name Description Tasks
EPD-Production-Engineer Enables users to perform tasks related to manag- Tasks include the following:
EPD-Evaluator Enables users to perform tasks related to evaluat- Tasks include the following:
If you want to create your own roles, follow the steps given in Create Roles for Subscribed Applications Using
Existing Role Templates.
For more information about the provided default role templates and default role collections for a specific SaaS
application of SAP Product Lifecycle Management, see the relevant document:
Administration Guide
50 PUBLIC User Management
5.2.1 Role Templates for Collaboration
The Collaboration SaaS application for SAP Product Lifecycle Management provides the following role
templates:
CollaborationAdmi Allows the user to de- level, type Scopes relevant for Configure
Collaboration,
n termine which fields level are:
Configure Product
are shown in an app
• admin Data, Workflow
and which value is dis- Properties,
played for each busi-
• superadmin
Collaboration - Data
ness user. Scope relevant for Security, Monitor
Workflows, My
type is:
Allows the user to ac- Collaborations, My
cess and work with col- • internal Inbox, Configure
laborations. Visibility Scenarios,
Event Acquisition,
Manage Decisions,
Manage Packages,
Monitor Visibility
Scenarios, Process
Flexibility Cockpit,
Process Workspace,
Visibility Scenario
Dashboard
CollaborationUser Allows the user to ac- type Scopes relevant for My Collaborations, My
Inbox
cess and work with col- type are:
laborations.
• internal
• external
Administration Guide
User Management PUBLIC 51
Tiles on SAP Fiori
Name Description Available Attributes Attribute Scope Launchpad
CollaborationAdminis- Allows the user to de- type Scope relevant for Configure
Collaboration,
trator termine which fields type is:
Configure Product
are shown in an app
• internal Data, Workflow
and which value is dis- Properties,
played for each busi- Collaboration - Data
ness user. Security, Monitor
Workflows, My
Collaborations, My
Inbox, Configure
Visibility Scenarios,
Event Acquisition,
Manage Decisions,
Manage Packages,
Monitor Visibility
Scenarios, Process
Flexibility Cockpit,
Process Workspace,
Visibility Scenario
Dashboard, Visibility
Scenario Dashboard
CollaborationDPPAd- Allows the user to de- type Scope relevant for Configure
Collaboration,
ministrator termine which fields type is:
Configure Product
are shown in an app
• internal Data, Workflow
and which value is dis- Properties,
played for each busi- Collaboration - Data
ness user. Security, Monitor
Workflows, My
Collaborations, My
Inbox, Configure
Visibility Scenarios,
Event Acquisition,
Manage Decisions,
Manage Packages,
Monitor Visibility
Scenarios, Process
Flexibility Cockpit,
Process Workspace.
CollaborationInterna- Allows the user to ac- type Scope relevant for My Collaborations, My
Inbox
lUser cess and work with col- type is:
laborations.
• internal
CollaborationExterna- Allows the user to ac- type Scope relevant for My Collaborations, My
Inbox
lUser cess and work with col- type is:
laborations.
• external
Administration Guide
52 PUBLIC User Management
Note
These are preshipped roles with default attributes. Do not modify or delete these role templates.
• CollaborationExternalUser
• CollaborationAdministrator
• CollaborationDPPAdministrator
• CollaborationInternalUser
Note
You can create other role collections applicable to collaboration, based on your business needs.
The following table shows you which of the default role collections contain the above role template:
EPD-Sys- EPD-Re-
Collaborat
ionAdminis
trator
Collaborat x x
ionDPPAdmi
nistrator
Collaborat x x x x x
ionInterna
lUser
Collaborat
ionExterna
lUser
To help you get started with the Collaboration cloud service, perform the following steps to create roles and role
collections:
Note
The following table is only an example. You can create roles based on your business needs.
Administration Guide
User Management PUBLIC 53
Example of Roles from Collaboration Role Templates
Administration Guide
54 PUBLIC User Management
Tiles on SAP Fiori
Role Description Role Template Attribute Scope Launchpad
Note
By default, Source field to be set as Static when creating a new role using Create Role wizard.
Note
The following table is only an example. You can create role collections based on your business needs.
Administration Guide
User Management PUBLIC 55
Role Collection Mandatory/Op-
Name Roles From Application tional Roles Purpose
Administration Guide
56 PUBLIC User Management
Role Collection Mandatory/Op-
Name Roles From Application tional Roles Purpose
Administration Guide
User Management PUBLIC 57
Role Collection Mandatory/Op-
Name Roles From Application tional Roles Purpose
Administration Guide
58 PUBLIC User Management
Role Collection Mandatory/Op-
Name Roles From Application tional Roles Purpose
Provisional Specifications
In addition to the general role templates for Collaboration, the following role templates are provided for working
with provisional specifications:
Administration Guide
User Management PUBLIC 59
Role Templates Provided for Provisional Specifications
SpecificationEditor Allows the user to create, edit, and read Manage Provisional Specifications
provisional specifications.
SpecificationAdministrator Allows the user to perform administra- • Load Value Sets for Specification
tive tasks like loading value sets, data • Specification - Data Security
anonymization, and data export. Also • Configure Provisional
allows the user to delete provisional Specifications
specifications. • Manage Provisional Specifications
SpecificationExternal Allows the user to read, edit, and copy Manage Provisional Specifications
provisional specifications assigned to
them in a collaboration.
Recommendation
When setting up an administrator role for the specification exchange scenario, we recommend that you add
both the SpecificationAdministrator and the CollaborationDPPAdministrator rights to that role.
This section provides you with the information about the role templates that are needed to work with other
services that are integrated with SAP Product Lifecycle Management.
Administration Guide
60 PUBLIC User Management
Role Name Role Template Application Identifier
For more information on UI5 flexibility, see What is UI5 flexibility? [page 229].
WorkflowContextAdmin
WorkflowDeveloper
WorkflowViewer
WorkflowInitiator
WorkflowParticipant
WorkflowContextViewer
The Product Package Exchange which is part of the Collaboration SaaS application for SAP Product Lifecycle
Management provides the following role templates:
The Collaboration SaaS application provides you with the following role templates:
ProductPackageExchangeProfessiona- Allows the users to access and work Product Package Exchange
lUser with collaboration and product data.
Administration Guide
User Management PUBLIC 61
5.2.2 Role Templates for Common Functions
The Common Functions SaaS application for SAP Product Lifecycle Management provides you with the
following role templates:
Note
For authorization contexts to
work properly, you must also
assign specific role templates
to the users who are assigned
to the authorization contexts.
For more information, see the
following:
• Role Templates for Enter-
prise Product Structure
[page 70]
• Role Templates for Intelli-
gent Handover [page 79]
For more information about what users can do in the individual apps, see the following documents:
To help you get started with Common Functions, you can use the following default role collections.
Administration Guide
62 PUBLIC User Management
Default Role Collections for Common Functions
Default Role Collection
EPD-
EPD- EPD-Re- Product- EPD-
EPD- EPD- Sys- quire- EPD- Man- EPD-Ad- Idea- EPD-De- EPD-
Role Quality- Quality- tems-En- ments- Product- ager-Ex- ministra- Contrib- sign-En- Service-
Template Manager Engineer gineer Engineer Manager tended tor utor gineer Engineer
Team_Ed x
itor
Team_Vi x x x x x x
ewer
EPD_Adm x
in
The Configuration Management SaaS application for SAP Product Lifecycle Management provides role
templates that you can use to enable your users to perform different actions depending on their roles.
Baseline_Administrator Allows the user to anonym- Manage Baselines, Manage • Takes care of data se-
ize the user details, to export Configuration Plans, Data
curity aspects.
business data, and to main- Security for Configuration
tain customizing data. Management, Configure • Has the authorization to
Baselines and Configuration maintain baselines and
Plans configuration plans.
• Maintains customizing
for baselines and config-
uration plans to define
baseline profiles and life-
cycle phase templates.
Administration Guide
User Management PUBLIC 63
Tiles on SAP Fiori Launch-
Name Description pad Tasks
Baseline_Editor Allows the user to both Manage Baselines, Manage • Defines configuration
define the required ad- Configuration Plans,
plans to describe the
ministrative settings for Configure Baselines and
controlled configuration
Configuration Management Configuration Plans
(configuration plans and life- management process.
cycle phases) and also to • Defines lifecycle phases
define the operational base- to detail – inside a con-
lines by adding product figuration plan – the in-
structures, routing, produc-
dividual phases or steps
tion version, or products, and
inside the configuration
documents to it, for example.
management process.
• Defines baselines to
freeze a product's struc-
ture at a specific point in
time.
• Views and customizes
entries for baselines and
configuration plans
Baseline_Viewer Allows the user to view base- Manage Baselines, Manage • Views configuration
lines and configuration plans Configuration Plans
plans to check the
and lifecycle phases.
controlled configuration
management process.
• Views configuration
phases to understand
– inside a configuration
plan – the individual
phases or steps inside
the configuration man-
agement process.
• Views baselines and
controlled objects, like
product structures,
products, or optionally
routing and production
version.
Administration Guide
64 PUBLIC User Management
Tiles on SAP Fiori Launch-
Name Description pad Tasks
Routing_Viewer Allows the user to baseline Manage Baselines • Pulls routing data from
and view routing information.
the source system.
• Views routing informa-
tion in the baselines.
Note
This role shall be
used along the
Baseline_Editor or
the Baseline_Viewer
role to be able to work
with routing information
in baselines.
EPD-
EPD- Prod- EPD-
EPD- Re- uct- Pro-
Qual- quire- Man- duc-
ity- EPD- EPD-Sys- ments EPD- ager- EPD-Ad- EPD-De- EPD-Serv- tion-
Role Tem- Man- Quality- tems-En- -Engi- Product- Ex- ministra- sign-Engi- ice-Engi- Engi-
plate ager Engineer gineer neer Manager pert tor neer neer neer
Baseline_Ad X
ministrator
Baseline_Ed X X X X X
itor
Baseline_Vi X X X X X X X X X
ewer
Status Management
Administration Guide
User Management PUBLIC 65
Note
Maintaining Attachments
As Configuration Management requires roles from other services, you must also create roles out of the
following role templates:
In order to maintain attachments in the Manage Baseline App, the existing role templates Baseline_Editor,
Baseline_Administrator, and Baseline_Viewer have to be extended with SDM_User, SDM_Admin.
This section provides you with the information about the role templates that are needed to work with the UI5
Flexibility Services that are integrated with SAP Product Lifecycle Management.
The following role templates from the UI5 flexibility services are relevant for your key users:
Administration Guide
66 PUBLIC User Management
Role Name Role Template Application Identifier Description
For more information on UI5 flexibility, see What is UI5 flexibility? [page 302]
The Engineering SaaS application for SAP Product Lifecycle Management provides you with the following role
templates:
TestCaseCoverage_Viewer Allows the user to view the test case Test Cases Coverage
coverage.
TestCase_Viewer Allows the user to read test cases. Manage Test Cases
TestCase_Editor Allows the user to read, create, update, Manage Test Cases
TestPlan_Viewer Allows the user to read test plans and Manage Test Plans
test cases.
TestPlan_Editor Allows the user to read test cases, as Manage Test Plans
TestExecution_Viewer Allows the user to read test executions, Manage Test Executions
Administration Guide
User Management PUBLIC 67
Name Description Tiles on SAP Fiori Launchpad
TestExecution_Editor Allows the user to read test executions, Manage Test Executions
• Test executions
• Test cases
• Test plans
• Test case results
• Test execution comments
• Test executions
• Test cases
• Test plans
• Test case results
• Test execution comments
RequirementQualityConfig_Edito Allows the user to configure the details Settings for Review Requirements
r
for reviewing requirement rules.
Engineering_Administrator Allows the user to manage data secur- Test Management - Data Security
Settings
ity for Engineering.
To work with the Requirements Management and Systems Modeling app, the following role templates are
provided.
Administration Guide
68 PUBLIC User Management
Role Templates for Working with Requirements Management and Systems Modeling
Name Description
EADesigner_Operator It is also provided and does not allow access to your reposi-
tory data, and is reserved for obtaining diagnostic informa-
tion.
To let your users perform extra functions in Engineering, the following role template is required:
SDM_User Allows the user to upload attachments. SAP Document Management service
To help you get started with the Engineering cloud service, create the following role collections.
EPD-Re-
EPD- EPD- EPD-Sys- quire- EPD- EPD-Ad- EPD-Idea- EPD-De- EPD-Serv-
Quality- Quality- tems-En- ments- Product- ministra- Contribu- sign-Engi- ice-Engi-
Name Manager Engineer gineer Engineer Manager tor tor neer neer
EADesign x
er_Admin
istrator
EADesign x
er_Opera
tor
EADesign x x x x x
er_User
Engineer x
ing_Admi
nistrato
r
MyTest_P x x
roducer
MyTest_V x x x x
iewer
ReportCe x x x
nter_Con
tributor
Administration Guide
User Management PUBLIC 69
Role Collection
EPD-Re-
EPD- EPD- EPD-Sys- quire- EPD- EPD-Ad- EPD-Idea- EPD-De- EPD-Serv-
Quality- Quality- tems-En- ments- Product- ministra- Contribu- sign-Engi- ice-Engi-
Name Manager Engineer gineer Engineer Manager tor tor neer neer
ReportCe x
nter_Vie
wer
TestCase x x x
Coverage
_Viewer
TestCase x x
_Editor
TestCase x x x x
_Viewer
TestExec x
ution_Ed
itor
TestExec x x x x
ution_Vi
ewer
TestPlan x
_Editor
TestPlan x x x x
_Viewer
Requirem x x x x x
entQuali
ty_Edito
r
Requirem x x x x x
entQuali
tyConfig
_Editor
SDM_User x x x x x x x
Note
The 'x' in the table indicates that the role template is recommended to define the corresponding role
collection.
The Enterprise Product Structure SaaS application of SAP Product Lifecycle Management provides the
following role templates:
Administration Guide
70 PUBLIC User Management
Role Templates Provided by Enterprise Product Structure
The application identifier for Enterprise Product Structure role templates is sap-epd-ps-dev<suffix>.
The following table shows you which of the default role collections contain the above role templates:
EPD-
Re- EPD-
EPD- quire- Pro-
Qual- ment duc-
ity- EPD- EPD-Sys- s-En- EPD- EPD-Ad- EPD- EPD-De- EPD- tion-
Role Tem- Man- Quality- tems-En- gi- Product- ministra- Idea-Con- sign-En- Service- Engi-
plate ager Engineer gineer neer Manager tor tributor gineer Engineer neer
Structure_ X X X X X X X X
Viewer
Structure_ X X X X
Editor
Administration Guide
User Management PUBLIC 71
Role Collection
EPD-
Re- EPD-
EPD- quire- Pro-
Qual- ment duc-
ity- EPD- EPD-Sys- s-En- EPD- EPD-Ad- EPD- EPD-De- EPD- tion-
Role Tem- Man- Quality- tems-En- gi- Product- ministra- Idea-Con- sign-En- Service- Engi-
plate ager Engineer gineer neer Manager tor tributor gineer Engineer neer
Structure_ X
Administra
tor
Structure_ X
Key_User
Note
Below role collection required for key user to access the UI5 flexibility services.
For more information on UI5 flexibility, see What is UI5 flexibility? [page 229]
The Formulation SaaS application uses role templates that are driven by business object models, usually
working with a display and maintainer template.
Note
The role template name generally contains Configurator for configuration data and Viewer for display-
only authorization.
Administration Guide
72 PUBLIC User Management
Name Description Tiles on SAP Fiori Launchpad
RecipeCalculationConfigurator Allows the user to configure recipe cal- Configure Recipe Calculations
culations.
The above role templates are included in the following default role collections:
EPD-
EPD- Re-
Qual- quire-
ity- EPD-Sys- ments- EPD-Prod- EPD-De- EPD-Serv-
Man- EPD-Qual- tems-Engi- Engi- uct-Man- EPD-Ad- sign-Engi- ice-Engi-
Role Template ager ity-Engineer neer neer ager ministrator neer neer
RecipeBasicCo X
nfigurator
RecipeBasicCo
nfigurationVi
ewer
RecipeEditor X
RecipeViewer
RecipeCalcula X
tionConfigura
tor
RecipeCalcula
tionConfigura
torViewer
RecipeStatusC X
oordinator
Administration Guide
User Management PUBLIC 73
Note
The 'x' in the table indicates that the role template is recommended to define the corresponding role
collection.
SDM_User This role is necessary to be able to see SAP Document Management service
the Documents tab in recipes.
Note
Formulation and Specification Management share the SDM_User role template. If you’ve subscribed to
both the Formulation and the Specification Management SaaS applications, and assign a user to a role
collection from either SaaS application containing the SDM_User role template, then features related to the
SDM_User role template are enabled for both SaaS applications.
Administration Guide
74 PUBLIC User Management
5.2.7 Role Templates for Insights
The Insights SaaS application for SAP Product Lifecycle Management provides role templates that you can use
to enable your users to access the different graphical representations of the information that your users work
with when managing the lifecycle of your products.
The Insights SaaS application for SAP Product Lifecycle Management provides the following role templates
that you can use to let your users to access the data shown on the UI integration cards in the content packages
for SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition:
Change_Management_Anal Allows the user to view the PLM Insights: Change • Change Execution Status
ytics cards with data about change Management • Newly Created and
records. Completed Change
Records
Insights_Collaboration Allows the user to view the PLM Insights: Collaboration • My Collaborations
_Viewer cards with data about collab- • My Collaborations by
orations. Type and Status
• Comments on My
Collaborations
Administration Guide
User Management PUBLIC 75
Name Description Related Content Package UI Integration Cards
Insights_Innovation_Ma Allows the user to view the PLM Insights: Define • Assignment of Tags to
nagement_Viewer cards for ideas and cam- Products Ideas
paigns. • New Ideas by Week
• Ideas by Modification
Date - For Product
Managers
• Ideas by Modification
Date - For Submitters of
Ideas
• Campaigns - For Product
Managers
• My Campaigns - For
Submitters of Ideas
Insights_RequirementsM Allows the user to view the PLM Insights: Define • My Requirements
anagement_Viewer cards for requirements mod- Products Models
els. • Requirements by Model
and Status
• Requirements by Type
and Status for One
Model
Insights_Structure_Vie Allows the user to view the PLM Insights: Develop My Products
wer
card for products. Products
For details on the cards, see
Insights Cards for Products.
Insights_Visualization Allows the user to view the PLM Insights: Deliver Visualizations
_Viewer
card for visualizations. Products
For details on the cards, see
Insights Cards for Visualiza-
tions.
Administration Guide
76 PUBLIC User Management
These role templates are included in the following default role collections:
EPD-
Product EPD- EPD-
EPD- EPD- -Manage EPD- EPD- Require EPD- EPD- EPD- Product
Idea- Product r- Quality Quality ments- Systems Design- Service ion-
Role Contrib -Manage Extende -Manage -Engine Enginee -Engine Enginee -Engine Enginee
Template utor r d r er r er r er r
Change_ X
Managem
ent_Ana
lytics
Insight X X X X X X
s_Colla
boratio
n_Viewe
r
Insight X X
s_Innov
ation_M
anageme
nt_View
er
Insight X
s_Requi
rements
Managem
ent_Vie
wer
Insight X X X X X X X X X
s_Struc
ture_Vi
ewer
Insight X X X X X X X X X
s_Visua
lizatio
n_Viewe
r
Administration Guide
User Management PUBLIC 77
If you don't use the default role collections, your users need the same level of authorization as provided by the
following role templates from the integrated SaaS applications:
PLM Insights: Change • Change Execution Not relevant as data is Not relevant as data is Not relevant as data is
Management Status coming from external coming from external coming from external
and Completed
Change Records
Innovation Homepage
PLM Insights: Define • Ideas by
Idea_Editor Product Innovation
Products Modification Date Management
- For Submitters of
Ideas
• My Campaigns -
For Submitters of
Ideas
Engineering
PLM Insights: Define • My Requirements EADesigner_User Requirements
Products Models Management and
Administration Guide
78 PUBLIC User Management
Tile on SAP Fiori Related SaaS Applica-
Content Package Cards Role Template Launchpad tion
Products
Related Information
The Intelligent Handover SaaS application provides the following role templates:
EPD-Administrator Allows users to configure • Configure Handover Tasks include the following:
the BOM attributes required
for working or planning the
• Manage Data Security
• Create and maintain
handovers. • Task Monitoring for plants.
Handovers
• Create and maintain
BOM usages.
• Create and maintain
item categories.
• Monitor backend tasks
for handovers.
Administration Guide
User Management PUBLIC 79
Tiles on SAP Fiori Launch-
Name Description pad Tasks
EPD-Production- Allows users to perform • Hand Over Engineering • Read BOMs from the
Engineer tasks related to maintaining
Bills of Material (EBOM) SAP S/4HANA system.
handovers.
• Task Monitoring for • Create, update, or delete
Handovers handovers.
• Synchronize changes
with SAP S/4HANA sys-
tem.
• View or display routings.
• Create or update rout-
ings.
• Work with visualizations
• Monitor backend tasks
for handovers.
The Intelligent Handover SaaS application provides the following role templates:
Administration Guide
80 PUBLIC User Management
Role Templates Provided by Intelligent Handover
Role Collections
Administration Guide
User Management PUBLIC 81
Role Collections
de-
lete
hand
over
s.
Administration Guide
82 PUBLIC User Management
Role Collections
Administration Guide
User Management PUBLIC 83
Role Collections
Administration Guide
84 PUBLIC User Management
Role Collections
294]
.
Visualization
The following table shows the default role templates provided by Visualization required for Intelligent Handover:
EPD-
Re-
EPD- quire
Qual- EPD- ment EPD-
ity- EPD- Sys- s-En- EPD- EPD-Ad- Feed- EPD-De- EPD-
Role Tem- Man- Quality- tems-En- gi- Product- ministra- back- sign-En- Service-
plate Description ager Engineer gineer neer Manager tor Provider gineer Engineer
Administration Guide
User Management PUBLIC 85
Role Collection
EPD-
Re-
EPD- quire
Qual- EPD- ment EPD-
ity- EPD- Sys- s-En- EPD- EPD-Ad- Feed- EPD-De- EPD-
Role Tem- Man- Quality- tems-En- gi- Product- ministra- back- sign-En- Service-
plate Description ager Engineer gineer neer Manager tor Provider gineer Engineer
Administration Guide
86 PUBLIC User Management
Enterprise Product Structure
The following table shows the default role templates provided by Enterprise Product Structure required for
Intelligent Handover:
Struct Allows X X X X X X X X
ureVie
users to
wer
view
prod-
ucts and
product
struc-
tures.
Struct Allows X X X X
ureEdi
users to
tor
import
prod-
ucts and
BOMs,
and
manage
product.
Struct Allows X
ureAdm users to
inistr perform
ator system
admin-
istration
tasks
like user
ano-
nymiza-
tion,
and cus-
tomer
data ex-
port.
Administration Guide
User Management PUBLIC 87
Role Collections
Base- Allows X X X X X X X X
line_Vie the user
wer to view
base-
lines
and
control-
led ob-
jects like
product
struc-
tures or
prod-
ucts..
The application identifier for Enterprise Product Structure role templates is sap-epd-ps-dev<suffix>.
The Product Innovation Management SaaS application for SAP Product Lifecycle Management provides you
with the following role templates:
Campaign_Editor Allows the user to create, view, edit, and Manage Campaigns, Manage Ideas
delete campaigns.
Idea_Producer Allows the user to read, edit, and delete Manage Campaigns, Manage Ideas
ideas.
evaluations.
Administration Guide
88 PUBLIC User Management
Name Description Tiles on SAP Fiori Launchpad
Need_Editor Allows the user to create, view, edit, de- Manage Ideas, Needs
Settings_Editor Allows the user to configure the details Settings for Product Innovation
Management
for Product Innovation Management.
Inm_Administrator Allows the user to manage data secur- Data Security - Product Innovation
Management
ity for Product Innovation Management.
To let your users perform extra functions in Product Innovation Management, the following role templates are
required:
StatusManagementAdmin Allows the user to create, view, edit and Manage Statuses
delete status profiles and status.
WorkflowAdmin Allows the user to send reminder emails Build Process Automation
to experts.
WorkflowInitiator Allow the user to send notification email Build Process Automation
to submitters and experts.
To help you get started with Product Innovation Management, create the following role collections.
EPD-Product- EPD-Require-
EPD-Product- Manager-Ex- EPD-Adminis- EPD-Idea-Con- ments-Engi-
Role Template Manager tended trator tributor EPD-Evaluator neer
Idea_Viewer x
Idea_Editor x
Campaign_Vie x
wer
Administration Guide
User Management PUBLIC 89
Role Collection
EPD-Product- EPD-Require-
EPD-Product- Manager-Ex- EPD-Adminis- EPD-Idea-Con- ments-Engi-
Role Template Manager tended trator tributor EPD-Evaluator neer
Campaign_Edi x x
tor
Idea_Produce x x
r
Evaluation_E x
ditor
Need_Editor x x x
Settings_Edi x
tor
Inm_Administ x
rator
Team_Viewer x x
SDM_User x x x
StatusManage x x x
mentAdmin
StatusManage x x x
mentUser
WorkflowAdmi x x
n
WorkflowInit x x
iator
The Specification Management SaaS application uses role templates that are driven by business object
models, usually working with a display and maintainer template.
Note
The role template name generally contains Configurator for configuration data, Editor for master data
maintenance, and Viewer for display-only authorization.
Administration Guide
90 PUBLIC User Management
The following role templates are provided:
Administration Guide
User Management PUBLIC 91
Name Description Tiles on SAP Fiori Launchpad
PropertyConfigurationViewer Allows the user to view property defini- • Value Qualifiers for Compositions
tions. Also allows the user to view ap- • Value Qualifier Groups for
plicable values that refine composition Compositions
item data.
• Qualitative Statements for
Compositions
• Qualitative Statement Groups for
Compositions
tion contexts.
Administration Guide
92 PUBLIC User Management
The following table shows you which of the default role collections contain the above mentioned role templates:
EPD-Re-
EPD- EPD- EPD-Sys- quire- EPD- EPD-Ad- EPD-Idea- EPD-De- EPD-Serv-
Role Tem- Quality- Quality- tems-En- ments- Product- ministra- Contribu- sign-Engi- ice-Engi-
plate Manager Engineer gineer Engineer Manager tor tor neer neer
Specific X
ationBas
icConfig
urator
Specific
ationBas
icConfig
urationV
iewer
ProductC X
ategoryC
onfigura
tor
ProductC
ategoryV
iewer
Specific X
ationEdi
tor
Specific X
ationIns
tanceAcc
ess
Specific
ationVie
wer
Specific X
ationSta
tusCoord
inator
Administration Guide
User Management PUBLIC 93
Role Collection
EPD-Re-
EPD- EPD- EPD-Sys- quire- EPD- EPD-Ad- EPD-Idea- EPD-De- EPD-Serv-
Role Tem- Quality- Quality- tems-En- ments- Product- ministra- Contribu- sign-Engi- ice-Engi-
plate Manager Engineer gineer Engineer Manager tor tor neer neer
Specific X
ationSta
tusCoord
inatorIn
stanceAc
cess
PhraseEd X
itor
PhraseVi X
ewer
PhraseSt X
atusCoor
dinator
PhraseCo X
llection
Editor
PhraseCo X
llection
Viewer
Property X
Configur
ator
Property
Configur
ationVie
wer
Property X
TreeConf
igurator
Property
TreeConf
iguratio
nViewer
Administration Guide
94 PUBLIC User Management
Role Collection
EPD-Re-
EPD- EPD- EPD-Sys- quire- EPD- EPD-Ad- EPD-Idea- EPD-De- EPD-Serv-
Role Tem- Quality- Quality- tems-En- ments- Product- ministra- Contribu- sign-Engi- ice-Engi-
plate Manager Engineer gineer Engineer Manager tor tor neer neer
Composit X
ionItemT
ypeConfi
gurator
Composit
ionItemT
ypeConfi
guration
Viewer
Composit X
ionItemC
onfigura
tor
Composit
ionItemV
iewer
Composit X
ionItemG
roupConf
igurator
Composit
ionItemG
roupView
er
Authoriza- X
tionCon-
textEditor
Authoriza-
tionCon-
textViewer
Specification Management uses the Unit of Measure, Status Management, and Document external services,
and a respective role template is needed for these as well.
• Team_Viewer (EPD common): This is necessary for available values of user groups when using the
Authorization Context app.
• UoM_Data_Access_User: This is necessary for loading unit of measure values from a central repository.
• SDM_User: This is necessary to be able to see the Documentation tab in specifications.
Administration Guide
User Management PUBLIC 95
Note
Specification Management and Collaboration share the SDM_User role template. If you’ve subscribed
to both the Specification Management and the Collaboration SaaS applications, and assign a user to
a role collection from either SaaS application containing the SDM_User role template, then features
related to the SDM_User role template are enabled for both SaaS applications.
Here is an example of what can happen in this situation: You only want your Specification Management
users to have read-only access to a specification that in this example is called SPEC_XYZ. However,
because these users also need access to features from the Collaboration SaaS application, they are all
assigned to a role that is based on the SDM_User role template. In this case, because the users have
the authorizations granted by the SDM_User role template, they will have more than read-only access
to SPEC_XYZ. They will also be able to attach documents to SPEC_XYZ.
• StatusManagementUser: This is necessary for the administrator to use the Specification Type and
Manage Specifications apps, when creating specifications and changing status.
The above mentioned authorizations can be individually added to custom created roles, or you can use the
following example role collections provided by SAP Product Lifecycle Management:
Role Quality- Quality- tems-En- ments- Product- ministra- Contrib- sign-En- Service- duction-
Template Manager Engineer gineer Engineer Manager tor utor gineer Engineer Engineer
Team_Ed X
itor
N
ote
It in-
clud
es
the
Team
_Vie
wer
role.
Administration Guide
96 PUBLIC User Management
Role Collection
Role Quality- Quality- tems-En- ments- Product- ministra- Contrib- sign-En- Service- duction-
Template Manager Engineer gineer Engineer Manager tor utor gineer Engineer Engineer
UoM_Con X
figurat
ion_Exp
ert
N
ote
It in-
clud
es
the
UoM_
Data
_Acc
ess_
User
role.
SDM_Use X
r
SDM_Adm X
in
StatusM X X
anageme
ntAdmin
N
ote
It in-
clud
es
the
Stat
usMa
nage
ment
User
role.
Administration Guide
User Management PUBLIC 97
You as an administrator may decide that you need custom role collections for the use of your company. For
example, you can define a phrase maintainer, as described in the following section of the user guide: Personas
and User Actions.
The Visualization cloud service for SAP Product Lifecycle Management provides the following role templates:
tent.
(read/create/update/delete) viewer
templates.
ers.
figuration.
Administration Guide
98 PUBLIC User Management
Name Description Tiles on SAP Fiori Launchpad
The following table shows you which of the default role collections contain the above role templates:
EPD-
EPD- Re-
Qual- quire-
ity- EPD-Qual- EPD-Sys- ments EPD-Prod- EPD-Ad- EPD-Idea- EPD-De- EPD-Serv-
Man- ity-Engi- tems-En- -Engi- uct-Man- ministra- Contribu- sign-Engi- ice-Engi-
Role Template ager neer gineer neer ager tor tor neer neer
Configurati X
onManager
ContentCrea X X X X X X X X
tor
ContentDele X X X X X X X X
ter
ContentRead X X X X X X X X X
er
ContentUpda X X X X X X X X
ter
DataSourceA X
dmin
ProjectCrea X
tor
SecurityAdm X
inistrator
ViewerTempl X
ateAdmin
Administration Guide
User Management PUBLIC 99
5.2.12 Role Templates for Manage Statuses
The Manage Statuses app is a part of the Collaboration SaaS application that can be used to create status
profiles across other SaaS applications for SAP Product Lifecycle Management.
The Collaboration SaaS application provides you with the following role templates:
The Product Data Integration of SAP Product Lifecycle Management provides the following role templates:
Design_Viewer Is able to view design items Not applicable (only relevant for the
Product Data Integration APIs)
Design_Editor Is able to edit design items Not applicable (only relevant for the
Product Data Integration APIs)
Product Data Integration integrates with Enterprise Product Structure to derive product structures from
design item structures and to use the 3D visualization of product structures. The following role templates
are consumed for these functionalities:
Structure_Editor Required to derive a product structure Not applicable (only relevant for the
from a Product Data Integration design Product Data Integration APIs)
item structure. See Role Templates
for Enterprise Product Structure [page
70]. The role becomes available in
the subaccount after the Enterprise
Administration Guide
100 PUBLIC User Management
Role Description Tiles on SAP Fiori Launchpad
ContentCreator Required to create the 3D visualization Not applicable (only relevant for the
of a product structure that has Product Data Integration APIs)
been derived from a Product Data
Integration design item structure. See
Role Templates for Visualization [page
98]. The role becomes available in
the subaccount after the Visualization
SaaS application has been subscribed.
ContentUpdater Required to update the 3D visualization Not applicable (only relevant for the
of a product structure that has Product Data Integration APIs)
been derived from a Product Data
Integration design item structure. See
Role Templates for Visualization [page
98]. The role becomes available in
the subaccount after the Visualization
SaaS application has been subscribed.
The role templates above are included in the following default role collections:
EPD EPD
EPD EPD EPD Requirem EPD EPD EPD EPD EPD Productio
Quality Quality Systems ents Product Administr Feedback Design Service n
Manager Engineer Engineer Engineer Manager ator Provider Engineer Engineer Engineer
Design_A X
dministr
ator
Design_E X
ditor
Design_V X X X X X X X X
iewer
Structur X X X X
e_Editor
Content X X X X X X X X X
Creator
Content X X X X X X X X X
Updater
Administration Guide
User Management PUBLIC 101
6 Connectivity
Provides you with information about the various connectivity configurations required to work with the SAP
Product Lifecycle Management services and features.
You configure destinations in the SAP Business Technology Platform cockpit to connect SaaS applications of
SAP Product Lifecycle Management to different systems.
Context
Use this procedure to find, add, or edit destinations mentioned in the subsequent topics.
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. Search for the destination name mentioned in a topic.
Remember
Destination titles should be prefixed with EPD_ for the apps to function.
• If the destination does not exist, choose New Destination, and under Destination Configuration, enter
the destination details as mentioned in the topic.
Administration Guide
102 PUBLIC Connectivity
• If the destination exists, ensure that the configuration is as mentioned in the topic.
4. Save your changes.
If the source system for data that you use in SAP Product Lifecycle Management is an on-premise system, you
must install and configure the Cloud Connector.
Context
You only need to install a Cloud Connector once for each network that you want to expose to the cloud.
One Cloud Connector can connect to as many target systems as required, and can also connect to multiple
SAP BTP accounts. Usually you only need to create multiple cloud connectors if you want to share different
networks with SAP BTP or to separate them for load or performance reasons.
Procedure
Note
If you require support or encounter any technical issues while configuring the Cloud Connector,
contact SAP by reporting an incident under the component BC-MID-SCC.
Next Steps
Set up the destination for the source system as described in the corresponding Connectivity document for
your SaaS applications.
Administration Guide
Connectivity PUBLIC 103
Note
If your Cloud Connector configuration uses a location other than the default one, make note of the location
ID. You will need that later when setting up your destination.
Configure this destination to connect to the Object Store service on SAP BTP, if needed.
Data that is imported into SAP Product Lifecycle Management is usually stored using the SAP Document
Management service. The SAP Document Management service is embedded within SAP Product Lifecycle
Management, so there is no need for you to create an additional destination. However, for some SaaS
applications, the features of the SAP Document Management service may not be sufficient. In those cases,
a connection to the Object Store service is needed, and you must configure a destination following the
instructions in this document. You only have to configure the destination once. Once you have the connection,
you can store imported data from any of the impacted SaaS applications. Those SaaS applications include the
following:
Collaboration The destination is optional. You can For a comparison of the default
continue to use the default storage and custom storage features for
on the SAP Document Management Collaboration and recommendations
service. However in some cases, it is when to use the Object Store service,
better to use the custom storage possi- see Compare Document Storage Types
bilities on the Object Store service. for Collaborations [page 207].
For more information about the Object Store service, see What Is Object Store?
Prerequisites
You have added the Object Store service to your subaccount. For more information, see Configure Entitlements
and Quotas for Subaccounts.
Note
Ensure you have enabled the feature for maintaining multiple versions of the object on Azure landscape. For
more information, see Object Versioning.
Ensure you have enabled the feature for preventing accidental deletion of objects in your service instance
resources. Make the settings that are described here:
Administration Guide
104 PUBLIC Connectivity
• Prevent Accidental Deletion of AWS S3 Buckets
You have created a service key for the service instance for the Object Store service. For more information, see
What Is Object Store?.
The values that are generated from the service key are needed, to create the destination. To access these
values, you can follow the below steps:
1. In your web browser, log on to the SAP BTP cockpit, choose the relevant subaccount.
2. In the left panel under Services, choose Instances and Subscriptions.
3. Select the instance, in the Credentials column, choose the service key that is created.
4. In the dialog, under JSON tab, you can see the values for the service instance.
Destination Configuration
For the steps to create the destination, see How to Configure Destinations [page 102].
Property Value
Name EPD_CUSTOM_STORAGE
Type HTTP
URL • Enter the URL that you have noted in the container uri field
from the service instance for azure-standard plan.
• Enter the URL mentioned that you have noted in the uri field
for s3-standard plan.
Authentication NoAuthentication
Under the Additional Properties panel, the following properties must be maintained.
To create a property, choose New Property. In the dropdown field, enter the property name as mentioned in the
following table, and then specify the value.
Property Description
plan azure-standard
Administration Guide
Connectivity PUBLIC 105
Property Description
region The region in which the storage account and container are created.
Note
Property Description
plan s3-standard
uri
Caution
You need to replace S3:// with https://
Note
SAP Product Lifecycle Management can be integrated with SAP S/4HANA Cloud using PLM system
integration. The technical component PLMSI also offers an integration layer between SAP Product Lifecycle
Management and SAP S/4HANA or SAP ERP.
The integration using PLM system integration is currently available for the following SaaS applications:
• Configuration Management
• Enterprise Product Structure
Administration Guide
106 PUBLIC Connectivity
• Intelligent Handover
• Specification Management
This chapter covers how to configure the destinations needed to transfer data:
To retrieve data from an SAP ERP system using PLM system integration, you need to add a destination.
Context
It is mandatory that you use the technical component PLMSI if you need to integrate data from your SAP ERP
system into the following SaaS applications for SAP Product Lifecycle Management:
• Configuration Management
• Enterprise Product Structure
• Intelligent Handover
• Specification Management
Note
To use the PLMSI technical component, the SAP ERP system to be connected must have at least
Enhancement Package 8.
Set up one destination per source system. After you set up a destination to connect an SAP ERP system using
the PLMSI technical component, that SAP ERP system can use the same destination for exchanging data for
any SaaS application that is connected via the PLMSI technical component.
Prerequisites
• You have installed the PLMSI technical component as explained here: About Integrating SAP Product
Lifecycle Management with SAP S/4HANA or SAP ERP.
• You have installed and configured the Cloud Connector as explained here: Using the Cloud Connector to
Connect to On-Premise Systems [page 103].
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
Administration Guide
Connectivity PUBLIC 107
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Property Description
Name <MySystem>
Type HTTP
URL Enter the source system URL as mentioned in the section Finding Source System URL [page
249].
Authentication PrincipalPropagation
We recommend that you create the destination with principal propagation authentication.
For PrincipalPropagation, the user needs to have the same authorizations that are delivered in
the SAP_PLME_INTEG_USER role template. Enter the credentials of a user who has Read access
to the service in the source system.
If you use principal propagation, each Cloud user also needs a user for the integrated SAP ERP
system with the same email address maintained. Users are able to synchronize all content that
they have access to in the SAP ERP system.
Note
After system synchronization, the synchronized content can be used by all users in the SAP
Product Lifecycle Management system.
BasicAuthentication
For BasicAuthentication, the user needs to have the same authorizations that are delivered in the
SAP_PLME_INTEG_USER role template. Enter the credentials of a user who has Read access to
the service in the source system.
Basic authentication allows Cloud users to perform synchronization without having a user for
the integrated SAP ERP system assigned. In this case, users can synchronize any content that
they can access via their technical user assignment. (Technical user with client certificate is
supported, see also User Authentication and Authorization.
Administration Guide
108 PUBLIC Connectivity
Property Description
For BasicAuthentication:
• Add a property with key: sap-client and value: <client number>.
• Add a property with key: sap.epd.purpose and value: synchronization.
• Add a property with key: sap.epd.displayname and value: <must contain your
system's display name>.
To retrieve data from an SAP S/4HANA system using PLM system integration, you need to add a destination.
Context
It is mandatory that you use the technical component PLMSI if you need to integrate data from your SAP
S/4HANA system into the following SaaS applications for SAP Product Lifecycle Management:
• Configuration Management
• Enterprise Product Structure
• Intelligent Handover
• Specification Management
Note
To use the PLMSI technical component, the SAP S/4HANA system to be connected must have at least
release 2021 FPS000.
Set up one destination per source system. After you set up a destination to connect an SAP S/4HANA
system using the PLMSI technical component, that SAP S/4HANA system can use the same destination for
exchanging data for any SaaS application that is connected via the PLMSI technical component.
Prerequisites
• You have installed the PLMSI technical component as explained here: About Integrating SAP Product
Lifecycle Management with SAP S/4HANA or SAP ERP.
• You have installed and configured the Cloud Connector as explained here: Using the Cloud Connector to
Connect to On-Premise Systems [page 103].
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
Administration Guide
Connectivity PUBLIC 109
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Property Description
Name <MySystem>
Type HTTP
URL Enter the source system URL as mentioned in the section Finding Source System URL [page
249].
Authentication PrincipalPropagation
We recommend that you create the destination with principal propagation authentication.
For PrincipalPropagation, the user needs to have the same authorizations that are delivered in
the SAP_PLME_INTEG_USER role template. Enter the credentials of a user who has Read access
to the service in the source system.
If you use principal propagation, each Cloud user also needs a user for the integrated SAP
S/4HANA system with the same email address maintained. Users are able to synchronize all
content that they have access to in the SAP S/4HANA system.
Note
After system synchronization, the synchronized content can be used by all users in the SAP
Product Lifecycle Management system.
BasicAuthentication
For BasicAuthentication, the user needs to have the same authorizations that are delivered in the
SAP_PLME_INTEG_USER role template. Enter the credentials of a user who has Read access to
the service in the source system.
Basic authentication allows Cloud users to perform synchronization without having a user for
the integrated SAP S/4HANA system assigned. In this case, users can synchronize any content
that they can access via their technical user assignment. (Technical user with client certificate is
supported, see also User Authentication and Authorization.
Administration Guide
110 PUBLIC Connectivity
Property Description
For BasicAuthentication:
• Add a property with key: sap-client and value: <client number>.
• Add a property with key: sap.epd.purpose and value: synchronization.
• Add a property with key: sap.epd.displayname and value: <must contain your
system's display name>.
To retrieve data from SAP S/4HANA Cloud using PLM system integration, you need to add a destination.
Context
It is mandatory that you use PLM system integration if you need to integrate data from your SAP S/4HANA
Cloud system into the following SaaS applications for SAP Product Lifecycle Management:
• Configuration Management
• Enterprise Product Structure
• Intelligent Handover
• Specification Management
Note
Set up one destination per source system. If you have already set up a destination for connecting SAP
S/4HANA Cloud, the system uses this destination for all SaaS applications that connect to SAP S/4HANA
Cloud via this connection method.
Prerequisites
• You have activated scope item 6u3 in your SAP S/4HANA Cloud system. Instructions for setting up
scope items is available here: SAP Best Practice Explorer .
• Your SAP S/4HANA Cloud user has been assigned a business role that contains the
Communication Management (SAP_CORE_BC_COM) business catalog, for example, the Administrator
(SAP_BR_ADMINISTRATOR) business role.
• You have set up a communication arrangement in your SAP S/4HANA Cloud system. For integration
with SAP Product Lifecycle Management, activate the Product Lifecycle Management - EPD Integration
(SAP_COM_0937) communication scenario. For more information, see Technical Integration with SAP
Enterprise Product Development in the documentation for SAP S/4HANA Cloud.
• To create the destination as described in the following steps, you need the API URL of the communication
arrangement. You can find the URL in the Common Data section, Inbound Services, of the Communication
Arrangement UI. (For more information, see How to Create Communication Arrangement).
Administration Guide
Connectivity PUBLIC 111
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Property Description
Name Enter a name for the destination, for example, SAP S/4HANA Cloud system.
Type HTTP/HTTPS
URL Enter the API URL for the communication arrangement as mentioned in the Prerequisites
section.
Note
After system synchronization, the synchronized content can be used by all users in the SAP
Product Lifecycle Management system.
Basic authentication (not recommended due to compatibility issues) via user and password
allows Cloud users to perform synchronization without having a user for the integrated SAP
S/4HANA Cloud system assigned. In this case, users can synchronize any content that they can
access via their technical user assignment. (Technical user with client certificate is supported,
see also User Authentication and Authorization.
Note
If you want to switch between different authentication methods, you need to create one user
per authentication method.
For authentication via client certificate, you need to provide the .pfx file that contains the public
key and the private key of the client certificate, as well as the password that protects the private
key.
Administration Guide
112 PUBLIC Connectivity
6.5 Configuring Connectivity for Collaboration
Collaboration uses SAP Connectivity service to connect to Java and ABAP on-premise systems. To make the
connection, you create and configure destinations per relevant protocol type.
Administration Guide
Connectivity PUBLIC 113
6.5.1 Destination for Identity Authentication
This destination is used to connect to Identity Authentication to allow invited collaboration participants to
register with the application.
Recommendation
Configure this destination to allow first-time users to receive email notifications when invited to
collaborations.
Prerequisites
Before creating a destination for Identity Authentication, create a technical user in the Identity Authentication
administration console by performing the following steps:
Note
https://<Subdomain>.accounts.ondemand.com/admin
To find your <Subdomain>, log on to the cloud cockpit and navigate to your subaccount. The
subdomain is displayed in the subaccount details.
Note
Remember
The client credentials are used by the destination to retrieve the first name, last name, and email
address of users who are added as participants to collaborations. For more information, see Configure
Secrets for API Authentication
Destination Configuration
For the steps to create the destination, see How to Configure Destinations [page 102].
Administration Guide
114 PUBLIC Connectivity
Field Value
Name EPD_Identity_Provider
Type HTTP
URL https://<tenantId>.accounts.ondemand.com
Authentication BasicAuthentication
Note
For the credentials, enter the client ID and secret noted
in the Prerequisites [page 114] section.
1. Under the Additional Properties panel, the properties listed in the table below must be maintained.
2. To create a property, choose New Property. In the dropdown field, enter the property name as mentioned in
the following table, and then specify the value:
Administration Guide
Connectivity PUBLIC 115
6.5.2 Destination for Email Notifications Using SMTP APIs
Configure this destination using SMTP API for sending email notifications from a common mailbox or when the
following occurs:
Prerequisites
• You have the details for configuring SMTP email for your scenario.
• Your mail server has the following characteristics:
• It supports the SMTP STARTTLS command on ports 587 or 465
• It requires authentication.
Destination Configuration
To send email notifications for tasks within a workflow, you must configure a destination. For the basic steps for
completing this task, see Configure the Workflow Capability Mail Destination.
Under the Additional Properties panel, the following properties must be maintained.
To create a property, choose New Property. In the dropdown field, enter the property name as mentioned in the
following table, and then specify the value.
Property Value
mail.epdc.participant.invit true
e
mail.epdc.task.assignee.not true
ification
Note
This value is used for sending mail notifications to your business users who
are added as new assignees to the existing work items in collaborations.
Administration Guide
116 PUBLIC Connectivity
6.5.3 Destination for Email Notifications Using Microsoft
Graph
Learn how to enable the connection between SAP Product Lifecycle Management and Microsoft Cloud service
resources using Microsoft Graph. With this connection, participants in a collaboration can use Microsoft
Outlook to send emails from within a collaboration.
Prerequisites
• You have registered a new application in the Microsoft Azure Active Directory.
• The values that are generated from the registration are needed to create a destination. The relevant client
secret information is available in the Microsoft Azure Active Directory.
• You have added the necessary permissions for the Microsoft Graph API in the Microsoft Azure Active
Directory to use the service.
For more information on the Microsoft Azure Active Directory steps, see Microsoft documentation .
Context
If you want your business users to send email notifications from their Microsoft Outlook mailbox for custom
workflows, you have two alternatives for configuring the destination. We recommend that you configure the
destination for sending your email notifications using the SMTP API. This destination has the type Mail. For
more information on how to configure that destination, see Destination for Email Notifications Using SMTP
APIs [page 116].
The other alternative is to follow the steps in the section below to create a destinationn with the type HTTP.
For an overview of the steps for configuring destinations, see How to Configure Destinations [page 102].
To create the destination at the subaccount level, enter the destination details as shown in the table:
Field Value
Name MS_GRAPH_MAIL
Type HTTP
URL https://graph.microsoft.com
Administration Guide
Connectivity PUBLIC 117
Field Value
Authentication OAuth2ClientCredentials
Client ID Enter the application (Client) ID that you have noted in the
Microsoft Azure for the client secret.
Client Secret Enter the value that you have noted in the Value column of
the client secret.
Under the Additional Properties panel, the following properties must be maintained.
Choose New Property to create a new property. In the fields that are displayed, enter the following values:
Property Value
graphApiUrl Enter the endpoint URL for the Microsoft Graph API.
scope https://graph.microsoft.com/.default
tokenService.body.grant_type client_credentials
tokenServiceURL.headersContent-Type application/x-www-form-urlencoded
This destination is used to configure the connection between SAP Product Lifecycle Management and
Microsoft Cloud service resources using Microsoft Teams. With this connection, you can create a team
using the Microsoft Teams app, add members, and synchronize the information as a collaboration to the My
Collaborations app.
Prerequisites
• You have registered for the Collaboration application in the Microsoft Azure Active Directory.
Administration Guide
118 PUBLIC Connectivity
The values that are generated from the registration are needed to create a destination. The relevant client
secret information is available in the Microsoft Azure Active Directory.
• You have added the necessary permissions for the Microsoft Graph APIs in the Microsoft Azure Active
Directory.
For more information about the Microsoft Azure Active Directory steps, see the Microsoft documentation .
Context
You configure this destination if you want your business users to use the Microsoft Teams app.
Destination Configuration
For an overview of the steps for configuring destinations, see the How to Configure Destinations [page 102].
To create the destination at the subaccount level, enter the destination details as shown in the table:
Field Value
Name EPD_TEAMS<tenantId>
Type HTTP
URL https://graph.microsoft.com
Authentication OAuth2ClientCredentials
Client ID Enter the application (Client) ID that you have noted in the
Microsoft Azure for the client secret.
Client Secret Enter the value that you have noted in the Value column of
the client secret.
Under the Additional Properties panel, the following properties must be maintained.
Administration Guide
Connectivity PUBLIC 119
Choose New Property to create a new property. In the fields that are displayed, enter the following values:
Property Value
scope htts://graph.microsoft.com/.default
tenantId You can find your tenant ID details in the Microsoft Azure
Active Directory.
Field Value
Name EPD_TEAMS_CERTIFICATE
Type HTTP
URL https://graph.microsoft.com
Authentication ClientCertificateAuthentication
Update and Delete Certificates Choose Upload Certificate, browse to the certificate you
need to upload.
Key Store Password Enter the password that you have created when generating
the p12 file.
The p12 file contains certificate chain and private key that are used to decrypt information or notification.
Prerequisites
• You have the X.509 client certificate and private key (.pem).
• You have uploaded the certificate (.pem) in the Microsoft Azure Active Directory.
Administration Guide
120 PUBLIC Connectivity
Procedure
1. To generate p12 and the key store password using the certificate and the private key (.pem).
2. Run the following command format given:
For example: Openssl pkcs12 -export -in <certificate.pem> -inkey <key.pem> -out <certificate.p12> -name
<certificateAliasName>
3. Enter a new key store password.
You need this value to configure the destination.
Under the Additional Properties panel, the following properties must be maintained.
Choose New Property to create a new property. In the fields that are displayed, enter the following values:
Property Value
alias Enter the name that you have noted down when generat-
ing the .p12 file as explained in the procedure for How to
Generate p12 file from PEM?.
encryptionCertificateId Enter the certificate ID that you have noted after you have
uploaded the certificate (.pem) in the Microsoft Azure Active
Directory.
This destination is used to configure connectivity from SAP Business Technology Platform to the product
environment of SAP Ariba APIs.
Note
If you are using SAP Ariba Supplier Lifecycle and Performance and intend to onboard suppliers as
participants in collaborations, this destination configuration is mandatory.
Prerequisites
Before configuring the destination, perform the activities mentioned in Configure Supplier Data [page 210].
Destination Configuration
The following destination is used to configure connectivity to an API published on the production environment
of SAP Ariba APIs.
For an overview of how to create destinations, see How to Configure Destinations [page 102].
Administration Guide
Connectivity PUBLIC 121
Field Value
Name EPD_Ariba
Type HTTP
URL https://openapi.ariba.com/api
Authentication OAuth2ClientCredentials
Client ID Enter the client ID that you noted while configuring the con-
nectivity SAP Business Technology Platform to SAP Ariba,
see Configure Supplier Data [page 210].
Client Secret Enter the client secret that you noted in SAP Business
Technology Platform to SAP Ariba, see Configure Supplier
Data [page 210].
Under the Additional Properties panel, the properties listed in the table below must be maintained.
To create a property, choose New Property. In the dropdown field, enter the property name as mentioned in the
following table, and then specify the value.
saml2idp Enter the value that you noted in the This value is used to allow your busi-
Original Key column of the Ariba Iden- ness users to fetch the supplier data di-
tity Provider. You can find these de- rectly from the Ariba Sourcing project.
tails in the SAP BTP cockpit in the
For more detailed explanation about
Security Trust Configuration ta- how to establish the connection be-
ble. tween Ariba Network and collabora-
tions, see Configuring Single Sign-On
Between Ariba Network and Collabora-
tions.
Administration Guide
122 PUBLIC Connectivity
6.5.6 Destination for Collaborating on Specifications
To retrieve specification data from any of your source systems, you need to add a destination for your source
system.
Prerequisites
If the Cloud Connector for SAP BTP, Cloud Foundry Environment, is not already installed and configured
for connecting cloud applications to your SAP S/4HANA system, complete the necessary steps. For more
information, seeUsing the Cloud Connector to Connect to On-Premise Systems.
If your source system is an on-premise system, add a destination for the Cloud Connector.
Note
The specification exchange scenario works with APIs that are available in the following SAP S/4HANA
On-Premise releases: 2020 or later, 1909, and 1809. The scenario can also work with the Enhancement
Package 8 of SAP ERP.
Here is the workflow for setting up the cloud connector using principal propagation:
Note
If you require support or encounter any technical issues while configuring the Cloud Connector, contact
SAP by reporting an incident on the Support Portal under the component BC-MID-SCC.
Configure HTTP destinations to connect to an SAP S/4HANA system through HTTP(s) as mentioned below.
For the source system that you want to retrieve product data from, you must create a destination as mentioned
in the following table. It is left to your discretion to select the authentication type of the destination.
Administration Guide
Connectivity PUBLIC 123
Recommendation
We recommend that you create the destination with principal propagation authentication.
AdditionalProper-
Name Type URL Proxy Type Authentication ties
For more information about implementing the Classification API, see SAP Note 3145055 .
To retrieve specification data, you have to also configure the APIs that are related to specifications in your
source system. For more information, see Specification APIs for Recipe Development.
Administration Guide
124 PUBLIC Connectivity
6.5.7 Destination for Updating Workflow Permissions
This destination is used to update the workflow permission for collaboration users.
Prerequisites
You have created a service key for the service instance for the Collaboration service as mentioned in
Configuration for Using APIs [page 455].
The values that are generated from the service key are needed, to create the destination. To access these
values, you can follow the below steps:
1. In your web browser, log on to the SAP BTP cockpit, choose the relevant subaccount.
2. In the left panel under Services, choose Instances and Subscriptions.
3. Under Instances tab, select the application. Choose (Actions) .
For more information, see Creating a Service Instance and Service Key
4. In the endpoints section, note the value of the Collaboration service URL in the url parameter.
5. In the uaa section, note the values of clientid, clientsecret, and url.
CLIENT ID CLIENT ID
Destination Configuration
For the steps to create the destination, see How to Configure Destinations [page 102].
Property Value
Name EPD_Collaboration
Type HTTP
URL Enter the endpoints URL that you noted in the prerequisites.
Administration Guide
Connectivity PUBLIC 125
Property Value
Authentication OAuth2ClientCredentials
Client Secret Enter the client secret that you noted in the prerequisites.
Token Service URL Enter the URL that you noted in the prerequisites and ap-
pend suffix /oauth/token.
Under the Additional Properties panel, the following properties must be maintained.
To create a property, choose New Property. In the dropdown field, enter the property name as mentioned in the
following table, and then specify the value.
Property Value
Destination Configuration
For the steps to create the destination, see Configuring Connectivity for Common Functions [page 132] .
This destination is required for the integration of Collaboration with Engineering and must be manually
configured in your subaccount.
Administration Guide
126 PUBLIC Connectivity
Prerequisites
You have created a service key for the service instance for the SAP EA Designer service as shown in
Configuration for Using APIs [page 455].
From the service key details, note the following values to use when creating the destination:
• ead-designer-backend url
• client id
• client secret
• uaa url(Authentication url)
Destination Configuration
For information about how to create the destination, see How to Configure Destinations [page 102].
Property Value
Name EPD_EAD_COLLABORATION
Type HTTP
URL Enter the ead-designer backend url that you noted in the
prerequisites.
Authentication OAuth2JWTBearer
Client Secret Enter the client secret that you noted in the prerequisites.
Token Service URL Enter the uaa URL that you noted in the prerequisites and
append /oauth/token.
Administration Guide
Connectivity PUBLIC 127
6.5.10 Destination for SAP Document Center, desktop client
Configure this destination, if SAP Document Management service, desktop client is used to connect with the
collaboration users. It must be manually configured in your subaccount.
Prerequisites
You have created a service key for the service instance for the Collaboration service as mentioned in
Configuration for Using APIs [page 455].
The values that are generated from service key are needed to create a destination. To access these values, you
can follow the steps below:
1. In your web browser, log on to the SAP BTP cockpit, choose the relevant subaccount.
2. In the left panel, under Services, choose Instances and Subscriptions.
3. Under Instances tab, select the application. Choose (Actions) .
For more information, see Creating a Service Instance and Service Key.
4. In the endpoints section, note the value of the Collaboration service URL to enter in the url parameter.
5. In the uaa section, note the values of clientid, clientsecret, and url parameter:
CLIENT ID CLIENT ID
Token Service URL TOKEN SERVICE URL AND APPEND suffix /oauth/token
Destination Configuration
For the steps to create the destination, see How to Configure Destinations [page 102].
Property Value
Name SDM_Instance_Client
Type HTTP
URL Enter the value of the service URL that you have noted in the
endpoints URL of the service instance.
Administration Guide
128 PUBLIC Connectivity
Property Value
Authentication OAuth2ClientCredentials
Client Secret Enter the client secret that you noted in the prerequisites.
Token Service URL Enter the uaa URL that you noted in the prerequisites and
append suffix /oauth/token.
Configure this destination to add the Object Store service on SAP BTP. This service enables your business
users to work with custom file storage in a collaboration.
Prerequisites
You have added the Object Store service to your subaccount. For more information, see Configure Entitlements
and Quotas for Subaccounts.
Note
Ensure you have enabled the feature for maintaining multiple versions of the object on Azure landscape. For
more information, see Object Versioning.
Ensure you have enabled the feature for preventing accidental deletion of objects in your service instance
resources. Make the settings that are described here:
You have created a service key for the service instance for the Object Store service. For more information, see
What Is Object Store?.
The values that are generated from the service key are needed, to create the destination. To access these
values, you can follow the below steps:
1. In your web browser, log on to the SAP BTP cockpit, choose the relevant subaccount.
2. In the left panel under Services, choose Instances and Subscriptions.
3. Select the instance, in the Credentials column, choose the service key that is created.
4. In the dialog, under JSON tab, you can see the values for the service instance.
Administration Guide
Connectivity PUBLIC 129
Destination Configuration
For the steps to create the destination, see How to Configure Destinations [page 102].
Property Value
Name EPD_CUSTOM_STORAGE
Type HTTP
URL • Enter the URL that you have noted in the container uri field
from the service instance for azure-standard plan.
• Enter the URL mentioned that you have noted in the uri field
for s3-standard plan.
Authentication NoAuthentication
Under the Additional Properties panel, the following properties must be maintained.
To create a property, choose New Property. In the dropdown field, enter the property name as mentioned in the
following table, and then specify the value.
Property Description
plan azure-standard
region The region in which the storage account and container are created.
Note
Property Description
Administration Guide
130 PUBLIC Connectivity
Property Description
plan s3-standard
uri
Caution
You need to replace S3:// with https://
Note
This destination provides information about configuring process flows using process variants for collaboration.
It must be manually configured in your subaccount.
Destination Configuration
Related Information
Administration Guide
Connectivity PUBLIC 131
6.6 Configuring Connectivity for Common Functions
To use the Common Functions SaaS applications, you need a connection to the APIs of the SAP Authorization
and Trust Management service.
The Common Functions SaaS applications for SAP Product Lifecycle Management allows you to use default
role collections and the Manage Teams app. A connection to the APIs of the SAP Authorization and Trust
Management Service is needed. This destination is mandatory for using the Common Functions SaaS
applications and must be manually configured in your subaccount. For more information about the APIs, see
Accessing Administration Using APIs of the SAP Authorization and Trust Management Service.
Prerequisites
To create this destination, you need the API credentials of the SAP Authorization and Trust Management
service. The steps for getting this information are available here: Get Access to the APIs.
Destination Configuration
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Property Description
Type HTTP
URL Enter the API URL value from the API credentials.
Authentication OAuth2ClientCredentials
Client Secret Enter the Client Secret value from the API credentials.
Token Service URL Enter the Token URL from the API credentials.
Administration Guide
132 PUBLIC Connectivity
6.7 Configuring Connectivity for Configuration
Management
Describes the connectivity configuration for Configuration Management apps to allow data sources to retrieve
data from SAP ERP, SAP S/4HANA, and SAP S/4HANA Cloud.
PLMSI is required to integrate SAP S/4HANA with the Configuration Management SaaS application. For
detailed information on how to configure connectivity, see Connectivity Using PLM System Integration [page
106].
Note
In the prerequisite step of How to Create Communication Arrangement, ensure that you have created the
communication arrangement for the SAP_COM_0937 communication scenario.
Note
To enable the master data objects to work for the routing scenario, subscribe to the following public APIs that
are available in the following SAP S/4HANA On-Premise releases:
Administration Guide
Connectivity PUBLIC 133
Public APIs Available From Release
The necessary steps to set up the destination are available here: Destination for Connecting to SAP S/4HANA
Cloud [page 111].
Note
Ensure that you have created the communication arrangement for the following communication scenarios:
• SAP_COM_0104
• SAP_COM_0519
For more information, see the prerequisites in this document: How to Create Communication Arrangement.
For the above communication scenarios (SAP_COM_0104 and SAP_COM_0519), perform the following
procedure as described in How to Create Communication Arrangement:
To enable the master data objects to work for the routing scenario, the following public APIs are available for
the above communication scenarios:
• Production Routing
• Work Center
• Routing Version
You need to create a destination for your Content Server to retrieve document content from an on-premise
Content Server (KPro). An on-premise Content Server is set up outside SAP S/4HANA, SAP S/4HANA Cloud
or SAP ERP systems.
Note
If you use the Content Server within the source system, this topic is not relevant.
Administration Guide
134 PUBLIC Connectivity
Prerequisites
• You've set up a Cloud Connector for your on-premise Content Server to enable access to Enterprise
Product Structure to retrieve the document originals. For more information, see Using the Cloud
Connector to Connect to On-Premise Systems [page 103].
• You've configured the connectivity for Enterprise Product Structure apps to allow data sources to retrieve
data from the SAP ERP, SAP S/4HANA, or SAP S/4HANA Cloud systems. For more information, see
Configuring Connectivity for Enterprise Product Structure [page 144].
Configure HTTP destinations to connect to your content server through HTTPS as mentioned below. The
connection can be established by a technical user.
For the Content Server that you want to retrieve document content from, you must create destinations as
mentioned in the table below. Enterprise Product Structure supports multiple destinations, so it is left to your
discretion to choose a name for a destination.
There are three additional properties that need to be specified for the Enterprise Product Structure services to
recognize a destination properly:
• sap.epd.purpose: content
Recommendation
We recommend that you create the destination with technical user authentication.
Destination
Property Description
Name <MySystem>
Type HTTP
Authentication NoAuthentication
Administration Guide
Connectivity PUBLIC 135
Property Description
The Engineering cloud service for SAP Product Lifecycle Management allows you to use the following features:
You must connect the Test Management apps to other applications and services in order to enable the
complete functionalities of these apps.
Create the destinations mentioned in the subsequent topics for Test Management by using the following
procedure:
1. In the SAP Business Technology Platform cockpit, navigate to your subaccount page and choose
Connectivity Destinations to view the list of destinations.
2. Create a destination by choosing New Destination, entering the values, and then choosing Save.
For the Test Management feature, if you want to retrieve the list of quality engineer, and assign test cases to the
engineers in the Manage Test Executions app, you can configure a destination for the list. For more information,
see Configuring Connectivity for Common Functions [page 132].
[Test Management apps] To access the data of bills of materials (BOMs) from the Test Management apps,
configure integration with either SAP S/4HANA Cloud or SAP S/4HANA (on-premise).
Administration Guide
136 PUBLIC Connectivity
Connecting to SAP S/4HANA (On-Premise) [page 138]
Prerequisites
• To be able to access the BOM data in SAP S/4HANA Cloud, make sure the scope items 3LO and 3LP
are activated.
• Before creating the following destination, you must use the Communication Management apps from
SAP S/4HANA Cloud to make the required configuration, which enables the Test Management apps to
securely exchange data with SAP S/4HANA Cloud. See Communication Management for details about the
configuration, or reference the following process overview:
1. Log on to your SAP S/4HANA Cloud launchpad with the appropriate role. In the Maintain
Communication Users app, create a new user for the Test Management apps. Enter a user name,
description and password as appropriate. Keep the entered user name and password available for
use shortly - the values are required when creating the destination in SAP Business Technology
Platform cockpit.
2. In the Communication Systems app, create a new communication system for the Test Management
apps. Enter a system ID (for example, ), system name and host name (as host name is not required in
this scenario, just enter the system ID again in the Host Name field) for it as appropriate. Add the user
you just created to the communication system in the Users for Inbound Communication table.
3. In the Communication Arrangements app, create a new communication arrangement. Select Product
Lifecycle Management - Master Data Integration (SAP_COM_0105) as its communication
scenario. Enter the communication system and the user name you just created for the arrangement.
Destination
Property Description
Name EPD_S4HANA_Service
Type HTTP
URL
https://<s4-cloud-domain>.<domain>
Note
You can copy your SAP S/4HANA Cloud system URL from User Settings User Account
Server .
Administration Guide
Connectivity PUBLIC 137
Property Description
Authentication BasicAuthentication
User Enter the name and password of your communication user of SAP S/4HANA Cloud.
Password
Property Description
Name EPD_S4HANA_Application
Type HTTP
URL
https://<s4-cloud-domain>.<domain>/ui#
Note
You can click the Home button to enter to the home page, copy your SAP S/4HANA Cloud
system URL from https:// to #, and paste it in the field.
Authentication NoAuthentication
Prerequisites
Install and configure the SAP HANA Cloud Connector as a link between your SAP Business Technology
Platform subaccount for Test Management apps and the on-premise SAP S/4HANA system.
1. Install the SAP HANA Cloud Connector to the on-premise server for your SAP S/4HANA system. For more
information, see Installation in the SAP BTP Connectivity documentation.
2. Log on to the SAP HANA Cloud Connector from your Web browser and connect it to your SAP Business
Technology Platform subaccount.
For detailed information about the initial logon and configuration, see Initial Configuration in the SAP BTP
Connectivity documentation.
Enter parameters as follows and click Save:
Parameter Description
Administration Guide
138 PUBLIC Connectivity
Parameter Description
Note
This value can be found in the Subaccount Details panel on the subaccount Overview page in
the SAP BTP cockpit.
Display Name [optional] Enter the name to show for the subaccount in the Cloud Connector interface.
Location ID Specifies a short name to identify the Cloud Connector in the subaccount. This value will be used
when adding the Cloud Connector instance as a destination in your subaccount.
HTTPS Proxy [if required in your environment] Enter parameters for your proxy.
If your parameters are correct, the Cloud Connector will automatically connect to your subaccount.
3. Create a system mapping from the Cloud Connector to the SAP S/4HANA system:
1. In the Cloud Connector navigation area, click Cloud To On-Premise, click Add, and then complete the
Add System Mapping wizard pages as follows:
Parameter Description
Internal Host / Specify the actual host and port under which the SAP S/4HANA system can be reached within
Port the intranet. Click Next.
Virtual Host / Specify a name for the agent instance and keep the same port as for the internal port. These
Port values will be used adding the Cloud Connector instance as a destination in your subaccount.
Host in Request Keep the default value Use Virtual Host and click Next.
Header
Description Optionally enter a description for the mapping, click Next, check Check Internal Host
and then Finish.
For detailed information, see Configure Access Control (HTTP) in the SAP BTP Connectivity
documentation.
2. Click the Check Availability action to see if your parameters are correct.
3. Click the Add tool above the Resources Accessible table, enter parameters as follows, and then click
Save:
Parameter Description
Administration Guide
Connectivity PUBLIC 139
Parameter Description
Procedure
In your subaccount, create two destinations. For details about how to create a destination, see Configuring
Connectivity for Engineering [page 136].
Property Description
Name EPD_S4HANA_Service
Type HTTP
URL Enter the virtual host and port value you specified when creating a system mapping from the Cloud
Connector to the your on-premise system in the form:
http://<VirtualHost>:<Port>
Authentication BasicAuthentication
User Enter the name and password of your technical user in SAP S/4HANA.
Password
Property Description
Name EPD_S4HANA_Application
Type HTTP
Administration Guide
140 PUBLIC Connectivity
Property Description
https://<hostname>/sap/bc/ui5_ui5/ui2/ushell/shells/abap/
FioriLaunchpad.html<sap-language=>&<sap-client=>#
Note
You can click the Home button to enter to the home page, copy your
system URL from https:// to #, and paste it in the field. For exam-
ple, https://uyt928-er9001.wdf.sap.corp/sap/bc/ui5_ui5/ui2/ushell/
shells/abap/FioriLaunchpad.html?sap-language=&sap-client=928#
If a specific language is configured in the destination, the web page will be displayed in the
configured language, even though the end users set a different logon language. You can also
leave the language unconfigured in the destination, and the web page will be displayed in the
logon language end users set.
Authentication NoAuthentication
Next Steps
If you want to verify whether S4 function works well, you can go to Test Management app, choose Manage Test
Execution and click Add Test Object, instead of choosing Check Connection on BTP.
Describes the connectivity configurations for the Requirements Management and Systems Modeling apps.
Integrate the Test Management apps with the Requirements Management and Systems Modeling app.
Context
The integration allows your users to assign the requirements in Requirements Management and Systems
Modeling to test cases for traceability. For more information, see Assigning Requirements to a Test Case.
Administration Guide
Connectivity PUBLIC 141
Procedure
Note
For all the following steps, you must be assigned to a role collection that contains the role
EADesigner_Administrator , which includes the Edit Extensions on Web right.
Enter EPD-Engr-<tenantID> Reference the application URL of EPD or other meaningful descrip-
your SAP Fiori launchpad for the tion.
For <tenantID>, go to your sub-
EPD apps - copy the URL from the
account page in the SAP Business
beginning to the character "#".
Technology Platform cockpit. In the
Subaccount Details section, copy the
Note
value for ID.
To find the application URL:
1. Go to your subaccount in
SAP BTP cockpit.
2. Select Subscriptions in the
navigation panel.
3. Click Go to Application on
the EPD tile
Administration Guide
142 PUBLIC Connectivity
6.8.2.2 Connecting to Collaboration
Integrate the Collaboration SaaS application with the Requirements Management and Systems Modeling app.
Procedure
1. In Requirements Management and Systems Modeling, click Administration Settings in the navigation
panel, and then click the External Systems tile. Select External Objects.
3. Click Activate.
Now, Collaboration is activated as an external object type and listed in the Active External Object Types
table.
4. Go back to the External Systems tile, and then select the System Connections tile.
5. Select the Add button and enter the property values for the Collaboration SaaS application.
To connect to the Collaboration apps, Copy the launchpad portal URL Enter something that indicates the
enter EPD-Colla-<tenantID>. starting from the beginning to the purpose.
character "#". For example:
Replace <tenantID> with the ID of
the Collaboration apps' subaccount.
https://<host ID>/
portal.portal/site#
Administration Guide
Connectivity PUBLIC 143
For more information, see Connecting to External Systems [page 315].
Describes the connectivity configuration for Enterprise Product Structure apps to allow data sources to
retrieve data from the SAP ERP, SAP S/4HANA, and SAP S/4HANA Cloud systems.
You must integrate the Enterprise Product Structure SaaS application via PLMSI. For detailed information on
how to configure connectivity, see Connectivity Using PLM System Integration [page 106].
You can configure connections to the following destinations, depending on your source system:
The necessary steps to set up the destination is here, see Destination for Connecting to SAP ERP [page 107].
The necessary steps to set up the destination is here, see Destination for Connecting to SAP S/4HANA [page
109].
The necessary steps to set up the destination is here, see Destination for Connecting to SAP S/4HANA Cloud
[page 111].
Note
If your source system is an SAP S/4HANA Cloud system, then download of document originals and
Visualization are not supported.
Administration Guide
144 PUBLIC Connectivity
6.9.1 Destination for Connecting to On-Premise Content
Server
You need to create a destination for your Content Server to retrieve document content from an on-premise
Content Server (KPro). An on-premise Content Server is set up outside SAP S/4HANA, SAP S/4HANA Cloud
or SAP ERP systems.
Note
If you use the Content Server within the source system, this topic is not relevant.
Prerequisites
• You've set up a Cloud Connector for your on-premise Content Server to enable access to Enterprise
Product Structure to retrieve the document originals. For more information, see Using the Cloud
Connector to Connect to On-Premise Systems [page 103].
• You've configured the connectivity for Enterprise Product Structure apps to allow data sources to retrieve
data from the SAP ERP, SAP S/4HANA, or SAP S/4HANA Cloud systems. For more information, see
Configuring Connectivity for Enterprise Product Structure [page 144].
Configure HTTP destinations to connect to your content server through HTTPS as mentioned below. The
connection can be established by a technical user.
For the Content Server that you want to retrieve document content from, you must create destinations as
mentioned in the table below. Enterprise Product Structure supports multiple destinations, so it is left to your
discretion to choose a name for a destination.
There are three additional properties that need to be specified for the Enterprise Product Structure services to
recognize a destination properly:
• sap.epd.purpose: content
Recommendation
We recommend that you create the destination with technical user authentication.
Administration Guide
Connectivity PUBLIC 145
Destination
Property Description
Name <MySystem>
Type HTTP
Authentication NoAuthentication
Allows you to work on Bills of material (BOMs) from different source systems and to enable the exchange of
BOM data between the intelligent handover and the source systems, you need to configure the connectivity.
You can configure to the following destinations depending on your source system:
Note
Administration Guide
146 PUBLIC Connectivity
Note
Note
In the prerequisite step of How to Create Communication Arrangement, ensure that you have created the
communication arrangement for the SAP_COM_0937 communication scenario.
Note
Additionally, you need to enable the master data objects to work for routing scenario by subscribing to the
following public APIs that are available in the following SAP S/4HANA On-Premise releases:
Note
In the prerequisite step of How to Create Communication Arrangement, ensure that you have created the
communication arrangement for the following communication scenarios:
• SAP_COM_0104
Administration Guide
Connectivity PUBLIC 147
• SAP_COM_0519
Also note that for communication scenarios SAP_COM_0104 and SAP_COM_0519, perform the following as
provided in the link, How to Create Communication Arrangement:
To enable the master data objects to work for the routing scenario, the following public APIs are available for
the above communication scenarios:
• Production Routing
• Work Center
• Routing Version
Learn how to create the destinations that are needed for the Insights SaaS application for SAP Product
Lifecycle Management in the SAP BTP cockpit.
Connecting SAP Build Work Zone, standard edition or SAP Build Work Zone,
advanced edition
Before you use the Insights SaaS application, you must configure the destination needed to connect Insights
for SAP Product Lifecycle Management and SAP Build Work Zone, standard edition or SAP Build Work Zone,
advanced edition. This connection lets your business users access data in the UI integration cards in SAP Build
Work Zone, standard edition or SAP Build Work Zone, advanced edition. For the required steps, see Connecting
SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition [page 150].
The UI integration cards for Insights are delivered in content packages for SAP Build Work Zone, standard
edition or SAP Build Work Zone, advanced edition. For some content packages, you need to also configure
a destination to an external system. This allows Insights to ingest the information that is displayed in an
aggregated form on the UI integration cards.
Administration Guide
148 PUBLIC Connectivity
PLM Insights: Change Management Content Package
An additional mandatory destination is needed for using the PLM Insights: Change Management content
package.
To ingest the change record information to be displayed on the UI integration cards, you must configure a
destination to connect Insights for SAP Product Lifecycle Management and SAP S/4HANA. For information on
the parameters that you need, see Connecting SAP S/4HANA for Change Management Data [page 152].
• The Product Innovation Management SaaS application for cards with information about ideas and
campaigns. Important: You must subscribe to the Product Innovation Management SaaS application for
the data ingestion to work.
• The Engineering SaaS application for cards with information about requirements models. Important: You
must subscribe to the Engineering SaaS application for the data ingestion to work.
To load the product images to be displayed on the My Products card, you must configure a destination
to connect Insights for SAP Product Lifecycle Management and the Enterprise Product Structure API. For
information on the parameters that you need, see Connecting to the Enterprise Product Structure API for
Images [page 155].
Insights automatically ingests the other data from the products that are part of the Enterprise Product
Structure SaaS application. Important: You must subscribe to the Enterprise Product Structure SaaS
application for the data ingestion to work.
To load the thumbnails to be displayed on the Visualizations card, you must configure a destination to connect
Insights for SAP Product Lifecycle Management and the Visualization API. For information on the parameters
that you need, see Connecting to the Visualization API for Thumbnails [page 156].
Insights automatically ingests the other data from the visualizations that are part of the Visualization SaaS
application. Important: You must subscribe to the Visualization SaaS application for the data ingestion to work.
There is also information related to Insights in the Security Guide for SAP Product Lifecycle Management.
Check the information about authorizations, audit logging, and data storage for Insights here:
Administration Guide
Connectivity PUBLIC 149
• User Administration, Authentication, and Authorizations
• Data Storage Security
Follow these steps to configure the destination needed for connecting Insights for SAP Product Lifecycle
Management and SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition.
Prerequisites
1. You have subscribed to the Insights SaaS application. For more information, see Subscribing to the SaaS
Applications [page 23].
2. You have created a service instance for Insights and (in Cloud Foundry) a service key or (in other
environments) a service binding. You need the credentials of your service key/binding for the destination
details. For more information, see the following documents:
• Creating Service Instances
• Creating Service Keys in Cloud Foundry
• Creating Service Bindings in Other Environments
Context
This connection allows you to give your business users access to the UI integration cards in SAP Build Work
Zone, standard edition or SAP Build Work Zone, advanced edition. You only need to create this destination
once.
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Note
For general information about configuring destinations, see How to Configure Destinations [page 102] .
Administration Guide
150 PUBLIC Connectivity
Field Value
Name
• For SAP Build Work Zone, standard edition:
Note
You must enter PLM_Insights as the destina-
tion name.
Recommendation
Enter PLM_Insights as the destination name.
If you enter this name, you don't need to make
any additional settings in the configuration for
each card.
Type HTTP
URL Use the json property url that is stored in the credentials
from your Insights service key/binding.
Authentication OAuth2JWTBearer
Client ID Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Insights.
Client Secret Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Insights.
Token Service URL Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Insights.
Enter the URL and add the following at the end: /oauth/
token
Next Steps
1. If you want to use UI integration cards in the PLM Insights: Change Management content package,
configure the connection to SAP S/4HANA. Information on how to do that is available here: Connecting
SAP S/4HANA for Change Management Data [page 152].
2. Set up your SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition entitlement
in SAP BTP. Activate and configure the UI integration cards for the content package that you need. For
Administration Guide
Connectivity PUBLIC 151
more information on how to do that, see SAP Build Work Zone, standard edition with Multiple SaaS
Applications [page 172] or SAP Build Work Zone, advanced edition [page 176].
Follow these steps to configure the destination needed for connecting Insights for SAP Product Lifecycle
Management and SAP S/4HANA so that you can use the PLM Insights: Change Management content package.
Prerequisites
• You have checked the information about the integration between Insights and SAP S/4HANA to ensure
that your SAP S/4HANA release is supported: Integrating Insights with Other Products.
• You have configured the connection to SAP Build Work Zone, standard edition or SAP Build Work Zone,
advanced edition. For more information, see Connecting SAP Build Work Zone, standard edition or SAP
Build Work Zone, advanced edition [page 150].
• If the Cloud Connector for SAP BTP, Cloud Foundry Environment, is not already installed and configured
for connecting cloud applications to your SAP S/4HANA system, complete the necessary steps. For more
information, see Using the Cloud Connector to Connect to On-Premise Systems [page 103].
• You have contacted the system administrator of your SAP S/4HANA system to get the following
information:
• URL for the SAP S/4HANA system
• Client information for the SAP S/4HANA system if you want to use a client that is different from the
default client
• If you choose to use basic authentication (not recommended), the user name and password for the
technical user
• To allow navigation from the Insights cards to the Manage Change Records app, you have exposed the SAP
S/4HANA app in SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition. For
more information, see Content Providers - On-Premise Solutions.
Context
This connection allows Insights to ingest the change record information to be displayed on the UI integration
cards in the PLM Insights: Change Management content package for SAP Build Work Zone, standard edition or
SAP Build Work Zone, advanced edition. For more information about the available cards, see User Guide for
Insights.
Administration Guide
152 PUBLIC Connectivity
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Note
For general information about configuring destinations, see How to Configure Destinations [page 102].
Field Value
Name PLM_S4HANA_Insights
Caution
Enter only this value.
Type HTTP
URL Enter the URL that you got from the administrator of your
SAP S/4HANA system.
Authentication PrincipalPropagation
Administration Guide
Connectivity PUBLIC 153
Field Value
BasicAuthentication
User Enter the user that you got from the administrator of your
SAP S/4HANA system.
Password Enter the password that you got from the administrator of
your SAP S/4HANA system.
Additional Properties If you want to use the default system client, no additional
property is needed.
Next Steps
Set up your SAP Build Work Zone, standard edition or SAP Build Work Zone, advanced edition entitlement in
SAP BTP. Activate the UI integration cards for the content package that you need. For more information on how
to do that, see SAP Build Work Zone, standard edition with Multiple SaaS Applications [page 172] or SAP Build
Work Zone, advanced edition [page 176].
Administration Guide
154 PUBLIC Connectivity
6.11.3 Connecting to the Enterprise Product Structure API
for Images
Follow these steps to configure this optional destination so that thumbnails are displayed on the My Products
card in the PLM Insights: Develop Products content package.
Prerequisites
• You have completed all steps that are explained here: Connecting SAP Build Work Zone, standard edition or
SAP Build Work Zone, advanced edition [page 150].
• You have created a service instance for Enterprise Product Structure and (in Cloud Foundry) a service key
or (in other environments) a service binding. You need the credentials of your service key/binding for the
destination details. For more information, see the following documents:
• Creating Service Instances
• Creating Service Keys in Cloud Foundry
• Creating Service Bindings in Other Environments
Context
When you install the PLM Insights: Develop Products content package and activate the My Products card, your
business users can use the card and see data for products. However, if images are available for the products,
they will not be displayed until you create this destination. A default icon is displayed instead.
For information about the data shown on the card, see Insights Cards for Products.
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Note
For general information about configuring destinations, see How to Configure Destinations [page 102].
Field Value
Administration Guide
Connectivity PUBLIC 155
Field Value
Type HTTP
URL Use the json property url that is stored in the creden-
tials from your Enterprise Product Structure service key/
binding.
Authentication OAuth2JWTBearer
Client ID Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Enterprise Product
Structure.
Client Secret Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Enterprise Product
Structure.
Token Service URL Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Enterprise Product
Structure.
Enter the URL and add the following at the end: /oauth/
token
Follow these steps to configure this optional destination so that thumbnails are displayed on the Visualizations
card in the PLM Insights: Deliver Products content package.
Prerequisites
• You have completed all steps that are explained here: Connecting SAP Build Work Zone, standard edition or
SAP Build Work Zone, advanced edition [page 150].
• You have created a service instance for Visualization and (in Cloud Foundry) a service key or (in other
environments) a service binding. You need the credentials of your service key/binding for the destination
details. For more information, see the following documents:
• Creating Service Instances
Administration Guide
156 PUBLIC Connectivity
• Creating Service Keys in Cloud Foundry
• Creating Service Bindings in Other Environments
Context
When you install the PLM Insights: Deliver Products content package and activate the Visualizations card, your
business users can use the card and see data for visualizations. However, if thumbnails are available for the
visualizations, they will not be displayed until you create this destination. A default icon is displayed instead.
For information about the data shown on the card, see Insights Cards for Visualizations.
Procedure
1. In your web browser, log on to the SAP BTP cockpit, and choose the relevant subaccount.
2. In the left panel, under Connectivity, choose Destinations.
3. To create the destination at the subaccount level, enter the destination details as shown in the following
table:
Note
For general information about configuring destinations, see How to Configure Destinations [page 102].
Field Value
Type HTTP
URL Use the json property url that is stored in the creden-
tials from your Visualization service key/binding.
Authentication OAuth2JWTBearer
Client ID Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Visualization.
Client Secret Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Visualization.
Administration Guide
Connectivity PUBLIC 157
Field Value
Token Service URL Use the properties that are enclosed by the uaa json ob-
ject for your service key/binding for Visualization.
Enter the URL and add the following at the end: /oauth/
token
Describes the connectivity configuration for Specification Management apps to allow data sources to retrieve
data from SAP ERP, SAP S/4HANA, and SAP S/4HANA Cloud systems.
Integration for the Specification Management SaaS application is performed via PLM System Integration. For
detailed information on how to configure connectivity, see Connectivity Using PLM System Integration [page
106].
You also need to configure the SAP Build Work Zone, standard edition to establish connectivity. For more
details, see Federation of Remote Content Providers.
The necessary steps to set up the destination is here, see Destination for Connecting to SAP ERP [page 107].
Note
The necessary steps to set up the destination is here, see Destination for Connecting to SAP S/4HANA [page
109].
Note
Administration Guide
158 PUBLIC Connectivity
For Synchronization of Product Master Data With SAP S/4HANA Cloud
The necessary steps to set up the destination is here, see Destination for Connecting to SAP S/4HANA Cloud
[page 111].
Note
Central Components
The Specification Management cloud service of SAP Product Lifecycle Management allows you to use the
following central components:
• Status Management
For more information on the used service, see Managing Statuses [page 182].
• Unit of Measure
For more information on the used service, you can read through the following document: What is Unit of
Measure.
• Plants
For more information on the used service, see Configuring Plants [page 293].
• Common Functions
For more information on the used service, see User Guide for Common Functions.
More Information
Describes the connectivity configuration for Visualization apps to allow data sources to retrieve data from an
S/4HANA On-Premise back-end system.
For data sources, you can configure a connection to an SAP S/4HANA On-Premise system.
SAP Business Technology Platform Cloud Connector must be configured to allow connection to an on-premise
system. SAP Business Technology Platform Cloud Connector provides a proxy to an on-premise URL resource.
Administration Guide
Connectivity PUBLIC 159
Configuring and Installing Cloud Connector
If your source system is an on-premise system, add a destination for the cloud connector.
Parameter Description
Note
This value can be found in the Subaccount Details panel on the subaccount Overview page in
the SAP Cloud Platform Cockpit.
Display Name [optional] Enter the name to show for the subaccount in the Cloud Connector interface.
Location ID [optional] Specifies a short name to identify the Cloud Connector in the subaccount. This value
will be used when adding the Cloud Connector instance as a destination in your subaccount. This
is typically used when there are multiple Cloud Connectors connected to the same subaccount.
HTTPS Proxy [if required in your environment] Enter parameters for your proxy.
If your parameters are correct, the Cloud Connector will automatically connect to your subaccount.
3. Configure access control or copy the complete access control settings from another subaccount on the
same Cloud Connector by following the procedure mentioned in Configure Access Control.
4. [optional] Configure principal propagation by following the procedure mentioned in Configure principal
propagation.
5. Create a system mapping from the Cloud Connector to the SAP S/4HANA system:
1. In the Cloud Connector administration UI, click Cloud To On-Premise, click Add, and then complete the
Add System Mapping wizard pages as follows:
Parameter Description
Internal Host / Specify the actual host and port under which the SAP S/4HANA system can be reached within
Port the intranet. Click Next.
Administration Guide
160 PUBLIC Connectivity
Parameter Description
Virtual Host / Specify a name for the agent instance and keep the same port as for the internal port. These
Port values will be used adding the Cloud Connector instance as a destination in your subaccount.
Example
S4H
Principal Type If you have configured principal propagation for the data source, then select X.509 Certificate
(General Usage) or X.509 Certificate (Strict Usage). If you have not configured principal propa-
gation, but have chosen a different authentication method, for example, Basic Authentication,
then select None here.
Click Next.
Host in Request Keep the default value Use Virtual Host and click Next.
Header
Description Optionally enter a description for the mapping, click Next, check Check Internal Host
and then Finish.
For detailed information, see Configure Access Control (HTTP) in the SAP BTP Connectivity
documentation.
2. Click the Check Availability action to see if your parameters are correct.
3. Click the Add tool above the Resources Accessible table, enter parameters as follows, and then click
Save:
Parameter Description
URL Path Enter /. You can specify a more specific path here (for example, /sap/opu) if you want to
further restrict which paths are available to the data source.
Note
If you require support or encounter any technical issues while configuring the Cloud Connector, contact
SAP by reporting an incident on the Support Portal under the component BC-MID-SCC.
You use details from the Cloud Connector that you set up in SAP BTP Cockpit to provide information in the data
source configuration in Visualization. Make the following relevant settings in the Connection section of the data
source configuration.
• In URL, specify Host name as the proxy host name (this is also the Virtual Host used in the Cloud
Connector configuration, for example, S4H). Host name is shown in SAP BTP Cockpit for the Cloud
Administration Guide
Connectivity PUBLIC 161
Connector under Exposed Back-End Systems. URL also specifies the service that the data source connects
to in the S/4HANA system.
• Set Proxy Type to On Premise. This makes the connection to the S/4HANA On-Premise system through
the Cloud Connector.
• [optional] If a Location ID was specified when connecting the Cloud Connector to the subaccount, set
Location ID to be the same as the Master Instance name configured in the Cloud Connector in SAP BTP
Cockpit.
• In Authentication, select the authentication method. If you have configured principal propagation, select
Principal Propagation. Otherwise, select Basic Authentication and enter the username and
password of a technical user in the S/4HANA On-Premise system.
For more information about configuring a data source, see Creating a New Data Source.
Learn how to create the destinations that are needed for the Product Innovation Management SaaS application
for SAP Product Lifecycle Management in the SAP BTP cockpit.
It is mandatory to build connections between needs from Product Innovation Management and requirements.
Context
With the integration, your users can create a requirement in a specified requirements model in Requirements
Management and Systems Modeling based on needs sourced from innovation. For more information, see
Creating a Requirement Link.
Procedure
Administration Guide
162 PUBLIC Connectivity
Note
For all the following steps, you must be assigned to a role collection that contains the role
EADesigner_Administrator , which includes the Edit Extensions on Web right.
1. Choose Administration Settings in the navigation panel, and then choose the External Systems
tile. Select External Objects.
Two tables are displayed on the page.
2. Above the right table, select SAP Enterprise Product Development from the dropdown list.
3. Select Activate on the top right.
Now, need is activated as an external object type and listed in the right table.
3. Add the system of Product Innovation Management as an external system by performing the following
steps:
1. Choose Administration Settings in the navigation panel, select the External Systems tile, and
then select the System Connections tile.
2. Choose Add button and enter the following property values for the new external system:
1. Go to your subaccount in
SAP BTP cockpit.
2. Select Subscriptions in the
navigation panel.
3. Click Go to Application on
the EPD tile
Next Steps
Standard users of Requirements Management and Systems Modeling are assigned to a role collection
containing the role EADesigner_User, which allows connecting to the app. To create requirements from
Product Innovation Management, users also need the Edit on Web previlege, which must be granted by you
(or any administrator user of Requirements Management and Systems Modeling). See the following steps
1. Choose Administration Users in the navigation panel, and then select the appropriate user in the list
to open its property sheet.
Administration Guide
Connectivity PUBLIC 163
Note
For your users to appear in the list, they must log in to the Requirements Management and Systems
Modeling at least once after roles are assigned.
For more information about the previleges and permissions in Requirements Management and Systems
Modeling, see Controlling Repository Access [page 304].
This destination is used to build the connection between the project management software Jira and Product
Innovation Management. With the destination, you can create a Jira item based on a need in Product Innovation
Management.
Property Description
Type HTTP
Description It is used for the integration with the external project management tool, that is, the Jira software
Example
https://jira.tools.sap
Authentication BasicAuthentication
User Enter the Jira technical users, who can create and review Jira items in the Jira system.
Administration Guide
164 PUBLIC Connectivity
6.14.3 Configuring Connectivity for SAP Build Process
Automation
Your users can send emails for notifications and reminders after you configure the required destinations for
SAP Build Process Automation.
To enable SAP Build Process Automation, which allows your users to send email notifications and reminders to
idea submitters, evaluators, and product managers, you need three destinations:
• Create a new destination for connecting to Product Innovation Management, see Destination for
Connecting to Product Innovation Management [page 165].
• Create a new destination for connecting to the email service, see Destination for Connecting to Email
Service [page 166].
• Add customized properties for the existing destination of SAP Build Process Automation, see Destination
for Connecting to SAP Build Process Automation [page 167].
Create a new destination to build a connection between Product Innovation Management and SAP Build
Process Automation.
Prerequisites
You have created a service key for the service instance under Service Marketplace Product Innovation
Management . For more information about creation steps, see Configuration for Using APIs [page 455].
Destination Configuration
Property Description
Type HTTP
Administration Guide
Connectivity PUBLIC 165
Property Description
URL Enter the endpoint of the service key, append the path /
odata/v4/InnovationManagementService to the
end of it.
Authentication OAuth2JWTBearer
Client Secret Enter the value of clientsecret from service key credentials.
Token Service URL Enter the value of URL from service key credentials and ap-
pend the path /oauth/token.
Choose New Property and add each of the following additional properties.
sap.applicationdevelopment.actions.enabled true
sap.build.usage odata_gen
sap.processautomation.enabled true
Create a new destination that is required for users to send email notifications.
Destination Configuration
Property Description
Type MAIL
Administration Guide
166 PUBLIC Connectivity
Property Description
Authentication BasicAuthentication
Choose New Property and add each of the following additional properties.
mail.smtp.auth true
mail.smtp.ssl.checkserveridentity true
mail.smtp.starttls.enable true
mail.smtp.starttle.required true
mail.transport.protocol smtp
For more information about how to configure the destination, see Configure an SMTP Mail Destination in SAP
Build Process Automation.
Add additional properties to the existing SAP Build Process Automation destination so that you can have
customized configurations on email notifications.
Prerequisites
Administration Guide
Connectivity PUBLIC 167
Destination Configuration
Note
With two new destinations that you've created, you can deploy the predefined process templates we
provide. For more information about how to configure the email notifications, see Configuring Email
Notifications [page 421]. After deploying, you can find the process definition IDs in the destinations. For
more information about how to find the definition ID, see Determine the Workflow Definition ID.
Product Data Integration needs a destination for the Object Store service and a destination for Identity
Authentication.
Related Information
Administration Guide
168 PUBLIC Connectivity
6.15.1 Destination for Identity Authentication
A destination needs to be configured for Product Data Integration that points to the SAP Cloud Identity Service
- Identity Authentication (IAS) tenant. It is used by the Common Functions SaaS application to perform the
token exchange when the authoring system plugin authenticates.
Prerequisites
You have set up the SAP Cloud Identity Services tenant, see Configuring the Identity Provider for Product Data
Integration [page 34].
Procedure
Sign in to the SAP Business Technology Platform cockpit and navigate to your subaccount. Create a
destination (see How to Configure Destinations [page 102]) with the following configuration:
Property Value
Name EPD_Desktop_Client
URL https://notused
Authentication OAuth2ClientCredentials
Client Secret <Client Secret that has been created within the application
in the SAP Cloud Identity Services tenant>
A destination needs to be configured for Product Data Integration that points to the Object Store service on
SAP BTP to store authoring system files.
Administration Guide
Connectivity PUBLIC 169
Procedure
Product Data Integration uses the same Object Store service and destination configuration as the
Collaboration SaaS application. For the steps to follow, see Destination for Storing Data in Object Store [page
104]
Administration Guide
170 PUBLIC Connectivity
7 Entry Point for App Access
You need to set up the entry point for your users to access and work with the apps from SAP Product Lifecycle
Management.
• SAP Build Work Zone, standard edition is a cloud-based solution that enables your users to access apps
from multiple systems, cloud and on premise, in a unified manner. The site is divided into groups or spaces
and pages that contain tiles that launch apps.
If you have subscribed to several SaaS applications for SAP Product Lifecycle Management, you can
configure the SAP Build Work Zone, standard edition. Your users can then use SAP Build Work Zone,
standard edition as the single entry point for the apps provided by the different SaaS applications. For
more information, see SAP Build Work Zone, standard edition with Multiple SaaS Applications [page 172].
• SAP Build Work Zone, advanced edition provides the same functions as SAP Build Work Zone, standard
edition with the addition of features for your teams and colleagues to share and interact and the possibility
for you to flexibly create business workspaces as entry points for your users. SAP Build Work Zone,
advanced edition is provided as an entry point with the Insights SaaS application. You can use the UI
integration cards that are provided by Insights, create your own cards, and set up role-based workspaces
that combine UI integration cards and other SAP Fiori apps. For more information, see SAP Build Work
Zone, advanced edition [page 176].
• If you have subscribed to only one SaaS application, you can use the individual SAP Fiori launchpad
provided for that SaaS application. This individual launchpad contains only the apps for this specific SaaS
application. For information, see SAP Fiori Launchpad for Single SaaS Applications [page 180].
Caution
If you use the Collaboration SaaS application, we recommend that you always use SAP Build
Work Zone, standard edition instead of the individual SAP Fiori launchpad. The Collaboration SaaS
application reuses apps that are part of other SAP BTP services. You cannot control the access to these
SAP BTP apps on the individual SAP Fiori launchpad. The apps will appear on the individual SAP Fiori
launchpad for users who cannot open them.
To learn which apps are provided by each SaaS application, check the role template documentation: Role
Templates for SAP Product Lifecycle Management [page 50].
Related Information
Administration Guide
Entry Point for App Access PUBLIC 171
7.1 SAP Build Work Zone, standard edition with Multiple
SaaS Applications
SAP Build Work Zone, standard edition provides a central entry point to apps from SAP Product Lifecycle
Management and other platforms.
If you have subscribed to several SaaS applications from SAP Product Lifecycle Management, we recommend
that you use SAP Build Work Zone, standard edition. This central service lets you tailor access to the apps from
the different SaaS applications for different users. The general steps for setting up and administering SAP Build
Work Zone, standard edition are explained in the SAP Build Work Zone, standard edition documentation: Initial
Setup
This document provides additional guidance that is specific to setting up the service for use with SAP Product
Lifecycle Management.
App Access
There are two scenarios for accessing the apps in SAP Product Lifecycle Management:
• You use the default role collections that are provided by the Common Functions SaaS application for SAP
Product Lifecycle Management.
• You want to create your own role collections for accessing the apps in SAP Product Lifecycle Management.
Using the Default Role Collections for SAP Product Lifecycle Management
To make SAP Product Lifecycle Management apps visible on SAP Build Work Zone, standard edition and allow
your users to navigate between them as needed, follow these steps:
1. Assign the same apps that are included in the SAP Product Lifecycle Management default role collection to
the new SAP Build Work Zone, standard edition role.
2. Assign the SAP Build Work Zone, standard edition role to the users that need to see and use the apps.
The role in SAP Build Work Zone, standard edition is the same as the SAP Product Lifecycle Management
default role collection.
3. Inform your users that they need to log off and on again to see the changes.
Note
Visualization Apps
The Viewer and Authoring apps that are provided by the Visualization subscription can't be launched
directly from a launchpad or a menu. These apps are launched from within other apps, for these purposes:
The Viewer and Authoring apps are excluded from the list of applications that can be added to a catalog or
group in an SAP Build Work Zone, standard edition and advanced edition launchpad. So, to use these apps,
you must add them to My Content and assign them to the appropriate SAP Build Work Zone, standard
edition and advanced edition roles.
Administration Guide
172 PUBLIC Entry Point for App Access
Creating Your Own Role Collections
If you want to build your own role collections, you can use them for the app access for both SAP Product
Lifecycle Management and for SAP Build Work Zone, standard edition. Follow these steps:
1. Create role collections in SAP Build Work Zone, standard edition. The detailed steps to follow are available
here: Assign Content to a Role.
Caution
When deleting a role in the Role editor in SAP Build Work Zone, standard edition, the corresponding
role collection, and all user and group assignments to it, are deleted from SAP BTP as well.
2. Assign the roles for accessing apps in SAP Product Lifecycle Management. For more information, see Role
Templates for SAP Product Lifecycle Management [page 50].
Prerequisites
To use the UI integration cards that are included with the Insights SaaS application, you have given your
business users the authorizations that they need. For more information, see Role Templates for Insights [page
75].
Procedure
1. In the Channel Manager of the Site Manager of your instance of the SAP Build Work Zone, standard edition,
you can find the content packages that you want to use. The following content packages are provided by
the Insights SaaS application for SAP Product Lifecycle Management:
• PLM Insights: Change Management. For more information about its cards, see Insights Cards for
Change Management.
• PLM Insights: Collaboration. For more information about its cards, see Insights Cards for Collaboration
Information.
• PLM Insights: Define Products. For more information about its cards, see Insights Cards for Product
Innovations.
• PLM Insights: Develop Products. For more information about its cards, see Insights Cards for Products.
• PLM Insights: Deliver Products. For more information about its cards, see Insights Cards for
Visualizations.
2. Edit the content packages, activate the Automatically add all content items to subaccount toggle, and save
it. This adds the roles delivered with the content package as role collections to your SAP BTP subaccount.
3. Create a site. In the site settings, choose the Spaces and Pages - New Experience view mode, as explained
in Site Settings. For more information, see Managing Sites.
4. Configure your Spaces and Pages. For more information, see Manual Configuration of Spaces and Pages.
5. Configure each card. For more information, see Business Configuration for Insights [page 415].
6. In the table listing the available cards in Business Configuration for Insights [page 415], check which of the
delivered roles with prefix ~sap.plm.ins is required for the cards you want to use. Open the site settings for
your newly created site and assign the corresponding roles to the site.
7. In the SAP BTP cockpit, go to your subaccount and open the Role Collections section within Security.
Choose the matching role collections corresponding to the roles delivered with the cards, and assign your
users to them.
Administration Guide
Entry Point for App Access PUBLIC 173
8. Inform your business users of the new site you have created.
If a business user wants to see texts translated in a language other than the source language that the site in the
SAP Build Work Zone, standard edition was built with, you need to activate the language. This enables the user
to select the language in their runtime site. For more information about how to activate languages in a site, see
Translate Your Site.
Recommendation
We recommend that you activate the languages that are supported for the user interfaces and in-app help
for SAP Product Lifecycle Management. For more information, see the Supported Languages section in
Overview [page 7].
SAP Companion provides on-screen help to support your business users when they are using the apps for SAP
Product Lifecycle Management.
To Activate SAP Product Lifecycle Management In-App Help, follow these steps:
1. In the Site Directory, choose the site for which you want to activate the in-app help.
2. On the Site Settings screen of the relevant site, select the SAP Companion setting.
3. Enter the following parameters:
Parameter Value
product PLM_EPD
version Cloud
stateUACP PRODUCTION
dataUrlUACP https://help.sap.com/webassistant/
resourceUrl https://xray.hana.ondemand.com/
xRayControls/resources/sap/dfa/help
Note
If you have a license for SAP Enable Now and would like to add your own content to the in-app that is
delivered for SAP, also enter the following values for these parameters:
Administration Guide
174 PUBLIC Entry Point for App Access
Parameter Value
serviceLayerVersion EXT
dataURLSEN2 Enter the URL for the workarea in your SAP Enable Now
Manager instance.
For more information about the features and functions that are provided by SAP Enable Now, see SAP
Enable Now on the SAP Help Portal.
Caution
After activating SAP Companion, in the browser settings in your site configuration, ensure that
asynchronous module loading is not active.
Results
After activation, in the launchpad, business users can open the SAP Companion by choosing the Open Help .
1. In the Site Directory, choose the site for which you want to activate the in-app help.
2. On the Site Settings screen of the relevant site, select the SAP Companion setting.
3. Enter the parameters for the SAP Build Work Zone, standard edition in-app help in the SAP Companion
section. Those parameters are available here: Activating SAP Companion Content.
4. Save your settings.
Each SaaS application for SAP Product Lifecycle Management that you have subscribed to has a content
channel on your site. To see the in-app help for a SaaS application, you have to add the corresponding content
channel as a destination in SAP BTP Cockpit. The name of the destination must match the ID of the content
channel exactly as shown in your Channel Manager. For example, if you have subscribed to the Configuration
Management SaaS application, you can create a destination in the following way:
Parameter Value
Type HTTP
URL https://help.sap.com
Authentication NoAuthentication
Administration Guide
Entry Point for App Access PUBLIC 175
Parameter Value
Create a destination for each of the SaaS applications that you have subscribed to and for which you want
to use the in-app help. If you also use other SAP products, create additional destinations for them. For more
information, check the relevant product documentation on the SAP Help Portal.
SAP Build Work Zone, advanced edition gives your users quick access to the information they need to start
their workday and allows them to jump directly to the apps they need to get their work done.
For more information about other features offered by SAP Build Work Zone, advanced edition, see What is SAP
Build Work Zone, advanced edition?
When you use SAP Build Work Zone, advanced edition together with SAP Product Lifecycle Management,
you optimize your business processes for managing the lifecycle of your products by creating role-specific
workspaces that give your users access to the following:
• Any of the SAP Fiori apps from the SaaS applications for SAP Product Lifecycle Management that you have
subscribed to in the same subaccount.
• Any of the UI integration cards provided by the Insights SaaS application for SAP Product Lifecycle
Management. These cards allow your users to view information, for example, about a product's lifecycle in
different kinds of charts. For information about the UI integration cards that are available with the Insights
SaaS application, see User Guide for Insights.
• Any SAP Fiori apps or UI integration cards that are available from other integrated SAP products.
• Any of your own UI integration cards or other SAP Build Work Zone, advanced edition objects that you have
created to meet your specific needs.
A workspace for your users of SAP Product Lifecycle Management with apps and cards could then look, for
example, like this:
Administration Guide
176 PUBLIC Entry Point for App Access
Procedure
1. To get access to all SAP Build Work Zone, advanced edition, features for SAP Product Lifecycle
Management, subscribe to the Insights SaaS application as explained here: Subscribing to the SaaS
Applications [page 23]
2. To give your users access to the relevant features and functions from SAP Product Lifecycle Management,
subscribe to the other SaaS applications that are part of SAP Product Lifecycle Management that you need
in one subaccount. Subscribe to each additional SaaS application, ensure that your business users have
the proper roles to access the relevant apps, and make the needed business configuration settings. The
relevant steps are explained in the corresponding sections in this Administration Guide.
To be able to use the default role collections from SAP Product Lifecycle Management, we recommend that
you also subscribe to the Common Functions SaaS application.
Administration Guide
Entry Point for App Access PUBLIC 177
3. Configure the connectivity between SAP Product Lifecycle Management and SAP Build Work Zone,
advanced edition as described here: Configuring Connectivity for Insights [page 148].
4. Complete the onboarding process for SAP Build Work Zone, advanced edition. For more information, see
Onboarding to SAP Build Work Zone, advanced edition.
5. Create the necessary workspaces in SAP Build Work Zone, advanced edition and add the relevant apps and
cards. For more information on adding apps and cards, see the following sections.
You can add apps from SAP Product Lifecycle Management into the workpages of your site using the Content
Manager tool in SAP Build Work Zone, advanced edition.
The general steps for adding apps are explained in the SAP Build Work Zone, advanced edition documentation:
Adding Apps to Your Site. Follow the steps for adding apps from an SAP BTP content provider for each of the
SaaS applications that you have subscribed to.
The following section provides additional guidance about the role concept that you need for using apps from
SAP Product Lifecycle Management.
• You use the default role collections that are provided by the Common Functions SaaS application for SAP
Product Lifecycle Management.
• You want to create your own role collections for accessing the apps in SAP Product Lifecycle Management.
Using the Default Role Collections for SAP Product Lifecycle Management
To make SAP Product Lifecycle Management apps visible on the SAP Build Work Zone, advanced edition and
allow your users to navigate between them as needed, follow these steps:
1. Assign the same apps that are included in the SAP Product Lifecycle Management default role collection to
the new SAP Build Work Zone, advanced edition role. The role in SAP Build Work Zone, advanced edition is
the same as the SAP Product Lifecycle Management default role collection.
2. Assign the SAP Build Work Zone, advanced edition role to the users that need to see and use the apps.
3. Inform your users that they need to log off and on again to see the changes.
Note
Visualization Apps
The Viewer and Authoring apps that are provided by the Visualization subscription can't be launched
directly from a launchpad or a menu. These apps are launched from within other apps, for these purposes:
Administration Guide
178 PUBLIC Entry Point for App Access
The Viewer and Authoring apps are excluded from the list of applications that can be added to a catalog or
group in a SAP Build Work Zone, advanced edition launchpad. So, to use these apps, you must add them to
My Content and assign them to the appropriate SAP Build Work Zone, advanced edition roles.
1. Create role collections in SAP Build Work Zone, advanced edition. The detailed steps to follow are available
here: Assign Roles to Your Site.
Caution
When deleting a role in the Role editor in SAP Build Work Zone, advanced edition, the corresponding
role collection and all user and group assignments to it are deleted from SAP BTP as well.
2. Assign the roles for accessing apps in SAP Product Lifecycle Management. For more information, see Role
Templates for SAP Product Lifecycle Management [page 50].
For more information about the apps that are available in the different SaaS applications, see the relevant
section in the User Guide for SAP Product Lifecycle Management.
How to Get the UI Integration Cards in SAP Build Work Zone, advanced
edition
Prerequisites
To use the UI integration cards that are included with the Insights SaaS application, you have given your
business users the authorizations that they need. For more information, see Role Templates for Insights [page
75].
Procedure
In the Administration Console in SAP Build Work Zone, advanced edition, find the content packages that you
want to use. The following content packages are provided by the Insights SaaS application for SAP Product
Lifecycle Management:
• PLM Insights: Change Management. For more information about its cards, see Insights Cards for Change
Management.
• PLM Insights: Collaboration. For more information about its cards, see Insights Cards for Collaboration
Information.
• PLM Insights: Define Products. For more information about its cards, see Insights Cards for Product
Innovations.
• PLM Insights: Develop Products. For more information about its cards, see Insights Cards for Products.
• PLM Insights: Deliver Products. For more information about its cards, see Insights Cards for Visualizations.
Administration Guide
Entry Point for App Access PUBLIC 179
3. Integrate the cards into your work pages.
4. Configure each card. For more information, see Business Configuration for Insights [page 415].
5. Inform your business users that the new cards are available.
Caution
If you use the Collaboration SaaS application, we recommend that you always use SAP Build Work Zone,
standard edition instead of the individual SAP Fiori launchpad. The Collaboration SaaS application re-uses
apps that are part of other SAP BTP services. You cannot control the access to these SAP BTP apps on the
individual SAP Fiori launchpad. The apps will appear on the individual SAP Fiori launchpad for users who
cannot open them.
As described in Onboarding [page 19], you activate the application link on subscribing to the SaaS application
for your SaaS application. Choose the Go to Application link to launch the application.
Once you are redirected to the SAP Fiori launchpad, obtain its URL and share this link with your business users
so they can access the SAP Fiori launchpad to use the apps.
Using a URL query parameter sap_idp with the IDP origin key, you can set the identity provider (IDP) for the
application's login process.
Note
This URL parameter works with the launchpads for the individual SaaS applications of SAP Product
Lifecycle Management, but not with SAP Build Work Zone, standard edition.
A typical use case is that of a company that wants to provide access to SAP Product Lifecycle Management
to both internal and external users. The company configures two SAML 2.0 identity providers, one for internal
users and another for external users. In such a case, the company would then be able to provide different URLs
to the internal users and external users, using the URL parameter sap_idp with values that point to different
identity providers.
You can define the SAML 2.0 identity provider using a URL parameter with the format
sap_idp=<origin_key_of_idp>:
• If you don't provide the query parameter sap_idp, when you log in to the launchpad, all the configured
SAML 2.0 identity providers are provided for you to choose from.
• If you provide the query parameter sap_idp, when you log on to the launchpad, the IDP defined in the
query parameter is chosen by the system automatically to allow you to log in.
Administration Guide
180 PUBLIC Entry Point for App Access
To find the origin key in the SAP BTP cockpit, choose Security Trust Configuration . The origin key is
shown in the Origin Key column.
Note
Position the parameter sap_idp ahead of the fragment identifier, which is preceded by a hash (#)
character, as the fragment identifier is not sent to the network. In the case of the following URLs, the
first works as expected, but the second does not:
Administration Guide
Entry Point for App Access PUBLIC 181
8 Business Configuration
Based on your business requirements and the SaaS applications of SAP Product Lifecycle Management that
you use, perform the required business configuration described in the following sections.
Overview
A status profile contains individual user statuses and rules defined for those statuses. Defining a status profile
lets you create a status network for different business processes. For more information, see Working with
Status Profiles [page 183].
Actions are user-defined tasks for each status. It is also possible to have multiple actions for a single status. For
more information, see Working with Actions [page 190].
Status profiles can be used across multiple SaaS applications. As an administrator, you must define the status
profiles that you need for any of the following SaaS applications:
• Collaboration
• Configuration Management
• Specification Management
• Formulation
• Product Innovation Management
Administration Guide
182 PUBLIC Business Configuration
Prerequisites
You have been assigned the necessary authorization for using the Manage Statuses app as described in the
role template documentation for the relevant SaaS application. See Role Templates for SAP Product Lifecycle
Management [page 50].
Related Information
Use a status profile to form a status network of various business transactions that can be done with an object.
You can create status profiles using the Manage Statuses app, and also edit, copy, or delete them.
With status profiles, you can define and manage the status of objects that are used by multiple SaaS
applications of SAP Product Lifecycle Management. To make it easier for your business users to work with
these status profiles, you can add labels for them in different languages as needed. Your business users will see
the labels that you've configured for the status profile description in the Manage Statuses app.
Prerequisites
You have the necessary authorizations, as explained in the Prerequisites section in the Managing Statuses
[page 182].
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. On the Status Profiles tab, choose Create.
The page displays with the header data, status network, and translation tabs.
Administration Guide
Business Configuration PUBLIC 183
3. On the Header Data tab, to create a status profile enter the following values:
Status Profile Enter a name (maximum 100 charac- The following special characters are
ters). allowed: underscore (_), hyphen (-), or
space (" ").
Status Profile Description Enter a description for the status pro- You can only configure the langauge
file (maximum 500 characters). by editing the status profile.
Object Select the object for which you want The objects are used by the SaaS ap-
to create a status profile from the plications of SAP Product Lifecycle
drop-down list. Management to manage statuses
within the status profile.
The related object details are dis-
played on the Related Objects tab
when viewing or editing a status pro-
file.
4. On the Status Network tab, to add statuses to the status profile choose Status Nodes .
• To add a new status, choose Create New .
In Create Status dialog, enter the following values:
Status Enter a unique status (maximum 100 charac- The following special characters are allowed:
ters). underscore (_) and dash (-).
Status Type • For the initial status type, you must add -
the Next Status.
5. To establish a link between the two statuses in the status network, on the Status Network tab, choose
Transitions Create .
In the table that is displayed, enter the following values:
Administration Guide
184 PUBLIC Business Configuration
Note
• The status profile can have either no status or one status of the type Initial. A status profile can
have no more than one status of type Initial.
• You can create multiple statuses with the In Work, For Review, Rejected, Released, or Obsolete
status types.
• The table on the Statuses tab displays the list of statuses that are defined in the Next Status field
while you are creating a status profile.
6. To make it easier for your business users to work with status profiles, you can add different languages as
needed. On the Translation tab, choose Manage Languages.
In the Manage Languages dialog box, enter the following values:
Field Comments
Language Choose the language that you want to use for the transla-
tion.
Status Profile Description Enter a value that you want your business users to see.
Note
If you dont add any value to the user's preferred lan-
guage, then the default status profile description will
be displayed.
Note
• On the Administration tab, details such as Created By, Created On, Changed By, and Changed On are
displayed only when viewing or editing a status profile.
• You can add and manage your own variants that allows you to configure and personalize the list of
status profiles in both filter bar and in the table.
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. On the Status Profile tab, choose a status profile.
3. Choose Edit.
Administration Guide
Business Configuration PUBLIC 185
4. The following values are available:
Status Profile Description Overwrite with the value of the language that you want
your business users to see.
5. On the Status Network tab, in the Status Nodes section, you can edit the statuses:
1. On the toolbar, choose (Graph) .
2. Select the status node to enable the legend and choose the respective button:
(Transition) In the Select Target Status dialog, The table in the Transitions section
you can edit the target status. displays the list of associated transi-
tions that are linked to statuses.
(Remove Node) You can remove the status from the You can delete a status from a status
status network of a status profile. profile only if there are no objects
linked to it.
Note
When you delete a status, it is
also deleted from all the associ-
ated transitions that are linked
to the status.
6. If you need to rewrite the description in another language, on the Translations tab, choose Edit.
Note
To delete a language that you have configured, select the language that you want to delete and choose
Delete.
Administration Guide
186 PUBLIC Business Configuration
Copying a Status Profile
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. On the Status Profile tab, choose a status profile.
3. Choose Copy.
Note
You see a copy of the status profile with the associated linked statuses, action, transitions, and
translations on the Status Profiles tab.
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. On the Status Profile tab, choose a status profile.
3. Choose Delete.
4. Confirm the warning.
Note
• The status profile with the (Status is in use) icon indicates that the status profile is being used by any
other SaaS applications.
Manage Statuses app to create and edit statuses of a status profile. You can also delete a status if needed.
A status profile contains individual user statuses and rules defined for those statuses. These statuses can be
used to determine a sequence of different steps that are involved in processing an object in various business
processes. The statuses can be used in multiple status profiles for different business processes. To make
it easier for your business users to work with these statuses, you can add descrptions for them in various
languages as needed. Your business users can see these values that you have configured for the status
description in the Manage Statuses app.
Prerequisites
You have the necessary authorization as explained in the Prerequisites section in Managing Statuses [page
182].
Administration Guide
Business Configuration PUBLIC 187
Creating a Status
Status Enter a name (maximum 100 charac- The following special characters are
ters). allowed: underscore (_), hyphen (-), or
space (" ").
4. To make it easier for your business users to work with status profiles, you can add different languages as
needed. On the Translation tab, choose Manage Languages.
In the Manage Languages dialog box, enter the following values:
Field Comments
Language Choose the language that you want to use for the transla-
tion.
Status Description Enter a value that you want your business users to see.
Note
If you dont add any value to the user's preferred lan-
guage, then the default status description will be dis-
played.
Note
You can add and manage your own variants that allows you to configure and personalize the list of
statuses in both filter bar and in the table.
Administration Guide
188 PUBLIC Business Configuration
Editing a Status
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. On the Statuses tab, choose Edit.
The page displays with the header data, and translation tabs.
3. On the Header Data tab, edit the following values:
4. To make it easier for your business users who use other languages, you can add or remove different
languages as needed. On the Translation tab, choose Manage Languages.
In the dialog that is displayed, select the language, and edit the following values:
Field Comments
Language Select the language that you want to use for the transla-
tion.
Status Description Overwrite with the value in the language that you want
your business users to see.
5. The details on the Translation and Administration tabs are displayed only when viewing or editing a status.
Note
On the Administration tab, details such as Created By, Created On, Changed By, and Changed On are
displayed.
Deleting a Status
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. Choose the status that you want to delete.
3. Choose (Delete).
Administration Guide
Business Configuration PUBLIC 189
4. Confirm the warning message.
Note
• The status with the (Status is in use) icon indicates that the status is being used by some other
SaaS applications.
Use the Manage Statuses app to create actions predefined tasks for each status of a status profile. You can add
actions to the status in a status profile. It's also possible to have multiple actions for a single status.
Prerequisites
You have the necessary authorization as explained in the Prerequisites section in Managing Statuses [page
182].
Context
Actions are pre-shipped tasks that can be linked across multiple status profiles for different objects that are
used by multiple SaaS applications of SAP Product Lifecycle Management.
Creating an Action
1. From the SAP Fiori launchpad, open the Manage Statuses app.
The table on the Actions tab displays the list of pre-shipped tasks:
Administration Guide
190 PUBLIC Business Configuration
Items Action Description Object
Lock master data object versions Prevents the user from modifying Baseline
master data.
Allow adding baselines Allows the user to add baselines to a Lifecycle Phase
certain status.
Allow adding lifecycle phases Allows the user to add lifecycle phases Configuration Plan
to a certain status.
2. To add an action with the status in a status network, see Working with Status Profiles [page 183].
Note
• When you delete a status, all associated actions are also deleted.
• When an action is Editable, it means that the action can be modified or changed by other SaaS
applications.
• You can edit or delete only actions that are Editable.
• You can add and manage your own variants that allows you to configure and personalize the list of
actions in both filter bar and in the table.
Describes the business configuration needed to work with the various apps in the Collaboration SaaS
application of SAP Product Lifecycle Management.
Prerequisites
Your user is assigned the CollaborationAdmin role listed in Role Templates for Collaboration [page 51].
As an administrator, you must perform the following business configuration, which is essential for working with
collaborations, in the correct sequence:
• Create a user group with special authorizations for collaborations. For more information, see Creating a
Group with Special Authorizations [page 193].
Administration Guide
Business Configuration PUBLIC 191
• Define status profiles using the Status Management app. For more information, see Managing Statuses
[page 182].
• Define collaboration types and status profiles to use in collaborations, using the Configure Collaboration
app. For more information, see Configure Collaboration [page 196].
• Model and deploy workflows to use in collaborations. For more information, see Modeling Workflows [page
232].
• Configure workflow properties that you define in the workflows, using the Workflow Properties app. For
more information, see Workflow Properties [page 238].
• Configure systems and objects to retrieve product data from your source system using the Configure
Product Data app. This configuration allows your users to collaborate on product data in collaborations. For
more information, see Configure Product Data [page 248].
• Load value sets from the source system to work with provisional specifications. For more information, see
Useful Information for Value Sets [page 259].
• Integrate with SAP Ariba Supplier Lifecycle and Performance to enable your users to search for and add
suppliers to collaborations. For more information, see Configure Supplier Data [page 210].
User groups are a collection of users who can work together to perform a similar set of tasks in a collaboration.
Users of these groups are also assigned to roles and authorizations to perform specific actions.
You can add individual users and user groups to collaborations. This section provides you with the following
information:
• Creating a user group with special authorizations in collaborations. For more information, see Creating a
Group with Special Authorizations [page 193].
Note
This configuration is mandatory. Without this user group, you will not be able to create collaborations.
• Creating user groups to add as participants in collaborations. For more information, see Creating
Participant User Groups [page 195].
Administration Guide
192 PUBLIC Business Configuration
8.2.1.1 Creating a Group with Special Authorizations
You can create a group with authorizations to supersede the rights of participants having the Administrator role
within collaborations. Users of this group can perform certain actions that are available only to them.
Note
Creating this group is mandatory. Without this group, you cannot create collaborations.
Only participants assigned the Administrator role within a collaboration can perform the following actions:
While working with collaborations, you may encounter the following situations:
• A collaboration cannot be worked upon due to collaboration administrators being unavailable to perform
their actions.
• A participant is no longer available in your subaccount, or required in a collaboration, and must be replaced
or removed from a collaboration. (Also, the administrators of the collaboration are unavailable to add or
remove participants.)
To address such situations, you require a user group with access to all collaborations.
Caution
Deciding who and how many users you assign to this group requires a great deal of consideration because
they have a higher level of access, and can modify any collaboration existing in your subaccount.
Remember
• Once you have created this user group, every collaboration that is created in your subaccount will have
the user group added as a participant, and assigned the Administrator role.
• The user group DL_SUPER_ADMIN_GROUP must not be deleted.
• This user group will not be visible in the list of participants in a collaboration.
• This user group name is not searchable, and is not displayed in the suggestion list when you add
participants in a collaboration.
Procedure
Administration Guide
Business Configuration PUBLIC 193
1. Create the user group DL_SUPER_ADMIN_GROUP in the cloud cockpit as mentioned in Creating Participant
User Groups [page 195] and assign the super admin email IDs to this group by performing the following
steps:
1. Ensure that your user is assigned the CollaborationDPPAdmin role. For information about the role,
refer to the Collaboration section in Defining and Bundling Roles.
2. If you use the public API, one of the e-mail IDs in this group can be set as the From header to have
access to all collaboration.
Note
If you are configuring the collaboration capabilities of the solution, the following information is not relevant.
If the Collaboration apps have been configured, and you need to replace participants in a collaboration, refer to
the following information.
Prerequisites
• You are added as a user to the DL_SUPER_ADMIN_GROUP role collection as mentioned in Creating
Participant User Groups [page 195].
• You are familiar with working in collaborations using the My Collaborations app. For more information, see
Working with Collaborations and Participants in the User Guide for Collaboration.
Procedure
Note
• New Participant supports type-ahead functionality. If you enter an email address, the list of
suggestions displays the user names.
• The new participant you require must be listed in the suggestion list.
6. Choose Replace.
The existing participant is removed from the collaboration and is replaced by the new participant. All tasks
that were being processed by the existing participant get unassigned.
Administration Guide
194 PUBLIC Business Configuration
8.2.1.2 Creating Participant User Groups
You can add individual users and user groups as participants in a collaboration. Refer to the information in this
topic to use the feature of user groups in collaborations.
Prerequisites
You have created a destination called EPD_XSUAA_APIAccess. For more information, see Destination for User
Groups [page 126].
Note
• The user group can be created using SAP Business Transformation Services (BTS) security role
collection or using the XSUAA API. For more information, see the Role Collections entity in the
Authorization API .
• Do not add roles to the user groups other than the ones mentioned in the Role Templates for SAP
Product Lifecycle Management [page 50].
Procedure
1. Create the user group in the role collection and add the required users to the user group.
2. Ensure that the users are assigned the necessary role collections.
Remember
Create the status profiles that you need for your collaborations and shared product data.
You create status profiles in the Manage Statuses app. For information on how to use the app, see Managing
Statuses [page 182].
Administration Guide
Business Configuration PUBLIC 195
Status Profiles for Collaborations
Status profiles are linked to the collaboration types that you must configure for collaborations. For more
information, see Working with Collaboration Types [page 200].
Note
If you want your users to be able to invite participants to a collaboration, you must set the action of a
status profile to editable when you create it. You then link this status profile to the relevant collaboration
types and use those collaboration types for collaborations. The participants in those collaborations can
then invite other participants to join.
A processing status is needed for product data records to properly record the lifecycle of an object. For more
information about how users can work with this kind of processing status, see Setting the Processing Status of
Product Data Records.
Note
For an integration with SAP Ariba Sourcing: Create a status profile with the status network as explained
here: Integrating with SAP Ariba Sourcing.
You can use the Configure Collaboration app to define the collaboration type for a collaboration. To work with
collaborations, you must configure a collaboration type and link it to a status profile.
On launching the Configure Collaboration app, the page displays an overview of sections that you as an
administrator have to configure before your business users can start working with collaborations:
Section Result
Supplier Data Enables your business users to search for supplier data in
the My Collaborations app. For more information, see Config-
ure Supplier Data [page 210].
Administration Guide
196 PUBLIC Business Configuration
Section Result
Job Scheduler Enables your business users to plan, run, and monitor execu-
tion of scheduled jobs.
Settings
Note
If you want to use collaborations within Microsoft
Teams, you must enter information on the Settings tab.
For more information on how to set up the integration
with Microsoft Teams and what to enter in this app, see
Integration with Microsoft Teams.
Collaboration Types
Defining collaboration types enables you to create collaborations for different purposes and to keep
collaborations consistent.
Note
Every collaboration type must be linked to a status profile, which you create using the Manage Statuses
app.
Pagination support is available. By clicking More allows you to move to the next page or the preceding page
of the listed collaborations.
Note
The support Chatbot is available in the Configure Collaboration app. For more information, see Chatbot.
Administration Guide
Business Configuration PUBLIC 197
Status Description
In Preparation When you create a collaboration type, this status is the de-
fault status until you change its status to In Use. A collabora-
tion type with status In Preparation is not available for use
when creating collaborations.
When you also edit and save a collaboration type, this status
is automatically assigned.
In Use Once you set a collaboration type to this status, the collabo-
ration type is available to use.
Status Profiles
Defining a status profile lets you create a status network for different business processes in collaborations. The
status profile that you set represents the entire processing cycle of a collaboration, from beginning to end. The
status network is formed by the relationship of one collaboration to another, as predecessor and successor.
Status profiles can be used to indicate the status of the whole collaboration as well as the processing status of
shared product data.
Every collaboration has a status that helps to show its progress with respect to the defined business process.
The statuses you define to form a status network let you set the collaboration status within a collaboration.
Field Description
Administration Guide
198 PUBLIC Business Configuration
You must map every status to a status type. A status type determines the action to be performed on a
collaboration. The following table describes the available status types:
Locked A status that allows no changes to a If set, only the user who created the
collaboration (if necessary, it can be collaboration can set the collaboration
set back to Initial or In Work status for back to Initial or In Work status from a
changes) locked status. All other users who are
a part of the locked collaboration only
have read permissions on the collabora-
tion. You are allowed to post comments
in a collaboration that's in the Locked
status.
Note
• It is mandatory to have two statuses in the status network, Initial, and In work or Locked mapped to the
Initial status type.
• The status profile can be changed only under these conditions:
• When a collaboration type is first created
• When the collaboration type is in the status In Preparation.
Once the status of collaboration type is changed to In Use, the associated status profile cannot be
changed.
• If you edit a status profile that is used in collaboration types, the changes are visible in the existing or
new relevant collaborations.
• When you create a collaboration, the collaboration is assigned the status mapped to the Initial status
type.
For more information about working with status profiles, see the following:
Processing Status
In a collaboration, users can share product data. To indicate in which phase of the process the given product
data collaboration is, a processing status can be set for each product data record.
This status is only valid for the product data record within the collaboration, and is not the status of the object
in the source system.
Each collaboration type can have a different processing status profile assigned. To define processing status
profiles, see Working with Status Profiles [page 183].
Administration Guide
Business Configuration PUBLIC 199
Example
As a company, you can ask external suppliers to fill in the specification templates for your item. The project
manager sets the processing status of each specification according to the defined profile, for example, to
Sent, Received, Reviewed.
Note
• It is mandatory to have two statuses in the status network, Initial and In Work or Locked mapped to the
Initial status type.
• The processing status profile can be changed only under these conditions:
• When the collaboration type is created for the first time.
• When the collaboration type is in the status, In Preparation
Once the status of collaboration type is changed to In Use, the associated processing status profile
cannot be changed.
• If you edit a processing status profile that's used in collaboration types, the changes are visible in the
relevant product data of collaboration type.
Use the Configure Collaboration app to work with collaboration type for collaborations.
Prerequisites
• You have the necessary roles and authorizations as mentioned in Role Templates for Collaboration [page
51].
• You have created the necessary status profiles. For more information, see Managing Statuses for
Collaboration [page 195].
Note
• Create the collaboration type DFLT. This collaboration type is applicable only for default storage.
• In the collaboration type DFLT, add PPX as the associated reference object.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. Choose Collaboration Type.
3. Choose Create.
Administration Guide
200 PUBLIC Business Configuration
4. Edit the fields as shown in this table:
Description Enter a description for the collabora- When you create a collaboration, the
tion type. description for the collaboration type
is displayed in the Type field.
Configure Tabs in Collaboration Type Enable or disable tabs: Based on the selection, show or hide
tabs for the collaboration type in the
Note Shared Product Data collaboration.
Administration Guide
Business Configuration PUBLIC 201
Field User Action Comments
Associated Workflows Select the relevant workflows and Based on the business purpose of a
process variants. collaboration type, you can associate
multiple workflows and process var-
iants with it. In a collaboration of
this collaboration type, these work-
flows and process variants are rec-
ommended when you want to add a
workflow.
Note
You can assign multiple workflows
to a collaboration type. Once the
status of a collaboration type is
changed to In Use, you cannot
unassign the workflows from the
collaboration type. But, you can
assign more workflows to the
same collaboration type.
Note
Only the workflows for which at
least one property is associated
within the Workflow Properties
app are displayed here.
Administration Guide
202 PUBLIC Business Configuration
Field User Action Comments
User Management Allow users to start workflow and work Readers of a collaboration can man-
items age the lifecycle of workflows or work
items that are created by them.
Note
When you set an action to
Editable, it locks the collabora-
tion. You can't modify it in this
state.
Admin Settings Allow Propagation to Visualization Allows design model files to be propa-
gated to a visualization.
Administration Guide
Business Configuration PUBLIC 203
Field User Action Comments
Enable document expiry for docu- Enter the number of days for the
ments within collaboration collaboration type in the Document
Expiry(Days) field.
Note
In custom storage, the number of
days for document expiry feature
is applicable for files and folders.
Allow override of document expiry day Allows user to change the document
during collaboration creation expiry days when creating a new Col-
laboration.
Note
The table on the Collaboration Type tab displays a new collaboration type with the status In Preparation.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
Administration Guide
204 PUBLIC Business Configuration
2. Choose Collaboration Type, choose Edit.
Restriction
The following table also shows the change in status after a collaboration type is edited:
In Preparation In Preparation
In Use In Preparation
Note
When you are making changes to the collaboration type, the status of the collaboration type goes from its
current status of In Use to the status In Preparation.
However, provided that the collaboration type has been set to the status In Use at least once in the past,
users can still continue to create a collaboration while the collaboration type is still in the In Preparation
status.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. Choose Collaboration Type, choose Delete.
Note
Administration Guide
Business Configuration PUBLIC 205
Ariba sourcing
For the Ariba sourcing use case, it is mandatory to create the collaboration type SRCE with below
configuration:
Field Information
Associated Reference Object The SRCE collaboration type to associate with the following:
• ARIBA
• COLLABORATION
• MATERIAL
Toolbar Buttons
The toolbar buttons that are available in the Collaboration Type main page. Select the required collaboration
type and choose the respective button:
Import You can import a list of collaboration • You can import a maximum of
types and their metadata. 1000 records.
Administration Guide
206 PUBLIC Business Configuration
Button User Action Comments
(Export) You can select a list of collaboration • When you export a collaboration
types to download and save the data to type, you download the informa-
a CSV file. tion associated to a collaboration
type such as: status profile, asso-
ciated workflows, associated ref-
erence objects, configure tabs,
admin settings and shared docu-
ments.
• Atleast one collaboration type
should be selected.
• The exported file that is down-
loaded to your local system.
Read about the differences between default and custom storage so that you know which storage type you need
when configuring collaboration types.
Context
A key element of a collaboration is managing and sharing files and folders with participants. Depending on your
ways of working with your documents, you need to choose the optimal storage type.
SAP Product Lifecycle Management offers the following different document storage types:
• Default storage: This storage type uses the SAP Document Management service embedded directly into
SAP Product Lifecycle Management. Default storage supports all available integrations for collaboration,
namely SAP Document Management service, SAP Engineering Control Center, SAP Ariba as well as
sharing of product data (PPX). However, the maximum size of a file is limited.
• Custom storage: This storage type uses the Object Store service on SAP BTP. Custom storage with
the Object Store service does not support integration with SAP Document Management service, SAP
Engineering Control Center, SAP Ariba or sharing of product data (PPX). It is suitable for large files that are
greater than 1 GB in size.
Recommendation
We recommend that you choose default storage if your scenario requires any of the available standard
integrations. We recommend that you choose custom storage if you plan to exchange very large files
through Collaboration that are either uploaded manually or through the available APIs.
It is also possible to use both storage types in parallel for different scenarios. You can configure the storage
type that you required within the collaboration type. It is also possible to link collaborations to each other.
Administration Guide
Business Configuration PUBLIC 207
This way one collaboration can be used to handle integration scenarios and a linked collaboration can be
used for the exchange or transfer of the (very) large files.
Default storage uses the SAP Document Management service. For more information, see What Is Document
Management Service. This service is embedded directly into SAP Product Lifecycle Management, which allows
you to access it without any additional configuration.
Key Features:
Custom storage uses the Object Store service on SAP BTP. It allows you to store and manage your business
documents. This service supports Infrastructure as a Service (IaaS) such as Azure Blob Storage, Amazon Web
Services. To use this service, you need to configure a destination. For more information, see Destination for
Custom Storage [page 129].
Key Features:
• No storage limitation
• Maximum data availability and scale efficiently for large files.
• Allows usage of storage provided by the hyperscaler's object store offerings.
Administration Guide
208 PUBLIC Business Configuration
When to choose Default Storage or Custom Storage?
• When you are working with smaller files. For more information, see Restrictions and Limits.
• When you are working with different versions of a file.
• When you are working with the other SAP products that are integrated with the Collaboration SaaS
application.
• When you are working with very large files and no standard integration or versioning is required.
Note
Depending on your business use case, choose the collaboration type with a suitable storage type. These
collaborations can also be linked to each other via reference object.
The following tables break down the features of the two storage types allowing easy comparison of their
attributes and the features supported for collaborations:
Storage Attributes
Storage Attributes Default Storage Custom Storage
Administration Guide
Business Configuration PUBLIC 209
Features Default Storage Custom Storage
Usability Features
Usability Features Default Storage Custom Storage
Integration
Integration Default Storage Custom Storage More Information
Note
For more information about the API, see the SAP Business Accelerator Hub .
For information about browser recommendations, see Browsers and Browser Settings [page 16].
Use the Configure Collaboration app to add, edit, or delete product and service categories, and supplier
locations.
As a solution administrator, you must configure product and service categories, and supplier locations, to allow
collaboration users to search for suppliers from SAP Ariba Supplier Lifecycle and Performance.
Administration Guide
210 PUBLIC Business Configuration
Prerequisites
• You have configured the connectivity from SAP Business Technology Platform to SAP Ariba by performing
the following steps:
1. Get an SAP Ariba APIs Account.
2. Follow the procedure section in the topic Register an Application in SAP Ariba Developer Portal.
Remember
• When creating the application, select the Supplier Data API With Pagination API with version 4.
• Store the application key in a safe place as you need it in a later step.
Remember
Store the client ID and client secret in a safe place as you need these details in a later step.
• You've configured the destination for connecting to SAP Ariba APIs. For more information, see Destination
for Connecting to SAP Ariba APIs [page 121].
Note
If this destination is not configured, the collaboration feature to add suppliers is not visible on the UI.
• You have performed the configuration to retrieve the supplier information when collaboration users search
for suppliers:
• To perform the configuration, see How to configure export fields for the Supplier Data API in SAP Ariba
APIs documentation.While configuring, from the list of configurable fields, select the following:
• PrimaryContact
• Qualification
Context
Supplier data refers to the information including product and service categories, and supplier locations. You
can configure your supplier data in two different ways:
• Upload a CSV file containing the list of product and service categories, or supplier locations with the
maximum file size of 20MB .
Caution
Administration Guide
Business Configuration PUBLIC 211
Adding Product and Service Category
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Supplier Data tab.
3. In the Product and Service Categories section, to configure the list of product and service categories, follow
one of the below options:
Option 1
1. To import a CSV file containing a list of product and service categories in the same order as mentioned
in the example below, choose Import.
Note
Example
• The header attributes must be entered in English and are validated for correctness.
• The product and service categories can be entered in any language of your choice, and are not
validated for correctness.
• You can only update a CSV file with a maximum file size of 20 MB.
• Do not enter any personal data in the CSV file. Data from the file is displayed on the UI when
searching for suppliers in collaborations.
• To view the existing data, choose (Export).
Administration Guide
212 PUBLIC Business Configuration
Option 2
2. To add a new list of product and service categories, choose Add.
In the Add Product and Service Category dialog, enter the following values:
Field
Segment
Segment Name
Family
Family Name
Class
Class Name
Commodity
Commodity Name
4. Save changes.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Supplier Data tab.
3. In the Product and Service Categories section. Choose a product and service category.
Select a product and service category to enable Edit and Delete buttons:
• To edit the product and service category, choose Edit.
• To delete the product and service category, choose Delete.
4. Save changes
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Supplier Data tab.
3. In the Supplier Locations section, to configure the list of supplier locations, follow one of the below options:
Option 1
1. To import a CSV file containing a list of your supplier locations, choose Import.
Administration Guide
Business Configuration PUBLIC 213
Note
• The header attributes must be Name and Code in the same order and case. You can refer to
the ISO code set for locations. The following is an example of the CSV file content.
Example
Name,Code
• The header attributes must be entered in English and are validated for correctness.
Argentina,AR Australia,AUS India,IN Sweden,SE.
• The supplier locations can be entered in any language of your choice, and are not validated for
correctness. It is left to your discretion to enter the locations correctly.
• You can only update a CSV file with a maximum file size of 20 MB.
• Do not enter any personal data in the CSV file. Data from the file is displayed as a suggestion
list when searching for suppliers in collaborations.
• To view the existing data, choose (Export).
Option 2
2. To add a new list of product and service categories, choose Add.
In the Add Supplier Location dialog, enter the following values:
Field
Name
Code
4. Save changes.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Supplier Data tab.
3. In the Supplier Locations section. Choose the supplier location.
Select a supplier location to enable Edit and Delete buttons:
• To edit the supplier location, choose Edit.
• To delete the supplier location, choose Delete.
4. Save changes.
Use the Configure Collaboration app to create, edit, or delete custom reference objects. The standard reference
objects that belong to the object types Collaboration, Specification, Requirements, Change Record, Product
Administration Guide
214 PUBLIC Business Configuration
Package Exchange (PPX), Configuration Management Baseline, Specification Management, Product Version,
and Formulation cannot be edited. Reference objects that are added as associated references to any of the
collaboration types cannot be edited or deleted.
Prerequisites
You must be assigned to the COLLABORATION_ADMIN group as mentioned in the Role Templates for
Collaboration [page 51].
Context
Reference objects are entities that are defined for a business object. There are two types of reference objects:
• Custom reference objects: Custom reference objects can be added as needed, based on your business
requirements by your collaboration administrator, using the Configure Collaboration app.
• Standard Reference Objects
The following table displays the preshipped reference objects and the values for their key and non-key
fields:
Key2: DESCRIPTION
Key2: DESCRIPTION
Key4: DIAGRAMREPOSITORYID
Key5: PRIORITY
Key6: DESCRIPTION
Key2: DESCRIPTION
Key3: TYPE
Key4: SYSTEM
Administration Guide
Business Configuration PUBLIC 215
Reference Object Key Field Non-Key Field
CONFIG_MGMNT_BASELINE Key1: GUID (The value is hidden to the Non-Key1: Baseline Description
users)
Non-Key2: Controlled Object
Key2: Baseline ID
Non-Key3: Controlled Object Descrip-
Key3: Baseline Version tion
SPECIFICATION_MANAGEMENT Internal ID: UUID (The value is hidden Non-Key1: NAME (The value is hidden
to the users) to the users)
Key2: Product ID
Key3: Version
Key2: Alternative
Key3: Version
Key2: ID
Key4: Alternative
Key5: Version
Administration Guide
216 PUBLIC Business Configuration
Creating a Reference Object
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Reference Objects tab, choose Create.
The page displays with the header data, keys, and non-keys tabs.
3. On the Header Data tab, to create a reference object enter the following values:
Reference Object Enter an object type with a maximum The following special characters are
length of 30 characters. allowed: underscore (_), dash (-), or
space (" ").
Navigation URL Enter a URL that uses one of these For the URL to navigate to a custom
protocols: http, https, or ftp. reference object, note the following:
• Example
https://<basepath>.<do-
main>/?<param-
name1>={key1}&<param-
name2>={key2}&<param-
name3>={key3}&<param-
name4>={key4}&<param-
name5>={key5}&<param-
name6>={nonkey1}
Administration Guide
Business Configuration PUBLIC 217
Column User Actions Comments
Fields You can enter up to 6 keys. It's mandatory to enter a key. A maxi-
mum of 6 keys are allowed.
Value Enter any value for keys. Hypertext does not support place-
holders.
Data type Select text or hypertext as re- Default data type is text.
quired.
Note
• You can delete the value that was added only if the particular reference object is not used in any
collaboration.
7. To configure your preferences for keys with a hypertext Data Type, enter the following values:
Field Comments
Administration Guide
218 PUBLIC Business Configuration
Field Comments
Enter a valid URL Enter a URL that uses one of these protocols: http, https,
or ftp.
Note
Ensure that both fields are either filled or left empty,
and partial entry into one field is not allowed.
Your users see the default hypertext value in the Reference Objects of the My Collaborations app.
Fields Enter any free text. Only 10 non-key fields are allowed.
• Non-keys are optional.
• Non-key fields have to be in se-
quence.
For example:
• Non-Key1 is created by
• Non-Key2 is modified by
• Non-Key3 is a description
Data type Select text or hypertext as re- Default data type is text.
quired.
9. To configure your preferences for non-keys with a text Data Type, on the Preferences tab choose one of the
below options:
• To enable users to enter free text value for non-keys, choose Allow users to enter custom value.
• To enable users to select a single value for non-keys, choose Allow users to select only one value.
To make it easier for your users to select one value for reference object on the Reference Objects of the
My Collaborations app you can add values on the Selection Values tab.
Administration Guide
Business Configuration PUBLIC 219
Note
• You can delete the value that was added only if the particular reference object is not used in any
collaboration.
10. To configure your preferences for non-keys with a hypertext Data Type, enter the following values:
Field Comments
Enter a valid URL Enter a URL that uses one of these protocols: http, https,
or ftp.
Note
Ensure that both fields are either filled or left empty,
and partial entry into one field is not allowed.
Your users see the default hypertext value in the Reference Objects of the My Collaborations app.
You edit a reference object. The reference objects that are added as associated references to any of the
collaboration types cannot be edited.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Reference Objects tab, choose in the navigation panel.
3. Choose Edit.
The page displays with the header data, keys, and non-keys tabs.
4. Edit the following values:
Reference Object Enter an object type with a maximum The following special characters are
length of 30 characters. allowed: underscore (_) and en dash
(-).
Administration Guide
220 PUBLIC Business Configuration
Field User Action Comments
Select Language Define a reference object only in Eng- The selected language is added to
lish. the Display Language list. For more in-
formation, see Filtering Texts by Lan-
Select the language that you want
guage [page 231].
to use for the translation. For the
information about the supported lan-
guages, see Overview [page 7].
Navigation URL Enter a URL that uses any of these • The navigation URL is not a man-
protocols: http or https or ftp datory field.
• The navigation URL is case sensi-
tive.
• Both keys and non-keys are valid
placeholders.
• The key value which is used to
reference associated value of the
key.
• Example
https://<basepath>.<do-
main>/?<param-name1>={
key1}&<param-name2>={
key2}&<param-name3>={
key3}&<param-name4>={
key4}&<param-name5>={
key5}&<param-name6>={
nonkey1}
Value Enter any value for keys. Hypertext does not support place-
holders.
Administration Guide
Business Configuration PUBLIC 221
Column User Actions Comments
Select Language Select the language that you The selected language is added to
want to use for the transla- the Display Language list. For more in-
tion. For the information about formation, see Filtering Texts by Lan-
the supported languages, see guage [page 231].
Overview [page 7].
Data type Select text or hypertext as re- Default data type is text.
quired.
Value Enter any value for non- keys. Hypertext does not support place-
holders.
Administration Guide
222 PUBLIC Business Configuration
Column User Actions Comments
Select Language Select the language that you The selected language is added to
want to use for the transla- the Display Language list. For more in-
tion. For the information about formation, see Filtering Texts by Lan-
the supported languages, see guage [page 231].
Overview [page 7].
Data type Select text or hypertext as re- Default data type is text.
quired.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Reference Objects tab, choose the reference object.
3. Choose Delete.
Use the Configure Collaboration app to configure daily notification and deletion jobs. This is applicable only for
default storage.
Prerequisites
You must be assigned to the COLLABORATION_ADMIN group to have the authorization to create a job scheduler
as mentioned in the prerequisites in Business Configuration for Collaboration [page 191].
Administration Guide
Business Configuration PUBLIC 223
Context
You can schedule a job to create or delete the daily notification frequency option for participants in a
collaboration.
You can schedule a job to delete files and folders that are older than a certain number of days in a collaboration.
Creating a Job
You can create a job for sending the daily notification and deletion of files and folders.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Job Scheduler tab.
• Choose Notifications tab, choose Create.
Enter values in the fields as follows:
Schedule Daily
Schedule Time Enter the time at which the job should run daily.
Scheduled Start Time Enter the date and time when the job should run.
Enter values in user's local time for the schedule time, scheduled start time, and scheduled end time
fields.
Note
The daily notification frequency option is enabled for the participants in the My Collaborations app,
only if you have added a Job Scheduler.
Administration Guide
224 PUBLIC Business Configuration
Step Fields Additional Instructions
Scheduled start time Enter the data and time when the
job should run.
Administration Guide
Business Configuration PUBLIC 225
Step Fields Additional Instructions
Example
The following examples ex-
plain how some sample condi-
tions would be handled in the
deletion run:
• All collaborations that
match any of the key-
words entered for one
condition type. For exam-
ple, to delete all collabora-
tions that have "COLLAB"
at the beginning of their
name, you select "starts
Administration Guide
226 PUBLIC Business Configuration
Step Fields Additional Instructions
Administration Guide
Business Configuration PUBLIC 227
Step Fields Additional Instructions
Editing a Job
You can only edit a job scheduled for deleting files and folders in a collaboration.
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Job Scheduler tab.
3. Choose the Deletion tab.
4. Choose the job you want to edit, choose Edit.
Deleting a Job
Administration Guide
228 PUBLIC Business Configuration
1. From the SAP Fiori launchpad, open the Configure Collaboration app.
2. On the Job Scheduler tab.
3. Choose the job you want to delete, choose Delete.
Users with the UI5 flexibility role can customize user interface controls using Adapt UI in the user profile and
manage views (public variant) in the My Collaborations app.
Features
Adapt UI
The Adapt UI feature is shown in the user profile in My Collaborations app, only if the user has FlexKeyUsers
role authorization.
Public Variant
• Public views (variant) can be visible only to the key users, to create filter and table views available for all
authorized end users.
• For saving variants, key users can save the view to Public and this will be available within Manage Views
dialog.
• The Manage Views (public variant) option is available only in the My Collaborations app.
Note
The public variant feature is not supported for reference objects in the My Collaborations app.
Users with the UI5 flexibility role can customize using "Adapt UI" available in user profile and Manage views
(public variant) in the My Collaborations app. A key user can make UI changes and publish on behalf of end
users.
Prerequisites
To use flexibility features, you must have assigned FlexKeyUser role. For more informaton, see Role
Templates for Collaboration [page 51].
Administration Guide
Business Configuration PUBLIC 229
Note
Key users must have an understanding about the application and apply the changes cautiously.
• Restricting access to any UI controls is not available. Hence, it is the key user's responsibility to make
changes carefully. After applying changes, if the error appears, you can revert to the default view on UI.
• Removing any mandatory field from the UI will result in a validation error.
• The "Adapt UI5" feature is only supported for static UI5 controls with stable ids.
• If you want to add the URL link to the embedded content, you would require certain preconditions and
security standards.
For more information on editing embedded content, see Embedding Content
For more information on UI5 flexibility for key users, see What Is UI5 Flexibility for Key Users?
Use this procedure to enable the Model Object Assignments feature in a collaboration for users.
Prerequisites
You have the necessary roles and authorizations as subaccount administrator to manage the role collections
and destinations.
Context
By integrating with the Requirement Engineering and System Modeling SaaS application, you can also add
requirements to collaborations. When a participant creates a requirement in the Requirement Engineering
and System Modeling app, the requirement can be linked to a collaboration and worked on it as a reference
object in the My Collaborations app. To enable this feature, you need to configure a destination. For more
information see Destination for Model Object Assignments [page 126]. Your business users see the Model
Object Assignments button in the collaboration header section.
Procedure
1. Assign any of the EADesigner roles to users who need access to this feature. For more information, see
Role Templates for Engineering [page 67].
For steps on how to assign the role to users, see Assign Users to Role Collections.
2. Create the destination EPD_EAD_COLLABORATION.
For steps on how to create the destination, see Destination for Model Object Assignments [page 126].
Administration Guide
230 PUBLIC Business Configuration
8.2.6 Filtering Texts by Language
Prerequisites
Context
Your business user sees the texts in the configured language other than the default language. You can configure
the preferred language from the list of supported languages.
Note
In addition to the Manage Statuses app, you can use this feature in the Configure Product Package
Exchange app, the Workflow Properties app, and the Configure Collaboration app in the Collaboration SaaS
application.
Procedure
1. From the SAP Fiori launchpad, open the Manage Statuses app.
2. Choose Display Language, on the configuration page of the app.
• You see the translated texts in the preferred language.
• For more information about the supported languages, see Overview [page 7].
3. The selected language is highlighted bold in the Display Languages column.
4. Save your changes.
Results
The configured rows are highlighted bold in the preferred language, if the user wants to see the texts in a
different language other than default language.
Related Information
Administration Guide
Business Configuration PUBLIC 231
Configure Product Package Exchange [page 289]
Working with Status Profiles [page 183]
To achieve the goal of a business process, you can model workflows.You can use forms to model the user
interfaces for the My Collaborations and My Inbox apps used in the workflow. You can set up the workflow
for use in a collaboration. Your business users can then process the tasks contained in the workflow for the
collaboration.
Prerequisites
• You have subscribed to the SAP SAP Business Application Studio. For more information, see What is SAP
Business Application Studio?.
• You have configured the destination for email notifications with the additional property
mail.epdc.participant.invite set to true. For more information, see Destination for Email
Notifications Using SMTP APIs [page 116].
Context
If you enter workflowDueDate as the property in the Workflow Properties app. Your business users will see the
due date for the workflow in the Due Date column on the Work Items tab. For more information, see Work Items.
Note
This topic outlines the general process for creating a workflow and provides links to detailed instructions
and information at each step.
Procedure
1. To model a workflow, you must first create a workflow module. See Create a Workflow Module.
2. Next, you need to define the workflow. SeeDefine Workflows.
Consider the following points when defining a workflow:
Administration Guide
232 PUBLIC Business Configuration
• When configuring a user task in the workflow, enter these values in the component information:
Property Value
Note
• To send emails to one or more recipients, configure mail tasks. See Configure Mail Tasks.
• In the workflow editor, in the Workflow Properties panel, ensure that you have the following values
configured:
Important: Without this configuration, the workflow feature does not work in collaborations.
Caution
Do not add the subject and business key values in the Workflow Properties app that is part of the
Collaboration cloud service for SAP Product Lifecycle Management.
3. For information about how to define workflow properties in workflow tasks, see Expressions.
4. Next, ou build the workflow module. See Build and Deploy the Workflow Module.
5. For information about how to use decisions in the workflows, see Creating and Reading Workflow Context
Structures. Use following code in the script task:
Sample Code
$.context.<usertask> = {
action:{
approve:{
text:"Approve Changes",
type:"Accept" //Either Accept or Reject
},
reject:{
text:"Reject",
type:"Reject" //Either Accept or Reject
}
}
};
Administration Guide
Business Configuration PUBLIC 233
The <usertask> is the ID of the task that you want to apply to a decision button.
Note
• The text and type attributes can be changed according to your business requirements.
• The texts that are used as labels for the decision buttons are not translated.
Example
You must configure a workflow definition so that email notifications are sent to the participants in a
collaboration when the following events occur:
Add adhoc work items To add users to the work SAP_EPD_ADHOC_WI_DE Enabling collaboration partic-
items F ipants to add ad hoc work
items to collaborations.
Notification Mails To add registered users to EmailInviteWorkflow Enable this option to add reg-
the collaborations as partici- istered users as participants
pants to a collaboration. You have
the option of sending notifi-
cation mails to them.
Administration Guide
234 PUBLIC Business Configuration
Type Purpose Name Description
To get e-mail notifications for Event Notification Enable this option for partic-
collaboration status changes ipants to receive e-mail noti-
fication for collaboration sta-
tus changes.
Note
If you have configured
recipientGroups as
the property and
UserGroup as the
property value in the
Workflow Properties app.
Your business users
would receive an e-mail
notification for collabo-
ration status changes.
For more information,
see Workflow Properties
[page 238].
Note
To see the configuration steps and download the workflow definition templates for SAP Product Lifecycle
Management, see SAP Note 3060483 .
Administration Guide
Business Configuration PUBLIC 235
Do not delete the workflows from your subaccount: SAP_EPD_ADHOC_WI_DEF,
EPDC_DOCUMENT_CHANGES_CONSOLIDATED_NOTIFICATION .
You must perform the following configuration to send notification mails to participants when working with
collaborations:
Note
To see the configuration steps and download the workflow definition templates for the Collaboration SaaS
application of SAP Product Lifecycle Management, see 3060483 .
• To send invitation mails to first-time users when added to collaborations, see Invitation Mails to First-Time
Users [page 236].
• To send email notifications to registered users when they are added as participants to collaborations, see
Modeling Workflows [page 232].
Invitation mails can be sent to participants when they are first-time users and are added to collaborations. A
default mail template provided by SAP is used to send invitation mails.
Prerequisites
Note
If the prerequisites mentioned are not met, invitation mails are not sent to first-time users to register with
the application and access the collaboration.
Procedure
1. The invitation mail uses a default HTML mail template provided by Identity Authentication service. The mail
format is as follows:
Administration Guide
236 PUBLIC Business Configuration
Example
Dear User,
The link to register with the application is present in <Click here to accept>.
2. To customize the mail template with different language versions, see Configuring E-Mail Templates.
Remember
Customize the template for the Invitation option in Identity Authentication service.
Prerequisites
Subscribe to the SAP Build Process Automation service. For more information see Subscribe to SAP Build
Process Automation (Standard Plan).
Context
Starting with the July 2024 delivery of SAP Product Lifecycle Management, it is mandatory for you to migrate
from SAP Workflow Management service to SAP Build Process Automation if you want to continue viewing
existing workflows, creating new workflows for collaborations.
You can either continue to deploy workflow definitions from SAP Business Application Studio to a service
instance of the workflow capability or you can deploy to a service instance of SAP Build Process Automation.
Note
This is applicable for both SAP Enterprise Product Development and SAP Product Lifecycle Management
systems.
Follow the procedure to migrate from SAP Business Application Studio service to SAP Build Process
Automation service.
Administration Guide
Business Configuration PUBLIC 237
Procedure
1. Configure a destination to import live process projects. For the detailed steps, see Configure Destination
for Live Process Projects.
2. Adapt your bpmworkflowruntimeoauth destination. For the detailed steps, see Adapt the
bpmworkflowruntimeoauth Destination.
3. Assign the necessary roles and authorizations. For the detailed steps, see Authorizations.
4. Transition to SAP Build Process Automation.
5. Import a visibility scenario from process visibility capability to SAP Build Process Automation service. For
the detailed steps, see Move your workflow management packages to SAP Build Process Automation. For
the detailed steps, see Transition to SAP Build Process Automation.
6. Move your business rule projects to SAP Build Process Automation. For the detailed steps, see Transition
to SAP Build Process Automation.
Results
When the migration is complete, the workflows inside My Collaborations app work as expected, and there is no
impact on business users. All workflow instances and tasks have been automatically migrated.
You can use the Workflow Properties app to configure the workflow properties that were defined in the
workflows.
Prerequisites
You have modeled workflows and defined properties in the workflow tasks. For more information, see Modeling
Workflows [page 232].
Administration Guide
238 PUBLIC Business Configuration
Fields Relevant for Workflow Properties
A workflow task (work item) has properties such as description, recipient user, and recipient groups. You must
define these properties when creating a task. To simplify the process of configuring values for these properties,
you can use the Workflow Properties app. In this app, a workflow property is defined by the following fields:
Workflow Property Name of the workflow property exactly If you enter workflowDueDate as
as defined in the workflow. the property, to prevent possible in-
consistencies, the Property Value field
and the Assign Users to Business
Role checkbox are hidden. The Allow
Changes at Runtime checkbox is se-
lected and the value can't be changed.
Default Property Value A default value for the workflow prop- If you do not enter a value in Property
erty. Value, the value entered in Default
Property Value is used. This will be sup-
ported in the future release.
Allow Changes at Runtime An option, when enabled, to allow If you enable this option, you must
changes to the property value when the enter a value for Property Value
workflow is triggered in a collaboration. Description. This value is displayed as
the label of a mandatory field when
adding the workflow in a collaboration.
Assign Users to Business Role An option, when enabled, that allows If you enable this option, you must
you to assign users to the business role enter a value for Property Value
when adding the workflow to a collabo- Description. This value is displayed as
ration. For more information about this the name of the business role when
field, and business roles, see Business adding the workflow in a collaboration.
Roles [page 242].
The following entities are available for use in expressions in the field Property Value.
Administration Guide
Business Configuration PUBLIC 239
Sl. No. Entity Expression Format Attribute Note
modifiedAt -
CreatedAt -
ID Collaboration ID
Administration Guide
240 PUBLIC Business Configuration
Sl. No. Entity Expression Format Attribute Note
participantId
2 Collaboration/contrib- • Collabora- Examples:
utors tion/contribu-
• Collabora-
tors<attribute EQ
tion/contribu-
value>
tors/participan-
• Collabora- tId.
tion/contribu-
tors/attribute Note
• Collabora-
If you are not
tion/contribu-
adding any at-
tors<attribute EQ
tributes, SAP
value>/attribute
recommends
• Collabora- that you al-
tion/contribu- ways specify
tors<attribute NE the attribute
value>/attribute Type:
• Collabora- UserGroup or
tion/contribu- Member for
tors<attribute EQ Collabora-
value || attrib- tion/contrib-
ute EQ value>/ utors/partici-
attribute pantId.
• Collabora-
• Collabora-
tion/contribu-
tion/contribu-
tors<attribute EQ
tors<Role EQ
value && at-
Administrator ||
tribute EQ value>/
Role EQ Contribu-
attribute
tor>/participantId
• Collabora-
tion/contribu-
tors<Role EQ
Administrator ||
Role EQ Contrib-
utor && Type EQ
Member>/partici-
pantId
Role Collaboration/contrib-
utors<Role EQ Admin-
istrator>/participantId
Administration Guide
Business Configuration PUBLIC 241
Sl. No. Entity Expression Format Attribute Note
Examples:
• Collabora-
tion/contribu-
tors<Type EQ
Member>/partici-
pantId
• Collabora-
tion/contribu-
tors<Type
EQ UserGroup>/
participantId
Note
The default value
for a user group,
must match with
the name of the
user group defined
in the Manage
Teams app.
Note
Business Roles
A business role represents a group of users who perform similar functions in your organization. To indicate
whether a workflow property is a business role, you must enable the option Assign Users to Business Role.
Note
It is left to your discretion to name your business roles using the Property Value Description field.
Administration Guide
242 PUBLIC Business Configuration
The following depicts an example of a workflow property that is related to a business role:
Example
You have defined and deployed a workflow named DocumentReview to be used in collaborations. You
have created a workflow task in the workflow, and defined a workflow property as sDesignEngineer. To
configure a value for this property, create an entry in the Workflow Properties app as follows:
Field Value
The value you maintain in the Property Value Description is displayed as the name of the business role when
adding the workflow in a collaboration. You can then assign users to the business role from the list of available
participants. For information about adding workflows in collaborations, see Adding a Workflow in the User
Guide for Collaboration.
This section provides you with information on how to create, edit and, delete workflow properties.
Prerequisites
1. From the SAP Fiori launchpad, open the Workflow Properties app.
2. On the Workflow Properties tab, choose (Create Workflow Property).
3. Edit the fields as described in the following table. For examples and more information about the fields, see
Workflow Properties [page 238].
Administration Guide
Business Configuration PUBLIC 243
Field User Action
Workflow Property Enter the name of the property as defined in the workflow
task.
Note
Enter free text within double quotes.
Allow Changes at Runtime Enable the option to allow changes to the property value
when the workflow is triggered in a collaboration.
Assign Users to Business Role Enable the option to use the Property Value Description
field as a business role. For more information, see Busi-
ness Roles [page 242].
Note
Workflow properties aren't validated for correctness. Hence, you must ensure that the property name
entered in Workflow Property is as defined in the workflow.
Note
• By default, the workflow properties when created are sorted in alphabetical order.
• Only workflows for which atleast one property is set within the Workflow Properties application are
relevant for collaboration.
• Once workflow is associated to a collaboration type, then the workflow properties cannot be
deleted.
• When you set Purpose as workflow property with the property value as lockedCollaboration,
enables your business users to work with workflows even when the collaboration in the Locked
state.
Administration Guide
244 PUBLIC Business Configuration
Editing a Workflow Property
Note
Note
Use the Workflow Properties app to add and edit context labels for workflows or work items. You can also delete
context properties if needed.
The context in a workflow or work item definition contains properties. To make it easier for your business users
to work with these properties, you can add labels for them in different languages as needed. Your business
users see the labels that you have configured for the context properties in the My Collaborations app.
Prerequisites
1. From the SAP Fiori launchpad, open the Workflow Properties app.
2. On the Context Properties tab, choose Add.
3. In the dialog that opens, enter the following values:
Administration Guide
Business Configuration PUBLIC 245
Field Values to Be Entered
Context Property Enter the technical name of the context property as defined in the workflow task.
The technical name of the context property follows this pattern: "workflow.status.en-
tityName".
Context Label Enter the label text that you want your business users to see.
The default language for creating labels is English. You can only change the language
and translate the label by editing the context property.
The table on the Context Properties tab displays the list of workflow items with the property values.
You edit the context label for a workflow or a work item when you want to translate the label text into different
languages.
1. From the SAP Fiori launchpad, open the Workflow Properties app.
2. On the Context Properties tab, choose (Edit Context Property Label).
3. In the dialog that is displayed, enter the following values:
Select Language Select the language that you want to use The selected language is added to the
for the translation. Display languages list. For more informa-
tion, see Filtering Texts by Language [page
The following languages are supported:
231]
• English
• German
• Spanish
• French
• Simplified Chinese
Administration Guide
246 PUBLIC Business Configuration
Field Values to Be Entered Comments
Select Language Select the language that you want to use The selected language is added to the
for the translation. For the information Display languages list. For more informa-
about the supported languages, see Over- tion, see Filtering Texts by Language [page
view [page 7]. 231]
The next time that your business users open the My Collaborations app, they will see the translated label for the
context properties.
1. From the SAP Fiori launchpad, open the Workflow Properties app.
2. On the Context Properties tab, choose (Delete Context Property Label) .
3. Confirm the warning.
The context property with the selected label in the configured languages is deleted.
You can configure process flows using process variants to meet your changing business environment, stay
compliant, improve the experience of the people involved, and improve process efficiency.
SAP Workflow Management allows you to configure your process flows using process variants. Once you
activate the process variants and perform the required configuration, your users can then add them in
collaborations the same way as workflows.
Administration Guide
Business Configuration PUBLIC 247
Procedure
1. To activate the process variant, follow the steps described in Configure a Process Variant.
2. Configure the workflow properties defined in the workflows of the process variant. For more information,
see Workflow Properties [page 238].
3. Add the process variant as an associated workflow to a collaboration type. For more information, see
Working with Collaboration Types [page 200].
When a collaboration is created using the relevant collaboration type, the process variant can be added as
a workflow in the collaboration. For more information, see Work Items in the User Guide for Collaboration.
Related Information
Using the Configure Product Data app, you can enter the SAP S/4HANA systems and product data needed to
collaborate with suppliers on product data within a collaboration.
Original equipment manufacturers (OEMs) want to be able to share product data information (bills of material)
available in SAP S/4HANA with participants in a collaboration, so that the participants from different suppliers
can check the BOM details and provide their feedback to the OEM as redlines. Before this can happen, you
must have configured the SAP S/4HANA systems needed to establish the connection between SAP S/4HANA
and Collaboration.
• Configure the SAP S/4HANA systems from which you want to retrieve product data (object) for inclusion
in the collaboration.
• Configure the type of object (product data) that you want to retrieve from the SAP S/4HANA system to the
collaboration.
To configure product data, follow the steps to create the destinations as described in before proceeding to
configure the systems and objects.
For information on working with product data in a collaboration, see Collaborating on Product Data.
Administration Guide
248 PUBLIC Business Configuration
Configuring URL Definitions [page 255]
Configure the URLs for combinations of object types and source systems.
Collaboration participants who do not have users in the source system must still be able to view and perform
operations on product data in collaborations. To make this possible, perform the following configuration steps.
To retrieve product data from any of your source systems into collaborations, you need to add a destination for
your source system.
• If your source system is a cloud system, add a destination according to the communication arrangement.
• If your source system is an on-premise system, add a destination for the Cloud Connector.
Note
If you require support or encounter any technical issues while configuring the Cloud Connector, contact
SAP by reporting an incident on the Support Portal under the component BC-MID-SCC.
Note
Destination titles should be prefixed with EPD_S4HANA_ for collaboration applications to function.
Administration Guide
Business Configuration PUBLIC 249
Configure HTTP destinations to connect to an SAP S/4HANA system through HTTP(s) as mentioned below:
1. For every SAP S/4HANA system that you want to retrieve product data from, you must create a destination
using the details mentioned in the following table. It is left to your discretion to select the authentication
type of the destination.
Recommendation
We recommend that you create the destination with principal propagation authentication.
AdditionalProper-
Name Type URL Proxy Type Authentication ties
Configure the system using destinations. The configured systems are made available in collaborations to
retrieve product data.
Prerequisites
• You have configured the destinations for the source system, that is, SAP S/4HANA systems.
• You have launched the Configure Product Data app from the SAP Fiori launchpad.
Administration Guide
250 PUBLIC Business Configuration
Adding a System
Editing a System
Deleting a System
Note
URL and objects related to systems should be deleted first (sequence to delete is URL, objects, and
systems).
(Delete).
The configured system is only deleted from the Configure Product Data app but not from the source
system.
Administration Guide
Business Configuration PUBLIC 251
8.2.10.3 Configuring an Object Type
You configure the type of object (product data) that you want to retrieve from the configured source system to
collaborations.
Prerequisites
• You have configured the source systems or the on-premise back-end systems using the destinations. For
more information, see Prerequisites for Configuring Product Data [page 249].
• You have valid services for retrieving product data. For more information, see OData Services [page 252].
Related Information
Each object type in the Configure Product Data app is associated with an OData service.
The OData service for bills of material (BOM) and order bills of material (Order BOM) are
API_BILL_OF_MATERIAL_SRV and API_ORDER_BILL_OF_MATERIAL_SRV, respectively.
For information on other published services, see SAP API Business Hub .
Based on the available service, API_BILL_OF_MATERIAL_SRV, you can define object types using the details
mentioned in the following table.
For steps to add an object type, see Adding an Object Type [page 254].
Administration Guide
252 PUBLIC Business Configuration
Field Value Note
Object Type Name Enter a name as required. The Object Type Name you define is
displayed as an entry in the Product
Data field in collaborations. Your users
can select this entry to search for this
type of product data from the source
system that you have configured in the
System tab
Path /odata/SAP
Based on the available service, API_ORDER_BILL_OF_MATERIAL_SRV, you can define object types using the
details mentioned in the following table.
Object Type Name Enter a name as required. The Object Type Name you define is
displayed as an entry in the Product
Data field in collaborations. Your users
can select this entry to search for this
type of product data from the source
system that you have configured in the
System tab
Path /odata/SAP
Configure object types (product data) to allow your users to retrieve product data records of those object types
from the configured source system, into collaborations.
Prerequisites
You have launched the Configure Product Data from the SAP Fiori launchpad.
Administration Guide
Business Configuration PUBLIC 253
Adding an Object Type
Note
• The Object Type Name you define is displayed as an entry in the list of product data to add to
a collaboration. Your users can select this entry to search for this type of product data from the
source system.
• For the field Service Name, select the service as configured in the destination. For example, for the
bills of material (BOM) object type, the service is API_BILL_OF_MATERIAL_SRV and for order bills
of material (Order BOM), the service is API_ORDER_BILL_OF_MATERIAL_SRV.
• The field Root Entity displays the root entities based on the service.
Note
The sequence to delete is URL first and then product data from collaborations.
(Delete).
The configured object is only deleted from the Configure Product Data app, and not from the source
system.
Administration Guide
254 PUBLIC Business Configuration
8.2.10.4 Configuring URL Definitions
Configure the URLs for combinations of object types and source systems.
When collaborating on product data in collaborations, you can view the details of the product data in the source
system. To enable this feature, you must configure the navigation URL for a combination of an object type and
the source system.
Note
Access to viewing product data in the source system depends on the authentication and authorizations of
the user in the source system.
Prerequisites
• You have configured the source systems or the on-premise back-end systems. For more information, see
Prerequisites for Configuring Product Data [page 249] and Configuring a System [page 250].
• You have valid OData services for retrieving product data. For more information, see .
• You have configured the object types for retrieving product data from the source systems into
collaborations. For more information, see Working with Object Types [page 253].
Note
A solution administrator has the discretion to add a URL definition, either bona fide or otherwise.
1. In the Configure Product Data app, choose the URL Definitions tab.
2. Choose (Add URL Definition).
3. Select the object type and system.
4. Enter the URL that is required for viewing product data of the selected object type from the source system.
The URL has the following pattern:
<External_System_Host_URL>?sap-client=<sap-client>#<semanticObject>-<action>?
sap-app-id=<sap-app-id>&//<C_CDS_View>(<AttributeName1>=’$<AttributeName1>$’,
<AttributeName2>=’$<AttributeName2>$’,…)
where
Administration Guide
Business Configuration PUBLIC 255
<semanticObject>-<action> Bill of Material -Read
and the attribute names are the names of the fields in the service metadata (linked
to the object type).
Example
<External_System_Host_URL>?sap-client=790#MaterialBOM-maintenance?sap-app-
id=pise.mi.plm.bom.mbom.0001&//
C_BillOfMaterialTP(BillOfMaterial='$BillOfMaterial$',BillOfMaterialCategory='
$BillOfMaterialCategory$',BillOfMaterialVariant='$BillOfMaterialVariant$',Bil
lOfMaterialVersion='$BillOfMaterialVersion$',EngineeringChangeDocument='$Engi
neeringChangeDocument$',Material='$Material$',Plant='$Plant$',DraftUUID=guid'
00000000-0000-0000-0000-000000000000',IsActiveEntity=true)
Note
The navigation URL is validated only for a URL format, and not for correctness.
1. In the Configure Product Data app, choose the URL Definitions tab.
2. For the URL definition that you want to edit, choose (Edit).
3. Edit the navigation URL and save your changes.
Note
The navigation URL is validated only for a URL format, and not for correctness.
Administration Guide
256 PUBLIC Business Configuration
Deleting a URL Definition
Note
If you delete a URL definition, the feature in a collaboration that allows you to view the relevant product
data details in the source system is disabled.
1. In the Configure Product Data app, choose the URL Definitions tab.
2. Delete a URL definition by choosing (Delete).
3. Confirm the warning message.
Note
The specification exchange scenario works with APIs that are available in the following SAP S/4HANA On-
Premise releases: 2020 or later, 1909, and 1809. The scenario can also work with Enhancement Package 8
of SAP ERP.
Prerequisites
Before you can configure provisional specifications, you must do the following:
• Set up the destination for your source system. For more information, see Destination for Collaborating on
Specifications [page 123].
• Set up users within Collaboration for the specification exchange scenario. For more information, see Role
Templates for Collaboration [page 51].
• Register the specification-related API services and the Characteristic Data for Classification API service
in your source system. For more information about the specification-related APIs, see Specification APIs
for Recipe Development and 3117894 . For more information on how to configure the Classification API
for EPD, see 3145055 .
• Check if you need to apply any SAP Notes based on the following collection: SAP Notes for the
Specification Exchange Scenario [page 288].
Procedure
The recommended order for performing the administrative tasks for configuring the specification exchange
scenario is as follows:
Administration Guide
Business Configuration PUBLIC 257
1. Set the relevant customizing activities in your source system.
For an S/4HANA On-Premise system, you can find the customizing activity Define Settings for
Specification APIs under Logistics - General Product Lifecycle Management (PLM) PLM Web
User Interface Recipe Development Specification Management Specification Additional Information
for Value Assignment Specific Settings for Recipe Development . For more information, first consult the
documentation of the customizing activity, and then the API documentation: Specification APIs for Recipe
Development. For setting up the standard composition items (nutrients, allergens, and pure substances)
properly, see the section Setting Up Standard Composition Items [page 260].
You can also find useful information in the following video:
2. In the Load Value Sets for Specification app, load the values from your source system, see Loading Value
Sets [page 259]. For information on how to set up your value sets to be able to load them, see Useful
Information for Value Sets [page 259].
Note
The first time you do this, it may take time for the values to load. Later, when you are just updating the
values, the process should be quicker.
3. In the Configure Provisional Specifications app, define property groups. For more information, see Handling
Properties and Property Groups [page 262].
4. (Optional) In the Configure Provisional Specifications app, you can add additional information for suppliers
for every property. For more information, see Long Text Information [page 264].
5. Still in the Configure Provisional Specifications app, create at least one template. Templates are custom-
defined views where you can decide which compositions and properties are available for a provisional
specification. For more information, see Defining Templates [page 265].
Note
Your product developer may need multiple templates based on the set of data they need to request
from suppliers.
As an administrator, you can also export or anonymize your data if needed. For more information, see
Provisional Specifications: Data Export and Anonymization [page 465].
Troubleshooting
If you encounter any problems, or if the specification exchange scenario doesn't work properly, see the
following topic: Most Common Problems [page 282].
Administration Guide
258 PUBLIC Business Configuration
8.2.11.1 Loading Value Sets
Here you can see how to load your value sets into SAP Product Lifecycle Management and how to clear your
synchronization.
Process
Loading value sets from your source system has the following steps:
When changing the source system, the synchronization dates can cause incoherence, because in the new
system all items should be checked. We recommend to clear synchronization dates after changing a source
system, and then load all values again. To do this, do the following:
Note
To load all value sets again, click the respective Load buttons.
Here you can find information on how to set up your source system to be able to load your value sets to SAP
Product Lifecycle Management.
Prerequisites
You have set up the respective specification APIs and the Customizing activities properly in your source
system. For more information, see Specification APIs for Recipe Development and the documentation for the
following Customizing activity: Logistics - General Product Lifecycle Management (PLM) PLM Web User
Interface Recipe Development Specification Management Specification Additional Information for Value
Assignment Specific Settings for Recipe Development Define Settings for Specification APIs .
Administration Guide
Business Configuration PUBLIC 259
Use
• Composition Definitions:
• Nutrients: Values used in the nutrient composition of a specification.
• Substances: Values used in the standard composition of a specification.
• Allergens: Values used in the allergen composition of a specification.
• Allergen Statements: Exception values used for allergen statements.
• Roles in Composition: Values used as component types in a composition. For more information, see
Roles in Composition [page 261] below.
• Custom Composition Definitions: Values that are custom-defined in the source system. You can load
the custom composition definitions and the related exception values, listed items, and component
types as well.
• Property Definitions: Values that are custom-defined in the source system. You can load custom property
definitions and the related property fields (characteristics) together. You can also load your phrase sets
from your active library here.
Loading the value sets is a manual process. You have to load all values from the source system before using
provisional specifications. If there are any changes in the source system (for example, when a value is created,
modified, or deleted), the value sets have to be manually loaded to the cloud again.
Note
Loaded value sets are not deleted in SAP Product Lifecycle Management after they are removed from your
source system.
Reference Quantity
In case of nutrients and quantitative (RMS_N) type custom compositions, the reference quantity for the
specification exchange scenario is always 100 grams. When transfering back this type of data into the
source system, the Customizing activity Define Reference Quantity for Composition per Specification Type isn't
considered, and the values are written back as they are in the cloud.
If you're managing nutrients, allergens, and pure substances, SAP already provided a definition for those items.
Therefore, to replicate these value sets to the cloud, as an administrator you only have to add the relevant rows
in the Customizing activity Define Settings for Specification APIs, in the view Define Compositions (Custom).
Note
For other purposes, you can also expose nutrients, allergens, and pure substances in the view Define
Compositions (Standard), but those are not considered in SAP Product Lifecycle Management.
The following table contains the information that must be added for each standard composition item.
Administration Guide
260 PUBLIC Business Configuration
Standard Composition Items in the Define Compositions (Custom) View
Roles in Composition
The data is brought over from your source system using the following logic:
1. If a Value Assignment Type (VAT) is given for STANDARD COMPOSITION under the Define Compositions
(Custom) view of the Customizing activity Define Settings for Specification APIs, then roles in composition
are the component types that are maintained in the respective VAT. You can check this in the
following Customizing activity: Logistics - General Product Lifecycle Management (PLM) PLM
Web User Interface Recipe Development Specification Management Specification Specification
Database Structure Component Settings Specify Context-Specific Component Types , with Work Area
SUBSTANCE, and the exact same VAT that you assigned to STANDARD_COMPOSITION in the other
Customizing activity (Define Settings for Specification APIs).
2. If no VAT is maintained for STANDARD_COMPOSITION under the Define Compositions (Custom) view
of the Define Settings for Specification APIs Customizing activity, the component types for the default
SUB_COMP_STD_DIALOG context parameter will be used as roles in composition.
Composition Descriptions
When loading compositions from the source system, the language-dependent descriptions of the value
assignment types are also loaded and these are then used in the Manage Provisional Specifications app as
headers for the composition tables.
For this function, if your source system is earlier than SAP S/4HANA On-Premise 2020 FPS2, make sure that
you've installed SAP Note 3054030 .
If there are no VAT descriptions loaded to the cloud, the custom composition definition IDs given in the Define
Settings for Specification APIs are used instead.
Administration Guide
Business Configuration PUBLIC 261
More Information on Property Definitions
You define properties (characteristics) in your source system, and after loading them, you can add them to
property groups in SAP Product Lifecycle Management. See Handling Properties and Property Groups [page
262].
Here are some notes that you may find useful when defining properties:
• Date and time type characteristics can't be loaded to SAP BTP, but you can use character type
characteristics for this purpose with a suitable template defined (for example YYYY-MM-DD).
• Additional data and restrictions are not taken over from characteristics.
• Multivalue characteristics are not supported on the SAP BTP side.
• Allowed values can be modelled with phrases and phrase enabled fields.
• Property tree nodes (value assignment type category H) are not taken over from your source system. You
can create property nodes in the Configure Provisional Specifications app manually.
Properties are taken over from the source system with the Load Value Sets for Specification app. In the
Configure Provisional Specifications app, these properties are only displayed on the Properties tab. Property
fields are displayed on the Property Fields tab.
Properties can be organized into property groups. The property groups are then assigned to templates, and
based on the used template, each property group is displayed as a separate tab in the Manage Provisional
Specifications app.
Properties can contain a single value or multiple values. Both single-value and multi-value properties can be
included in one property group.
Note
A property can be assigned to multiple property groups and a property group can be assigned to multiple
templates. However, a property can occur only once in a template.
Administration Guide
262 PUBLIC Business Configuration
Assigning Properties to Property Groups
To assign properties to a property group, open the property group in the Configure Provisional Specifications
app and do the following:
Example
If a property has a single value, only one form is displayed. A good example can be PH value.
If a property has multiple values allowed, it is rendered as a table, and the product developer can add
multiple rows to that property with different values. A good example can be color.
A property can be removed from the property group it is assigned to, depending on the following
circumstances:
• If the property hasn't been used in any provisional specifications, it is simply removed from the property
group.
• If the property has been used in any provisional specifications, the property is not removed, it instead gets
a Hidden flag and is hidden from the UI, but the values aren't deleted. In this case, the flag can be changed
back to visible, so the values will again be visible for the provisional specifications.
Note
While hidden, properties are not copied over or transferred back to the source system.
A property group assignment can be removed from templates, depending on the following circumstances:
• If no property within the property group has been used in any provisional specifications, then the property
group is simply removed from the template.
• If a property within the property group has been used in any provisional specifications, the property group
is not removed, instead it gets a Hidden flag and is hidden from the UI, but the values aren't deleted. In
this case, the flag can be changed back to visible, so the values will again be visible for the provisional
specifications.
Note
While hidden, properties are not copied over or transferred back to the source system.
Administration Guide
Business Configuration PUBLIC 263
Deleting Property Groups
If a property group is no longer needed, you have two options to remove them from productive use.
• Delete: Property groups can only be deleted if they're not included in any templates.
• Set to Obsolete status: If the property group is assigned to a template, you can still make it obsolete.
Obsolete property groups do not appear in the list when you create a new template, but they can be used
with already existing templates, and these property groups are also visible in the Configure Provisional
Specifications app.
Note
The mandatory attribute of a property is set in your source system, not in the cloud side. The mandatory
attribute is simply taken over when you are loading the custom properties with the Load Value Sets for
Specification app.
Tip
The property fields within the specification exchange scenario use respective characteristics in your source
system, so if you want to modify the mandatory attribute, check the characteristic with transaction CT04.
Property Fields
Property fields are taken over from your source system, and in SAP Product Lifecycle Management they
are only displayed. However, you can mark a CHAR type property field with multiple values, see Long Text
Information [page 264].
After loading properties from your source system, you can add an arbitrary long text to these properties in
the cloud. This is not transferred back to the source system and is only visible in the Manage Provisional
Specifications app.
Administration Guide
264 PUBLIC Business Configuration
To add this long text to a property, perform the following steps:
When loading characteristics to the cloud with the Load Value Sets for Specification app, these characteristics
will become property fields for properties. However, characteristics with character format that have multiple
values enabled can be marked in the Configure Provisional Specifications app for long text enablement. This
allows the user to add a maximum of 1000 characters to the respective property field.
If you want to enable long text for a CHAR type property field with multiple values enabled, perform the following
steps:
Note
The semicolon (;) character is not supported in this feature; please avoid using it in the long text.
Templates are custom-defined views where you can decide which compositions and properties are available for
a provisional specification in the Manage Provisional Specifications app. Templates are visible to all users.
Note
At least one template is needed before provisional specifications can be created in the Manage Provisional
Specification app, because selecting a template is mandatory.
Compositions
• Nutrient composition
• Allergen composition
• Standard composition
You can also add custom compositions to a template. You have to define them in your source system.
Administration Guide
Business Configuration PUBLIC 265
Property Groups and Properties
You can assign multiple property groups to a template, these are then displayed as separate tabs in the Manage
Provisional Specifications app.
Note
A property can occur only once in a template. A template can have properties from different property
groups, but only if the groups don't contain the same properties. Therefore, if two property groups share
any of the same properties, you can add only one of those groups to the template, but not both.
For more information about property groups, see Handling Properties and Property Groups [page 262].
Note
By default, technical ID-s are visible because the name of a composition or a property is not unique.
You can also edit one of your existing templates by choosing Edit.
Deleting Templates
If a template is no longer needed, you have two options to remove them from productive use.
• Deletion: Templates can only be deleted if no specifications use it (the Number of Uses status equals zero).
• Obsolete status: If one or more specifications use the template, you can still make it obsolete. Obsolete
templates do not appear in the list when creating new provisional specifications, but they can continue
to be used with already existing specifications, and these templates are also visible in the Configure
Provisional Specifications app.
Note
Administration Guide
266 PUBLIC Business Configuration
8.2.11.4 Locking and Unlocking Provisional Specifications
To make it easier to trace approved content, you can lock and unlock provisional specifications if needed.
Prerequisites
Locking
To ensure traceability of approved content, you have the possibility to lock a provisional specification. Follow
these steps:
After a provisional specification is locked, it can't be modified. But you can still copy it, assign it to a
Collaboration, or transfer its data back to the source system.
Unlocking
As an administrator, you can also unlock a previously locked provisional specification with the following steps:
Deleting a provisional specification removes the object and all references to it (for example in a collaboration)
from the system.
Context
Administration Guide
Business Configuration PUBLIC 267
Procedure
In the Specification Exchange scenario, possible unit of measurement values are defined and delivered by SAP.
These are the same as in an SAP S/4HANA system. It is important to have the same UoMs to be able to load
and transfer specification data between your systems.
The following table lists all of the UoMs that are currently provided by SAP. The columns of the table are as
follows:
• Code: used for matching nutrient or qualitative composition base UoM while syncing
• Technical Code: used on the UI
• EN Description: used on the UI
• Dimension Code: used for grouping the values by dimensions
• ISOCode: used for matching UoMs while loading/transferring compositions or properties with UoM
% % Percentage PROPOR P1
4G µl Microliter VOLUME 4G
4O µF Microfarad CAPACI 4O
4T pF Pikofarad CAPACI 4T
Administration Guide
268 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
Business Configuration PUBLIC 269
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
270 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
DGP 48 AAAADL
DR Dr Drum AAAADL DR
EA EA each AAAADL EA
Administration Guide
Business Configuration PUBLIC 271
Code Technical Code EN Description Dimension Code ISO Code
GJ GJ Gigajoule ENERGY GV
H H Hours TIME H
Administration Guide
272 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
Business Configuration PUBLIC 273
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
274 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
MA mA Milliampere ECURR 4K
Administration Guide
Business Configuration PUBLIC 275
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
276 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
Business Configuration PUBLIC 277
Code Technical Code EN Description Dimension Code ISO Code
MV mV Millivolt VOLTAG 2Z
P P Points POINTS 89
Administration Guide
278 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
PS ps Picosecond TIME
Administration Guide
Business Configuration PUBLIC 279
Code Technical Code EN Description Dimension Code ISO Code
Administration Guide
280 PUBLIC Business Configuration
Code Technical Code EN Description Dimension Code ISO Code
TST 1 TIME
UN UN Unit AAAADL
VW1 1 AAAADL
Gs Gs Gauss MAGNFD 76
Administration Guide
Business Configuration PUBLIC 281
8.2.11.7 Most Common Problems
If the specification exchange scenario doesn't work, go through these preliminary checks to determine where
can the problem be.
• The first thing to check is whether you activated all of the following services and you're getting data from
these APIs:
• Allergen - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/API_ALLERGEN/Allergen)
• Allergen Statement - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_ALLERGENSTATEMENT/AllergenStatement)
• Nutrient - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/API_NUTRIENT/Nutrient)
• Nutrient Statement - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_NUTRIENTSTATEMENT/NutrientStatement)
• Product Specification (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_PRODUCTSPECIFICATION/ProductSpecification)
• Product Specification Composition Configuration - Read (sample URL: https://{host}:
{port}/sap/opu/odata/sap/API_PRODSPECCMPSTNCONFIGN/ProdSpecComponent)
• Product Specification Property Configuration - Read (sample URL: https://{host}:{port}/sap/opu/
odata/sap/API_PRODSPECPRPTYCONFIGN//ProdSpecPrptyDefinition)
• Pure Substance - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_PURESUBSTANCE/PureSubstance)
• Pure Substance Component Type - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_PURESUBSTCOMPONENTTYPE/PureSubstanceComponentType)
• Specification Phrase - Read (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_SPECIFICATIONPHRASE/SpecificationPhrase)
• Characteristic Data for Classification (sample URL: https://{host}:{port}/sap/opu/odata/sap/
API_CLFN_CHARACTERISTIC_SRV/A_ClfnCharacteristicForKeyDate)
• Product Specification Authorization Group
• (sample URL: https://{host}:{port}/sap/opu/odata/sap/API_PRODSPECAUTHZNGROUP/
ProdSpecAuthorizationGroup)
• Product Specification Type
• (sample URL: https://{host}:{port}/sap/opu/odata/sap/API_PRODSPECTYPE/ProdSpecType)
Note
For detailed information about the Specification APIs, see: Specification APIs for Recipe Development
and 3117894 . For information on how to configure the Classification API for EPD, see 3145055 .
• Also check whether all relevant SAP Notes are there in your system, see SAP Notes for the Specification
Exchange Scenario [page 288].
Here are the most common problems that cause the specification exchange scenario to not work properly.
If you get data from the APIs listed in this topic, but the specification exchange scenario still doesn't work
properly, you may have a problem with your cloud connector or with the destination. To check if everything is
Administration Guide
282 PUBLIC Business Configuration
set up correctly, see the following guide: Connectivity [page 102]. If you don't get any response for those API
requests, look for a setup issue in your source system. For more information, see: Destination for Collaborating
on Specifications [page 123].
Authorization Issues
If you've set up your destination and are using basic authorization (for details, see the following topic:
Destination for Collaborating on Specifications [page 123]), and you're using technical users, make sure that
you set up users to have at least Read access to the service in the source system. Otherwise the value sets
won't load.
To load the value sets properly to the cloud, the system needs to understand which nutrients, allergens, and
substances you're using in your source system. To make sure that the system recognizes those items, assign
the appropriate category to your specification types in the following Customizing activity: Logistics - General
Product Lifecycle Management (PLM) PLM Web User Interface Recipe Development Specification
Management Specification Specification Master Specify Specification Types in Recipe Development
If you can’t load data from your source system with the Load Value Sets app, check the Customizing activity to
see if your specification types Allergen, Nutrient, and Pure Substance do have those specification categories
assigned.
When the specification API wants to create composition headers (for example, when transferring data back to
the source system), it checks for the settings in the customizing activity Define Settings for Specification APIs,
where a rating and a validity area are assigned to a VAT. The VAT itself is defined in the customizing activity
Specify Value Assignment Types, where a usage profile is assigned to it (you can check by double-clicking
the respective VAT). The usage profile assigned to the VAT has to contain the same rating and validity area
information that is defined in Define Settings for Specification APIs, otherwise the API call fails.
You can check the usage profile in the following customizing activity: Logistics - General Product
Lifecycle Management (PLM) PLM Web User Interface Recipe Development Specification Management
Specification Additional Information for Value Assignment Usage Specify Usage Profiles .
Administration Guide
Business Configuration PUBLIC 283
Getting All Specification Types for Custom Compositions
In case of B (listing) or C (composition) type custom compositions, the Specification Type column in
the Customizing activity Define Settings for Specification APIs isn't taken into consideration. To fix this
problem, in the Customizing activity Specify Value Assignment Types you have to define which specification
types are allowed for the custom composition. To do this or to check the settings, go to the following
node: Logistics - General Product Lifecycle Management (PLM) PLM Web User Interface Recipe
Development Specification Management Specification Specification Database Structure Settings for
Value Assignment .
In the Customizing activity Specify Value Assignment Types, select the respective VAT and go to the detailed
Specification Type view, where you can list the specification types that you want associated with your custom
composition.
Note
Check the Used in Composition flag for the specification types that you would like to use in the cloud.
If no specification type is defined here, all specification types are accepted for the respective custom
composition - and loading all data with the Load Value Sets for Specification app can take much longer.
With RMS_D (qualitative) or RMS_N (quantitative) type custom compositions, the Specification Type column in
the Customizing activity Define Settings for Specification APIs is taken into consideration. This means that only
specifications with the given specification type can be entered as an item in the composition.
However, this specification type has to correspond to the specification type defined in the respective
calculation ID as well.
To assign Calculation ID-s to VATs, go to the following Customizing activity: Logistics - General Product
Lifecycle Management (PLM) PLM Web User Interface Recipe Development Specification Management
Specification Additional Information for Value Assignment Specific Settings for Recipe Development
Assign Calculation ID to Value Assignment Type . If you set up a new custom composition, you have to assign a
calculation ID to it as well.
Note
Although calculations are used primarily in recipes, assigning to Calculation IDs is needed for specifications
themselves because the specification type determines the data tables too.
The specification type given in the respective calculation ID and the specification type given in the
Customizing activity Define Settings for Specification APIs both have to be the same. Otherwise transferring
data from the cloud to the source system can cause inconsistencies.
In the following Customizing activity, you can check the specification type that's assigned to the calculation ID:
Logistics - General Product Lifecycle Management (PLM) PLM Web User Interface Recipe Development
Administration Guide
284 PUBLIC Business Configuration
Specification Management Recipe Calculations Define Recipe Calculations . Here you select the
calculation ID and go to the subview as follows:
• In case of RMS_D (qualitative) type custom compositions, select the subview Qualitative Composition
(Group-Based)
• In case of RMS_N (quantitative) type custom compositions, select the subview Quantitative Composition
(Group-Based)
The mandatory attribute of properties can be only set in the source system. However, because of how the
different Customizing activities work, something that is mandatory in the source system may not be marked as
mandatory in the UI of the Manage Provisional Specifications app.
Recommendation
We recommend that all fields be filled, so that no problem occurs with transferring data back to the source
system.
This transfer problem can happen when a characteristic isn't set as Entry Required in transaction CT04, but is
marked later as Rq.Ent.Fld in the Customizing activity Set Up Table-Based Value Assignment. This setting isn't
regarded as mandatory in the provisional specification, therefore, if fields are left empty, the transfer can fail.
If while transferring you get an error message stating that the request can't be performed and you should
check the respective Customizing activities, this may be because the Value Assignment Types (VATs)
that are used as properties aren't marked as active. To check this, go to the Implementation Guide and
open the Customizing activity Logistics - General Product Lifecycle Management (PLM) PLM Web
User Interface Recipe Development Specification Management Specification Specification Database
Structure Settings for Value Assignment Specify Value Assignment Types .
Here, double click on the VATs that you're using in your cloud system and check if the following fields are
checked:
• VA Copy Active
• New VA Active
• Change Active
If you see no descriptions for your compositions or properties on the cloud side and you are sure that they are
maintained in your source system, then the problem can be that the identifiers are not configured correctly.
Administration Guide
Business Configuration PUBLIC 285
You can customize the displayed identification types with the following Customizing activity: Check
Identification Listing under Logistics - General Product Lifecycle Management (PLM) PLM Web User
Interface Recipe Development Specification Management Specification Specification Master .
The identifiers in position 1 and 2 are exposed to the API per specification category. You can use language
dependent and language independent descriptions.
Tip
The following table summarizes how the identifiers should look like.
Defining Identifiers
Spec. Cat. IDListPos. IDLISTPrio ID Categ ID Type Comment
You have to maintain this table for all used specification categories, including the category SUBSTANCE, which
is used by the specification exchange scenario as the main category.
It can happen that any of your Units of Measurement doesn't synchronize during one of the following actions:
This is most likely because the UoM codes and ISO codes in your source system do not match with the
supported UoMs provided by SAP for the specification exchange scenario. You can find the list of supported
UoMs in the following document: Supported Units of Measurement [page 268].
If this problem occurs, go to transaction CUNI in your source system, and compare the respective UoM's code
and ISO code with the one in the above mentioned document. These two should match.
If you find that you are using a UoM that is not provided by SAP in the specification exchange scenario, and it is
not a custom UoM but an ISO certified one, you can raise an incident to component PLM-CLOUD-COL-SXC.
Administration Guide
286 PUBLIC Business Configuration
8.2.11.7.1 Descriptions in Different Languages
This topic is only relevant if you are using the specification exchange scenario in a language that is different
from English.
Use
Compositions, properties and property fields are loaded from your source system, therefore all translations
happen there. The specification exchange scenario only uses these descriptions.
Note
SAP Product Lifecycle Management has its language scope that may differ from your source system, so
please refer to the following topic: Overview [page 7] for available languages.
Here you can see which object gets their description in the source system and where from:
• Custom composition: takes over the translation of the respective value assignment type (VAT)
• Property: takes over the translation of the respective value assignment type (VAT)
• Property field: takes over the translation of the respective characteristic
After translations are done, you have to manually load these translations to the cloud with the Load Value Sets
for Specification app.
VAT Translations
If you want to add a translation to a value assignment type, follow these steps:
1. Open the respective value assignment type in the Customizing activity: Logistics (General) Product
Lifecycle Management PLM Web User Interface Recipe Development Specification Management
Specification Specification Database Structure Settings for Value Assignment Specify Value
Assignment Types .
2. Choose Goto, and then Translation.
3. Select the languages you want to maintain.
4. Maintain translations.
Note
If you want to add languages after the initial setting, you can do it selecting the Utilities and then the
Choose Languages menu items.
Administration Guide
Business Configuration PUBLIC 287
Translations of Characteristics
Here are the SAP Notes collected that may be relevant when setting up the specification exchange scenario.
• 3124692 : Set PLM RD expected behaviour for EHS in Product Specification API
• 3206622 : Property Upsert (Create with Update) Processing
• 3193473 : Cannot Create Composition Item by Association with ECN
• 3181916 : Product Specification API - 'Assign Characteristics to Property Definitions' cannot be
transported correctly
• 3189584 : Product Specification API - Characteristic Internal IDs Are Exposed with Different Keys
• 3226570 : The overwrite property values with create operation is not functioning correctly if property
contains phrase based attribute
• 3241119 : Product Specification API - Correction for Multi-Value Properties
• 3247138 : Product Specification API - Correction for Property Update
• 3278205 : Enable Specification Type, Authorization Group and Create opearation for Prov.Spec API
Please read and apply the following SAP Notes if your source system is running SAP S/4HANA On-Premise:
Administration Guide
288 PUBLIC Business Configuration
Source System Earlier than SAP S/4HANA On-Premise 2020 FPS2
Please read through this composite note if your source system is earlier than SAP S/4HANA On-Premise 2020
FPS2: 3167052 : Product Specification APIs for SAP S/4HANA 1809 and 1909 - Composite Note.
Please also read and apply the following note: 3054030 : Specification - Last Changed Date Issues.
Please read through this composite note if your source system is on EHP8: 3117894 : Product Specification
APIs for SAP Business Suite (EhP8) - Composite Note.
Also, implement the following note: 3145055 : Product Specification APIs - Implementation Guide for
Reading Characteristic Data.
Use the Configure Product Package Exchange app, to add, and edit header labels for bill of material, material,
and change master. You can also remove the label if needed.
Your business users see the labels in the header section that you have configured for the Bill of Material,
Material, and Change Master tabs in the Product Package Exchange app.
Prerequisites
Context
The attributes are pushed from your SAP S/4HANA system. You can configure the header labels for these
attributes for bill of material, material, and change master.
Adding Attributes
1. From the SAP Fiori launchpad, open the Configure Product Package Exchange app.
2. Choose one of the following tabs to configure:
1. Bill of Material
Administration Guide
Business Configuration PUBLIC 289
2. Material
3. Change Master
3. Choose Add.
4. In the dialog that opens, select a maximum of six attributes.
The selected attributes are displayed in the selected items.
5. Save your changes.
The table displays the list of attributes with the label values.
Editing Attributes
You edit the label of an attribute when you want to translate the label text into different languages.
1. From the SAP Fiori launchpad, open the Configure Product Package Exchange app.
2. Select a label attribute, choose (Edit Label Attribute)..
Note
Select Language Select the language that you want to use The selected language is added to the
for the translation. For the information Display Language list. For more informa-
about the supported languages, see Over- tion, see Filtering Texts by Language [page
view [page 7]. 231].
Removing Attributes
1. From the SAP Fiori launchpad, open the Configure Product Package Exchange app.
Administration Guide
290 PUBLIC Business Configuration
2. Select an attribute and choose (Delete).
3. Confirm the warning.
The attribute with the selected label in the configured languages is removed.
This information is aimed at technology consultants, security consultants, and system administrators.
It provides an overview of the security-relevant information that applies to Collaboration and Status
Management:
Note
In the Configure Collaboration app, select the option Malware Scanning, to check the uploaded files for
malware before they are processed and made available for download. Files found to contain malware are
deleted. For more information, see What Is SAP Malware Scanning Service.
For security-related information such as audit logging and malware scanning, see the relevant chapters in the
security guideSecurity Guide.
The Collaboration capability allows SAP Business Technology Platform administrators to monitor the list of
events and accesses concerning documents in collaboration. The relevant events and accesses are logged in
the Audit Log Service.
Events
Administration Guide
Business Configuration PUBLIC 291
Collaboration entity Events
Access
• Changed On – Timestamp
• Changed By – Name of the user
• Deleted By – Name of the user
• Event name – Created, Deleted, Uploaded, Downloaded
• Entity name mentioned in the above table
For more information, see Audit Logging in the Cloud Foundry Environment.
Describes the business configuration steps to be performed in order to work with the various apps in the
Common Functions service for SAP Product Lifecycle Management.
Prerequisites
You must be assigned the appropriate roles as mentioned in Role Templates for Common Functions [page 62].
Related Information
Manage Teams
Configuring Plants [page 293]
Managing Authorization Contexts [page 294]
Administration Guide
292 PUBLIC Business Configuration
8.3.1 Configuring Plants
Import plants from a source system so that they can be referenced by apps in SAP Product Lifecycle
Management. Once configured, the imported and activated plants are visible to the users.
Prerequisites
• You must be assigned the EPD-Admin role as mentioned in Role Templates for Common Functions [page
62].
• You've set up destinations on SAP Business Technology Platform to connect to your source system (SAP
S/4HANA, SAP S/4HANA Cloud, or SAP ERP) to retrieve data from it. For more details, see Configuring
Connectivity for Common Functions [page 132].
Procedure
Note
When importing plants, the description of matching plants that are imported from another source
system previously, is overwritten with the description of the selected source system.
3. To change the status of the plants, select the plants and choose Activate.
Note
The plants imported from the source system are, by default, Inactive in status. When a plant is inactive,
it doesn't appear in the Plant filter. To enable a plant to be available as a filter option, you need to
activate them.
4. Once the import is complete, the Plants table refreshes and displays the imported plants.
Results
The plants can now be used in the apps in the other SaaS applications for SAP Product Lifecycle Management
that you have subscribed to.
For more information on how plants are used in Specification Management, see Synchronization of Data [page
409].
Administration Guide
Business Configuration PUBLIC 293
8.3.2 Managing Authorization Contexts
Use this app to create authorization contexts for controlling the access of individual users or teams of users to
specific business objects used within the processes supported by several integrated SaaS applications.
Prerequisites
• You have subscribed to the following SaaS applications as needed for your business processes:
• Enterprise Product Structure
• Intelligent Handover
• You must have the same authorizations as provided by the EPD-Admin role template as mentioned in Role
Templates for Common Functions [page 62].
• If you want to control user access at the team level, you have created the necessary teams using the
Manage Teams app. For more information, see Manage Teams.
• You have assigned roles based on the specific role templates from the integrated SaaS applications to
the users who are assigned to the authorization contexts, as needed. For more information about the role
templates, see the following documents:
• Role Templates for Enterprise Product Structure [page 70]
• Role Templates for Intelligent Handover [page 79]
• You restrict access to objects that have a certain attribute. Two object attribute types are supported: BOM
usage and plant. Before you can add object attribute types to authorization contexts, you must have done
the following:
• BOM usage: You have imported and configured the necessary BOM usages into SAP Product Lifecycle
Management using the BOM Usages app provided by the Enterprise Product Structure. For more
information about importing BOM usages, see Configuring BOM Usages [page 348].
• Plants: You have imported and configured the necessary plants into SAP Product Lifecycle
Management using the Plants app provided by Common Functions . For more information about
importing plants, see Configuring Plants [page 293].
Context
You use roles to control your users' access to the apps that are provided by different SaaS applications in
SAP Product Lifecycle Management. With authorization contexts, you can further narrow down access rights
by allowing individual users or a whole team to only perform particular activities (for example, read, write, or
delete) on business objects with a specific attribute. The following types of object attributes are supported:
• BOM usage
• Plant
These authorization contexts then control the users' access across the different apps provided by the
integrated SaaS applications that you have subscribed to. When the users open the apps provided by these
SaaS applications, their access to the business objects within the apps is already filtered by the authorization
contexts that they are assigned to.
Administration Guide
294 PUBLIC Business Configuration
Tip
Example 1: You have a group of engineers who should only have access to engineering BOMs. You could
proceed as follows:
1. You create a team for those engineers in the Manage Teams app.
2. You ensure that the users have the necessary authorizations that are provided by the additional role
templates for integrated SaaS applications.
3. In the Manage Authorization Contexts app, you then create an authorization context that gives read and
write access to objects that have 2 (Engineering) as the BOM usage.
4. You assign the team of engineers to this authorization context.
Example 2: You have a group of production engineers working with Intelligent Handover apps who are only
allowed to create new BOMs for plant 0001, but they can view BOMs for plant 002. You could proceed as
follows:
1. You create a team for those engineers in the Manage Teams app.
2. You ensure that the users have the necessary authorizations that are provided by the additional role
templates for Intelligent Handover.
3. In the Manage Authorization Contexts app, you then create an authorization context that, in the first
entry, gives read, write, and delete access to objects assigned to Plant 001.
4. In the next line in the same authorization context, you give read access to objects assigned to Plant
002.
5. You assign the team of engineers to this authorization context.
Procedure
1. To create an authorization context, on the SAP Fiori Launchpad, open the Manage Authorization Contexts
app.
2. Choose Create.
3. Enter a unique ID and description for the new authorization context. The ID can have no more than 10
characters.
4. To use the authorization context to restrict access to a particular business object with a particular
attribute, choose Add Attribute.
5. In the Object Attribute Type column, select the relevant type.
6. Use the value help to select the specific attribute.
7. In the Activity on Related Objects column, select the activity that the users can perform on business
objects that have the attribute that you entered..
Note
This activity gives the user the authorization to read, create, and edit business objects with the
corresponding attributes.
Administration Guide
Business Configuration PUBLIC 295
• Delete
8. Repeat these steps to add the other combinations of object attributes and activities that are needed in this
authorization context.
The relationship between the different object attribute types in the same authorization context is an
or-relationship, that is, for example, if you entered 2 different plants, Plant 001 and Plant 002, the users
restricted by that authorization context have access to objects that are assigned to Plant 001 or Plant 002.
9. Assign the users whose access should be restricted in the Users or Teams section.
Users that are not included in an authorization context but have access to an app because of their role
assignment have access to all possible business objects and they can perform all activities that are allowed
by the role.
10. Save your entries.
Results
After you save your authorization context, it immediately takes effect. The next time a user that is restricted by
the authorization context opens an app to work on related business objects, they will only see the objects that
meet the settings that you made.
Any user with the same authorizations that are provided by the EPD-Admin role template can edit or delete any
existing authorization context.
If you later want to change the access that one user or team has, you can filter the list of already created
authorization contexts on the initial list page of the app to find the contexts a specific user or a team of users is
assigned to and then edit the authorization contexts as needed.
This section describes the business configuration to be performed so that you can work with the various
applications in the Configuration Management SaaS application of SAP SAP Product Lifecycle Management.
Subscription
• New customers (beginning with 2302): First subscribe to Enterprise Product Structure, then to
Configuration Management.
• Existing customers (before 2302): Simply subscribe to Enterprise Product Structure.
• (Optional): If you want to create your baselines within SAP Product Lifecycle Management using the Hand
Over Engineering Bills of Material (EBOM) app, you need to subscribe to the Intelligent Handover SaaS
application.
• (Optional) If you want to use the function View 3D Models of Parts in the Manage Baselines app (see also
Frequently Used Functions in Manage Baselines), you need to subscribe to Visualization.
Administration Guide
296 PUBLIC Business Configuration
• (Optional): If you want to use the function Collaboration in the Manage Baselines app, you need to
subscribe to the Collaboration SaaS application.
In order to configure the correct synchronization of document info records of the source system, follow these
instructions:
To configure the synchronization of BOM usages and plants, follow these instructions:
• Configuring BOM Usages [page 348] for importing BOM usages from a source system.
• Configuring Plants [page 293] to import plants from a source system.
Status Management
To configure status management for Configuration Management, see Managing Statuses for Configuration
Management [page 301].
In this section, you learn how to create baseline profiles as well as lifecycle phase templates.
When working with configuration plans, your business users may often have to do tasks that are widely similar
(if not identical) for many products. You want your users to perform these tasks in a uniform way, so that
similar things look similar, and they avoid tedious and repetitive tasks.
By creating baseline profiles in the Manage Baseline Profiles and Configuration Plans app, you reduce the
workload of your business users by configuring basic settings for the baselines that they later create for
configuration plans. To do this, you make reusable settings in the Master Data Object Selection part of this app.
This is the place where you specify which master data is to be loaded into a baseline for a specific lifecycle
phase.
In addition to creating baseline profiles in this app, you can also streamline the creation of lifecycle phases by
creating templates for them in this app.
Administration Guide
Business Configuration PUBLIC 297
The lifecycle phase templates along with their associated baseline profiles that you create in this app can be
assigned to a configuration plan in the Lifecycle Phases section of the Manage Configuration Plans application.
Note
The use of baseline profiles in SAP Product Lifecycle Management is mandatory. This means that for each
lifecycle phase that you create in a configuration plan, you have to assign a baseline profile.
Prerequisites
You have the Baseline_Administrator role assigned to your user. See Role Templates for Configuration
Management [page 63].
1. On the SAP Fiori launchpad, open the Configure Baselines and Configuration Plans app.
2. In the Baseline Profiles view, choose Create.
3. In the Header section, provide a unique Profile Name. To make it easier for your business users to
understand the purpose of the new baseline profile, we recommend entering a Description.
Next, depending on the data source from which the data is to be pulled during baseline creation, make the
following settings:
Note
For more information about how the data is fetched from different sources in the different scenarios for
baseline creation, see Business Process Flow of Configuration Management.
Note
You need to select at least one of the options in the Master Data Object Selection section. Otherwise,
you can't save the profile.
• For baselines created in the handover to manufacturing process, select any of the following:
• Product Structure: Specifies whether derived baselines shall contain a product structure or not.
• Routing: Specifies whether derived baselines shall contain routing information or not.
• Product Data: Specifies whether derived baselines shall contain product data or not.
Administration Guide
298 PUBLIC Business Configuration
• For baselines created from within Configuration Management, select any of the following:
• Product Structure: Specifies whether derived baselines shall contain a product structure or not.
• Product Data: Specifies whether derived baselines shall contain product data or not.
• Document Info Records: Specifies whether derived baselines shall contain document info records
or not.
3. In the Default Options section, specify the default settings for newly created baselines:
Note
You can skip the default options for baseline profiles for the handover to manufacturing process.
The data for those baselines is taken automatically from the structure that is open in the Hand Over
Engineering Bills of Material (EBOM) app.
• Plant: Specifies the plant to which the construction or manufacturing data apply.
• Date Determination: Specifies the calendar date as of which the BOM data shall be used. You can
choose between the Current Date at runtime, or no date determination, that is, you'll have to specify a
date manually later on in the process.
• Set Controlled Object as Default Product: Indicates whether the specified controlled object shall be
used as the top-level object for the Pull Master Data function in the Manage Baselines app.
Note
You need to select at least one of the options in the Master Data Object Selection section. Otherwise,
you can't save the profile.
• Product Structure: Specifies whether derived baselines shall contain a product structure or not.
• Routing: Specifies whether derived baselines shall contain routing information or not.
• Product Data: Specifies whether derived baselines shall contain product data or not.
• Document Info Records: Specifies whether derived baselines shall contain document info records or
not.
• BOM Explosion Stopping at: Specifies the hierarchy level of the bill of materials that shall be made
available in the derived baselines. You can choose between two predefined hierarchy levels. In addition,
you can choose the explosion level entry and specify the desired hierarchy level as a number, or you
specify that no BOM explosion shall be performed. The predefined hierarchy levels are:
• Assemblies on Stock
• Items Externally Procured
Note
Only single-level quantity calculations are supported: Structure items are handled with quantity =
1 as a basic value. This means that a multilevel quantity calculation is not currently supported, as
well as any specific variant configuration logic that is set up in the source system.
To learn more about the different BOM explosion options, see the detailed explanation here:
Restricting the View for BOM Explosion.
Administration Guide
Business Configuration PUBLIC 299
3. In the Default Options section, specify the default settings for newly created baselines:
• Source System: From the list of connected systems, choose the one to be used.
Note
Specifying a default source system is an essential setting. Therefore, maintaining a value for this
field is mandatory.
• BOM Application: Specifies the application that provides the bill of material data to be used.
• Plant: Specifies the plant to which the construction or manufacturing data apply.
• Date Determination: Specifies the calendar date as of which the BOM data shall be used. You can
choose between the Current Date at runtime, or no date determination, that is, you'll have to specify a
date manually later on in the process.
• Set Controlled Object as Default Product: Indicates whether the specified controlled object shall be
used as the top-level object for the Pull Master Data function in the Manage Baselines app.
Once you have finished configuring the baseline profile, save your entries. If you're sure that the profile has
reached its final state, you can choose Activate right away. However, you can postpone this step to a later point
in time, for example, after the profile has been checked by other involved parties.
Instead of manually maintaining all the settings for the objects you create, you can also select an existing
object and choose Copy to create a new object with the same settings as the source object. You can then
modify only those settings where source and target objects differ from each other. Using this feature can save
you time when you want to create lots of similar objects that only differ in certain details.
1. In the Configuration Management launchpad group, choose the Configure Baselines and Configuration
Plans application.
2. From the Lifecycle Phase Templates view, choose Create.
3. In the Header section, provide a unique Phase Template Name. To make it easier to understand the purpose
of the new lifecycle phase template, we recommend entering a Description.
4. In the Lifecycle Phases section, specify the different lifecycle phases that shall be provided by the template:
• Lifecycle Phase ID: Enter a numeric identifier for the lifecycle phase.
• Phase Description: Enter a short text to explain the purpose of the phase (for example, "planning" or
"construction").
• Baseline Profiles: From the baseline profiles that exist in your system, choose one that you want to
associate with the lifecycle phase.
Note
For a baseline profile to be assigned to a lifecycle phase template, the profile must have been activated.
5. Once you're done with configuring the lifecycle phase, choose Save.
6. If you're sure that the lifecycle phase has reached its final state, you can choose Activate right away.
However, you can postpone this step to a later point in time, for example, after the profile has been
checked by other involved parties.
Administration Guide
300 PUBLIC Business Configuration
Note
For a lifecycle phase template to be assigned to a configuration plan, the template must have been
activated.
Instead of manually maintaining all the settings for the objects you create, you can also select an existing
object and choose Copy to create a new object with the same settings as the source object. You can then
modify only those settings where source and target objects differ from each other. Using this feature can save
you much effort when it comes to creating lots of similar objects that only differ in certain details.
Create the status profiles that you need for status-enabled object types in Configuration Management, such as
baselines, lifecycle phases, or configuration plans.
Prerequisites
You must be assigned the role StatusManagementAdmin as described in Managing Statuses [page 182].
Use the predefined profile IDs to define the status profile for different objects, such as configuration plan,
lifecycle phase, and baseline.
Baseline CM_BASE0
As an administrator, you must ensure that every object (baseline, configuration plan, lifecycle phase) in
Configuration Management is provided with its own status profile.
Follow the steps described in the topics shown in Managing Statuses [page 182].
In order to work with status profiles in the Configuration Management apps, you need to make sure that
SAP-provided standard actions for the objects (such as baselines, lifecycle phases, and configuration plans)
have a meaningful assignment to the statuses within the configured profiles.
Editable Allows the user to modify the objects Baseline, Configuration Plan, Lifecycle
Phase
Lock master data object versions Prevents the user to modify the dedi- Baseline
cated master data version
Allow adding baselines Allows the user to add baselines in a Lifecycle Phase
certain status
Administration Guide
Business Configuration PUBLIC 301
Action Action description Object
Allow adding lifecycle phases Allows the user to add lifecycle phases Configuration Plan
in a certain status
Note
The behavior of the applications depend on the assigned status profiles and the assigned actions. For
example, the Lock master data object versions action can be maintained in a status profile for baselines in
particular for the status with the Released status type.
UI5 flexibility allows users with the UI5 flexibility key role to customize user interface controls using the Adapt
UI feature, and to manage views (public variant) in the Manage Baselines and Manage Configuration Plans apps.
Features
Adapt UI
The Adapt UI feature is shown in the user profile in Manage Baselines and the Manage Configuration Plans apps
only for users who have the FlexKeyUsers role authorization.
Users with the FlexKeyUsers role (key users) can do the following:
Public Variant
• Public views (variants) are visible only to key users to create filter and table views that are available for all
authorized users.
• For saving variants, key users can save the view to Public in the Manage Views dialog box.
• The Manage Views (public variant) option is available only in the Manage Baselines app.
Limitations
• The Action buttons are not adaptable (that is, they cannot be modified) in Edit mode in the Manage
Configuration Plans app.
• Only changes created in the most recent version can be applied. Changes saved in a previous version can
be used after reactivating it as a new version.
Administration Guide
302 PUBLIC Business Configuration
• When you are adapting the UI, you will need to switch from adaption mode to navigation mode to go to a
new screen.
UI5 flexibility allows users with the UI5 flexibility role to customize the UI using the Adapt UI feature, and to
manage views (public variant) in the Manage Baselines and the Manage Configuration Plans apps.
Prerequisites
To use the UI flexibility feature, you must have the FlexKeyUser role assigned. For more information, see Role
Templates for Configuration Management [page 63].
Note
Users with the FlexKeyUser role (key users) must be familiar with using the app and apply changes
cautiously. Keep the following in mind:
• As a key user, you have access to all UI controls. When making changes to a UI control, be extra careful
because the change could affect many parts of the app. After applying changes, if an error appears,
you can revert to the default view of the UI.
• Mandatory fields can't be removed. Removing them causes a validation error.
• The Adapt UI feature is supported only for static UI5 controls with stable IDs.
• If you want to add a URL link to embedded content, certain preconditions and security standards must
be met.
For more information on editing embedded content, see Embedding Content.
For more information about UI5 flexibility for key users, see What Is UI5 Flexibility for Key Users?
The Engineering cloud service for SAP Product Lifecycle Management enables users to use the Requirements
Management and Systems Modeling app and the Test Management apps.
As the account administrator, you must configure the service for use. For more information, refer to the
following sections:
Administration Guide
Business Configuration PUBLIC 303
8.5.1 Configuring Requirements Management and Systems
Modeling
Note
Some of the content in this section may refer to features that are only available in the Web application SAP
Enterprise Architecture Designer, cloud edition application.
Access to the SAP EA Designer repository is managed via an identity provider configured in the SAP BTP, but
repository privileges and permissions on specific repository folders and documents are controlled by SAP EA
Designer administrators through repository user accounts.
Context
Repository privileges give users access to general repository features, while permissions give them access to
particular locations in the repository. The following privileges and permissions are available:
Administration Guide
304 PUBLIC Business Configuration
Privileges (Entire Repository) Permissions (Per Folder or Item)
• Connect - Connect to the repository and view di- • List - This permission level is not currently in use.
agrams in Requirements Management and Systems
• Read - Open and compare documents.
Modeling.
• Export from Web - Export content from
• Submit - Also propose changes to the document for
Requirements Management and Systems Modeling as review by a user with Write permission.
a repository Zip file, report or PowerPoint. • Write - Also review changes by other users and pub-
• Edit on Web - Create and edit diagrams in lish changes directly.
Requirements Management and Systems Modeling. • Full - Also move and delete documents, and manage
• Edit Extensions on Web - Create and edit permissions granted to users and groups.
custom properties in Requirements Management and
Systems Modeling. Gives access to the Customize item
Note
in the navigation panel.
• Manage All Documents - Perform any action on Administrators, who have implicit Full permission
any document version. Implicitly includes Full per- on all repository objects, will only receive models
mission on all repository documents. Gives access to for review if they have been granted explicit Write
the Activities/Log tile. permission on them.
• Manage Users & Permissions - Create, mod-
ify, and delete repository users and groups, grant
them privileges, and add them to groups. Users with
this privilege can list all repository documents and
set permissions on them without needing explicit
Full permission. Gives access to the Administration/
Users, Administration/Groups, and Activities/Security
Log tiles.
• Manage Repository - Gives access to the
Administration/Settings item.
Procedure
1. Ensure that users are provisioned with the EADesigner_User in your identity provider (see Managing
Repository Users [page 307]).
2. [optional] Prepare user accounts for your users (see Preparing User Accounts for New Users [page 307]).
3. [optional] Create high-level functional groups (see Creating Repository Groups [page 308]) to organize
users by type and assign appropriate privileges to them to govern general actions that they can perform in
the repository (see Granting Privileges to Users and Groups [page 311]).
For example:
Groups Privileges
Administrators Connect, Manage All Documents, Manage Users & Permissions, Manage Repository
Stakeholders Connect (to provide read-only access to Requirements Management and Systems Modeling).
Administration Guide
Business Configuration PUBLIC 305
Note
There is no requirement to create groups - you can assign privileges and permissions to individual
users - but we recommend that in all but the smallest deployments, you do create groups to simplify
the process.
4. Create an appropriate folder structure in the repository to enable you to group documents by project or in
any other appropriate way, and to simplify the granting of permissions.
In this example, we imagine the following simple folder structure:
• Library
• EA
• Process Map
• Process Diagrams
• HR
• Sales
• Data
5. Determine your review policy either at a global or project by project level. SAP EA Designer supports the
following kinds of policy:
• Simple review - Change lists submitted by users with the Submit permission are reviewed by users
with the Write or Full permission.
• Peer review - Users with the Write or Full permission voluntarily submit change lists for review.
• Direct check in - The Submit permission and change lists are not used, and users all check in changes
without review.
6. Create development groups and implement your review policies by assigning appropriate permissions to
control what actions users and groups can perform on particular repository documents and folders.
In this example, we propose a simple group structure with permissions based on role and line of business:
• Enterprise Architects - Have full control over all documents.
• Process Analysts - Maintain the process map and review business process diagrams for publication in
the repository.
• Process Owners - May submit business process diagrams for their domain.
• Data Modelers - Maintain data models.
• Stakeholders - Have read access to all documents by default.
Administration Guide
306 PUBLIC Business Configuration
Process Dia- Process Dia-
Group Library EA Process Map grams/HR grams/Sales Data
7. Assign users to appropriate groups (see Adding Users and Groups to a Group [page 310]) according to
their roles and project responsibilities.
There is no limit to the number of groups to which a user or group can be assigned, and users benefit from
the cumulative total of all the privileges and permissions they receive.
Users cannot connect to SAP EA Designer until an identity provider administrator provisions them with the
role collection EADesigner_User. Editing privileges and permissions on specific folders and documents in the
repository are managed by an SAP EA Designer administrator.
Context
To personalize a user's first connection to SAP EA Designer, we recommend that you pre-create their
repository user account and assign appropriate privileges and permissions to them (see Preparing User
Accounts for New Users [page 307]).
When a user first connects to SAP EA Designer, a repository user account is created for them, and they are
automatically included in the Public group. To personalize a user's first connection you can pre-create a
repository user account and assign appropriate privileges and permissions, either directly or by assigning them
to one or more groups.
Context
The Public group has, by default, Read permission on the repository root. To optimize the onboarding
experience, we recommend that you create additional groups with appropriate privileges and permissions on a
structure of sub-folders (see Controlling Repository Access [page 304]) and add your users to these groups.
Administration Guide
Business Configuration PUBLIC 307
Procedure
1. Click Administration Users in the navigation panel, and then click the + button to create a new user.
2. Enter the user's name in the Full Name field, and the login attributed to them in the identity provider in the
Login Name field.
3. In the Privileges panel, select the check boxes corresponding to the privileges you want to assign:
• Connect - Connect to the repository and view diagrams in Requirements Management and Systems
Modeling.
• Export from Web - Export content from Requirements Management and Systems Modeling as a
repository Zip file, report or PowerPoint.
• Edit on Web - Create and edit diagrams in Requirements Management and Systems Modeling.
• Edit Extensions on Web - Create and edit custom properties in Requirements Management and
Systems Modeling. Gives access to the Customize item in the navigation panel.
• Manage All Documents - Perform any action on any document version. Implicitly includes Full
permission on all repository documents. Gives access to the Activities/Log tile.
• Manage Users & Permissions - Create, modify, and delete repository users and groups, grant
them privileges, and add them to groups. Users with this privilege can list all repository documents
and set permissions on them without needing explicit Full permission. Gives access to the
Administration/Users, Administration/Groups, and Activities/Security Log tiles.
• Manage Repository - Gives access to the Administration/Settings item.
4. Click the Groups tab and add the user to any appropriate groups (see Adding Users and Groups to a Group
[page 310]).
5. Select Menu Push Diagrams to User or Menu Push Folder to User to make appropriate
diagrams and folders available in their homepage (see Pushing Diagrams and Folders to Users' Homepages
[page 313]).
6. Click Save to complete the creation of the user.
The repository administrator is responsible for creating groups of users in the repository. Users are added to
groups in order to simplify the granting of privileges and permissions. You can create hierarchies of groups. For
example, you could insert the Designers, Quality Assurance, and Documentation groups into the R&D
group, to which you assign permissions to documents that all these groups must use.
Context
• Administrators, [ADMN] - Has, by default, all available privileges and implicit Full permission on all
repository folders.
• All users [PUBLIC] - Has, by default, Read permission on the repository root. All users belong to this group
and can thus, by default, browse any diagram.
Administration Guide
308 PUBLIC Business Configuration
Procedure
1. Click Administration Groups in the navigation panel, and then click the + button to create a new
group.
2. Enter the following properties as appropriate:
Property Description
Name Specifies the name of the group as it will appear in the interface.
Code Specifies the internal name of the group, which can be used in scripting.
Privileges By default, groups do not have any privileges. Select the checkboxes corresponding to the privi-
leges you want to assign:
• Connect - Connect to the repository and view diagrams in Requirements Management and
Systems Modeling.
• Export from Web - Export content from Requirements Management and Systems
Modeling as a repository Zip file, report or PowerPoint.
• Edit on Web - Create and edit diagrams in Requirements Management and Systems
Modeling.
• Edit Extensions on Web - Create and edit custom properties in Requirements
Management and Systems Modeling. Gives access to the Customize item in the navigation
panel.
• Manage All Documents - Perform any action on any document version. Implicitly
includes Full permission on all repository documents. Gives access to the Activities/Log
tile.
• Manage Users & Permissions - Create, modify, and delete repository users and
groups, grant them privileges, and add them to groups. Users with this privilege can list all re-
pository documents and set permissions on them without needing explicit Full permission.
Gives access to the Administration/Users, Administration/Groups, and Activities/Security Log
tiles.
• Manage Repository - Gives access to the Administration/Settings item.
3. Click the Members tab and add any appropriate users and groups to the group (see Adding Users and
Groups to a Group [page 310]).
4. Click the Parents tab and add the group to any appropriate groups (see Adding Users and Groups to a
Group [page 310]).
5. Select Menu Push Diagrams to Group or Menu Push Folder to Group to make appropriate
diagrams and folders available in group members' homepages (see Pushing Diagrams and Folders to
Users' Homepages [page 313]).
6. Click Save to complete the creation of the group.
Administration Guide
Business Configuration PUBLIC 309
8.5.1.1.3.1 Adding Users and Groups to a Group
You can add users and groups as members of a group from either the user or the group property sheet.
Context
• To add a user to a group from the user's property sheet, click the Groups tab, which lists the groups to
which the user belongs. Click the + tool to open a list of groups, select one or more, and then click OK to
add the user to them.
• To add a group to a parent group from the child group's property sheet, click the Parents tab, which lists the
groups to which the group belongs. Click the + tool to open a list of groups, select one or more, and then
click OK to add the group to them.
• To add a user or group to a group from the parent group's property sheet, click the Members tab, which
lists the users and groups which are members of the group. Click the Add tool to open a list of users and
groups, select one or more, and then click OK to add them to the group.
When you delete a group from the repository you do not delete the members (either users or groups) of the
group.
Procedure
Administration Guide
310 PUBLIC Business Configuration
8.5.1.1.3.3 Specifying Group Managers
In some cases, when you create a group, you may need to be able to delegate the addition and removal of
members to some selected members (users or groups) of this group without giving them the Manage Users
& Permissions privilege. You can select these group members and specify them as Group Manager.
Procedure
In order to specify a user or group as a group manager, display the group property sheet, click the Members
tab, check the appropriate Name and Group Manager boxes and click Save.
Group managers can access the property sheet of the group they manage and use the Members tab to add or
remove users or groups (see Adding Users and Groups to a Group [page 310]).
Group managers that do not have Manage Users & Permissions privilege cannot modify the group
privileges and they cannot access or modify properties or privileges of the group members. They can however
make some edits in the Comment field of the group property sheet.
The All Users and External Users groups cannot be specified as group manager and cannot be added/
removed from the group members by the group manager (only the administrator or user with Manage Users
& Permissions privilege can do this).
A group manager can remove Group Manager status to other group managers for a group he manages, but he
cannot remove this status for himself unless there is at least another manager for this group.
A new user has only the Connect privilege assigned by default and belongs only to the PUBLIC group. The
repository administrator can grant additional privileges to the user either directly or by adding her to other
groups.
Context
User privileges are associated with document permissions (see Granting Access Permissions on Repository
Items [page 312]) to define the actions a user can effectively perform on a document.
Procedure
1. Click Administration Users (or Administration Groups ) in the navigation panel, and then click
the appropriate user or group in the list to open its property sheet.
Administration Guide
Business Configuration PUBLIC 311
2. Select the check boxes corresponding to the privileges you want to assign:
• Connect - Connect to the repository and view diagrams in Requirements Management and Systems
Modeling.
• Export from Web - Export content from Requirements Management and Systems Modeling as a
repository Zip file, report or PowerPoint.
• Edit on Web - Create and edit diagrams in Requirements Management and Systems Modeling.
• Edit Extensions on Web - Create and edit custom properties in Requirements Management and
Systems Modeling. Gives access to the Customize item in the navigation panel.
• Manage All Documents - Perform any action on any document version. Implicitly includes Full
permission on all repository documents. Gives access to the Activities/Log tile.
• Manage Users & Permissions - Create, modify, and delete repository users and groups, grant
them privileges, and add them to groups. Users with this privilege can list all repository documents
and set permissions on them without needing explicit Full permission. Gives access to the
Administration/Users, Administration/Groups, and Activities/Security Log tiles.
• Manage Repository - Gives access to the Administration/Settings item.
3. Click Save to save your changes.
Context
A user wanting to browse and edit documents in the repository must have at least the following permissions:
• Browsing - Read permission. When you create a user, she is inserted into the Public group, which by
default is granted Read permission on the repository root.
• Creating or editing a diagram - Submit on the target folder to propose a new diagram or edits to an
existing diagram, or Write to publish them directly.
Note
Object permissions should be viewed in conjunction with the privileges granted to users or groups (see
Granting Privileges to Users and Groups [page 311]).
Procedure
1. Click Repository Explorer in the navigation panel, navigate to the item, and click its Permissions tab.
2. Click the + button to open a list of available users and groups, select one or more, and click OK to add them
to the list.
Administration Guide
312 PUBLIC Business Configuration
3. For each user or group, select the permission you want to grant in the Granted Permission column:
• List - This permission level is not currently in use.
• Read - Open and compare documents.
• Submit - Also propose changes to the document for review by a user with Write permission.
• Write - Also review changes by other users and publish changes directly.
• Full - Also move and delete documents, and manage permissions granted to users and groups.
Note
Administrators, who have implicit Full permission on all repository objects, will only receive
models for review if they have been granted explicit Write permission on them.
The Effective Permissions column shows the highest level of permission that each user or group has on the
item either directly or via a group.
4. [optional] Click the Copy Permissions to All Children tool to propagate changes to the item's children.
When you create a folder or diagram, the permissions defined on its parent folder are propagated to it.
However, subsequent changes made to the permissions for the parent are not applied to its children unless
you click this tool. For example, if you grant Write permission on the Major Project folder, to the
Development Team 2 group, then they will not automatically be granted Write access on its existing
contents.
The repository administrator can push diagrams and folders to users' homepages to give them personalized
entry points to the repository. Diagrams appear as cards in the user's homepage, and folders as entries in the
Quick Links card. You can push diagrams and folders to individual users or to groups.
Context
Note
Diagrams and folders pushed to groups are received by all the members of the group at the time of the
action. Users that are subsequently added to the group will not receive the diagram or folder unless you
push it again. If you push a diagram or folder that is already present in a user's homepage, it will not be
duplicated.
Procedure
1. Click Administration Users (or Administration Groups ) in the navigation panel, and then click
the appropriate user or group in the list to open its property sheet.
Administration Guide
Business Configuration PUBLIC 313
2. To push diagrams to the user or group:
a. Select Menu Push Diagrams to User/Group to open the Select Diagrams dialog.
b. Navigate to or search for the diagrams you want to push, and select them.
c. When your selection is complete, click Push to push them to the user or group.
3. To push a folder to the user or group:
a. Select Menu Push Folder to User/Group to open the Select Folder dialog.
b. Navigate to the folder you want to push, and click Push to push it to the user or group.
The repository administrator or a user with the Manage Users & Permissions privilege can deactivate
users. Inactive users cannot connect to the repository and the information held about them is deleted except
for the log of their checkins and other repository actions.
Context
Caution
A user cannot deactivate himself, even if he has the Manage Users & Permissions privilege.
Procedure
1. Click Administration Users in the navigation panel, and then click the appropriate user in the list to
open its property sheet.
2. Select the Inactive status and click OK.
3. [optional] Click the Anonymize button to replace all occurrences of the user's name, code, and email in logs
and repository document version histories with an anonymous pseudo-identity. Anonymizing data in this
way allows you to retain a history of operations without personally-identifying information.
Note
Note
A confirmation dialog is displayed to inform you that the change lists for the deactivated user can
be automatically deleted. Click OK to delete the change lists (this deletion is non-reversible) or click
Cancel to keep the change lists.
Administration Guide
314 PUBLIC Business Configuration
8.5.1.2 Configuring the Requirements Management and
Systems Modeling Server
The repository administrator is responsible for configuring the Requirements Management and Systems
Modeling server.
Configure connections between SAP EA Designer and external systems to allow your users to create links
between SAP EA Designer model objects and external objects, and to include these external objects in their
impact analysis.
Context
For more information about the model object assignments function, see Assigning Model Objects to External
Objects in the user guide.
Context
To enable the link to SAP EA Designer from your external system, first configure the external system
environment. The model object assignments function can be enabled from the following external systems:
Administration Guide
Business Configuration PUBLIC 315
• For other external systems where the model object assignments function is not originally offered, a URL
pattern is provided to open the external objects in an SAP EA Designer page, where users can view and
make assignments. For details, see (Optional) Enabling Model Object Assignments from Custom External
Systems [page 321].
Context
Before your users can assign model objects to different types of external objects, activate the metamodels for
these object types in SAP EA Designer. You can activate object types predefined in the system at one click by
selecting an appropriate external system, or create custom object types by uploading your own metadata in
a .json file.
Note
To set up the configuration, you must have an SAP EA Designer user with the Edit Extensions on Web right.
For details of user rights in the SAP EA Designer, see Granting Privileges to Users and Groups [page 311].
Procedure
1. In SAP EA Designer, click Administration Settings in the navigation panel, and then click the External
Systems tile.
Two tables are displayed on the page. The left table lists the object types that are currently active, along
with system information of the object type, and the number of objects already saved in SAP EA Designer.
The table on the right lists the predefined object types and their statuses in the system, grouped by the
external systems which provide them.
Note
To review the attributes and other details of each object, click the name of the object type in the tables.
The object types you just activated will now be present in the left table.
For object types that are currently active and marked as Changed in the right table, note that after
another activation, the associated metamodel will be updated and any objects of this type already
saved in SAP EA Designer will be deleted.
c. If you have more than one external system connected to SAP EA Designer for model object
assignments, switch the system versions in the dropdown list and activate all the relevant object types.
Administration Guide
316 PUBLIC Business Configuration
3. Optional: To create custom object types, perform the following steps:
a. Download a metamodel template by selecting Object Type Template. In the downloaded .json file, fill
in the information of your object types based on the template. You can include multiple object types in
the metamodel and import them to SAP EA Designer altogether.
[
{
"ObjectName": "xx.xxx",
"SingleName": "",
"PluralName": "",
"Facet": {
"TitleName": "",
"DisplayOrder": [
""
]
},
"Navigation": "",
"Attributes": [
{
"Name": "",
"KeyIndex": 1,
"DisplayName": ""
}
]
}
]
• ObjectName - Name of the object type. Start the name with a prefix followed by a dot. For
example, “COMPANY.BillOfMaterial”. Do not use SAP as the prefix as it has been reserved for
the predefined objects in the system.
• SingleName / PluralName - Object type name in the singular/plural forms, used in different
places in the application to represent the object type. In this example, the singular name Bill of
Material is displayed as the page title, and the plural name Bills of Material is used in the
property sheet of the associated object.
• TitleName - Name an attribute of your object type so that its value will be displayed as the title
of the object page header during model object assignments. In this example, the TitleName is
displayed as SG22, value of attribute Material.
• DisplayOrder - Enter an array that contains all the attributes that you want your users to see
in the application describing an external object of this type. In this example, the DisplayOrder
is probably defined as "Material,Plant,BOMUsage,AlternativeBOM". These attributes are
displayed in order both in the object page header (attribute that has already been set as the
TitleName will not appear again) and in the property sheet of the associated object.
• Navigation - Define the URL pattern which navigates the user back to the specified page in the
external system. The complete navigation URL is the combination of the external system host URL
Administration Guide
Business Configuration PUBLIC 317
(see section Managing External System Connections in this topic) and the pattern you define here.
You can reference the actual URL in the external system and replace the attribute values with the
placeholder ${AttributeName}.
Example
MaterialBOM-maintenance&//C_BillOfMaterialTP(BillOfMaterial='$
{BillOfMaterial}',BillOfMaterialCategory='${BillOfMaterialCategory}',BillOfMaterialVariant='$
{BillOfMaterialVariant}',BillOfMaterialVersion='$
{BillOfMaterialVersion}',EngineeringChangeDocument='$
{EngineeringChangeDocument}',Material='${Material}',Plant='${Plant}',DraftUUID=guid'$
{DraftUUID}',IsActiveEntity=${IsActiveEntity})
b. Upload the metamodel to create custom object types by selecting Create Custom Object Types. Select
the metamodel you created based on the template or other appropriate .json file from your local
files.
c. Select the custom object types that you want to create in the popup box, then select Activate.
You can also update the attributes (except ObjectName) of existing custom object types by uploading
the modified information.
d. A CSV file is automatically downloaded if the activation failed. Check the file containing the error
details, fix them in your metamodel, then upload again.
Administration Guide
318 PUBLIC Business Configuration
Managing Active External Object Types
Context
Active External Object Types table lists all the available types to link with model objects. In this table, you can
manage all the object types with the action bar. The following table shows the specific operations:
Object Type Template Get the object type template. For more information, see
Activating External Object Types in this topic.
Create Custom Object Types Create custom object types. For more information, see
Activating External Object Types in this topic.
Delete Select an object type or types and click Delete for deletion.
Note
The lineage and impact can be both enabled at the same time. And the Dependency Rule column turns to
Impact and Lineage.
Administration Guide
Business Configuration PUBLIC 319
Managing External System Connections
Context
To allow users to navigate back to the original system of an external object, you must specify the external
system connection in SAP EA Designer.
Note
To make the configuration you must have an SAP EA Designer user with the Edit Extensions on Web right.
For details of user rights in the SAP EA Designer, see Granting Privileges to Users and Groups [page 311].
Procedure
1. In SAP EA Designer, click Administration Settings in the navigation panel, click the External Systems
tile, and then click the System Connections tile.
2. Click the Add tool to add information of a new external system.
3. Fill the following fields, and click Save.
To connect to the Collaboration apps, Host URL of the external system. Enter something that indicates the
enter . purpose of this external system.
Reference the application URL of your
Replace <tenantID> with the ID of external system - Usually the host
the Collaboration apps' subaccount. URL starts from the beginning to the
character "#".
Administration Guide
320 PUBLIC Business Configuration
System ID Host URL System Description
The model object assignments function allows your users to create links between SAP EA Designer model
objects and external objects, and to include these external objects in their impact analysis. For external
systems where the function is not originally offered, a URL pattern is provided for configuration to open the
external objects in an SAP EA Designer page, where users can view and make the assignments.
Reference the URL pattern below for opening external objects in an SAP EA Designer page, where your users
can make model object assignments:
https://<host_name>/eadesigner/resources/index.html#appPage|
{"id":"ExternalLinkEditor","viewName":"externalLink.ExternalLinkEditor","data":
{"SystemID":"${SystemID}","ObjectType":"${ObjectType}","RequirementModel":"$
{RequirementModel}","${KeyName}": "${KeyValue}", "Description":"$
{Description}","Properties":{"${AttributeName}":"${AttributeValue}"}}}|1
The format is similar to a JSON format. The placeholder identified by ${ } should be replaced with the actual
value:
• ${SystemID}: Must be consistent with what you defined in SAP EA Designer, see the Managing External
System Connections section in Connecting to External Systems [page 315].
Administration Guide
Business Configuration PUBLIC 321
• ${ObjectType} : The ObjectType, defined in the metamodel of the external object type, see the Activate
External Object Types section in Connecting to External Systems [page 315].
• ${RequirementModel}: [optional] The SAP EA Designer model that contains the requirements you want
to assign. When this parameter is included in the URL, users are directly navigated inside the specified
requirements model when making assignments.
• ${KeyName} and ${KeyValue}: The object key name and its value. There may be multiple key-value
pairs.
• ${Description}: The description of the external object.
• ${AttributeName} and ${AttributeValue}:The attribute name and its value. There may be multiple
key-value pairs.
Example
https://hostExample.com/eadesigner/resources/index.html#appPage|
{"id":"ExternalLinkEditor","viewName":"externalLink.ExternalLinkEditor","data":
{"SystemID":"SYS001","ObjectType":"BillOfMaterial","Material":"SG22","BillOfMater
ial":"00000001","BillOfMaterialCategory":"M","BillOfMaterialVariant":"1","BillOfM
aterialVersion":"","EngineeringChangeDocument":"","Plant":"4410","DraftUUID":"000
0","IsActiveEntity":true,"Description":"SEMI22,PD,Phantom","Properties":
{"Plant":"4410","BillOfMaterialVariantUsage":"1"}}}|1
Users with the appropriate privileges can review lists of repository activities, change lists, and file locks.
• Log - [requires the Manage All Documents privilege] View events concerning repository documents:
• Check In - User publishes a new document or a new version of a document. This event is also
triggered each time a user saves a draft diagram.
• Change List Submission - User submits a diagram for review.
• Change List Approval / Rejection / Return for Revision - A reviewer approves (publishes),
rejects, or returns a diagram to the user for revision.
• Lock / Unlock - A document is locked for editing or the lock is released manually or by a check in.
• Document Move - User moves a document from one repository folder to another.
• Version Deletion / Document Deletion - User deletes a version of a document or a document.
• Repository Upgrade - Repository is upgraded to a new version.
• Security Log - [requires the Manage Users & Permissions privilege] View events concerning user
accounts:
• User Created - User's account is created.
• Login - User enters correct user name and password combination.
• Logout - User logs out.
• User Deactivated - User is deactivated by an administrator (see Deactivating Users [page 314]).
• User Activated - User is reactivated by an administrator.
• User Accessed - User's account information is accessed by an administrator.
Administration Guide
322 PUBLIC Business Configuration
• User Updated - User's account information is updated by an administrator.
• User Deleted - User's account is deleted by an administrator
• Change Lists - View all your Draft and Submitted change lists. You can delete your own submitted
change list by selecting it and clicking the Delete tool.
Note
Users with the Manage All Documents or Manage Users & Permissions privilege can view all
change lists from all users. If the creator of a change list is unavailable and if you have the Manage All
Documents privilege, you can re-assign this change list using the Re-Assign tool or delete it using the
Delete tool. The list of users to whom you can re-assign the change list is limited to those who have at
least Submit permission on the diagram.
• Locks - View documents that are currently locked in the repository. You can remove a lock from a
document that you have locked by selecting it and clicking the Delete tool.
Note
Users with the Manage All Documents or Manage Users & Permissions privilege can remove
the lock from any document locked by any user.
• Retention Policy - Manage retention of log data (see Defining a Retention Policy for Log Data [page 323])
To reorder any of these lists by values in a column, click in the column header. Some columns also support
filtering on their values. To filter the list by values in any of its text fields, enter two or more characters in the
search box above it.
A repository administrator can specify a retention period for log entries, after which they will be deleted
automatically. By default, log entries are kept indefinitely.
Procedure
1. Click Activities in the navigation panel, and then click the Retention Policy tile.
2. Enter an appropriate value in the Log data retention period (days) field.
For example, to retain log entries for only the last four weeks, enter 28.
3. Click Save to save your changes.
Administration Guide
Business Configuration PUBLIC 323
8.5.1.4 Using APIs
Developers can make authenticated requests to Requirements Management and Systems Modeling APIs to
access its resources.
Requirements Management and Systems Modeling checks user information in API requests to verify whether
the user is permitted to the requested resources. Normally, you can use the OAuth 2.0 authorization grant
types Authorization Code or Resource Owner Password Credentials to obtain the access token in JWT format.
In cases where these grant types don't fit the situation, use the OAuth 2.0 Client Credentials grant as the
alternative authentication type, which doesn't require sending user information. Instead, specify the user
information in Requirements Management and Systems Modeling in advance.
Prerequisites
• To configure the required settings in Requirements Management and Systems Modeling, you must have
the Manage Users and Permissions privilege (see Controlling Repository Access [page 304]).
• You have created a Requirements Management and Systems Modeling user and granted it with the
appropriate permissions and privileges (see Controlling Repository Access [page 304]) that match your
API requests. This user will be used for authorization check when you send the requests.
Procedure
Next Steps
Now you can send API requests to Requirements Management and Systems Modeling using the OAuth 2.0
Client Credentials grant type. Then refer to Configuration for Using APIs [page 455] to create a service and
Administration Guide
324 PUBLIC Business Configuration
a service key. With the service key, you can get the parameters Client ID, Client Secret, and Access
Token URL. For more information, see Requirements Management and Systems Modeling Reference .
Requirements Management and Systems Modeling provides an API that lets you export repository content.
In order to be able to use the API, you must be connected to Requirements Management and Systems
Modeling or call a GET query from the same browser session.
<Web-client-URL>/api/v1/repositoryDocuments?path=<path to
model>&documentType=<model-type>
<Web-client-URL>/api/v1/repositoryDocuments?path=<path to
folder>&documentType=Folder
Note
The path should not start with /. Folder names must be separated with / (before encoding). Therefore, if a
folder or model name contains the / character, you need to encode it with %2F first, then encode the path.
documentType indicates the type of path. If the path refers to a folder you must specify
documentType=Folder, if the path refers to a model you must specify the model type (EAM, BPM...).
documentType can be omitted if the path name is unambiguous, but is required is there are several models
with different types and the same name.
Sample Code
{
"d":{ "exportRepositoryApi": "<base64-encoded-content>" }
}
In order to produce a ZIP result similar to the result obtained when using the Export to Repository Zip File
command from the from the GUI, you must then decode the exported content (which is a base64 encoded ZIP
blob) using your favorite converter tool or method.
The resulting ZIP file can contain folders, model JSON files and extension JSON files.
Administration Guide
Business Configuration PUBLIC 325
• 401: Permission denied. User does not have the permission to view or export the document.
• 404: Repository document not found. The document specified in path does not exist.
• 406: Export is not supported. Repository folder is root, repository folder contains branch or
document does not support export.
• 500: Internal error
http://<host-name>:<port-number>/eadesigner/api/v1/docs
Users with the Edit Extensions on Web privilege can define custom properties and dependencies for
standard types of objects, and can create custom objects.
• Custom properties for objects (see Creating Custom Properties [page 326]).
• Custom dependencies for objects (see Creating Custom Dependencies [page 328]).
• Custom lists of values for object properties (see Customizing Lists of Values [page 330]).
• Customized property sheets (see Customizing Object Property Sheets [page 331]).
• Custom objects (see Creating Custom Object Types [page 332]).
These customizations must be packaged in custom extension files, which can be manually attached to models
(see Creating Custom Extension Files [page 334]) or used as a new type of model for selection in the New
Model dialog (see Making Your Customizations Available in the New Model Dialog [page 337]).
Users with the Edit Extensions on Web privilege can define custom properties for objects. Custom
properties are displayed on the Info tab of objects of the specified type, by default in a section entitled Custom
Properties.
Procedure
Note
If your object type is not present, click the + button, and then click the object type to add it to the list
and open it.
Administration Guide
326 PUBLIC Business Configuration
4. In the Properties section, click the + button to create a property, and enter:
Property Description
Name Specifies the name of the property as it will appear in the interface.
Code Specifies the internal name of the property, which must not contain spaces or the dot character
and must be unique for this class of objects.
Caution
If you change the code after the property is in use, then any values set in models will be lost.
Default Value Specifies the value of the property that will be set in the interface by default.
Complete Specifies that only values defined in the List of Values box can be used for this property.
Multi-selection Specifies that you can enter more than one value for this property.
Object type [object] Click the Select tool to open a list to choose the type of object with which to populate
the property. By default, the object types from the current model type are listed. To select from
another type of model, click the More Types button and select the required model type.
In this example, a new boolean property is created for the Data Store class:
Administration Guide
Business Configuration PUBLIC 327
5. Click Save to save your changes.
6. Optionally, customize the property sheet to move the new property from the Custom Properties section
(see Customizing Object Property Sheets [page 331]).
The new property is available to all objects of the specified type on their Info tab, by default in a section
entitled Custom Properties:
Users with the Edit Extensions on Web privilege can define new types of dependencies for modeling
objects. Custom dependencies are displayed on the Dependencies tab of objects of the specified type.
Procedure
Note
If your object type is not present, click the + button, and then click the object type to add it to the list
and open it.
4. In the Dependencies section, click the + button to create a dependency and choose the type of object with
which to populate the dependency list. By default, the object types from the current model type are listed.
To select from another type of model, click the More Types button and select the required model type.
Administration Guide
328 PUBLIC Business Configuration
Property Description
Name Specifies the name of the dependency list as it will appear in the interface on the Dependencies
tab.
Code Specifies the internal name of the dependency, which must not contain spaces or the dot
character and must be unique for this class of objects.
Caution
If you change the code after the dependency is in use, then any values set in models will be
lost.
Object type Click the Select tool to change the type of object for the dependency list.
In this example, a new dependency list is created for the Business Capability class:
Administration Guide
Business Configuration PUBLIC 329
8.5.1.5.3 Customizing Lists of Values
Users with the Edit Extensions on Web privilege can modify the lists of values available for certain
standard object properties, such as the Type, Status, and Priority properties of requirements or the
Development Language, Operating System, and Type of applications.
Procedure
All the properties with lists of values that can be edited are listed.
4. Click the property you want to edit to display its property sheet, and then click the Edit tool to the right of
the List of Values field.
5. The Values dialog lists all the available values for the property as a:
• Value - specifies the internal value, which must respect the datatype of the property.
• Label - specifies how the value is displayed in the UI.
Note
Some values depend on another property, such as the type of parent of the object. In this case, the
type of dependency is specified above the list and as an additional column in the list.
Note
The order in which labels are displayed in the list in the UI is controled by the Value.
• Delete or add value-label pairs using the tools above the list
7. Click OK to save your changes.
The updated list of values is immediately available to all objects of the specified type.
Administration Guide
330 PUBLIC Business Configuration
8.5.1.5.4 Renaming Standard Object Types
Users with the Edit Extensions on Web privilege can change the name used to identify standard object
types in object lists, property sheets, the diagram toolbox, and other places in the UI.
Procedure
Note
If your object type is not present, click the + button, and then click the object type to add it to the list
and open it.
4. Enter the new name for the object type in the Name field and the new plural form in the Plural field.
5. Click Save to save your changes.
The new object type name replaces the standard name in object lists, property sheets, the diagram
toolbox, and other places in the UI.
Users with the Edit Extensions on Web privilege can customize object property sheets by moving and
hiding properties and creating new sections on the Info tab.
Procedure
Note
If your object type is not present, click the + button, and then click the object type to add it to the list
and open it.
4. Click the Edit button to the right of the Property Sheet field to open the Property Sheet dialog, which
displays the Info tab sections and properties in a tree format.
Administration Guide
Business Configuration PUBLIC 331
• Move a property - Drag the property and drop it onto a section or between two properties.
Alternatively, select the property, click the Cut button, then select a section or other property and
click the Paste button.
Note
You cannot drag and drop properties if any item is selected in the list.
Note
You cannot move or manually hide either standard or new sections. However, a section will be
hidden if it contains no properties or all its properties are hidden.
The customized property sheet is available to all objects of the specified type.
Note
To revert your property sheet customizations, click the Delete tool to the right of the property sheet
field.
Users with the Edit Extensions on Web privilege can define new types of objects to be modeled. Custom
object types have their own object lists and, if the Symbol option is selected, have a tool displayed in the
Custom Tools category of the Toolbox.
Procedure
Property Description
Name Specifies the name of the object type as it will appear in the interface.
Code Specifies the internal name of the object type, which must not contain spaces or the dot
character and must be unique.
Administration Guide
332 PUBLIC Business Configuration
Property Description
Plural Specifies the plural form of the object name as it will appear in certain contexts.
Base class Specifies the standard object type on which the new object type is based. By default the
Extended Object class, which has only minimal standard properties, is selected, but you
can base your new object on any of the standard objects in this type of model.
For example, in an EAM, you could base a new object type, Factory, on the standard Site
class. A factory would automatically inherit the standard properties of a site, and you could
define additional properties, such as Annual production.
Symbol Specifies that the custom object can appear in diagrams and can be created from the toolbox.
When you select this option, you can also specify a toolbox icon from the UI5 icon library). The
icon you choose will also be used inside the object diagram symbol.
Note
If you do not select this option, the custom object can only be created in its object list.
Properties Specify properties as appropriate (see Creating Custom Properties [page 326]).
Dependencies Specify dependencies as appropriate (see Creating Custom Dependencies [page 328]).
Note
If you want to immediately use the new object type as a property or dependency for another object
type, you must refresh your browser tab to make it available for selection.
The custom object is available in its own object list in models of the selected type:
If the Symbol option is selected, a tool is available in the toolbox in the Custom Tools category:
Administration Guide
Business Configuration PUBLIC 333
8.5.1.5.7 Creating Custom Extension Files
Users with the Edit Extensions on Web privilege can define custom extension files to package their
customizations, which can then be manually attached to models or added as new types of diagrams in the New
Model dialog.
Procedure
The custom extension file is created and opens in the editor. The type of the extensions created by users is
User-defined Extension.
3. Click the + button to add the types of object that you want to customize:
Administration Guide
334 PUBLIC Business Configuration
Note
You can only delete a custom extension file if it is not attached to any model. If you need to rename a
custom extension, select it and click the Rename button.
The Attached Models column shows the number of models that use each extension. You can click the
number displayed in this column to open the list of models that are attached to the corresponding
extension. In some cases, models attached to the extension may not be displayed in this list due to
access restrictions.
Users with the Edit Extensions on Web privilege can define custom checks for objects. Custom checks
can be used when verifying diagrams (see Verifying Diagrams).
Context
For example, you may want to ensure that all Windows applications included in a specific enterprise
architecture diagram are developed in Javascript. In that case, the applications will be first checked for
operating system (using a pre-condition), and then all the Windows applications that do not meet the verify
expression condition (which is being developed in Javascript) will be reported as non-compliant during model
verification.
Procedure
Note
If your object type is not present, click the + button, and then click the object type to add it to the list
and open it.
4. In the Custom Check section, click the + button to create a custom check, and enter:
Property Description
Message Specifies the nature of the check done. This message will be displayed in the Errors and
Warnings panel (see Verifying Diagrams).
Administration Guide
Business Configuration PUBLIC 335
Property Description
Verify Expression Specifies the expression that must be satisfied to avoid the display of a warning or error.
Enabled Specifies if the custom check is active. Check this box if you want your custom check to be used
by the verify model feature.
Severity Specifies whether the check is designated by default as an Error (major problem that stops
generation) or as a Warning.
Pre-Condition Ex- Specifies one or more initial conditions that must be satisfied before the verify expression is
pression evaluated.
Click the Edit Pre Condition Expression tool to specify the expressions.
You can attach a custom extension file to a model to make the customizations defined in it available in the
model.
Procedure
1. Open a diagram in the model to which you want to attach the custom extension file. If it is not already in
edit mode, click Edit.
2. On the diagram property sheet Info tab, expand the Version Info section, and click the Model link to go to
the model property sheet.
3. Click the Children tab and expand the Extensions list.
4. Click the + tool, select the custom extension to attach, and click Select.
5. Click Save to activate the custom extension.
Once the model is saved, the customizations are available for use.
Administration Guide
336 PUBLIC Business Configuration
8.5.1.5.10 Making Your Customizations Available in the New
Model Dialog
You can associate your custom extensions with new types of diagrams and make them available in the New
Model dialog.
Procedure
1. Create a custom extension file (see Creating Custom Extension Files [page 334]) and define your
customizations in it as appropriate.
2. Create a model template:
a. In the repository explorer, navigate to the Library/Resources/Model Templates folder and click
the + tile to create a new model.
b. In the New Model dialog, enter the following values and then click Create:
• Name - Enter the name that you want to appear as the new model type.
• Type - Select the standard model type that your extension file is based on.
Note
You can create a model template in this folder with the same name as an existing model type
(as displayed in the Type list of the New Model dialog) in order to override the predefined model
template.
3. Attach your custom extension file to the model (see Attaching a Custom Extension File to a Model [page
336]).
4. Publish and preview the new model type:
Note
You must refresh the page in order to see the new model type. It will be available for other users
when they next log in.
c. Click the New Model quick link and expand the Type list to confirm that your new type is included.
5. [optional] Restrict the availability of the new model type to certain groups of users:
a. In the repository explorer, navigate to the Library/Resources/Model Templates folder and then
click the model template name in the Documents pane to display its property sheet.
b. Click the Permissions tab to display the permissions granted on the model template.
c. Remove the All Users group from the list.
d. Add those groups or users to whom you want to give access to the new model type to the list and
assign them Read permission.
Administration Guide
Business Configuration PUBLIC 337
8.5.1.6 Configuring Concurrent Editing
A repository administrator can use the Concurrent Editing tile to manage draft types for editing.
In Requirements Management and Systems Modeling, click Administration Settings in the navigation
panel, and then click the Concurrent Editing tile.
There are two types provided for editing requirement drafts: Shared and Separate. By default, the two types are
selected so that users can edit requirement models with shared or separate mode.
If only one type is selected, users can edit requirement models with the selected mode only.
If neither of the types is selected, the concurrent editing is disabled. One requirement model can only be edited
by only one user.
A repository administrator can use the Report Configurations tile to manage report templates.
Users can customize templates of reports generated from requirements. The templates are only applied to PDF
format.
Click Administration Settings in the navigation panel, and then click the Report Configurations tile..
Properties Description
Header Supports rich text and image. For images, only png and jpg
formats are supported.
Footer Supports rich text and image. For images, only png and jpg
formats are supported.
Note
For header and footer settings, if the text is blank, the image is placed at the top left of the report.
For image import, image optimization is implemented. If the length-width ratio is less than 1.5, the length is
set as 60 pixels with a fixed aspect ratio. If the length-width ratio is more than 1.5, the length is set as 120
pixels with a fixed aspect ratio.
Administration Guide
338 PUBLIC Business Configuration
After the properties are set, users can click Save to save the current template, or click Save as to save as a new
template.
A repository administrator can use the Color Configurations for Impact Analysis tile to customize object colors
and create color templates so that users can differentiate object types.
Procedure
1. Click Administration Settings in the navigation panel, and then click the Color Configuration for
Impact Analysis tile.
By default, there is no color template. But you can add colors in the Configure Colors table and save them
as a template. Each color template that you create contains all the colors listed in the table.
2. Choose to customize colors for Requirements Management and Systems Modeling objects or external
objects by switching between EA Designer and External tabs.
The following steps take the Requirements Management and Systems Modeling as an example.
3. Optionally, choose the Add icon to add one or more colors for the objects.
4. Configure colors.
Choose Color Choose a color for the object from the color palette.
As the external objects are activated in the External System, you can not add objects in the table, but only
choose a color for them. For the information about how to activate the external objects, see Connecting to
External Systems [page 315].
5. Choose Save As to save the current color template, including the colors you've added, as a new template.
The Save button is used to save the changes to the current template.
Administration Guide
Business Configuration PUBLIC 339
8.5.1.9 Configuring Global Identification
A repository administrator can enable the global identification feature and specify the global identification
format.
Context
For more information about the global identification feature, see Assigning Global Identifiers to Model Objects.
Procedure
1. Click Administration Settings in the navigation panel, and then click the Global Identification tile.
2. Check the Enable Global Identifier box.
3. Specify the Prefix and Suffix values.
'a'-'z','A'-'Z','0'-'9'
If other users are working on the repository when you modify the global identifier format, you might ask
them refresh their browser or disconnect/reconnect in order to implement new format.
This guide provides an overview of the security concepts used and recommended in administering an SAP
Enterprise Architecture Designer, Cloud Edition environment. It is aimed at technology consultants, security
consultants, and system administrators.
Note
This guide should be read in the context of and as a supplement to the SAP BTP Security Guide.
As it becomes more and more important for organizations to protect their critical data from unauthorized
access and to ensure compliance with a growing number of rules and regulations, the demands on security
are also on the rise. As a repository for your enterprise metadata, SAP EA Designer can contain sensitive
information about your organization and its systems. It is therefore essential that you integrate SAP EA
Designer into your infrastructures securely and that you protect your data in SAP EA Designer.
Administration Guide
340 PUBLIC Business Configuration
This guide provides an overview of the security-relevant information that applies to SAP Enterprise
Architecture Designer, Cloud Edition:
Auditing provides you with visibility on who did what in the Requirements Management and Systems Modeling
repository (or tried to do what) and when.
Auditing allows you to monitor and record selected actions performed in the Requirements Management and
Systems Modeling repository. Although auditing does not directly increase your system's security, if wisely
designed, it can help you achieve greater security in the following ways:
• Uncover security holes if too many privileges were granted to some user
• Show attempts to breach security
• Protect the system owner against accusations of security violations and data misuse
• Allow the system owner to meet security standards
For information about viewing lists of events concerning repository documents and user accounts, see
Monitoring Repository Activities [page 322].
Data protection is associated with numerous legal requirements and privacy concerns. In addition to
compliance with general data privacy acts, it is necessary to consider compliance with industry-specific
legislation in different countries.
For general information about data protection and privacy on SAP BTP, see the documentation under Data
Protection and Privacy.
Note
In the majority of cases, compliance with data privacy laws is not a product feature. SAP software supports
data privacy by providing security features and specific functions relevant to data protection, such as
functions for the deletion of personal data. SAP does not provide legal advice in any form. The definitions
and other terms used in this guide are not taken from any given legal source.
The logins, names, and email addresses of users are stored in their SAP EA Designer repository user accounts,
and may be created manually by an administrator or copied from an external identity provider. No consent is
Administration Guide
Business Configuration PUBLIC 341
requested for storing this information, as consent is considered to be implied through the user's employment
contract. If your organization requires that consent must be explicitly obtained, administrators must put in
place their own processes for obtaining such consent.
Note
This product contains open or freely configurable entry fields, which are not intended for storing personal
data without additional technical and organizational measures to safeguard data protection and privacy.
Users can view and download the information stored about them at any time by clicking their user name and
selecting User Account.
If a user is removed from an external identity provider, any information that was copied to SAP EA Designer
must be removed manually by deactivating their repository user account.
When a user is deactivated, any information held about them is deleted except for the log of their checkins and
other repository actions, which remain available to other users for auditing purposes (see Deactivating Users
[page 314]).
Account Termination
After receiving written notice of a customer's intention to terminate their account (or if an account is not
renewed), SAP will retain customer data for 60 days, and then will irrevocably delete all data including backups
within 14 days as follows:
• Notice Period (30 days) - The account is fully productive and accessible as usual, and the customer may
export their data.
• Grace Period (30 days) - Access to the account is blocked, but backups continue and the customer can
restore their account to a fully active account without data loss.
• Retention Period (14 days) - All services are deleted and any remaining backups will be deleted before the
end of the retention period.
Any time that the information stored in a user's repository account is accessed or modified by an
administrator, the event is recorded in the security log.
The security log can only be accessed by an administrator with the Manage Users & Permissions privilege
(see Monitoring Repository Activities [page 322]).
Administration Guide
342 PUBLIC Business Configuration
8.5.1.10.3 Identity and Access Managment
Every user who wants to work with the repository must have a repository user with the necessary privileges
and permissions. After a successful logon, the user's authorization to perform the requested operations on the
requested objects is verified.
Repository privileges give users access to general repository features, while permissions give them access to
particular locations in the repository. The following privileges and permissions are available:
• Connect - Connect to the repository and view di- • List - This permission level is not currently in use.
agrams in Requirements Management and Systems
• Read - Open and compare documents.
Modeling.
• Export from Web - Export content from
• Submit - Also propose changes to the document for
Requirements Management and Systems Modeling as review by a user with Write permission.
a repository Zip file, report or PowerPoint. • Write - Also review changes by other users and pub-
• Edit on Web - Create and edit diagrams in lish changes directly.
Requirements Management and Systems Modeling. • Full - Also move and delete documents, and manage
• Edit Extensions on Web - Create and edit permissions granted to users and groups.
custom properties in Requirements Management and
Systems Modeling. Gives access to the Customize item
Note
in the navigation panel.
• Manage All Documents - Perform any action on Administrators, who have implicit Full permission
any document version. Implicitly includes Full per- on all repository objects, will only receive models
mission on all repository documents. Gives access to for review if they have been granted explicit Write
the Activities/Log tile. permission on them.
• Manage Users & Permissions - Create, mod-
ify, and delete repository users and groups, grant
them privileges, and add them to groups. Users with
this privilege can list all repository documents and
set permissions on them without needing explicit
Full permission. Gives access to the Administration/
Users, Administration/Groups, and Activities/Security
Log tiles.
• Manage Repository - Gives access to the
Administration/Settings item.
Privileges and permissions can be granted to repository users either directly, or indirectly through groups.
Authentication to the SAP EA Designer repository is delegated to an identity provider configured in the SAP
BTP.
Administration Guide
Business Configuration PUBLIC 343
User Administration Tools
In order to manage repository users and groups, you must have the Manage Users privilege. In order to grant
permission on a repository folder or document, you must have Full permission on the folder or document.
• Administrators, [ADMN] - Has, by default, all available privileges and implicit Full permission on all
repository folders.
• All users [PUBLIC] - Has, by default, Read permission on the repository root. All users belong to this group
and can thus, by default, browse any diagram.
SAP EA Designer supports the enforcement of reviewing proposed changes to repository documents through
the use of the Submit permission, which requires users to pass through a review process before publication.
8.5.1.10.4 Cookies
Session cookies are required for each SAP EA Designer client session and are deleted when the session is
closed. Additional persistent cookies are used to store the most recent choices for content language and user
interface language.
Description: After you choose the Requirement Management and Systems Modeling tile in the SAP Fiori
launchpad, the SAP PowerDesigner logon page is displayed as shown in the following screenshot, instead of the
Requirement Management and Systems Modeling application page.
Administration Guide
344 PUBLIC Business Configuration
Suggestion: Clear the cookie of the browser and reopen the Requirement Management and Systems Modeling
application.
When integrating via PLMSI, you should carry out the configuration steps as outlined in Initial Configuration
before you proceed to the configuration steps mentioned below.
For a streamlined setup and operation of Enterprise Product Structure, certain default values need to be set up
which includes configuring BOM usages, default folder, product types, and material master data attributes. The
Configure Product Structure app lets system administrators perform these configurations tasks.
Prerequisite
• You must be assigned the StructureAdministrator role as mentioned in Role Templates for Enterprise
Product Structure [page 70].
• You've set up destinations on SAP BTP to connect to your source systems to retrieve data from it. For more
details, see Configuring Connectivity for Enterprise Product Structure [page 144].
Administration Guide
Business Configuration PUBLIC 345
General
Options Description
Default Folder A default folder is a folder that has been set up as the fall-
back folder.
Source System Source system is a SAP ERP system. The value entered here
will be used as the default value.
Options Description
Industry The industry code that you enter here becomes the default
industry sector for all the configurable early products.
Note
Select an industry code from those defined in your SAP
ERP system. Transaction OMS3 may be used to list the
configured industry codes in your SAP ERP system.
Product Type The product type selected here becomes the default product
type for all the configurable early products.
Base UoM The base unit of measure that you select here becomes the
default base unit of measure for all the configurable early
products.
Administration Guide
346 PUBLIC Business Configuration
Non-configurable Product Defaults
Options Description
Industry The ID that you enter here becomes the default industry
sector for all the nonconfigurable early products.
Note
Select an industry code from those defined in your SAP
ERP system. Transaction OMS3 may be used to list the
configured industry codes in your SAP ERP system.
Product Type The product type selected here becomes the default product
type for all the nonconfigurable early products.
Base UoM The base unit of measure that you select here becomes the
default base unit of measure for all the nonconfigurable early
products.
BOM Defaults
Option Description
BOM Usage The BOM usage specified here is used as the default usage
for any structure that is created in the Product Structure
app. The default BOM usage is also used when a BOM Usage
is required but not specified by the user or an API caller.
For example, BOMs created by Product Data Integration are
created with this usage.
The BOM Usage dropdown list displays only the usages that
have been imported from the source system and marked as
active for Enterprise Product Structure.
Administration Guide
Business Configuration PUBLIC 347
8.6.2 Configuring BOM Usages
Import BOM usages from a source system to configure them for Enterprise Product Structure. Once
configured, the imported BOM usages are available to the users in the BOM Usage filter options in the Product
Structures app. Only active BOM Usages are displayed to users in the filter.
Prerequisites
• You must be assigned the StructureAdministrator role as mentioned in Role Templates for Enterprise
Product Structure [page 70].
• You've set up destinations on SAP BTP to connect to your source systems to retrieve data from it. For more
details, see Configuring Connectivity for Enterprise Product Structure [page 144].
Procedure
1. Open the BOM Usages app from the SAP Fiori launchpad.
2. To import BOM usages from a source system, choose Import and select the source system from which you
would like to import the BOM usages.
Note
When importing BOM usages, the description of matching BOM usages that are imported from another
source system previously, is overwritten with the description of the selected source system.
3. To change the status of the BOM usages, select the BOM usages and choose Activate.
Note
The BOM usages imported from a source system are, by default, Inactive in status. When a BOM usage
is inactive, it doesn't appear in the BOM Usage filter. To enable a BOM usage to be available as a filter
option, you need to activate them.
4. Once the import is completed, the BOM Usages table refreshes and displays the imported BOM usages.
Import plants from a source system so that they can be referenced in Enterprise Product Structure. Once
configured, the imported plants are available for users to select in the Plants filter in the Product Structures
app. Only active plants are displayed to users.
For information on how to import plants, see Configuring Plants [page 293].
Administration Guide
348 PUBLIC Business Configuration
8.6.4 Configuring Document Synchronization
You can configure which document types should be included in synchronization (or excluded from
synchronization) through the Configure Document Synchronization app.
Prerequisites
You must be assigned the StructureAdministrator role as mentioned in Role Templates for Enterprise
Product Structure [page 70].
Context
Document types are defined in the source system. A document can be assigned to a BOM at different
levels such as BOM Header, Product, BOM Component or as a component of document type. During the
synchronization of a BOM, the Enterprise Product Structure also enables synchronization of the linked files
from the on-premise Content Server to the Document Management system in SAP BTP.
You can choose toc during this process. When documents are excluded from synchronization, the documents
aren't retrieved from the on-premise Content Server and not uploaded on the SAP BTP Document
Management System. However, users can still download those files from the Files tab in Documents and are
fetched from the on-premise Content Server.
Note
If no document types are configured as per this section, by default all document types are excluded from
synchronization from the on-premise Content Server to the SAP BTP Document Management System.
Procedure
1. Open the Configure Doument Synchronization app from the SAP Fiori launchpad.
2. Choose Enable Cloud Documents.
Note
Once cloud documents are successfully enabled, the Enable Cloud Documents option remains
disabled.
Administration Guide
Business Configuration PUBLIC 349
• Include in Synchronization: Choose this option if you want to include all the listed document types
in the synchronization. The document types that aren't displayed in the list are excluded from
synchronization.
4. To add a document type, choose Add and enter the following details:
• Code: Enter the document type that has been defined in your source system.
• Description: Enter a suitable description of the document type.
5. Choose OK to add the document type.
6. To switch between synchronization options after adding document types, repeat the actions from Step 3.
You, as a System Administrator, can enable Visualization integration for product structures so that users can
generate 3D models and thumbnails for product structures.
Prerequisites
• You must be assigned the StructureAdministrator role as mentioned in Role Templates for Enterprise
Product Structure [page 70].
• You must be subscribed to the Visualization SaaS application. For more details, see Subscribing to the
SaaS Applications [page 23].
• You're assigned the appropriate visualization roles like ProjectCreator role to create the visualization
root folder, ContentReader to view the 3D models, ContentUpdater to update or rename visualizations,
and ContentCreator to generate visualizations. For more details, see Role Templates for Visualization
[page 98].
• You've set up destinations on SAP BTP to connect to your source systems to retrieve data from it. For more
details, see Configuring Connectivity for Enterprise Product Structure [page 144].
• Your source system must have an on-premise integration with SAP Engineering Control Center or SAP
Teamcenter by Siemens system.
Procedure
1. Launch the Common Functions SaaS application on SAP Fiori launchpad and choose the Manage Teams
app to create a group of users who can have access to the Visualization SaaS application. For more details,
see Manage Teams.
Tip
It's recommended that you create two user groups, for example, Enterprise Product Structure
Users and Enterprise Product Structure Administrators. The Enterprise Product
Structure Users group must be assigned the Create, Read, and Update permissions to the
root folder (that you create in Step 3) and enclosed content. Enterprise Product Structure
Administration Guide
350 PUBLIC Business Configuration
Administrators must be assigned Create, Read, Update, Delete, and Admin on the root folder and
enclosed content.
2. Launch the Visualization SaaS application in SAP Fiori launchpad and choose the Browse app.
3. Create a root folder, such as, Enterprise Product Structure and choose (More) and then choose
(Access and Permissions).
Note
For users to access the visualizations of products, you must assign them the Create, Read, Update
permissions.
5. Open the Enterprise Product Structure SaaS application on the SAP Fiori launchpad and choose the
Configure Visualizations app.
6. Select the visualization folder that you created in Step 3 as the root folder.
Note
Once you've set the root folder in the Visualization tab, you shouldn't change your selection to another
folder. If you change the root folder, you need to delete the older root folder or delete the visualization
within it. You must also assign the permissions to access the new root folder to the user group as
mentioned in Step 4. If these actions aren't performed, then the system starts to show warnings about
duplicate visualizations when viewing dynamic visualizations.
The Create Document Type window displays. You can enter the document types, description, and their
name pattern.
Note
• You must configure all the CAD document types that you want to use for visualization, otherwise
some parts in the visualization aren't generated. If the system fails to find or generate some parts,
a warning message is displayed.
• Enterprise Product Structure supports dynamic visualization only which means that you can
configure file types that contain CAD part files only. It's recommended to not configure CAD
assembly file types.
Related Information
Administration Guide
Business Configuration PUBLIC 351
8.6.6 Configuring Product Types
Import product types from a source system so that you can assign a product type to an early product. You can
also import a codelist to Enterprise Product Structure so that a description is displayed next to the product
type, instead of only product type codes. Additionally, you can choose if a product type can be configurable or
not.
Prerequisites
• You must be assigned the StructureAdministrator role as mentioned in Role Templates for Enterprise
Product Structure [page 70].
• You've set up destinations on SAP BTP to connect to your source systems to retrieve data from it. For more
details, see Configuring Connectivity for Enterprise Product Structure [page 144].
Procedure
1. Open the Product Types app from the SAP Fiori launchpad.
2. To import product types from a source system, choose Import and select the source system from which
you would like to import product types.
Note
When importing product types, the description of matching product types that are imported from
another source system previously, is overwritten with the description of the selected source system.
3. To change the status of a product type, select the product type and choose Activate.
Note
The product types imported from a source system are, by default, Inactive in status. When a product
type is inactive, it doesn't appear in the Product Type filter. To enable a product type to be available as a
filter option, you need to activate them.
4. Once the import is completed, the Product Types table refreshes and displays the imported product types.
5. To make a product type configurable, select the product type and choose Configurable.
A configurable product is a product of which different variants are available. It consists of interwoven
structures of classification and decomposition, and can further contain individual and complex objects.
6. To make a product type nonconfigurable, select the product type and choose Nonconfigurable.
Administration Guide
352 PUBLIC Business Configuration
8.6.7 Troubleshooting and Common Errors
In the Configure Product Structure app, You don't have the Read access to the To configure visualization, you must
the Visualization tab is displaying fol- visualization root folder. have the administrative permission on
lowing message: The system has a the Enterprise Product Structure root
configured visualization folder ID '<XX- folder created for visualization. For
XX-XX>', but it isn't one of the folders more details, see Configuring Visualiza-
accessible to the current user. Refer tion [page 350].
to the Administration Guide for further
information. Note
Don't change the configured root
folder, it can break the integration
for the existing users.
Administration Guide
Business Configuration PUBLIC 353
Errors Reason Solution
Administration Guide
354 PUBLIC Business Configuration
Errors Reason Solution
Multiple folders configured as root: Multiple folders have been found that The folders that are beng identified as
[folder name 1, folder name 2]. Please are identified as the visualization root the Visualization root folder, are men-
see Administration Guide for informa- folder. There should only be one folder. tioned in the error message. You need
tion on how to resolve this. to perform the following steps to re-
move these folders as Visualization root
folders:
Generating Visualizations
Choosing the Generate Visualizations The visualizations have already been Check if the visualizations are display-
button in the Product screen displays generated and there are no document ing and have been generated before by
the following message: '0' parts queued changes detected by the system, so viewing the 3D model for the BOM.
for 3D processing. there's no processing required.
Go to the product structure details ta-
ble and choose the 3D button to view
3D model.
Administration Guide
Business Configuration PUBLIC 355
Errors Reason Solution
The product doesn't have any parts that Check if the visualization configuration
match the configuration profile. for the Engineering BOM Usages and
Document type and file name pattern
have been configured correctly. For
more details, see Configuring Visualiza-
tion [page 350].
Choosing the Generate Visualizations You don't have access to the root folder Ask you administrator to check the Task
button in the Product screen displays in visualization where the models are Monitoring tab and see if there are any
the following message: 'n' parts queued stored. errors or warnings. It can be that the
for 3D processing. system isn't configured correctly or it
could be that your user account doesn't
However, the visualizations haven't
have access. For more details, see Task
been generated and the same message
Monitoring.
displays if you repeat the action.
Viewing Visualization
Choosing 3D button displays the view- You don't have permission to read the Check if you're added to the group cre-
port containing warning: Unable to find visualization data. ated by your system administrator that
a visualization and no geometry is has the Read permission to the visuali-
loaded in the 3D viewport. zation folder. For more details, see Con-
figuring Visualization [page 350].
Some parts are missing from the view- Visualizations haven't been generated Go to the Product screen for the
port and there are a few warnings dis- for these parts. top-level component and choose the
playing the message: Unable to find a Generate Visualizations button.
visualization.
On viewing a visualization, warnings are Your system administrator has moved Delete the duplicate visualizations from
displaying following message: Multiple the Enterprise Product Structure root the older folder.
Visualizations are found. folder in EPD visualization. The system
doesn't know which visualization to
choose.
Administration Guide
356 PUBLIC Business Configuration
Errors Reason Solution
Access permissions have been set in- • Check the permissions as set cor-
correctly to the visualization root folder. rectly for Product Structure users.
For more details, see Configuring
Visualization [page 350].
• Locate and delete the duplicate
visualizations by performing the
following steps:
1. Launch the Visualization SaaS
application in SAP Fiori
launchpad and choose the
Browse app.
2. Choose Show Filter Bar to dis-
play your selection of filter op-
tions.
3. Search for relevant visualiza-
tions by entering the visualiza-
tion's usages, product name,
minor version in the search fil-
ters.
You can access the details
mentioned previously from
the Details window of the Task
Monitoring tab, see Task Moni-
toring.
4. In the search results, you can
either:
• Edit the duplicate visuali-
zations to remove the as-
signed ID usage, see Edit-
ing Visualizations and ID
Usages Panel for details,
or.
• Delete the duplicate vis-
ualization, see Deleting
Visualizations for details.
This chapter describes the business configuration needed to work with the various apps within the Formulation
SaaS application of SAP Product Lifecycle Management.
Administration Guide
Business Configuration PUBLIC 357
• Using Recipe Types [page 358]
• Configuring Calculations [page 361]
• Synchronization of Data [page 369]
• Translation of Data [page 371]
• Cross-Product Features used in Formulation [page 371]
Prerequisites
• Before you get started, make sure you've subscribed to Specification Management, and that
the administrator has completed all necessary configurations. For more information, see Business
Configuration for Specification Management [page 379].
• Your user must have the proper roles as described in the following document: Role Templates for
Formulation [page 72]
Recipe types serve to differentiate recipes based on business purposes and control recipe behavior.
When creating a recipe, you need first to assign a recipe type to it. Recipe type assignment affects the
following:
Prerequisites:
Configure status profiles in the Manage Statuses app. For more information, refer to: Managing Statuses [page
182].
Procedure:
1. From the SAP Fiori launchpad, open the Recipe Types app.
2. Choose Create, or select an existing recipe type to copy from and choose Copy.
3. Provide an ID and a name for the recipe type.
4. Specify a status profile to define the set of statuses that will be applicable to recipes with this recipe type.
Administration Guide
358 PUBLIC Business Configuration
5. Select a role in composition group to define a set of roles in composition which values will be used as
component types for input and output items in the recipe formula. For more information, see Roles in
Composition [page 391].
6. (Optional) Add translations for the recipe type name. Go to the Translations section and select the
language code from the list, then add the translation.
7. Select the Primary Output Specification checkbox if you want that recipes with this recipe type can be
linked to a primary output specification.
8. Choose Release to release your recipe type.
Note
Recipes can only be created with recipe types that have the Released status.
Note
Once a recipe type is created, you can set the following statuses:
Note
Note
You can edit the recipe type object when the status is set to In Work or Released.
The Configure Component Types for Formulation app enables administrators to define how component types
are used within a formula. Component types are attributes that describe the functions of input and output
items in the recipe formula.
Note
Component types correspond to the values of roles in composition. Therefore, configurations for
component types are created based on groups for roles in composition.
Administration Guide
Business Configuration PUBLIC 359
Prerequisites
• Your user has the proper roles as described in the following document: Role Templates for Formulation
[page 72].
• The corresponding groups for roles in composition have been created and released in the Groups for Roles
in Composition app. For more information, see Roles in Composition [page 391].
• The groups for roles in composition data have been synchronized with Formulation using the Synchronize
Data for Formulation app. For more information, see Synchronization of Data [page 369].
Note
Only one configuration can be created per each group for roles in composition.
4. Choose Continue.
5. Select the component types that will be available for input and output formula items. Multiple selections
for each component type are allowed.
6. (Optional) Choose which component types will be the default for input and output items when creating a
recipe formula.
Note
Only one component type can be set as the default per formula item type.
Now that you have completed the settings on the Formula Item Types tab, you can proceed to the
Calculation Relevance tab. Here, administrators can specify which component types should be excluded
from recipe calculations.
7. Navigate to the Calculation Relevance tab.
8. Select the checkboxes next to the component types that you want to exclude from calculations.
9. Choose Save.
1. Once the configuration for component types is set up, release it by choosing the Release button on the
object page in display mode.
Administration Guide
360 PUBLIC Business Configuration
2. Assign the group for roles in composition, used in this configuration, to the recipe type linked to the
required recipe. For more information, see Using Recipe Types [page 358].
Note
• In the recipe formula, quantities for these excluded component types will still be displayed but will not
contribute to the formula's primary output quantity and recipe calculations.
• If no settings are made in the Calculation Relevance tab, all listed component types will be considered
during recipe calculations.
Related Information
With the Configure Recipe Calculations app, as an administrator, you can configure the parameters required for
performing product calculations within recipes.
Context
Currently, the recipe calculations are predefined, and it's not possible to delete them or add new ones. These
include:
Ingredients
The system uses this calculation to determine the ingredients used in the recipe that are needed to produce
the primary output. The system uses the quantities specified in the recipe formula.
Note
• Configuring calculation with the calculation type Ingredients is mandatory for functioning of other
calculations. Also, ensure that the relevant property is specified for this calculation.
• You must maintain the property for ingredient composition for all of your specifications involved to be
able to determine ingredients.
Composition
The system uses this calculation to determine composition of the primary output and thus describe its
properties.
The composition describes the primary output as the result of a specific process. The system determines the
associated quantities as the proportions in which ingredients are contained in the current primary output. To
do this, it uses the quantities specified in the recipe and compositions.
Administration Guide
Business Configuration PUBLIC 361
Note
You must maintain the property for a standard composition for all of your specifications involved to be able
to determine composition of the primary output.
Nutrients
The system uses this calculation to determine the nutrients and calculate their quantity in the primary output
of a recipe.
For each input ingredient in the formula, the system checks for nutrients specified in the relevant specification
property. For every nutrient, it calculates the respective quantity based on formula input items and primary
output composition.
Note
You must maintain the property for nutrient composition for all of your specifications involved to be able to
calculate nutrients.
Allergens
The system uses this calculation to determine the presence of allergens in the primary output of a recipe.
For each input ingredient in the formula, the system checks for allergens specified in the relevant specification
property. For every allergen, it determines the qualitative statement that describes the allergens presence
in the ingredient. To determine the presence of allergens in the primary output of the recipe, the system
aggregates allergen data from all input ingredient specifications and selects the qualitative statement with the
highest priority.
Note
• A lower priority number indicates a higher priority. For example, a priority value of "1" indicates the
highest priority.
• You must maintain the property allergen composition for all of your specifications involved to be able to
determine allergens.
To configure specification properties to be used for recipe calculations, follow the steps below:
Administration Guide
362 PUBLIC Business Configuration
Ingredient Composition
For the ingredient composition property, the following settings are recommended:
Role in Composition Group Select the required value from the drop-down list.
Note
Role in composition groups are configured in the Groups
for Roles in Composition app. Role in composition values
are used for maintaining roles for composition items in
the product specification, for example, active ingredient,
solvent, stabilizer, and so on. Also, these values are con-
sidered for the aggregation function in the recipe.
Value Qualifier This is optional. For more information, refer to step 7 in Con-
figuring a Calculation [page 368].
Administration Guide
Business Configuration PUBLIC 363
If you follow the recommendations, the configuration will appear as shown in the image below:
Standard Composition
For the standard composition property, the following settings are recommended:
Role in Composition Group Select the required value from the drop-down list.
Note
Role in composition groups are configured in the Groups
for Roles in Composition app. Role in composition values
are used for maintaining roles for composition items in
the product specification, for example, active ingredient,
solvent, stabilizer, and so on. Also, these values are con-
sidered for the aggregation function in the recipe.
Administration Guide
364 PUBLIC Business Configuration
Field Value Option
Value Qualifier This is optional. For more information, refer to step 7 in Con-
figuring a Calculation [page 368].
If you follow the recommendations, the configuration will appear as shown in the image below:
Nutrient Composition
For the nutrient composition property, the following settings are recommended:
Administration Guide
Business Configuration PUBLIC 365
Field Value Option
Note
When configuring a property, if you select both param-
eters—value and qualitative statement group—the sys-
tem will determine both the quantity and qualitative
statement for each nutrient in the recipe. However,
these two parameters are calculated independently. The
system does not use the quantity value to determine the
qualitative statement for an item. Instead, it refers to the
qualitative statement configurations
Value Qualifier This is optional. For more information, refer to step 7 in Con-
figuring a Calculation [page 368].
Composition Item Type Select the required value from the drop-down list
If you follow the recommendations, the configuration will appear as shown in the image below:
Administration Guide
366 PUBLIC Business Configuration
Allergen Composition
For the allergen composition property, the following settings are recommended:
Qualitative Statement Group Select the required value from the drop-down list
Value Qualifier This is optional. For more information, refer to step 7 in Con-
figuring a Calculation [page 368].
Composition Item Type Select the required value from the drop-down list
If you follow the recommendations, the configuration will appear as shown in the image below:
Administration Guide
Business Configuration PUBLIC 367
Configuring a Calculation
Note
5. Specify a property. Properties serve as both the data source for the calculation and the location where the
calculation results of a recipe are stored after transferring to the primary output specification. You can use
the value help to quickly find the necessary property by certain criteria.
For instructions on configuring properties, see Recommendations for Property Configurations [page 362].
6. Adjust the reference quantity value if needed. By default, the fields for the reference quantity for
calculation and its unit of measure are set with predefined values from the assigned property. These values
are subsequently displayed in recipes containing this calculation.
Note
• Cross-dimension conversion for units of measure is not supported currently. For example, the
system cannot convert from mass (KG) to volume (L). Therefore, only units of mass dimension are
available in the UoM for Reference Quantity field.
• If you edit the reference quantity in the Configure Recipe Calculations app, it will only affect recipes
created after the modification. Existing recipes will maintain their current reference quantity.
• Reference quantity is available only for calculations with the Quantitative/Qualitative Composition
calculation type.
7. Select a value qualifier from the provided list. The available value qualifiers are determined by the
value qualifier group assigned to the property specified in step 5. All items transferred to the primary
output specification will receive this value qualifier. For example, you can create a value qualifier such as
Calculated in the Recipe to differentiate between property values that are calculated by system and those
determined manually (or in lab testing).
For more information, see Value Qualifiers for Compositions [page 394].
8. Define priorities for qualitative statements. Values in the Qualitative Statements section are determined by
the qualitative statements group assigned to the property specified in step 5. If no qualitative statement
group assigned, the qualitative statement priority section will be empty.
For more information, see Qualitative Statements for Compositions [page 392].
Note
• Qualitative statements are available only for calculations with the Quantitative/Qualitative
Composition calculation type.
Administration Guide
368 PUBLIC Business Configuration
• The lower the priority value, the higher the qualitative statement priority. For example, "1"
represents the highest priority.
9. (Optional) Add translations for the recipe calculations names. Go to the Translations section and select the
language code from the list, then add the translation.
10. Choose Save.
Related Information
Use the Synchronize Data for Formulation app to load data from external services to work with Formulation.
The Synchronize Data for Formulation app lists all the data that you need to synchronize from other services in
the card view. Each card represents a type of data.
Last Loaded Specifies the latest time and date when the data was loaded.
Number of Units of Measure Specifies the number of UoMs that you've loaded.
To load the latest unit of measure data, you need to choose Load on the card.
Restriction
If you are using the EU11 landscape, the Load button is not available. In this case, please contact SAP by
reporting an incident on the Support Portal under the application component PLM-EPD-FRM. Request a
sample file where you need to specify the UoM content that you would like to use in Formulation and send it
back to SAP.
Administration Guide
Business Configuration PUBLIC 369
Note
Cross-dimension conversion for units of measure is currently unsupported for recipe calculations. For this
reason, only mass units can be used in recipe formulas and calculations.
Last Loaded Specifies the latest time and date when the data was
loaded.
Number of Composition Items Specifies the number of composition items you've loaded.
Number of Composition Item Types Specifies the number of composition item types you've
loaded.
Number of Composition Item Groups Specifies the number of composition item groups you've
loaded.
Number of Roles in Composition Specifies the number of roles in composition you've loaded.
Number of Role in Composition Groups Specifies the number of role in composition groups you've
loaded.
Number of Qualitative Statement Groups Specifies the number of qualitative statement groups
you've loaded.
After creating or updating your objects in the corresponding apps in Specification Management, choose Load
to load the latest data for them.
Administration Guide
370 PUBLIC Business Configuration
8.7.5 Translation of Data
When entering configuration data to the system, you can also provide the name and description in other
languages. This way, if users use the apps of Formulation in one of the supported languages, they can see the
respective configuration data in that language.
Note
If no translation is given for the used language, the system falls back to the given name and description.
• Recipe Types
• Configure Recipe Calculations
For the appropriate roles to handle these, see Role Templates for Formulation [page 72].
To accurately describe and interpret recipe formula and calculation data, Formulation must use units of
measurement (UoM).
Context
For further details on UoM, refer to Units of Measurement and What is Unit of Measure
To load the latest unit of measure data, you need to choose Load in the Synchronize Data for Formulation app.
For more information, see Synchronization of Data [page 369].
Note
• Cross-dimension conversion for units of measure is currently not supported for recipe calculations. For
this reason, only units of mass dimension can be used in recipe formulas and calculations.
• If any of the UoMs specified earlier in your recipe formula have disappeared, please read and apply the
following SAP Note: 3467589 .
Administration Guide
Business Configuration PUBLIC 371
Procedure
1. In the SAP BTP cockpit, open your subaccount and navigate to Security Role Collections .
2. Choose Create New Role Collection and enter a name for the collection. For example, unit-of-measure.
3. In the Roles tab of the role collection detail page, add two roles: UoM_Configuration_Expert and
UoM_Data_Access_User.
4. In the Users tab of the role collection detail page, add target users.
5. Create a role collection and assign roles and users for it.
Manage Statuses is a central solution within SAP Product Lifecycle Management. It's used to create status
profiles that you assign to recipe types. This helps you keep track of the current state of a recipe throughout its
lifecycle.
Describes the various business configurations to be performed in order to work with the various apps in the
Intelligent Handover cloud service for SAP Product Lifecycle Management.
Prerequisites
You must be assigned the Handover_Admin role mentioned in Role Templates for Intelligent Handover [page
79].
Business Configurations
As a handover administrator, you must set up the business configurations that are essential for working with
handovers. For more information, see Configuring Handover [page 373].
Administration Guide
372 PUBLIC Business Configuration
8.8.1 Configuring Handover
You can use the Configure Handover app to define the BOM attributes. To work with the handover, you must
configure the BOM attributes (BOM usage, plant, item category).
Prerequisites
For more information, see Role Templates for Intelligent Handover [page 79].
Note
You can view the Configure Handover tile on the launchpad only if you have the role of the
Handover_Admin.
Procedure
Note
Initially, there are no values associated with the BOM attributes until you configure them.
3. Choose Add.
4. Enter the values of the BOM attributes as follows:
BOM Usage Search for the BOM usages and The app displays the BOM usages
choose the required BOM usage that maintained in the SAP S/4HANA sys-
you want to provide to the produc- tem.
tions engineers to work on the hand-
over. Note
Only nonversioned BOM usages
are supported.
Administration Guide
Business Configuration PUBLIC 373
BOM Attribute User Action Comments
Item Categories Add the required item categories. You can add the following item catego-
ries:
• Stock Item (L)
• Variable-Size Item
• Text
Only the item category (stock item) is
supported.
Plants Maintain the plants that you want to You can maintain the number of
associate with the handover. plants based on your requirement.
5. Choose Remove if you want to remove any values of the BOM attributes.
You, as a System Administrator, can enable Visualization integration for Intelligent Handover so that users can
generate 3D models and thumbnails for product structures.
Prerequisites
• You must be assigned the StructureAdministrator role as mentioned inRole Templates for Intelligent
Handover [page 79] .
• You must be subscribed to the Visualization SaaS application. For more details, see Subscribing to the
SaaS Applications [page 23].
• You're assigned the appropriate visualization roles like ProjectCreator role to create the visualization
root folder, ContentReader to view the 3D models, and ContentCreator to generate visualizations. For
more details, see Role Templates for Visualization [page 98].
• You've set up destinations on SAP BTP to connect to your source systems to retrieve data from it. For more
details, see Configuring Connectivity for Intelligent Handover [page 146].
• Your source system must have an on-premise integration with SAP Engineering Control Center or SAP
Teamcenter by Siemens system.
Procedure
1. Launch the Common Functions SaaS application on SAP Fiori launchpad and choose the Manage Teams
app to create a group of users who can have access to the Visualization SaaS application. For more details,
see Manage Teams.
Tip
It's recommended that you create two user groups, for example, Enterprise Product Structure
Users and Enterprise Product Structure Administrators. The Enterprise Product
Administration Guide
374 PUBLIC Business Configuration
Structure Users group must be assigned the Create and Read permissions to the root folder (that
you create in Step 3) and enclosed content. Enterprise Product Structure Administrators
must be assigned Create, Read, Update, Delete, and Admin on the root folder and enclosed content.
2. Launch the Visualization SaaS application in SAP Fiori launchpad and choose the Browse app.
3. Create a root folder, such as, Enterprise Product Structure and choose (More) and then choose
(Access and Permissions).
Note
For users to access the visualizations of products, you must assign them the Create and Read
permissions.
5. Open the Enterprise Product Structure SaaS application on the SAP Fiori launchpad and choose the
Configure Visualizations app.
6. Select the visualization folder that you created in Step 3 as the root folder.
Note
Once you've set the root folder in the Visualization tab, you shouldn't change your selection to another
folder. If you change the root folder, you need to delete the older root folder or delete the visualization
within it. You must also assign the permissions to access the new root folder to the user group as
mentioned in Step 4. If these actions aren't performed, then the system starts to show warnings about
duplicate visualizations when viewing dynamic visualizations.
The Create Document Type window displays. You can enter the document types, description, and their
name pattern.
Note
• You must configure all the CAD document types that you want to use for visualization, otherwise
some parts in the visualization aren't generated. If the system fails to find or generate some parts,
a warning message is displayed.
• Enterprise Product Structure supports dynamic visualization only which means that you can
configure file types that contain CAD part files only. It's recommended to not configure CAD
assembly file types.
As an Intelligent Handover administrator, you can manage who can access specific business objects, whether
it's individual users or user groups. You can control which apps a user can use by assigning business catalogs
Administration Guide
Business Configuration PUBLIC 375
to a role and then linking that role to the user. After that, define how they can access the data by adding
authorization values in the restriction fields.
You can restrict access to the business objects (BOMs or handover activity) that have the following attributes:
Plant
Using the Manage Authorization Contexts app, you can create authorization contexts for controlling the access
of individual users or teams of users to specific business objects.
Prerequisites
• To provide the authorization access, you must have the same authorizations as provided by the EPD-
Admin role template as mentioned in Role Templates for Intelligent Handover [page 79].
• To the users, you've assigned the role template Handover_Editor and additionally, you've assigned the
role template Handover_Inst.
Note
The Handover_Inst is an additional role template that you assign to the users to manage who can
access specific business objects.
• To control user access at the team level, you have to create the necessary teams using the Manage Teams
app. For more information, see Manage Teams.
Procedure
To create the authorization contexts that give read and write access to objects (BOM Usage and/or Plant),
use the Manage Authorization Contexts app. For more informaiton, see Managing Authorization Contexts [page
294].
Depending on their access levels, users or user groups can access the engineering bills of materials (EBOMs)
in the Intelligent Handover SaaS application. Here are some examples of how authorization contexts could be
used:
Example
You have a user or a group of production engineers working with Intelligent Handover apps who can be
provided any of the following authorization context:
• Read access for BOMs with plant 0001 and 0002: Users can view or search for these BOMs on the
Worklist page and Planner page.
• Read access for BOMs with plant 0001 and 0002 and BOM usage Production and 2 Engineering:
Users can view or search for these BOMs on the Worklist page. They can view handover activities
matching the BOM usage Production or 2 Engineering or plant 0001 or 0002, but cannot create
or edit handovers.
Administration Guide
376 PUBLIC Business Configuration
An error message is populated if the user tries to create handover or edit the target BOM.
• Write access for BOMs with plant 0001 and 0002 and read access with BOM usage Production and 2
Engineering: Users can view or search for these BOMs on the Worklist page and create handovers or
edit the target BOM if the target plant is 0001 or 0002.
An error message is populated if the user tries to create handover or edit the target BOM with BOM
usage Production or 2 Engineering.
The user can create handover or edit target BOM if the target plant is either 0001 or 0002.
• Write access for BOMs with plant 0001 and 0002 and write access with BOM usage Production and
2 Engineering: Users can view or search for these BOMs on the Worklist page and create handovers
for target plants 0001 or 0002, or for BOM usages of Production or 2 Engineering.
The user can also edit the target BOM on the Planner page for target plant 0001 or 0002 or for BOM
usages of Production or 2 Engineering.
In the Configure Handover app, you're Here are a few reasons listed: Check if any of the following proposed
solutions supports in resolving the er-
unable add the Plants, BOM Usage, or • The destination is wrong or not
rors:
Item Categories using the Add button. configured.
• Cloud connector or communica-
• Destination PLM_CORE_DISCRETE
is not created.
tion arrangement is not setup cor-
rectly. • Parameter sap.epd.purpose is
not set to synchronization.
• Backend services not registered
correctly. • Set up cloud connector. For more
information, Configuring Connec-
• Enterprise Product Structure SaaS
tivity for Intelligent Handover [page
application isn't subscribed.
146].
• Set up communication scenario.
For more information, Configuring
Connectivity for Intelligent Hand-
over [page 146].
• Check if PLM system integration
is registered for Configuration
Management. For more informa-
tion, see Configuring Connectiv-
ity for Configuration Management
[page 133].
• Subscrible to Enterprise Product
Structure SaaS application.
Administration Guide
Business Configuration PUBLIC 377
Hand Over Engineering Bills of Material (EBOM) App Errors
Unable to access the EBOM in the Here are a few reasons listed: Check if any of the following proposed
solutions supports in resolving the er-
Worklist page. • The destination is wrong or not
rors:
configured.
• Cloud connector or communica-
• Destination PLM_CORE_DISCRETE
is not created.
tion arrangement is not setup cor-
rectly. • Parameter sap.epd.purpose is
not set to synchronization.
• Backend services not registered
correctly. • Set up cloud connector. For more
information, Configuring Connec-
• Enterprise Product Structure SaaS
tivity for Intelligent Handover [page
application isn't subscribed.
146].
• Set up communication scenario.
For more information, Configuring
Connectivity for Intelligent Hand-
over [page 146].
• Check if PLM system integration
is registered for Configuration
Management. For more informa-
tion, see Configuring Connectiv-
ity for Configuration Management
[page 133].
• Subscrible to Enterprise Product
Structure SaaS application.
• Error accessing EBOM due to Missing Enterprise Product Structure Assign Enterprise Product Structure
read roles viewer role. For more information, see
missing authorization.
Role Templates for Intelligent Handover
• Remote OData service responded [page 79].
with status code 403.
Synchronization from the external Missing Enterprise Product Structure Assign Enterprise Product Structure
source system (SAP S/4HANA or SAP editor roles. editor role. For more information, see
ERP or SAP S/4HANA Cloud) failed. Role Templates for Intelligent Handover
[page 79].
Initiate Handover failed Business errors or service unavailability Click Failed Object Status to check the
errors reason for failure. For more details,
navigate to the Task Monitoring for
Handovers app.
Unable to generate visualizations for • Visualization is not setup correctly. For more information, see Configuring
the exploded structure. Visualization [page 350].
• It is a non-visual BOM.
Unable to expand BOM assembly even The BOM is present in the external The BOM does not contain any compo-
though (Assembly) icon is shown. source system (SAP S/4HANA or SAP nents.
ERP or SAP S/4HANA Cloud) without
any components.
Administration Guide
378 PUBLIC Business Configuration
Errors Reason Solution
In the Routing mode, when you're try- Routing service is not responding. • Routing viewer role is missing.
ing to assign routing using the Create
New Routing or Use Existing Routing as
• Routing service is not enabled
This chapter describes the business configuration to be performed before product developers can work
with the various apps within the Specification Management SaaS application of SAP Product Lifecycle
Management.
Prerequisites
• Your user must have the proper roles as described in the following document: Role Templates for
Specification Management [page 90].
• You must be familiar with the central components that the solution uses, see Configuring Connectivity for
Specification Management [page 158].
• Read through and adhere to the following document regarding Unit of Measure: Implementing Unit of
Measurement (UoM) [page 411].
Overview
For an overview of the business flow, see Overview of Process Flow [page 380].
For an overview of the data model, see Overview of Data Model [page 383].
Administration Guide
Business Configuration PUBLIC 379
8.9.1 Overview of Process Flow
Here is an overview of the activities that you as an administrator have to perform before product developers
can start working with specifications.
Administration Guide
380 PUBLIC Business Configuration
• #unique_289/unique_289_Connect_42_subs01 [page 381]
Click the elements on the left side to see the steps the administrator takes for configuring Specification
Management.
• The used property trees - and implicitly: which properties are displayed
• The status profile for the specification
Recommendation
The recommended categorization logic is the logistic layers, for example semi-finished product,
unpackaged product, packaged product, etc.
You have to decide which business objects will be modelled as composition items, and create the respective
composition item types.
Recommendation
It is recommended to model composition types to those simple elements, pure substances that do not
change often and you want to measure in your product, for example allergens, nutrients, hazardous
substances, etc.
Composition type properties are the ones where a list is displayed with the product's constituents.
Recommendation
It is ideal if you as an administrator inquire about possible composition items and composition item groups
that are needed by product developers already in configuration time. Of course these items can be created
later, but then you have to be careful with the statuses of objects.
Administration Guide
Business Configuration PUBLIC 381
Composition item groups are an arbitrary group where composition items of the same type are gathered. There
are multiple aspects you can use for grouping, for example product line, declaration requirements, etc.
Note
In a specification's composition property, you can choose composition item types for your property, and
filter down by group. That is why it is important to define composition item groups based on the product
developer's need.
See Composition Items [page 388] and Composition Item Groups [page 390].
These so-called value sets, allowed values can later be used by composition properties. There are three objects
and their respective grouping apps. You can define the following objects and their groups based on the needs of
your company, in any order:
• Roles in composition: A value that indicates the role of the substance in the standard composition of
a specification, such as active ingredient or impurity. This classification is used mostly for compliance
purposes. See Roles in Composition [page 391]
• Qualitative statements: A declared value that indicates whether a specification contains a certain
substance, for example: trace elements, contains, doesn't contain, unknown. See Qualitative Statements
for Compositions [page 392]
• Value qualifiers: A collection of values that are used as qualifiers for composition items within a
specification, for example: measured, certified, warning. See Value Qualifiers for Compositions [page 394]
5. Create Properties
There are two types of properties: attribute properties and composition properties.
• Data from Composition Configuration (for less complex constituents that change less frequently)
Note
You must give a composition item type and can filter down by composition item groups.
Note
You can use all specification types or filter down to a a subset of specification types.
Attribute properties have fields that use the following field types: numeric, character-based, date-time, URL, or
Boolean.
Note
For character-based attribute fields, you can also define allowed values based on phrase collections.
Administration Guide
382 PUBLIC Business Configuration
6. Create Property Trees
Property trees are a hierarchical view of a collection of properties. Property trees are assigned to specification
types.
Create property trees based on which properties you want your product developer to see for a specification of a
given specification type.
Properties can be organized under property nodes for better structuring. These nodes are unique to the
property tree.
After a property tree is created, you can assign it to a specification type in the Specification Types app.
Note
You can use product categories to give users access to just a subset of specifications. In the Authorization
Contexts app, you can set up an authorization context based on product categories for a previously defined
set of users and user groups - these users will only see those specifications they are allowed to based on the
product category.
You can also add properties to a product category. When displaying a specification, the property tree can be
filtered down by the product category, so only the most relevant properties are displayed.
See Managing Product Categories [page 405] and Handling Authorizations [page 407].
The following image explains the data model of the Specification Management SaaS application. The arrows
point to where the given business object is consumed.
Note
Administration Guide
Business Configuration PUBLIC 383
• Working with Phrases
• Roles in Composition [page 391]
• Properties [page 396]
• Value Qualifiers for Compositions [page 394]
• Managing Product Categories [page 405]
• Qualitative Statements for Compositions [page 392]
• Using Specification Types [page 384]
• Phrase Collections
• Phrases
• Phrase Collections
• Managing Statuses [page 182]
• Property Trees [page 402]
• Using Specification Types [page 384]
• Managing Product Categories [page 405]
• Managing Statuses [page 182]
• Working with Specifications
• Composition Items [page 388]
• Composition Item Groups [page 390]
• Property Trees [page 402]
• Working with Specifications
When you create a specification, it must belong to a specification type, so that the right properties are offered
to the product developer to choose from. These properties come from an assignment between a property tree
and the specification type that you define in the Specification Types app.
Administration Guide
384 PUBLIC Business Configuration
To create a specification type, follow these steps:
Note
A specification type can have multiple property trees, and one property tree can be assigned to
multiple specification types.
Note
Specifications can only be created with specification types that are in Released status.
Describes how to create a link between specifications and product masters in an external system.
Prerequisites
Establish connectivity to the external system, for example S/4HANA. For more information, see Configuring
Connectivity for Specification Management [page 158].
Specification Types
A product master in an external system can be linked to a specification if the assignment is allowed for its
specification type. To enable product master assignments for a specification type, select the Product Master
Link checkbox in the Specification Types app.
If this checkbox is selected, you can assign product masters to specifications created with this particular
type. By choosing a product master on the Related Objects tab of the Manage Specifications app, the link is
established to the specification.
Administration Guide
Business Configuration PUBLIC 385
Note
More Information
A composition is a list of ingredients or constituents used to describe what a mixture is made up of. A
composition appears in specifications as a type of property. You can use different types of compositions based
on your line of business.
A composition can be defined as a mandatory property to ensure that a specification can be released only if its
mandatory composition property is maintained.
The following video explains in detail how the composition apps are related:
The following image shows the suggested way to define the objects related to compositions.
One composition item type can be assigned to multiple composition item groups, but a composition item group
is always assigned to only one composition item type.
Composition items can exist in multiple composition item groups, whereas composition items of different
composition item types can't be added to a composition item group.
Administration Guide
386 PUBLIC Business Configuration
Example
Here are examples of how the business objects of composition can be related:
More Information
For the different steps of defining composition-related objects, see the following sections:
The Composition Item Types app enables you to create and release item types in configuration.
To create and maintain composition items in the system, one or more composition item types must be released.
A composition item type links composition items and composition item groups.
Example
Administration Guide
Business Configuration PUBLIC 387
To create a composition item type, you need to enter the following information:
Note
You can enter alphanumeric values up to 100 characters in the Name field and 30 characters in the ID
field.
• (Optional) You can translate the name of the object into a different language. This ensures that the object is
displayed in the language that users log on with.
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the composition item type is created, you can set following statuses:
Note
You can't create a new composition item or group if the composition item type is set to Obsolete.
• You can Edit or Delete the composition item type object when the status is set to In Work or Released.
Note
You can't delete a composition item type if it's used in composition item or composition item group.
The Composition Items app enables you to create items based on released composition item types in the
system.
Note
You can enter alphanumeric values up to 100 characters in the Name field and 30 characters in the ID
field.
Administration Guide
388 PUBLIC Business Configuration
• Select a composition item type from the list.
Note
The composition item type associated with the composition item can't be changed once it’s created.
• (Optional) You can enter a legally binding description about the composition item per country/region.
• Choose Create, select a language from the list, and enter the respective description. You can also add
the country/region information to it. You can create only one description per country/region.
Note
• (Optional) You can translate the name of the object into a different language. This ensures that the object is
displayed in the language that users log on with.
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
• (Optional) You can also select Default UoM from the Value help list. To assign Restricted List of UoM choose
Enable UoM Restriction.
Note
Once a composition item is created, you can set the following statuses:
Note
You can't select or add composition item in a composition item group that is set to Obsolete or In
Work.
• You can Edit or Delete the composition item object when the status is set to In Work or Released.
Note
You can't delete a composition item if it's used in a composition item group.
Administration Guide
Business Configuration PUBLIC 389
8.9.4.3 Composition Item Groups
The Composition Item Groups app enables you to create item groups based on released composition item
types in the system.
These groups are linked to a composition item type and allow you to add composition items only of the same
type as the group itself.
Example
A nutrient group U.S. Label will contain the nutrients on the U.S. nutrition label.
You can't combine composition items with different composition item types in a group.
Example
To create a composition item group, you need to enter the following information:
Note
You can enter alphanumeric values up to 100 characters in the Name field and 30 characters in the ID
field.
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
A composition item group can exist without adding a composition item in the status In Work. The following
image explains the different statuses.
To set the composition item group to Released, you need to assign at least one composition item. Composition
items can exist in multiple composition item groups.
Example
If nutritional groupings are divided into regulatory labeling jurisdictions, fat is a common nutrient that can
be used.
Administration Guide
390 PUBLIC Business Configuration
You can Edit or Delete the object when the status is set to Released.
Note
You can set the composition item group to Obsolete if it's no longer required.
Roles in Composition is a value set app that enables you to maintain necessary item roles for the composition
items in the product specification.
Example
To create a role in composition object, you need to enter the following information:
Note
You can enter alphanumeric values up to 100 characters in the Name field and 30 characters in the ID
field.
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the object is created, you can Edit it (or Delete it if no longer required.)
Note
You can't delete a role in composition object if it's used in groups for roles in composition.
Note
You can't select or add a role in composition in a group for roles in composition that is set to Obsolete.
Administration Guide
Business Configuration PUBLIC 391
Groups for Roles in Composition
Groups for Roles in Composition is a value set app that enables you to group all the roles in composition. It's
used in the Properties app.
To create a group for roles in composition object you need to enter following information:
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the roles in composition object is created, you can Edit it (or Delete it if no longer required).
Note
You can’t delete a group for roles in composition if it's already used in a property.
Note
You can't add or select a group for roles in composition object in a property, that is set to Obsolete.
Qualitative Statements for Compositions is a value set app that enables you to maintain necessary qualitative
statements for the composition items in the specification.
Qualitative statement is an exception value on premise, that basically holds certain values indicating the
presence of composition inside another product.
Example
Administration Guide
392 PUBLIC Business Configuration
Note
You can enter alphanumeric values up to 100 characters in the Name field and 30 characters in the ID
field.
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the qualitative statement object is created, you can Edit it (or Delete it if no longer required).
Note
You can't delete a qualitative statement if it’s used in qualitative statement groups.
Note
You can't add or select a qualitative statement to a qualitative statement group that is set to Obsolete.
Qualitative Statement Groups for Compositions is a value set app that enables you to group all the qualitative
statements. It will be used in the Properties app.
To create a qualitative statement group object, you need to enter following information:
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the qualitative statement object is created, you can Edit it (or Delete it if no longer required).
Administration Guide
Business Configuration PUBLIC 393
Note
Note
You can't add or select a qualitative statement group in a property that is set to Obsolete.
Value qualifier determines how the value should be interpreted in the composition values, the data source of it
and how it should be treated later.
Example
Measured, certified, warning, supplier provided, not validated, validated, calculated, compliance provided.
Note
You can enter alphanumeric values up to 100 characters in the Name field and 30 characters in the ID
field.
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the value qualifier object is created, you can Edit it (or Delete it if no longer required).
Note
You can't delete a value qualifier if it's used in value qualifier groups.
Administration Guide
394 PUBLIC Business Configuration
Note
You can't add or select value qualifier to a value qualifier group that is set to Obsolete.
Value Qualifier Groups for Compositions is a value set app that enables you to group all value qualifiers for
composition items in a product specification.
To create a value qualifier group object, you need to enter the following information:
Note
If you want to translate the object, go to the Translations section and select the language code from the list,
then add the translation.
Once the value qualifier group object is created, you can Edit it (or Delete it if no longer required).
Note
Note
You can't add or select value qualifier group to a property that is set to Obsolete.
You can set the status for an object once it's created.
Administration Guide
Business Configuration PUBLIC 395
8.9.5 Handling Properties
The most important aspect of maintaining specifications is to be able to define their respective properties.
The recommended order for defining these business objects is the following:
1. First, properties are defined in the Properties app, see Properties [page 396].
2. Properties are organized into a hierarchical structure called a property tree, see Property Trees [page 402].
3. Specification types are created, and then assigned to property trees, see Using Specification Types [page
384].
4. Attribute or composition properties can be defined as mandatory ensuring that specifications including
these properties can be released only when all the mandatory properties are maintained, see Working with
Mandatory Properties in a Specification.
When creating a specification, the product developer assigns a specification type to it, which uses the
connected property tree with the assigned properties.
Example
The product developer wants to create a raw specification for silicone-free shampoo. The company
administrator defined unpackaged product as a specification type, and the associated property tree is
"Properties for healthcare products". This way, all properties relevant for a shampoo will be displayed.
8.9.5.1 Properties
With the Properties app, you can create and maintain all the properties.
A property records the details on a specification in numeric or textual form. Depending on different business
cases, you can define Attribute Property, Composition Property, and Information Property.
Attribute A type of property that describes the characteristics of an object or entity in more detail.
Property Each attribute property groups a set of fields depending on the requirement to describe a
given property. See the following table for an example.
pH
pH Value 7.1
Composition A type of property that contains a list of properties sourced from a composition
Property configuration or specification. You can't maintain the content of compositions freely, but
you can select data from a composition configuration or specification instead. Here's an
example.
Administration Guide
396 PUBLIC Business Configuration
Nutrient Composition
Vitamin C 10 5 15 10 mg
Information A type of property that contains rich-text information to provide more details. For example,
Property your users can change font size. Unlike the other two types of property providing plain-text
information, the Information Property can help your users format the property content.
For example, the output of the Information Property can be an introduction to a product
briefing, which contains marketing and product requirements, offering emphasis on the
most important product changes or on the new requirements.
Prerequisites
Procedure
You can choose a single type, or any ones of the types as a combined property type.
4. Choose whether to enable Validity to indicate geographic or manufacturing information for the property.
5. Choose whether to enable Multiple Rows and define a Maximum Row Number if so.
6. Choose whether to enable Allow for Not Applicable and Allow for No Data Available.
If you enable the two options, users can set the property as Not applicable or No Data Available in
specifications.
7. Enter a description to provide more details.
Administration Guide
Business Configuration PUBLIC 397
8. Choose Save and Continue.
The detail page of a new property appears, with the status In Work.
After creating a property, you can edit and delete the property as well as enable translation for the property.
• For the In Work property, you can edit header section, release, and delete the property.
• If the Released property is not used by any specification, you can delete the property and set it to In Work.
Otherwise, you cannot delete the property or set it to In Work.
Go to the Attribute Settings tab and create attribute fields. For more information on creation, see Creating
Attribute Fields [page 400].
You can also edit fields, delete fields, and adjust the fields' order to be displayed in the specifications.
Go to the Composition Settings tab and choose Edit to enable settings as shown in the below table.
Administration Guide
398 PUBLIC Business Configuration
Header Unit of Measure Header Unit of Measure Choose a UoM behavior for composi-
tion column headers from three op-
tions:
Range Expression Single Input If you select this option, your users can
enter an expression to indicate data
range. For example, > 5 - <= 15.
General Composition Data Has Comment Select the check boxes to choose
whether to enable comment.
Administration Guide
Business Configuration PUBLIC 399
Role in Composition Group For example, Active Ingredient.
Go to the Information Property tab and choose Edit. You can customize property content format by the
following functions:
• Customize fonts
• Insert a list
• Add hyperlinks
Translating Property
Go to the Translation tab and maintain translations. The Property table lists the translations for the property
name and description. The Attribute Fields table lists the translations for the name of attribute fields.
Choose Show Empty to filter the language items whose translation is missing. Choose Edit to add or remove
languages for translation.
Attribute fields are the detailed property characteristics used to define and store specific data of different
types.
To create an attribute field, go to the Attribute Settings tab and choose Create. In the pop-up window, enter a
name and ID, and choose a field type. For different field types, you need to input different values.
Administration Guide
400 PUBLIC Business Configuration
Creating a Key Figure Field
The Key Figure field type allows you to create the numeric data that you want to maintain.
Range Expression • Single Input: if you select this option, your users can
enter an expression to indicate data range. For example,
> a - <= b.
• Multi Inputs: you choose multiple restrictions for the
data range, for example, whether to set a minimum
value.
The Character-based field type allows you to create the character data that you want to maintain.
Administration Guide
Business Configuration PUBLIC 401
Creating a DateTime Field
The DateTime field type allows you to create the date and time data that you want to maintain.
Choose to create a field data that only contains the date, or contains both date and time.
The Boolean field type allows you to create the Boolean data that you want to maintain. For example, True.
The URL field type allows you to create the URL data that you want to maintain, including the link and the texts
that define the link.
A property tree contains properties, organized into property nodes. Property nodes are defined within the
Property Trees application and are valid only for the given property tree.
Note
Each property can be present only once in a property tree but one property can be included in multiple
property trees.
You can have up to five levels of property nodes. The order of properties and property nodes on a level is
arbitrary.
After you've added properties, you can assign the property tree to a specification type in the Specification
Types app. When the product developer creates a new specification, they select a specification type for it. This
specification type and the assigned property tree determine which properties are visible in the specification.
For more information on specification types, see Using Specification Types [page 384].
When a property tree is created, its status is In Work. After adding properties and property nodes to it, you can
release it. Only released properties can be assigned to specification types.
Administration Guide
402 PUBLIC Business Configuration
If you no longer need the property tree, and you haven't assigned it to a specification type, you can delete it.
After it's assigned to a specification type, you can only set it to Obsolete. Obsolete property trees are displayed
in specifications, but can't be added to specification types and can't be modified.
More Information
You can create property trees with the Property Trees app.
Prerequisites
Context
Procedure
Note
A property node is defined and valid only for the particular property tree it's created in.
4. Add properties to your property tree by clicking the Add button on the desired level and selecting the Add
Properties option. You can select one or more properties to add.
Administration Guide
Business Configuration PUBLIC 403
Note
If you select the Add button next to a property node, then the properties will be added under the
respective property node. If you choose the Add button at the top of the table, the properties will be
added to the root level, without any parent.
Prerequisites
You can remove properties with the Remove button. This deletes only the association between the property and
the property tree, not the property itself.
Note
If you remove a property from the property tree while the property tree is already released, there may
already be a specification that has data maintained for the given property. In this situation, removing a
property can cause data to be hidden from the UI.
• If you want to add a property under a node, choose the Add button in the respective row, then select Add
Properties.
• If you want to add a property to the root (so it has no parent node), choose the Add button in the table
header, then select Add Properties.
You can remove property nodes with the Remove button. This deletes the property node, and removes the
association between the underlying properties and the property tree.
Administration Guide
404 PUBLIC Business Configuration
Note
If you delete a property node from the property tree while the property tree is already released, it may
happen that there's already a specification that has data maintained for the underlying properties and
therefore the change can cause data to be hidden from the UI.
• If you want to add a property node under another node, choose the Add button in the respective row, then
select Add Property Node.
• If you want to add a property node to the root (so it has no parent node), choose the Add button in the table
header, then select Add Property Node.
You can cut and paste whole branches of the property tree hierarchy as follows:
1. Select the items you want to place elsewhere in the property tree. You can select a whole hierarchy with
underlying properties and nodes as well, or you can select individual properties on any level.
2. Choose Cut.
3. Select the item where you want to paste your cut items. Depending on the target, you can paste before,
after, or into it. Select the Paste menu option, and then the respective button (for example, Paste Before).
Note
A property tree can have a maximum of five levels of property nodes, therefore the paste is successful
only if you don't exceed this limit with your action.
If you change your mind and don't want to place your cut items elsewhere, you can restore the original state of
the property tree with the Restore button.
A product category is a classification of products based on the collection of properties that are relevant for the
given product or product line.
When creating new specifications, the product developer can assign a product category to it, and this
information can be used for searching and categorization.
Tip
You can use product categories with adherence to industry standards like GS1 or FDA.
A product category can also filter down the properties that are provided by the property tree, so the user only
sees the properties relevant for the given product category.
Administration Guide
Business Configuration PUBLIC 405
You can order your product categories into a hierarchical list, with a maximum of 10 levels. You can define only
one product category hierarchy.
• Short name
• Description
• Properties
More Information
A default product category hiearchy appears when the app is first opened, which you can rename and create
new categories in the Product Categories app.
Each customer can have only one product category hierarchy. When the app is first opened, the product
category root is created.
Note
The product category root can be renamed according your company's needs.
Note
The system suggests an automatic ID for your product category, but you can use an ID of your own.
You can edit the name and description of a product category, as follows:
1. Open the Product Categories app, then select the respective property.
2. Choose Edit.
3. Apply any changes, then save.
Administration Guide
406 PUBLIC Business Configuration
8.9.6.3 Adding Properties to Product Categories
Property trees are a broader, more generic collection of properties. This is then filtered down by the product
category when the product developer creates a specification, so that only the relevant properties show up.
Example
For example, you can create a property tree for food products in the European Union. Then you can define a
product category that filters this down, such as infant food or dairy, and add the corresponding properties
to it.
If you then create a specification with the product category dairy, the property tree only shows the subset
of properties relevant for dairy products.
Inheritance
Inheritance means that properties assigned to a parent product category are also visible for its subcategories.
You can enable or disable inheritance for each product category.
• If inheritance is enabled, then the product category has the same properties assigned as its parent. If
the parent also inherits, then this goes all the way up to the first parent that doesn't inherit, such as the
product category root.
• If inheritance is disabled, you can assign a completely new set of properties to that product category,
regardless of which properties the parent has.
To disable inheritance, select the Enable Overwrite button. You can also turn off the overwrite function by
selecting Disable Overwrite, in which case property inheritance from the parent category is restored.
Filtering
After you've added properties to a product category, the Properties tab of the Manage Specifications app
only displays the assigned properties. It indicates that the properties are filtered by product category, but the
filtering can be switched off by clicking Undo.
You can also choose to filter by maintained properties in the property tree by choosing Filter..
You can control who can view and edit specifications by creating authorization contexts that regulate access,
based on certain attributes.
Your business may need to control who can view and edit certain specifications. Access to specifications can
be controlled within an entity called an authorization context.
You can set up an authorization context for previously defined users and user groups. They can be allowed to
see only specifications that belong to one or a combination of the following:
• specification types
• product categories
• specification versions
Administration Guide
Business Configuration PUBLIC 407
The specified users and user groups can then access specifications with all combinations of the specification
types, product categories, and specification versions that are included in the authorization context. This can be
further refined on an operation level, by individually granting viewing, changing, or deleting rights.
You can also add a note to describe the goal of the authorization context or to provide other language-
independent information.
Example
A user group from a department of a company can be authorized to see and edit specifications of one
specification version of a finished product in a product category, but not delete them.
If you want to create a new authorization context to control access to specifications, do the following:
Note
4. Select the product categories and specification types that you want the specified users or user groups to
access.
You can add only released specifications to the authorization context.
5. Save your authorization context.
Companies may want to make sure that sensitive data can only be changed or seen by the right people. In the
Authorization Contexts app, this is why you can grant operation-level access to specifications.
Operations mean creating, copying, reading, updating, deleting, and creating new versions of specifications with
certain types, versions, or product categories.
Example
To allow users to create, copy, read, and add new versions to, but not delete a specification with a product
category, do the following:
1. Open an authorization context with users already assigned, and choose Edit.
2. Add a product category and a specification type to the context by choosing Create both under Product
Category and Specification Type.
Administration Guide
408 PUBLIC Business Configuration
Note
If users are granted Create access, they are also allowed to copy specifications.
The users assigned to this authorization context can now create, read, and update specifications, as well as
add new versions. However, they aren't allowed to delete any specifications in the selected product category.
Access Types
• Authorization based on the combination of specification type and product category. Both of these must be
added to the authorization context, unless the specification is only defined by specification type.
• Authorization directly to specification versions
Note
Only Read, Update, and Delete authorizations are allowed for specification versions, because granting
Create access to existing specification versions isn't possible.
You can also combine the two access types in one context by adding specification types, product categories,
and specification versions to it.
The system then evaluates their union so that users see the following:
Use the Synchronize Data app to load data from external services to work with Specification Management.
The Synchronize Data app lists all the data that you need to synchronize from other services in the card view.
Each card represents a type of data.
Administration Guide
Business Configuration PUBLIC 409
Last Loaded Specifies the latest time and date when the data was loaded.
Number of Units of Measure Specifies the number of UoMs that you've loaded.
After creating your own UoM, you need to choose Load to load the latest unit of measure data.
Restriction
If you are using the EU11 landscape, the Load button is not available. In this case, please create a customer
incident to the SAP application component PLM-EPD-SPM and request a sample file in which you can send
us the UoM content that you would like to use in Specification Management.
Plants
Last Loaded Specifies the latest time and date when the plant is loaded.
After importing and activating your own Plants in the Plants application, you need to choose Load to load the
latest data of your plants.
For more information about this cross-product feature, see Implementing Plants [page 412].
When entering configuration data to the system, you can provide the name and description in other languages
as well. This way, if users use the apps of Specification Management in one of the supported languages, they
can see the respective configuration data in that language.
Note
If no translation is given for the used language, the system falls back to the given name and description.
• Composition Items
• Composition Item Types
• Composition Item Groups
• Groups for Roles in Composition
• Product Categories
Administration Guide
410 PUBLIC Business Configuration
• Properties
• Property Trees
• Qualitative Statement Groups for Composition Items
• Qualitative Statements for Composition Items
• Roles in Composition
• Specification Types
• Value Qualifier Groups for Composition Items
• Value Qualifiers for Composition Items
For information on which SaaS application you need to subscribe to, see Subscription Tips: Integrated SaaS
Applications [page 25].
For the appropriate roles to handle these, see Role Templates for Specification Management [page 90].
Specification Management is used to store property information about products and substances in a variety of
ways. To accurately describe and interpret this data, Specification Management must use Unit of Measurement
(UoM).
Context
For more information about the UoM service, see Units of Measurement.
After creating your own units of measurement (UoM), you need to choose Load to load the latest unit of
measure data in the Synchronize Data application. For more information, see Synchronization of Data [page
409].
Administration Guide
Business Configuration PUBLIC 411
Procedure
1. In the SAP BTP cockpit, open your subaccount and navigate to Security Role Collections .
2. Choose Create New Role Collection and enter a name for the collection. For example, unit-of-measure.
3. In the Roles tab of the role collection detail page, add two roles: UoM_Configuration_Expert and
UoM_Data_Access_User.
4. In the Users tab of the role collection detail page, add target users.
5. Create a role collection and assign roles and users for it.
Specification Management is used to store information about products and the plants where they're
manufactured or processed. To accurately describe and interpret this data, Specification Management uses
the Plants app, which is a common function for the SaaS applications of SAP Product Lifecycle Management.
For information about the Plants function, see Configuring Plants [page 293].
If you need to add new plants to use in your specifications, you need to synchronize them with the common
Plants function as follows:
1. In the Manage Specifications app, remove the plants from all the specifications.
2. In the Plants app, deactivate the plants.
3. Choose Load in the Plants tile within the Synchronize Data app to delete the plants from the database.
Manage Statuses is a central service within SAP Product Lifecycle Management. It's used to create status
profiles that you need for your specifications.
You create status profiles with the Manage Statuses app. For more information, see Managing Statuses [page
182].
Administration Guide
412 PUBLIC Business Configuration
8.9.11 Glossary
This section contains the most commonly used terms in Specification Management.
Term Definition
attribute property A type of property where you can precisely define and fine-
tune attribute fields of Boolean, character-based, date-time,
or key figure type.
business status A status that can be created manually for a particular proc-
essing step to provide more detailed status information for
that step. You can assign the business status you have cre-
ated for the step to a specific process. The business status
appears alongside the processing status for that step in the
process browser.
composition item type A type of ingredient that has a certain function in a product.
Good examples are nutrients, allergens, and so on.
configuration entity All objects that help the setting up of master data, for exam-
ple composition items, groups, and types, and so on.
Administration Guide
Business Configuration PUBLIC 413
Term Definition
phrase A standard text. Phrases can be used, for example, for value
assignment of characteristic fields in the property tree, or
value assignment of certain input fields. Phrases are man-
aged in libraries. A phrase can group the same text in several
languages.
product category tree The product categories of the company arranged in a struc-
tural way. The product category tree includes all of the prod-
uct categories of a company and their hierarchical structure.
property association The link between a property and another business object.
For example, a property can be associated with property
trees and product categories.
property node A logical group within a property tree, which can contain
properties under it. A property node helps with structuring
the properties within a property tree.
restriction list for UoM A multi-input field for selecting different units of measure. It
must have a default UoM on the list.
Administration Guide
414 PUBLIC Business Configuration
Term Definition
role in composition A value that indicates the role of the substance in the stand-
ard composition of a specification, such as active ingredient
or impurity. This classification is used mostly for compliance
purposes.
value qualifier A collection of values that are used as qualifiers for compo-
sition items within a specification, for example: measured,
certified, warning.
This chapter describes the business configuration to be performed before product developers can work with
the various cards within the Insights SaaS application of SAP Product Lifecycle Management.
1. Each card needs a destination setting to retrieve the necessary data. The instructions for creating the
destination are available here: Connecting SAP Build Work Zone, standard edition or SAP Build Work
Zone, advanced edition [page 150]. The recommended destination name is PLM_Insights. If you use this
destination name, you don't have to make any destination setting in the card configuration. However, if you
entered your own destination name when you created your destination for connecting to SAP Build Work
Zone, advanced edition, you must select that name from the dropdown list in the card configuration.
2. Optional: If you use the My Products card from the PLM Insights: Develop Products content package, and
you want to display product images on the card, you must create an additional destination setting to
Administration Guide
Business Configuration PUBLIC 415
retrieve the images. The instructions for creating the destination are available here: Connecting to the
Enterprise Product Structure API for Images [page 155]. After you create the destination, select the name
of that destination from the dropdown list for destinations in the card configuration.
3. Optional: If you use the Visualizations card from the PLM Insights: Deliver Products content package
and you want to display thumbnails on the card, you must create an additional destination setting to
retrieve the thumbnails. The instructions for creating the destination are available here: Connecting to
the Visualization API for Thumbnails [page 156]. After you create the destination, select the name of that
destination from the dropdown list for destinations in the card configuration.
4. Optional: For some cards, you can configure the way that the data is displayed on them. If you allow your
users to configure the cards themselves, they can overwrite your settings. You can make, for example, the
following configuration settings:
Available Cards
Content Package UI Integration Card Role Configuration Settings
• My Changes
PLM Insights: Change ~sap.plm.ins.changemt_sap Note
Management .plm.ins.changemt.role
There's no configura-
tion possibility availa-
ble for Change Manage-
ment.
Administration Guide
416 PUBLIC Business Configuration
Content Package UI Integration Card Role Configuration Settings
• My Ideas by ~sap.plm.ins.define_sap.pl
Modification Date - For m.ins.define.inm.submitter.r
Submitters of Ideas ole
Note
The roles are only relevant for SAP Build Work Zone, standard edition.
Administration Guide
Business Configuration PUBLIC 417
8.11 Business Configuration for Product Innovation
Management
Describes the various business configurations to be performed in order to work with the various apps in the
Product Innovation Management for SAP Product Lifecycle Management.
As an administrator, you need to set up the business configurations that are essential for working with Product
Innovation Management.
Context
Define evaluation questionnaires in the Settings for Product Innovation Management app so that your users can
use a questionnaire to evaluate ideas.
Procedure
1. Launch the Settings for Product Innovation Management app from the SAP Fiori launchpad.
2. Switch to the Define Evaluation Questionnaires tab.
3. Choose the Create button to create a questionnaire.
4. Enter a name and description for the questionnaire in the New Questionnaire page.
5. Define questions.
a. Go to the Questions tab to create score type questions.
b. Define a score range for the questions, for example, 0 to 100.
When evaluating, experts can only give a score within the range defined here.
c. Choose the Add button.
d. Input the question and give the question a weight to indicate how important it is among all the
questions.
Note
You can also remove questions or adjust the order of the questions.
Administration Guide
418 PUBLIC Business Configuration
You can use the Additional Questions tab to create text type questions.
b. Choose the Add button.
c. Define a question so that your users can provide an answer to the question.
You can also remove questions or adjust the order of the questions.
7. Choose Save to save the current questionnaire.
The phase is the sequence of progress for a campaign indicating to which extent the innovation ideas are
handled.
Procedure
1. Launch the Settings for Innovation Management app from the SAP Fiori launchpad.
2. Switch to the Define Phases tab.
3. Choose the Create button to create a phase.
4. Enter a phase name and description in the New Phase pop-up window.
5. Choose Create to confirm creation.
After created, the phase is displayed in the Phases table, where you can check how many campaigns use
the phase in the Number of Linked Campaigns column.
Next Steps
You can choose the Edit button to change the name and description of multiple phases at the same time. Also,
you can choose the Delete button to delete the selected phases.
Context
Define tags in the Settings for Product Innovation Management app so that your users can use tags to group
ideas more easily.
Administration Guide
Business Configuration PUBLIC 419
Procedure
The created tag is added to the tag list in which your users can set tags.
You can define status profiles to let your users manage statuses.
Procedure
For more information on how to create status profiles, see Working with Status Profiles [page 183].
Note
We recommend adding at least three status types, including Initial, Obsolete, and any of the rest of the
types.
The Initial type is used for the draft idea status, and the Obsolete type is used for the deleted idea
status. The next status after the Initial type that you choose is used as the status for the published idea.
The other types you set are used by the Product Manager to manage idea statuses.
3. Choose Save.
Additional idea fields let the idea submitters provide more information on ideas.
Context
Define additional idea field in the Settings for Innovation Management app so that your users can use the fields
to submit more details for ideas.
Administration Guide
420 PUBLIC Business Configuration
Procedure
Procedure
Note
Administration Guide
Business Configuration PUBLIC 421
Results
The status of all the projects are now monitored in SAP Build Process Automation.
Describes the various business configurations to be performed in order to work with the various apps in the
Visualization cloud service for SAP Product Lifecycle Management.
Prerequisites
You must be assigned the SecurityAdministrator role mentioned in the Visualization section in Defining and
Bundling Roles.
Business Configurations
As an administrator, you must set up the following business configurations that are essential for working with
visualizations:
Administration Guide
422 PUBLIC Business Configuration
8.12.1 Access Control
Access control lets you decide which specific Visualization content users can access and what they can do with
it.
You can also grant access to individual IdP users, or to IdP groups, when you want to give the same access to a
collection of users.
All Visualization applications and APIs enforce access control, and prevent unauthorized access to your
content.
Concepts
Ownership
The initial creator of a folder or a visualization is the Owner of it. An owner is someone who has access to the
content without having to be explicitly added to the permission list for the content.
Additionally, only the Owner (or someone with the SecurityAdministrator role), is able to modify the permission
list of a folder or visualization.
Ownership can be transferred to another user. Only IdP users can be owners. IdP groups can’t be assigned
ownership.
Once ownership is transferred, the previous owner loses access to the content unless they’re explicitly in the
permission list, or in an IdP group that is in the permission list.
Permissions
Permissions define the actions that users can perform on visualization content like folders or visualizations.
• Create: This permission applies to folders. When someone has the Create permission on a folder, they’re
permitted to create new subfolders or upload new visualizations into that folder.
• Read: This permission applies to folders and visualizations. When someone has the Read permission on a
folder, they’re able to see the folder in lists of folders, or search for it, and also able to navigate into the
folder. When someone has the Read permission on a visualization, they’re able to see the visualization in
lists of visualizations, view it, copy it, search for it, and view its details.
• Update: This permission applies to folders and visualizations. When someone has the Update permission
on a folder, they’re able to rename the folder. When someone has the Update permission on a visualization,
they’re able to rename the visualization or, create new versions of it, or delete existing versions
Note
You’re unable to delete the visualization itself unless you also have the Delete permission.
• Delete: This permission applies to folders and visualizations. When someone has the Delete permission on
a folder, they’re able to delete the folder and all of its contents (except for any content that has overridden
Administration Guide
Business Configuration PUBLIC 423
permission, which removes their access to that content). When someone has the Delete permission on a
visualization, they’re able to delete the visualization.
• Admin: This permission applies to folders and visualizations. It can be used by the owner to delegate
the ability to grant, modify or remove access to a folder or visualization. When someone has the Admin
permission on a folder, they're able to change who has access to the folder. When someone has the Admin
permission on a visualization, they’re able to change who has access to the visualization.
When a new top-level folder is created, it has no permission list by default, and only the Owner can access it.
The Owner has to add users or groups to the permission list before anyone else can see it or upload content
into it.
When someone has the Create permission on a folder, and creates a subfolder or uploads new content into it,
the new content has the same permission as the folder it was created in, and they’re the Owner of it.
If the owner of content changes the permission list in the Access and Permissions window, the permissions are
overridden, and any future changes to the permission list of the container folder don’t apply.
For example, if a folder grants access to user A, and the owner of a visualization in that folder removes user A
from the permission list of that visualization, any future changes to folder permissions aren’t reflected in the
visualization permission list, as it now has Overridden Permissions.
The owner of the folder can remove all overridden permissions by editing the permission list of the parent
folder, and checking Apply to enclosed content, which removes all overridden permissions from child content.
The Access and Permissions user interface has the following components:
Component Description
Change ownership If displayed, allows the current user to change the owner of
the object to another user.
My Permissions Shows the permissions that the current user has on the
object.
Permissions List If displayed, shows the permissions that have been config-
ured for the object.
Administration Guide
424 PUBLIC Business Configuration
Component Description
Add user or group permissions If displayed, allows the current user to add IdP users or
groups to the Permissions List.
Note
Anonymous access is subject to approval and is control-
led at folder level. The anonymous access status of a
visualization is inherited from its parent folder and can-
not be modified for individual visualizations.
User/Group Selection
When selecting users when changing ownership, or users/groups when editing the permission list, the combo-
box lists users that have already logged into the system, or known IdP groups.
This list may not be the complete set of IdP users or groups that are available.
The (More)and (Access and Permissions) buttons on the Visualization Card open the Access and
Permissions window.
If the current user has the Project Creator role, they can add a new top-level folder in the browse
application.
Whenever a user creates a new folder or uploads visualizations into a folder, they become the Owner of that
folder or visualization.
Searching only lists folders and visualizations for which the current user has at least the Read permission.
For information on setting access and permissions, see Setting Access and Permissions.
Administration Guide
Business Configuration PUBLIC 425
8.12.2 Security Administration
The Security Administration application allows an administrator to determine the way in which malware
scanning and content caching is handled. In addition, you have options to transfer ownership of content
in specific folder hierarchies from one owner to another, and options to configure allowed origins and role
collections. Finally, you have options to enable anonymous access for specific folders and the visualizations
they contain.
Malware Scanning
You can control malware scanning behavior, based on your security needs. Options include the following:
• Scanning user-uploaded files for malware, using the Malware Scanning Service.
• Turning scanning off entirely.
• Turning scanning off only for files that exceed the Malware Scanning Service file size limit of 400 MB.
• Aborting an import job if any malware is found in a file, even if other files have no malware.
• Continuing if malware is found, with appropriate messages and corrective actions taken. For example,
deletion of the affected files before processing.
Content Caching
Content caching improves performance when loading previously loaded visualizations, but must not be used
when visualizations contain sensitive data.
Transfer Ownership
You can transfer ownership of content in a specific folder or folder hierarchy from one user to another. You may
wish to use this function to recover from a situation where the owner of content is no longer an IdP user, or is
no longer an employee, but the content is still recorded as owned by them. You need to select the original user,
and the new user, and then select the required folder.
Allowed Origins
You can add allowed origins so that cross-origin requests from the origin hosts can be made to visualization
services. By default, such calls are not permitted.
Administration Guide
426 PUBLIC Business Configuration
Role Collections
You can configure role collections to not be shown when choosing an identity for a permission entry.
You can specify whether attempts are made to retrieve role collections from the tenant subaccount.
Anonymous Access
You can enable anonymous access for a folder and the visualizations it contains. You can:
The features of the Visualization SaaS application let you upload visualizations from external sources to SAP
Product Lifecycle Management. Before you use these features, configure the necessary malware scanning
settings in the Security Administration app
You've options to control how malware scanning proceeds when you import files. The options are either
enabled (On) or disabled (Off).
Prerequisites
You must be assigned the SecurityAdministrator role mentioned in the Visualization section in Defining and
Bundling Roles.
Procedure
1. Launch the Security Administration application from the SAP Fiori launchpad.
2. Choose the Malware Scanning tab.
3. Set your options as required. The available settings are as follows:
Administration Guide
Business Configuration PUBLIC 427
Settings
Button Description
Malware Scanning Checks uploaded files for known malware before they’re
processed and made available for download.
Recommendation
We recommend that you don’t switch this off.
Allow Unscannable Files Allows files that are either too large to scan (greater than
400 MB), or contain encrypted content to be processed.
Note
This option is applicable only when Malware Scanning
is set to On.
Abort on Detection Aborts the entire import job when a malware scan issue is
found.
When this option is set to Off for iOS, the affected files
are deleted, but the import activity proceeds, displaying
error messages for the affected files. When set to On, the
import is aborted as soon as a file with malware is found,
and no further scanning or processing of remaining files
occurs.
Note
This option is applicable only when Malware Scanning
is set to On.
You can configure your content caching settings in your Security Administration application. You have an option
to control whether content caching proceeds when you import files. The options are either enabled (On) or
disabled (Off).
Administration Guide
428 PUBLIC Business Configuration
Prerequisites
You must be assigned the SecurityAdministrator role mentioned in the Visualization section in Defining and
Bundling Roles.
Procedure
1. Launch the Security Administration application from the SAP Fiori launchpad.
2. Choose the Content Caching tab.
3. Set your options as required. The available settings are as follows:
Settings
Button Description
Note
This setting takes up to 30 minutes to take effect.
Prerequisites
You’re assigned the SecurityAdministrator role mentioned in the Visualization section in Defining and
Bundling Roles.
Context
You can use the Transfer Ownership tab to transfer ownership of content from the top-level folders. You select
the current user, and the new user, and then select the required folder.
Administration Guide
Business Configuration PUBLIC 429
Note
Procedure
1. Launch the Security Administration application from the SAP Fiori launchpad.
2. Choose the Transfer Ownership tab.
3. In the From field, select the current owner of the content you wish to transfer ownership. The From field
must contain the user name or email address to transfer ownership from. If the user has been deleted, the
virtual Deleted User user can be selected to transfer ownership from all deleted users.
4. In the To field, select the required new owner of the content you wish to transfer ownership.
5. In the Folders section, select one or more top-level folders in which the content that you wish to transfer
ownership reside, and click Apply.
Ownership transfer executes on all of the selected folders, recursively changing ownership within those
folders from the From user to the To user.
You can configure allowed origins in your Security Administration application. When you add an allowed origin,
by specifying a URL, requests from that origin (for example, an application hosted on an external website
making visualization service API calls) can be made to visualization services. By default, such calls are not
permitted.
Prerequisites
You have the SecurityAdministrator role mentioned in the Visualization section in Defining and Bundling
Roles.
Procedure
1. Launch the Security Administration application from the SAP Fiori launchpad.
2. Choose the Allowed Origins tab.
3. Click (Add) to add the URL for an allowed origin.
Note
You can only add URLs for the HTTP and HTTPS protocols. The URL must not include special characters
or a path but must include at least a hostname.
Administration Guide
430 PUBLIC Business Configuration
Caution
Although wildcards can be used to support testing, they must not be used in a production environment
due to the inherent security risk.
When you enter a URL, (Accept changes) is only enabled if the URL is valid.
You can add as many URLs as required. You can edit and delete existing URLs.
Note
You can configure the usage of teams and identity provider (IdP) groups for access control in your Security
Administration application. The options are either enabled (On) or disabled (Off).
Prerequisites
You must be assigned the SecurityAdministrator role mentioned in the Visualization section in Defining and
Bundling Roles.
Procedure
1. Launch the Security Administration application from the SAP Fiori launchpad.
2. Choose the Group Management tab.
3. Set your options as required. The available settings are as follows:
Settings
Button Description
Administration Guide
Business Configuration PUBLIC 431
Button Description
Identity Provider Groups Specifies whether identity provider (IdP) groups are
shown when choosing an identity for a permission entry.
For information on setting access and permissions, see User Interface Overview - Access and Permissions
[page 424].
You can configure anonymous access in your Security Administration application. When you enable anonymous
access for a folder, the visualizations contained in the folder can be viewed without authentication.
Requests for anonymous access are subject to approval processes and are subsequently assigned a status, as
follows:
• Requested: anonymous access has been requested for the folder but not yet approved
• Enabled: anonymous access has been approved for the folder, and unauthenticated users have read access
to the visualizations it contains
• Disabled: anonymous access has not been approved for this folder
• Suspended: anonymous access has been temporarily suspended, but can be enabled without further
approval
If an anonymous access request for a folder is approved and the status is Enabled, the following happens:
• The status is inherited by the visualizations contained in the folder. Unauthenticated users have read-
access to the visualizations, but cannot cannot modify or delete them.
• The status is not inherited by existing subfolders or the visualizations contained in them.
Note
Existing subfolders won't inherit the folder’s status, but new subfolders will. New subfolders and their
contents will inherit anonymous access. If a folder is moved to a new parent folder, the anonymous
access status is derived from the new parent folder once the subfolder is moved there.
If an anonymous access request is rejected and the status is Disabled, the folder won't be listed on the
Anonymous Access tab.
Prerequisites
You must be assigned the SecurityAdministrator role mentioned in the Visualization section in Defining and
Bundling Roles.
Administration Guide
432 PUBLIC Business Configuration
Procedure
1. Run the Security Administration application from the SAP Fiori launchpad.
2. Choose the Anonymous Access tab.
All folders with an anonymous access status of Enabled, Requested, or Suspended are listed. Folders with a
Disabled status are not displayed.
3. Select the required status for the folder.
Note
Whenever the anonymous access status of a folder is changed, the details are stored in the Audit Log
Service.
The System Administration application allows an administrator to create Visualization categories and different
types of usages so that visualizations can be grouped together by the purpose for which they're intended.
Visualization Categories
A Visualization Category is a mechanism that allows an administrator to centrally manage a set of named
categories. Any single Visualization can have one of the Visualization categories assigned by a user.
These categories are useful when there are multiple visualizations for the same product, and serve as a
mechanism to identify visualizations for a particular purpose.
ID Usages
Visualization Usages provide a template for storing business application identifiers in a consistently managed
way. The data is stored as Visualization metadata.
The user and application APIs allow for searching for visualizations without exposing the internal Visualization
metadata structures.
The advantages of using a usage template over just putting values directly into metadata are as follows:
• The system ensures that the data uses consistent names for the metadata values.
• The UI and APIs allow an administrator to specify identifiers in terms that make sense to the users of the
business application.
• It's necessary for the business application to store the Visualization ID. Instead, an administrator can
configure a usage.
Administration Guide
Business Configuration PUBLIC 433
8.12.3.1 Configuring Visualization Categories
A visualization category lets an administrator centrally manage a set of named categories. Any single
visualization can have one of the visualization categories assigned to it. These categories are useful when there
are multiple visualizations for the same product, and they also serve as a mechanism to identify visualizations
for a particular purpose.
Prerequisites
You must be assigned the ConfigurationManager role. For more information, see the Visualization section in
Defining and Bundling Roles.
Procedure
1. From the SAP Fiori launchpad, run the System Administration app .
2. Choose the Categories tab.
3. To add a new Visualization Category, choose Add.
Field Description
The Visualization Usages feature provides a template for storing business application identifiers in a
consistently managed way. The data from Visualization Usages is stored as visualization metadata. The
feature allows users to search for visualizations, based on the application data, without exposing the internal
visualization data identifiers. There are several preloaded usages, such as, As-Built, As-Designed, As-Installed,
and so on. These usages are designed to cover the most common usage scenarios, but system administrators
can always create more usages in the System Administration application. For example, in the application, you
can select an As-Installed usage to assign Equipment Number to a visualization to represent an installed piece
of equipment. The equipment number number can be used to search, view, or update a visualization. Usages
can be assigned to markers and to individual objects in 3D models. In the case of markers, usages are used
to show additional information in the info cards, or to navigate to external applications that provide correct
application information. In case of 3D model objects, in the Viewer, you can use the search functionality to find
such objects in the 3D scenes.
Administration Guide
434 PUBLIC Business Configuration
Prerequisites
You must be assigned to the ConfigurationManager role. For more information , see the Visualization
section in Defining and Bundling Roles.
Procedure
1. From the SAP Fiori launchpad, run the System Administration app .
2. Choose the Visualization Usages tab.
3. To add a new visualization usage, choose Add.
The Integration window opens, with the Visualization Usage tab displayed.
4. Enter the required information
Field Description
Name The name that users associate with this type of identifier.
Note
It is possible to assign multiple usages to a visualiza-
tion or to an object in a visualization. The usages are
displayed when there is a UI for adding and editing a
usage ID.
Intent navigation enables integration with related data for a visualization or folder.
Prerequisites
You must be assigned the ConfigurationManager role mentioned in the Visualization section in Defining and
Bundling Roles.
Administration Guide
Business Configuration PUBLIC 435
You have created a usage ID using Configuring Visualization Usages [page 434].
Context
You can specify that the same application is launched in different views or modes depending on the end user's
role. To allow this, navigation between launchpad applications is based on abstract representations (intents)
that are resolved to concrete navigation targets.
Procedure
1. Launch the System Administration application from the SAP Fiori launchpad.
2. Choose the Visualization Usages tab.
3. To define a new navigation intent, click Add.
Field Description
Display Name The name that the user associates with this type of navi-
gation.
Field Description
App Specific Route Some applications may use this mechanism to specify the
application destination. If used enter the value here.
Administration Guide
436 PUBLIC Business Configuration
Results
Any visualization or folder with the assigned usage ID now contains a Navigation to option from the
visualization or folder card.
As an administrator, you can configure import options sets. You can add, edit, delete, or change any other
option in a import option set as per your requirements. Once configured, these import options set are available
for the users on the Import app when they upload CAD files in Visualization. You can also set one import option
set as the default option. Once set as default, the option is selected by default as an Import Options Set in the
Import app. Also, this default import setting can't be deleted by the users.
If a file contains import properties which can be configured at import time, you can modify the global settings
and apply them to the format. They are then applied to all files of the same format when you process the files in
Visualization.
When modifying import settings, the options differ depending on the selected file format; others are identical
across different file formats. For more information about specific import options, see CAD File Formats.
Note
Some of the file formats and import options mentioned in the link above is not available for Visualization.
You can configure a workflow instance for when importing visualizations is being started, completed, and
published in the Visualization.
Prerequisites
You must be assigned the ConfigurationManager role mentioned in the Visualization section in Defining and
Bundling Roles.
Administration Guide
Business Configuration PUBLIC 437
Context
You can create workflows through the workflow Capability Within the SAP Workflow Management and
the Visualization and the SAP Workflow Management integration lets you configure workflows. For more
information, see Workflow in the Cloud Foundry Environment.
Procedure
1. Launch the System Administration application from the SAP Fiori launchpad.
2. Choose the Workflow Settings tab.
3. Select the Import option for workflows that you want to be available to users when they're importing a
visualization.
The workflows that you select for import are displayed as the Workflow options in the Imports app to users.
4. Select the Publish option for workflows that you want to be available to users when they're publishing a
visualization.
The workflows that you select for publishing are displayed as the Workflow options in Author screen to
users.
5. The Events section displays the message that is sent to the import workflow once importing visualizations
is completed.
Workflows can be configured to wait for such message before performing some other actions.
You, as a System Administrator, can create, and manage scripts. Using a scripting engine, you can write and
execute scripts to implement correct workflows and perform automatic visualization modifications.
Prerequisites
You must be assigned the ConfigurationManager role mentioned in the Visualization section in Defining and
Bundling Roles.
Context
Administration Guide
438 PUBLIC Business Configuration
Procedure
1. Launch the System Administration application from the SAP Fiori launchpad.
2. Choose the Scripts tab.
3. To create a new script, choose Add.
Field Description
Results
The script is now saved in the backend and is now available to the workflow for execution.
This topic includes guidelines for system administrators on how to write a script for the automation service,
details about the APIs that are available to execute a script, and how to invoke scripts using the REST API.
Request
• Path: v1/scripts/{script_name}/execute, for
example, https://subscription.automation.ingress.eu20.ve.shoot.live.k8s-
hana.ondemand.com/app/v1/scripts/renameVisualization/execute
• HTTP method: POST
• Request body: It can be empty if the script doesn't expect any parameters, otherwise the request body
should be a valid JSON value. For example:
Administration Guide
Business Configuration PUBLIC 439
• A string value: "a_string_value"
• A numeric value: 123
• A boolean value: true
• An object: { "visualizationId": "123" }
• An array of JSON values: [ "a_string", 123, { "visualizationId": "123" } ]
Response
If the script execution is successful, then the endpoint can return the following response:
• Status: 200 OK
• Response Body: a valid JSON value
OR,
If the script execution has failed, then the endpoint can return the following response:
Sample Code
{
"result": "failure", // The constant enum value "failure".
"message": "Script returned error.",
"events": [
{
"code": 300, // 300 - script explicitly called `exit(false[,
error])`.
"values": {}
}
]
}
If the script calls exit(false, errorObject) then the return value is as follows:
Sample Code
{
"result": "failure", // The constant enum value "failure".
"message": "Script returned error.",
"events": [
{
"code": 300, // 300 - script explicitly called `exit(false[,
error])`.
"values": {
"error": "string" // The stringified `errorObject` parameter.
}
}
]
}
If the script fails due to JavaScript error, such as SyntaxError or an unhandled exception the return value is
as follows:
Administration Guide
440 PUBLIC Business Configuration
Sample Code
{
"result": "failure",
"events": [
{
"code": 302,
"values": {
"error": "{\"code\":2,\"details\":{\"formattedMessage\":\"Some error
description from JavaScript\"}}"
}
}
],
"message": "Script failed."
}
The events[0].values.error property contains a stringified object that can be parsed to display the error.
It has the following structure:
Sample Code
{
"code": 2, // `2` -
indicates that this is a JavaScript error.
"details": {
"formattedMessage": "Some error description from JavaScript" // An error
description from the JavaScript engine.
}
}
Additionally, the endpoint can return other usual error statuses such as 404 Not Found and so on, if the
script doesn't exist.
The .d.ts files for the API provided by Visualization's scripting engine.
The scripting engine is a backend extensibility mechanism for Visualization which allows a high degree of
workflow customization as per the customer requirements.
Scripts can use any modern JavaScript features but you must be aware of the differences between the built-in
features of JavaScript and Web API.
Note
• sys:runtime/v1: This system is for objects and functions useful for all scripts and modules.
• sys:data_sources/v1Manage Data Sources app in Visualization.
To have access to the system modules, import them in user scripts as shown below:
Administration Guide
Business Configuration PUBLIC 441
Sample Code
User scripts can import other user modules. Use the usr: prefix in the import statement as shown below:
Sample Code
Module sys:runtime/v1
Sample Code
Examples:
Sample Code
Sample Code
If a valid JSON value is passed to the script in the v1/scripts/{script_name}/execute request body,
then it's available in the params object. Otherwise, the params object is undefined.
Administration Guide
442 PUBLIC Business Configuration
Sample Code
• Object console: The console API can be used to log messages, such as for debugging purposes and so
on.
Sample Code
interface Console {
error: (...args: any[]) => void
warn: (...args: any[]) => void
info: (...args: any[]) => void
debug: (...args: any[]) => void
trace: (...args: any[]) => void
log: (...args: any[]) => void // This is an alias for `info`.
}
const console: Console
The console object is not a part of the JavaScript's built-in features, but is a Web API.
The messages written via the console API are stored in the storage database.
The script execution log can be fetched via endpoint v1/scripts/{script_name}/executions/
latest?log=true.
• Function fetch: The fetch function can be used to make requests to other services.
Note
Sample Code
Administration Guide
Business Configuration PUBLIC 443
The possible options are:
• method: It's the request method, such as DELETE, GET, PATCH, POST, PUT. The default is GET.
• headers: It's like any header that you can add to your request, contained within an object
literal with string values.
If the script makes a PATCH, POST or PUT request and passes a JSON value as the request
body, it's the script's responsibility to set the Content-Type: application/json header.
• body: Any body that you want to add to your request, can be a string or an ArrayBuffer
object. The string body is encoded as UTF-8. The request using the GET or HEAD method can't
have a body, while a request using the PATCH, POST, or PUT method must have a body.
• fetch result: The fetch function starts the process of fetching a resource from the network, returning
a Promise which is fulfilled once the response is available.
The Promise resolves to the Response object representing the following response to your request:
• status: This read-only property of the Response interface contains the HTTP status code of the
response.
• headers: This read-only property of the Response interface contains the headers associated with
the response.
The following methods of the Response interface are asynchronous and they consume the Request
body (which means you can't call them more than once) are:
• arrayBuffer(): This method returns a Promise that resolves with an ArrayBuffer. If the
request body is empty the ArrayBuffer's length is zero.
• text: This method returns a promise that resolves with a string. If the request body is empty the
string length is zero.
• json(): This method returns a promise that resolves with a JsonValue. If the request body is
empty the promise results in a rejected status with an error.
• Function exit: The exit function can be used by scripts to return a value from the v1/scripts/
{script_name}/execute endpoint.
Sample Code
If the resultOrError parameter is not undefined, it's returned as the response body.
If the script does not call the exit function, then it is called by the Script Executors when the script
finishes with succeeded equal to true and resultOrError equal to undefined.
Note
If the script calls the exit method, the script finishes its execution and doesn't return the control flow
back to the script. You can take it as process.exit() in Node.js.
If the exit function is called with parameter succeeded equal to true then the v1/scripts/
{script_name}/execute endpoint returns the following HTTP statuses:
• 200 OK: This status is returned when the resultOrError parameter is not undefined.
• 204 No Content: This status is returned when the resultOrError parameter is undefined.
If the exit function is called with parameter succeeded equal to false, then the v1/scripts/
{script_name}/execute endpoint returns 500 Internal Server Errorwith a JSON object
describing the error.
Administration Guide
444 PUBLIC Business Configuration
Module sys:data_sources/v1
The sys:data_sources/v1 module provides function fetchData to request data from the data sources
created in the Manage Data Sources app in Visualization.
Sample Code
• dataSourceName: It's a name of the data source as defined in the Manage Data Sources app.
• params: It's an object whose properties define the parameters and their values used in the data source
mapping.
If the function is successful, it returns a Promise that resolves with a JSON value fetched from the data source.
If the function fails, it returns a Promise that rejected status with an Error object containing an error
description.
Rename Visualization
Sample Code
Sample Code
Administration Guide
Business Configuration PUBLIC 445
sceneId: string,
version: string
}
export async function findLastPublicVisualizationVersion (visualizationId:
string): Promise<VisualizationVersion> {
const response = await fetch(`visualization:v1/visualizations/$
{visualizationId}`)
console.debug('findLastPublicVisualizationVersion', response.status)
const json = await response.json()
const versions = json.versions
let lastVersion = versions[0]
for (let i = 1, count = versions.length; i < count; ++i) {
if (versions[i].index > lastVersion.index) {
lastVersion = versions[i]
}
}
return {
sceneId: lastVersion.sceneId,
version: lastVersion.version
}
}: This sytem is for accessing external services defined as data sources in
the
The module can be imported by other script or module. If you add the name last_visualization_version
in a module in the code mentioned above, you can import and use it as follows:
Sample Code
Sample Code
Administration Guide
446 PUBLIC Business Configuration
}
}
Sample Code
Sample Code
Administration Guide
Business Configuration PUBLIC 447
Close Authoring Session
Sample Code
Publish Visualization
Sample Code
If you are putting all the previously defined functions into a module called my_shared_lib, you can implement
a script that renames all nodes, such as by adding a prefix.
Administration Guide
448 PUBLIC Business Configuration
Sample Code
Overview
You use the Collaboration cloud service to collaborate on 2D drawings, 2D images and 3D models in
Visualization by adding markup and comments to Visualization objects. You can use redline tools to add
Administration Guide
Business Configuration PUBLIC 449
overlay shapes and lines on top of a 2D or 3D object. You can add comments relating to an object or to redline
elements.
This section describes the interaction between Collaboration and Visualization with regards to folders,
templates, and access and permissions.
A folder named Collaborations is available in the Visualization Browser. When you create a collaboration and
add a visualization in Shared Documents, a sub-folder with the name of the collaboration is created in the
Collaboratons folder. The visualization is added to Design Models and to the sub-folder.
Three templates named Collaboration are provided, one each for the content types 2D Drawing, 2D Image
and 3D Model. These templates are used when a user opens a visualization from a collaboration, in the My
Collaborations app. You can confgure these templates but you should not disable the Markup button or change
the data source settings.
In the My Collaborations app, you can control the users who have permissions for adding markup to a
visualization by assigning the roles Reader, Contributor and Administrator to users in Particpants. These roles
correspond to access and permissions in Visualization and are applied to the sub-folder that is created for a
collaboration in the Collaborations folder:
Administration Guide
450 PUBLIC Business Configuration
Data Sources
Two data sources are supplied and configured when the system is provisioned: GetCollaborationSession and
SaveCollaborationSession. These are used to read and save markup information, and are selected as the data
sources in the collaboration templates.
Note
This section describes the business configuration to be performed so that you can integrate the various
external authoring systems in the Product Data Integration SaaS application of SAP Product Lifecycle
Management.
Related Information
Product Data Integration provides a standard design type for each authoring tool integration that you can use
to run the integration without any additional configuration needed.
However, if your integration scenario requires specific file extensions, you can configure them using the
Configure Design Types app.
Prerequisites
From the SAP Fiori launchpad, open the Configure Design Types app. All existing design types that have been
configured are displayed.
Administration Guide
Business Configuration PUBLIC 451
Note
To create a new design type, choose Create and enter a unique code for the new design type. In the design type
detail view, you can configure the details of the design types.
To modify an existing design type, select a design type. Display the details of the design type and choose Edit.
General:
• Default name and description. These values are displayed if the standard texts have not been translated
into the logon language and the app is in edit mode.
Item Types:
• Item types represent the different types of objects that are available in the authoring system for example,
3D models, drawing, and part families.
• You define the list of available item types and set the options to define its processing within Product Data
Integration and the synchronization to Enterprise Product Structure.
Relation Types:
• Relation types represent the different relations between the objects that are available in the authoring
system, for example, component, reference, family.
• You define the list of available item types and set the options to define how they are processed within
Product Data Integration.
Exclusion Strategies:
• An exclusion strategy defines which of the available item types and relation types do not need an exploded
iteration structure for the authoring system.
• You define the list of available exclusion strategies.
• An explosion stop strategy defines at which item types or relation types the explosion of an iteration
structure stops.
• You define the list of available explosion stop strategies.
• The file retrieval stategy uses file types or file name patterns to determine which files are used in the
explosion process.
• You define the list of available file retrieval strategies and file types.
Translations:
• You can enter your own localized names to be displayed for the business users..
Administration Guide
452 PUBLIC Business Configuration
Configuration in Detail
Item Type:
• In the detail view for the item type you can define the default and localized names and descriptions.
Relation Type:
• In the detail view for the relation type you can define the default and localized names and descriptions.
• You can set the following options:
• Child iteration strategy:
Saved Iteration: Always return the saved iteration of the child design item
Latest Iteration: Always return the latest iteration of the child design item
Dynamic: Return the valid iteration of the child design item considering the explosion parameters
• Is variant / family relation: (true, false) – special relation to a child design item that contains the definition
of the parent design item
Exclusion Strategies:
• In the detail view for the exclusion strategy you can define the default and localized names and
descriptions,
• On the Applies To tab, you define which item types or relation types are excluded from needing to provide
an exploded iteration structure for an authoring system.
• In the detail view for the explosion stop strategy, you can define the default and localized names and
descriptions,
• On the Applies To tab, you can define item types orrelation types where the explosion of an iteration
structure stops.
• In the detail view for the file retrieval strategy, you can define the default and (optional) localized names
and descriptions.
• On the Applies To tab, you can set the option retrieve primary file (true, false) and define file types and a
regular expression (optional) to specify the files to provide for the handover to the authoring system.
Product Data Integration integrates with Enterprise Product Structure and Visualization to derive product
structures from uploaded data using Product Data Integration and to generate 3D models and thumbnails of
product structures.
Administration Guide
Business Configuration PUBLIC 453
Procedure
Refer to the following sections to configure the Enterprise Product Structure and Visualization service:
Administration Guide
454 PUBLIC Business Configuration
9 Configuration for Using APIs
Sometimes the standard functions that are provided by the apps for the SaaS applications of SAP Product
Lifecycle Management don’t map completely to the way you do your business. To enable you to adapt and
extend the standard business processes, SAP Product Lifecycle Management provides public APIs on the SAP
Business Accelerator Hub.
As part of the entitlement for SAP Product Lifecycle Management, in each of your subaccounts, you can
subscribe not only to each SaaS application but also create a service for using a application-specific API. For
the created service, you have two options to use the service:
• Collaboration
• Visualization
• Engineering including two functions: Requirements Management and Systems Modeling and Test
Management
• Common Functions
• Product Innovation Management
• Product Data Integration
To add the service plans needed for the public APIs, in the SAP BTP Cockpit, search for and select the relevant
service:
Engineering You need to add the following two serv- • For Engineering, choose standard.
ices: • For SAP EA Designer, cloud edition,
• Engineering choose system-modeling.
• SAP EA Designer, cloud edition
for the Requirements Management
and Systems Modeling
Administration Guide
Configuration for Using APIs PUBLIC 455
For general information about how to enable APIs, see Administration and Operations in the Cloud Foundry
Environment
For detailed information about each API, see the SAP Business Accelerator Hub .
Instance Parameters
Visualization allows service instances to link to the data used by the Visualization SaaS application, which
uses the same data partition that is used by the Visualization front-end applications. This is now the default
behaviour when a Visualization service instance is created.
Visualization supports a legacy behaviour that allows a service instance to have its own distinct data partition.
The ability to create a service instance that has a distinct data partition is now deprecated and restricted.
By default, it is now not going to create such unlinked service instances unless a quota for unlinked service
instances is allocated for your subaccount.
Note
If you need to create such instances in your consumer subaccount, create a ticket using the PLM-CLOUD-
VIZ component
When creating a service instance, you can use the link_to_saas_subscription property in the provided
JSON parameters to control whether the service instance is linked to the SaaS subscription data or uses its
own data partition. For example:
Sample Code
{
"link_to_saas_subscription": true
}
Note
Service Credentials
Visualization service credentials (produced in service bindings and service keys) currently contain two sets of
endpoint URLs.
One set of endpoints in the endpoints object always links to the SaaS application data regardless of whether
the service instance is created with link_to_saas_subscription set to true.
The URLs for these endpoints have /app as the first path component following the origin component of the
URL.
Administration Guide
456 PUBLIC Configuration for Using APIs
Sample Code
{
//...
"endpoints": {
"api": {
"url": "https://api.ingress.eu20.ve.shoot.live.k8s-hana.ondemand.com/
app",
//...
},
"automation": {
"url": "https://vb-renderer.ingress.eu20.ve.shoot.live.k8s-
hana.ondemand.com/app",
//...
},
//...
"storage": {
"url": "https://storage.ingress.eu20.ve.shoot.live.k8s-
hana.ondemand.com/app",
//...
},
//...
"asset": {
"url": "https://visualization.ingress.eu20.ve.shoot.live.k8s-
hana.ondemand.com/app",
//...
},
//...
},
//...
}
The api endpoint is the endpoint that should be used. The api endpoint is the endpoint that is documented in
Visualization API documentation.
Currently, the credentials JSON object also contains a set of top-level properties with names that have an -url
suffix.
These URLs point to a data partition specific to the service instance unless the service instance is created with
link_to_saas_subscription set to true.
The url/endpoint properties other than the api endpoint in the endpoints object are deprecated.
The deprecated url/endpoint properties are currently included in the credentials object for backwards
compatibility.
Administration Guide
Configuration for Using APIs PUBLIC 457
10 Monitoring Usage
Learn about the options for monitoring your usage of SAP Product Lifecycle Management capabilities in your
production plan.
Note
Usage is monitored for the capabilities of SAP Product Lifecycle Management as defined in the latest terms
and conditions, which are published here: Supplement Terms and Conditions . Metering can change over
time. For more information, contact your SAP Account Executive.
SAP for Me
SAP for Me is your digital companion for easy interaction with SAP and provides the starting point for tracking
your total measured usage of all capabilities for the production plan of SAP Product Lifecycle Management in
your global accounts. Usage of the test plan is not monitored.
For more information about the card, see Public Cloud Consumption Card .
For more general information about SAP for Me, see SAP for Me on the SAP Help Portal.
Usage Analytics
To break down the measured usage by capability, you can use the Usage Analytics page in the SAP BTP
Cockpit. In the global account view, you see the monthly usage that was measured for the production plan of
SAP Product Lifecycle Management over all subaccounts and for each subaccount. In the subaccount view,
Administration Guide
458 PUBLIC Monitoring Usage
you can either view the total capacity units for a subaccount for the selected time period, or you can filter the
metric to see the usage for a particular capability.
How do the values that you see here compare with the information in SAP for Me? SAP for Me looks at the sum
of the capacity units consumed by all subaccounts on each day, compares that with the sums from the last
30 days, and, from these values, displays the maximum sum. SAP BTP finds, per subaccount, the maximum
number of capacity units in the last 30 days and then adds these numbers, and displays the sum on the
Usage Analytics page. These different calculation methods may mean that different values are shown in the two
places on a single day.
For general information about monitoring usage in your global account in SAP BTP, see Monitoring Usage
and Consumption Costs in Your Global Account. For general information about monitoring usage in your
subaccounts, see View Subaccount Usage Analytics. Note that since SAP Product Lifecycle Management uses
the subscription-based commercial model, you can ignore the information in those documents about costs and
cloud credits.
Administration Guide
Monitoring Usage PUBLIC 459
11 Delivery Schedule and Dates
This document provides the planned deliveries of new or changed features for SAP Product Lifecycle
Management in 2024 and 2025.
Minor changes to the calendar may take place nearing the dates. In addition, ad hoc deliveries may also take
place to meet urgent customer needes.
Note
These dates are for informational purposes only. The information is subject to change without notice. SAP
makes no warranties, express or implied, or of merchantability, or fitness for a particular purpose.
The delivery of any new or changed features is announced 2 weeks before the delivery in the What's New
Viewer for SAP Product Lifecycle Management. To receive email notifications for the early announcement of
changes, subscribe to the What's New Viewer by using the Subscribe button in the toolbar on the What's New
Viewer page on the SAP Help Portal.
For more information about how to subscribe, see How to Use the What's New Viewer for SAP Product
Lifecycle Management.
Delivery Date
Administration Guide
460 PUBLIC Delivery Schedule and Dates
Delivery Timeline 2025
Delivery Date
Maintenance Windows and Major Upgrade Windows for SAP Cloud Services
Monthly deliveries generally do not require any downtime. However, if a downtime is needed, you will be
notified well in advance.
You can find the details here for standard maintenance and upgrade windows: Maintenance Windows and
Major Upgrade Windows for SAP Cloud Services .
Administration Guide
Delivery Schedule and Dates PUBLIC 461
12 Offboarding
Provides you with information about user offboarding from SAP Product Lifecycle Management, and tenant
offboarding.
User Offboarding
To offboard users so they can no longer access the application, unassign the relevant role collections for the
users in Identity Authentication.
Tenant Offboarding
In the event that you notify SAP to terminate your account, or you choose not to renew your account, tenant
offboarding is supported.
Important: If you have used the Collaboration cloud service for SAP Product Lifecycle Management, contact
SAP to help you perform the following actions before terminating your account or unsubscribing.
In order to delete all customer data managed by the SaaS applications, simply unsubscribe from the
applications. This triggers an automated deletion process, which destroys the data within 90 days.
Caution
If you wish to receive an export of the customer data before destroying it, please contact SAP by referring to
Getting Support [page 477].
The SaaS applications of SAP Product Lifecycle Management provide you with user interfaces for performing
data export and data deletion.
Administration Guide
462 PUBLIC Offboarding
For more information, see the following topics:
Provides you with information about how to retrieve personal data about a data subject in Collaboration, and
also delete the data.
Prerequisites
Your user is assigned the CollaborationDPPAdmin role. For more information about roles, see the
Collaboration section in Defining and Bundling Roles.
Context
Collaboration provides you with a UI that allows you to retrieve and delete personal data about a data subject
participating in collaborations.
Procedure
1. Launch the Collaboration - Data Security app from the SAP Fiori launchpad.
2. Choose the Data Protection and Privacy tab.
3. Enter the email ID of the data subject (collaboration user), and choose (Search).
The list displays the collaboration objects where the user data is present. The list includes collaborations
created by the user, collaborations in which the user is a participant.
Remember
• Remove the user from the user group before deleting the data.
Administration Guide
Offboarding PUBLIC 463
4. Choose Delete.
Note
Deleting the user data from the Collaboration will also automatically remove the user from Product
Package Exchange.
You can export all data created in the Collaboration apps before a certain date, from the subaccount to your
local system. The exported file is saved to a ZIP file.
Prerequisites
You must be assigned the CollaborationDPPAdmin role. For more information about roles, see Role
Templates for Collaboration [page 51].
Context
The Collaboration capability allows you to export all data including the following user data: first name, last
name, and the email address in the Collaboration apps.
Procedure
1. On the SAP Fiori launchpad, open the Collaboration - Data Security app.
2. On the Data Export tab, select an end date.
Note
• The start date is by default the date when the first collaboration was created in your subaccount.
Based on the end date, the date range for the data export is calculated.
• Data that is older than the given date is not exported.
3. Select one of the export options: Include User Data or Exclude User Data.
4. Choose Export.
Administration Guide
464 PUBLIC Offboarding
The ZIP file is downloaded to your local system.
You can delete collaboration data, including data history, from your subaccount.
Prerequisites
You have been assigned the CollaborationDPPAdmin role. For more information about roles, see Role
Templates for Collaboration [page 51].
Context
The Collaboration user interface allows you to delete the collaboration and product package exchange data
from the subaccount.
Procedure
1. Open the Collaboration - Data Security app from the SAP Fiori launchpad.
2. To delete all the data, choose Delete.
3. Select the checkbox and choose Yes to delete.
Caution
With the help of the Specification - Data Security app, you as an administrator can perform the following
activities:
Administration Guide
Offboarding PUBLIC 465
Data Export
You can export all the data created in the PLM Foundation applications before a certain date to your local
system. The exported file is saved in a .zip file with the prefix Data_Older_Than in its title.
Note
Data on the given date is not exported, only those older than the given date.
Data Anonymization
You can erase the information of a certain user from all the associated provisional specifications. After the
erasure, the user will be displayed as Unknown in the Created By and Modified By fields.
To anonymize all information regarding a specific user, perform the following steps:
Caution
The instance-based authorization happens with the help of IDs. If you anonymize a user, that user loses
their access to any objects.
You can use the Manage Authorization Contexts app, to create authorization contexts that restrict user access
to certain business objects and then assign users or groups of users (teams) to them. When a user leaves your
organization, you must ensure that the user is removed from the corresponding authorization contexts. The
process is as follows:
Administration Guide
466 PUBLIC Offboarding
4. An audit log entry is written after the anonymization process is complete.
With the help of the Data Security for Configuration Management app, you as an administrator can perform the
following activities:
Data Export
You can export all the data created in the PLM Foundation applications before a certain date to your local
system. The exported file is saved in a .zip file with the prefix Data_Older_Than in its title.
Note
Data on the given date is not exported, only those older than the given date.
Data Anonymization
You can erase the information of a certain user from all the associated provisional specifications. After the
erasure, the user will be displayed as Unknown in the Created By and Modified By fields.
To anonymize all information regarding a specific user, perform the following steps:
Caution
The instance-based authorization happens with the help of IDs. If you anonymize a user, that user loses
their access to any objects.
Administration Guide
Offboarding PUBLIC 467
12.1.7 Engineering: Data Export, Deletion, and Anonymization
Provides you with the information on how to export all the business data to your local system, delete data in
apps, or anonymize the information of a certain user.
Test Management
Context
As an app administrator, you can export all the data created before a certain date to your local system, and
delete it completely in the Test Management apps. You can also anonymize the information of a certain user in
the associated test cases.
In the My Tests app, the Quality Engineers in your organization assign one or more test cases to themselves,
in order to run them and enter the test results (see Entering Test Case Results). When a Quality Engineer
user leaves the organization, you can remove this user from all the test cases that have been assigned to this
user. After the anonymization, this user will be displayed as Unknown in the Quality Engineer field of all the
associated test cases.
Procedure
1. Launch the Test Management - Data Security app from your SAP Fiori launchpad.
Note
This role is contained in the predefined role collection EPD - Test Management - Configuration
Expert.
2. To delete data, select the Data Deletion tab. Perform the following steps:
1. In the Data Older Than: field, select a date to specify that the data to be deleted or exported is created
this date.
2. If you want to export data first, in the Export Options field, select an option to specify whether you also
want to export the associated user data.
3. Select Export to export the selected data.
A .zip file containing the selected data is downloaded to your computer.
4. Select Delete to delete the selected data from the Test Management apps.
3. To anonymize a user, select the User Data Anonymization tab. Perform the following steps:
1. In the User field, select a user as appropriate.
2. Select Anonymize and confirm your action.
The selected user is now displayed as Unknown in the Quality Engineer field of all the associated test
cases.
Administration Guide
468 PUBLIC Offboarding
Requirements Management and Systems Modeling
Data Export
• Sharing, Printing, Reporting On, and Exporting Diagrams
• Exporting Requirements to a ReqIF File
• Importing and Exporting SysML Models with XMI Files
• Transferring Content Between Repositories
• Exporting Repository Content Using an API [page 325]
Data Deletion
Deletion of Personal Data [page 342]
Data Anonymization
Deactivating Users [page 314]
As an app administrator, this topic provides you with information how to retrieve the personal data of a data
subject in Enterprise Product Structure, as well as annonymization of this data.
Prerequisites
• You’ve completed the steps in Configurations for Using APIs [page 455] in the Administration Guide, and
created a Cloud Foundry service instance of epd-product-structure-service .
• You’ve created a service key for this service.
• You’re able to perform GET API calls.
Data Export
A REST API exists for retrieving the data that has been added to the Enterprise Product Structure service. To
retrieve the token needed for authorizing the call, you need to use the credentials from the service key created
previously.
The clientid and clientsecret credentials can be found inside the service key of the Enterprise Product
Structure instance. Using the credentials, the GET <service url>/odata/v4/DataManagementService/
exportData() API can be called.
The response of this API call is a binary zip file, which should be saved with the .zip extension. The zip contains
all the data entities currently in the Enterprise Product Structure database.
Administration Guide
Offboarding PUBLIC 469
Data Anonymization
You can erase the information of a certain user from all the associated entity sets. This action can be
performed using a API call to DataManagementService/adminAnonymizeUser endpoint of Enterprise
Product Structure service.
To anonymize all information regarding a specific user, perform the following steps:
In the response, the API returns a list of attended entity sets and statistical information on any changes that
have been applied. Anonymizable fields in the database is replaced with Anonymous. These fields are Created
By, Modified By, and other fields containing username or email address.
If you want to export existing data as part of the offboarding process, create a customer incident to the
following SAP application component: PLM-CLOUD-FRM.
Note
You get the data in CSV format and the description of the CSV structure in XML format.
Provides you with the information on how to export all the business data to your local system, delete data in
apps, or anonymize the information of a certain user.
As an app administrator, you can export all the business data modified before a certain date to your
local system, and delete it completely from the Innovation Management apps. You can also anonymize the
information of a certain user.
1. Open the Innovation Management - Data Security app from your SAP Fiori launchpad.
Note
2. To delete data, select the Data Deletion tab. Perform the following steps:
1. In the Data Older Than: field, select a date to specify that the data to be deleted or exported is modified
this date.
2. If you want to export data first, in the Export Options field, select an option to specify whether you also
want to export the associated user data.
Administration Guide
470 PUBLIC Offboarding
3. Select Export to export the selected data.
A .zip file containing the selected data is downloaded to your computer.
4. Select Delete to delete the selected data from the Innovation Management apps.
3. To anonymize a user, select the User Data Anonymization tab. Perform the following steps:
1. In the User field, select a user as appropriate.
2. Select Anonymize and confirm your action.
If you unsubscribe from the Insights SaaS application, you can manually uninstall the content packages
that you installed previously in SAP Build Work Zone, advanced edition. For more information, see the
documentation for SAP Build Work Zone, advanced edition.
If using SAP Build Work Zone, standard edition, you can delete content packages from the Insights SaaS
application, provided as content channels in the Site Manager.
With the help of the Manage Data Security app, you as an administrator can perform the following activities:
Data Export
You can export all the data created in the PLM Foundation service applications before a certain date to your
local system. The exported file is saved in a .zip file with the prefix Data_Older_Than in its title.
Note
Data on the given date is not exported, only those older than the given date.
Administration Guide
Offboarding PUBLIC 471
Data Anonymization
You can erase the information of a certain user from all the associated provisional specifications. After the
erasure, the user will be displayed as Unknown in the Created By and Modified By fields.
To anonymize all information regarding a specific user, perform the following steps:
Caution
The instance-based authorization happens with the help of IDs. If you anonymize a user, that user loses
their access to any objects.
If you want to export existing data as part of the offboarding process, create a customer incident to the
following SAP application component: PLM-CLOUD-SPM.
Note
You get the data in CSV format and the description of the CSV structure in XML format.
As an app administrator, this topic provides you with information how to retrieve the personal data of a data
subject in Visualization, as well as deletion of this data.
Prerequisites
• You’ve completed the steps in Configurations for Using APIs [page 455] in the Administration
Guide, and created a Cloud Foundry service instance of epd-visualization with the
link_to_saas_subscription parameter set to true.
• You’ve created a service key for this service.
• You have the asset-url parameter from the service key for the epd-visualization service.
• You’re able to perform POST API calls.
Administration Guide
472 PUBLIC Offboarding
Listing the Personal Data Stored Against a Data Subject
In order to see the personal data held on a data subject, the data subject can perform one of the following
actions:
When logged in to SAP Product Lifecycle Management, the logged-in user can click the user icon, and then
Settings. This window displays their name and email address.
This is the information that the Visualization SaaS application of SAP Product Lifecycle Management holds on
the user, for the current IdP.
Via API
Once logged in, the logged-in user can execute the /v1/dpp/personal-data API, which returns all personal
data held from all the IdPs with which they’ve logged in.
This API can be executed by the user by taking the application URLs, and combining it the API path.
https://CONSUMER.epd.cfapps.eu20.hana.ondemand.com/
sapvis3dvisualization.sapvisualenterprisewebappsbrowse/api/asset/v1/dpp/personal-
data
An administrator with the Security Administrator role can execute this function, using the credentials
from the service key created previously, and the asset-url from the service key.
/v1/identities?$filter=email eq 'EMAIL-ADDRESS'
The ID field in the returned identities array contains the data subject ID.
Using the credentials from the service key created previously, and the asset-url, the POST /v1/dpp/data-
subject-delete API is called, with a JSON payload as follows:
{"dataSubjectId": "123"}
If the subject was found, personal data of the subject is overwritten, and the subject is no longer displayed
in lists of users. Any data that was owned by the subject displays anonymized values for their name, email
address, and any other personal data held on them.
Administration Guide
Offboarding PUBLIC 473
Exporting Visualizations
For each API call below, you need to use the credentials from the service key created previously, and the
asset-url from the service key as the base URL for your API calls.
In order to perform an export, you need to know the visualization ID and version for each visualization you want
to export. If you want to export the latest version, then you don’t need to know the current version.
You can list the visualizations that exist in the system by calling GET /v1/visualizations, which returns a
JSON response similar to the following response - note that some fields have been omitted for brevity:
[
{
"id": 12,
"versions": [
{
"version": "v1",
}
]
}
]
To start export, invoke POST /v1/exports with a JSON payload in the body, where ID is the id field of the
visualization returned by the GET /v1/visualizations call earlier, and VERSION is the version field.
{
"visualizationId": "ID",
"version": "VERSION",
"compress": false
}
Compression is turned off so that the downloadable file is a file you can open with a SQLite database reading
tool.
Mass export isn’t supported. If the API call succeeds, a JSON response as follows is returned:
{
"id": 123,
"status": "active",
"progress": 75,
"visualizationId": "ID",
"visualizationVersionId": "VERSION"
}
The id field in the response is the ID of the export task, which is running in the background. You need this ID to
check the status later as well as to determine how to download the results.
To check the status of an active export, you can call GET /v1/exports/ID, where ID is the id field returned
when you started the export.
Administration Guide
474 PUBLIC Offboarding
This call returns a JSON response in the same format as when you started the export.
{
"id": 123,
"status": "completed",
"outputs": [
{
"externalId": "b4f0a7a0-f76a-4f1c-9a3f-611bab0cd4b1",
}
]
}
The export task has finished when status is completed or error. Only when status is completed is there a
downloadable file, otherwise, the message field contains more details about why the export failed.
The file contents are returned inline as a SQLite database (if you turned off compression), which you can then
save and open in the tool of your choice.
You can export all your data from SAP Product Lifecycle Management as part of your offboarding process.
If you want to export existing data as part of the offboarding process, create a customer incident to the
following SAP application component: PLM-CLOUD-PDI .
Note
You get the data in CSV format and the description of the CSV structure in XML format.
Administration Guide
Offboarding PUBLIC 475
13 Giving Feedback
You can give feedback about your user experience from any screen in the solution. Currently we provide two
methods to give feedback.
• Enter specific suggestions about the features of your SaaS application. To do this, open an app from an
SaaS application and choose the Request Improvement icon on the top right of the screen. The Request
Improvement Ideas window asks you to fill in the following information:
• SaaS Application: choose a SaaS application for which you want to submit feedback.
• Title: enter a title for your topic.
• Content: describe your feedback here.
• Complete a quick feedback questionnaire that asks you to rate your user experience. To do this, open an
app from an SaaS application and choose the Give feedback icon on the top right of the screen. You can
answer questions like the following:
• How satisfied you are with the solution as a whole
• Whether the app from which you open the questionnaire meets your requirements and is easy to use
• Whether you have any additional feedback that could help us to improve your user experience (freetext
entry field)
Administration Guide
476 PUBLIC Giving Feedback
14 Getting Support
Provides you the information you need to contact SAP in case of any issues.
If you require support or encounter any technical issues, contact SAP by reporting an incident on the Support
Portal .
Collaboration PLM-CLOUD-COL
Engineering PLM-CLOUD-ENG
Formulation PLM-CLOUD-FRM
Insights PLM-CLOUD-INS
Visualization PLM-CLOUD-VIZ
Built-In Support
Built-In Support helps you to get support in real-time within the applications that you are working with.
Different from the traditional support model, it provides efficient, simplified and guided support channels: you
can search for knowledge, ask for needed information, get help from recommended solutions, or communicate
with SAP support experts.
If your users access the apps from SAP Product Lifecycle Management using SAP Build Work Zone, standard
edition or SAP Build Work Zone, advanced edition, Built-In Support is available for all apps provided by the
SaaS applications that you have subscribed to. Built-In Support is only available on the individual SAP Fiori
launchpads for following SaaS applications:
• Common Functions
• Configuration Management
• Engineering
Administration Guide
Getting Support PUBLIC 477
Note
You can only use Built-In Support in the apps for test management.
To use the Built-In Support, open an app provided by the SaaS application and choose the Built-In Support
icon at the right top of the screen. You can then ask questions and get answers or create tickets direct. For
more information, see Built-In Support.
Administration Guide
478 PUBLIC Getting Support
Important Disclaimers and Legal Information
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
• Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
• The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
• SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
• Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering an SAP-hosted Web site. By using
such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
Administration Guide
Important Disclaimers and Legal Information PUBLIC 479
www.sap.com/contactsap
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.