SAP BTP Configuration User Guide

Contents hide
1 BTP Configuration
2 Product Information
2.1 Specifications
2.2 Product Usage Instructions
2.2.1 1. Introduction
2.2.2 2. Prerequisites
2.2.3 3. Assign Entitlements
2.2.4 4. Subscribe to Price Calculation
2.3 FAQ
2.3.1 Q: What should I do if I encounter issues during the subscription process?
2.3.2 Documents / Resources
2.3.2.1 References

BTP Configuration

“

Product Information

Specifications

  • Product: SAP BTP Configuration Guide – Price Calculation
  • Document Version: 8

Product Usage Instructions

1. Introduction

This document outlines the manual steps required to onboard the
Price Calculation service within the SAP Business and Technology
Platform.

2. Prerequisites

Price Calculation is part of other SAP solutions and requires
prior onboarding to SAP Subscription Billing. If you have completed
the onboarding steps for SAP Subscription Billing, you can proceed
with subscribing to Price Calculation.

3. Assign Entitlements

  1. Access your subaccount/tenant on the Global Account page of the
    SAP BTP Cockpit.
  2. Select “Entitlements” in the navigation panel and then click on
    “Edit”.
  3. Select “Add Service Plans”.

  4. Add Service Plans for Price Calculation:

    1. Search for “price calculation” and select the appropriate
      plan.
    2. Check the default (Application) checkbox.
    3. (Optional) Select “standard” if you require access to the Price
      Calculation APIs.
  5. Save the changes on the Entitlements overview screen.

4. Subscribe to Price Calculation

  1. Open your subaccount and navigate to “Service Marketplace”
    under Services.
  2. Find the Price Calculation tile under Integration Suite, click
    on the actions icon, and choose “Create”.

FAQ

Q: What should I do if I encounter issues during the
subscription process?

A: If you face any difficulties while subscribing to Price
Calculation or performing any of the steps mentioned, please refer
to the troubleshooting section in the user manual or contact our
customer support for assistance.

“`

View Fullscreen

PUBLIC
SAP BTP Configuration Guide
Price Calculation
Document Version: 8

TABLE OF CONTENTS
DOCUMENT HISTORY ……………………………………………………………………………………………………………………. 3 1 INTRODUCTION ………………………………………………………………………………………………………………………. 4 2 PREREQUISITES……………………………………………………………………………………………………………………… 5 3 ASSIGN ENTITLEMENTS …………………………………………………………………………………………………………. 6 4 SUBSCRIBE TO PRICE CALCULATION ……………………………………………………………………………………. 8 5 BUILD ROLE COLLECTIONS ………………………………………………………………………………………………….. 10 6 ASSIGN ROLE COLLECTIONS TO USERS OR USER GROUPS ……………………………………………….. 14 7 DEFINE ROLE COLLECTIONS AND ROLES TO RESTRICT AUTHORIZATION BY MARKET
(OPTIONAL) …………………………………………………………………………………………………………………… 16 8 ENABLE API ACCESS (OPTIONAL)………………………………………………………………………………………… 19 8.1 Create a Service Instance …………………………………………………………………………………………………… 19 8.2 Create a Service Binding ……………………………………………………………………………………………………. 21 9 UNSUBSCRIBING ­ IMPORTANT NOTICE ………………………………………………………………………………. 23

DOCUMENT HISTORY The table provides an overview of changes with the most recent changes at the top.

Document Date of Update Version

8

June 2024

7

May 2024

6

April 2024

5

November 2023

4

August 2022

3

July 2022

2

January 2022

1

December 20, 2021

Change
Section Enable API Access updated to describe creation of a service instance in the runtime environment “Other”, rather than “Cloud Foundry”. This reduces the number of steps as spaces no longer must be created and user authorization (members and roles) no longer must be defined. Furthermore, this approach reduces the number of resources consumed.
Adding a mention to the ui_document_analyze role template. Adding the section 8.5 about the creation of the service key.
Changing screenshots due to UI changes affecting the Entitlements page and the documentation describing the assignment of a service to a BTP subaccount.
Adding section about how to access API (optional).
Adding section about how to define role collections and roles to restrict authorization by market (optional).
Adding information about booster option from SAP Subscription Billing.
Adding a caution about the time needed to subscribe to the service.
Initial version

3

1 INTRODUCTION This document describes the manual steps that you need to perform within the SAP Business and Technology Platform to onboard the Price Calculation service. In the case, you have used the automation wizard or “booster” for onboarding SAP Subscription Billing, you can continue to section 7 of this guide.
4

2 PREREQUISITES Price Calculation is not a standalone service. It is only available as part of other SAP solutions. Thus, before setting up Price Calculation, you’d have to have onboarded to SAP Subscription Billing. If you have used the manual steps described in the SAP BTP Configuration Guide for SAP Subscription Billing, then continue with this document to subscribe to Price Calculation.
5

3 ASSIGN ENTITLEMENTS You need to assign entitlements if you want to use Price Calculation. Your SAP BTP global account has entitlements to use resources, such as services and memory. You distribute quotas of these entitlements to your individual subaccounts (tenants) to define the maximum consumption for each subaccount.
1. On the Global Account page of the SAP BTP Cockpit, open your subaccount/ten ant.
2. In the navigation panel, select Entitlements. Select Edit.
3. Select Add Service Plans.
6

4. Add Service Plans for Price Calculation to your subaccount/ten ant. a. Enter price calculation into the filter to find Price Calculation. b. Select default (Application) checkbox c. (optional) Select standard if you need to get access to the Price Calculation APIs
5. Select Save on the Entitlements overview screen.
You have now added all the entitlements to your tenant.
7

4 SUBSCRIBE TO PRICE CALCULATION To subscribe to Price Calculation, execute the following operations:
1. Open your subaccount and choose Service Marketplace under Services in the navigation panel.
2. Under Integration Suite on the Price Calculation tile, select the actions icon on the upper right corner and choose Create.
8

3. Select the default plan and select Create.
4. Check the progress of the subscription creation by selecting View Subscription. This takes you to Instances and Subscriptions.
Caution: Note that this creation process can take a few minutes
9

5 BUILD ROLE COLLECTIONS To access the Price Calculation apps, it is necessary to control user authorizations. To define the relevant role collections, execute the following operations:
1. In the SAP BTP cockpit, go to your global account. Choose Subaccounts and then select your subaccount/ tenant
2. Under Security in the navigation panel, choose Role Collections.
3. Select the name of your role collection previously defined for SAP Subscription Billing.
10

4. In the overview of the role collection, select Edit to open the screen in edit mode.
5. From the Role Name list, select the role that you want to add. The application identifier of the roles from the Price Calculation service for SAP Subscription Billing begins with “price-management”.
11

6. The following roles are available for the Price Calculation service:

Role template (Role)

Description

Available Apps

Manage Lookup Table Data

Pricing_Specialist

Responsible for entering and maintaining prices.

Manage Lookup Tables Manage Aggregation Catalog

Manage Field Catalog

Manage Pricing Schemes

Configuration_Expert

Responsible for the setup, configuration and implementation of the pricing rules and schemes.

Manage Price Element Specifications
Manage Lookup Tables

Manage Aggregation Catalog

Manage Field Catalog

Consuming_Service

Technical role (for APIs) used to send price queries and get information about the pricing schemes.

none

Manage Pricing Schemes

Manage Price Element Specifications

Support

Read-only access to all data for auditing and support.

Manage Lookup Tables Manage Lookup Table Data

Manage Aggregation Catalog

Manage Field Catalog

Analyze Documents

ui_document_analyze

Use of the Analyze Documents app.

Analyze Documents

View Authorization
Yes Yes Yes Yes Yes Yes Yes Yes Yes
Yes Yes Yes Yes Yes Yes Yes Yes

Manage Authorization
Yes No No No Yes Yes Yes Yes Yes
No No No No No No No Yes

7. Select the roles that you want to configure and choose Add.

12

8. Select Save to close the edit mode.

9. Optional: You can create role collections to restrict a specific market for a user.

See details in the section below.

13

6 ASSIGN ROLE COLLECTIONS TO USERS OR USER GROUPS In the SAP BTP cockpit, you must assign role collections to IdP users or user groups.
1. Create or open the role collection. In the overview, select Edit to open the screen in edit mode.
2. Under Users, enter the ID of the user and choose the identity provider in the first row. Then select the + icon.
3. The user is now added. Repeat the previous step to add further users to the collection.
4. Select Save to close the edit mode.
14

5. Now your role collection should have at least one user.
15

7 DEFINE ROLE COLLECTIONS AND ROLES TO RESTRICT AUTHORIZATION BY MARKET (OPTIONAL)
You can restrict user access to data that is associated with certain markets. For example, a user can be allowed to only view or manage lookup table data in a particular market. Users without a role that restricts market authorization have access to data for all markets. For detailed information about the data that is visible to users who are authorized only for certain markets, see Build Role Collections in the Setup and Administration Guide. You restrict the markets for which users have authorization by assigning them a role collection that contains at least one role based on the role template “ui_market_restriction” in the SAP BTP cockpit. Always make sure that the markets defined in SAP Subscription Billing and in Price Calculation are the same. 1. UnderSecurityin the
navigation panel, choose Role Collections
2. Create a Role Collection for a specific market.
3. In the navigation panel, choose Security > Roles.
16

4. Enter “market” in the search field to find the role that restricts authorization for markets.
5. In the row that contains the role template “ui_mark et_restriction”, select Create Role.
6. Configure the Role and assign the respective Role Collection.
7. In the navigation panel, choose Security > Users.
17

8. From the list of users, pick the row containing the user to whom you will assign the market restriction.
9. Assign the role collection of the market restriction to this user.
18

8 ENABLE API ACCESS (OPTIONAL) This section describes the prerequisites for using Price Calculation API. See the Service Guide for more information about using the API. Note: To view the service key, you require the Subaccount Viewer role.
8.1 Create a Service Instance When you create an instance of the Price Calculation API service, you provide a set of scopes that define which of the APIs can be called and which activities can be done using service keys created for the instance. To create an instance, you require the Subaccount Service Administrator role. When you create a subaccount, SAP BTP automatically grants this role to your user. 1. In your subaccount,
choose Services > Service Marketplace in the navigation panel.
2. You see all the services that are available to you. Search for and select the service Price Calculation. Note: There are two services called Price Calculation. One of them belongs to the API service.
3. Under Service Plans, display the action menu of the plan for which you want to create an instance and select Create. NB: In this guide, we use the default plan for the example.
19

4. Name the instance and select Next. NB: In this guide, we use “INSTANCEDEMO” as the example name.
5. No parameters need to be specified. Select next.
20

6. Check that everything is correct and select Create.
7. The creation process starts. Select View Instance to switch to the Instances screen under the Instances and Subscriptions page.
8. Your instance is created.
8.2 Create a Service Binding To create the access token used to call the API, you need to create a service key.
21

1. In the Instances screen, display the action menu of the instance and select Create Service Binding.
2. Enter a name for the service key, then select Create.
3. Your service key is created.
22

9 UNSUBSCRIBING ­ IMPORTANT NOTICE
SAP strongly recommends that you do not unsubscribe from Price Calculation while its tenant is part of an integration with SAP Subscription Billing: unsubscribing would delete all data of Price Calculation and result in inconsistencies within SAP Subscription Billing.
23

www.sap.com/contactsap
© 2021 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company.
The information contained herein may be changed without prior notice. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.
In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation, and SAP SE’s or its affiliated companies’ strategy and possible future developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, and they should not be relied upon in making purchasing decisions.
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. See https://www.sap.com/copyright for additional trademark information and notices.

Documents / Resources

SAP BTP Configuration [pdf] User Guide
BTP Configuration, BTP Configuration, Configuration

References

Leave a comment

Your email address will not be published. Required fields are marked *