Introduction

It gathers all information needed for the customer to understand the relationship between the content of the Discovery Center and the content of the BTP Cockpit, as well as any information needed to understand how the service is billed. The commercial information page is only mandatory for services using capacity units as metrics, however if you think that it would be useful for your users, please feel free to set up one in your service guide.

The information page is the responsibility of the UA developer with the help of the service owner.

Getting Started

Creating the Topic in the CMS

  1. Clone the template topic (loioc4c33e027f0c4cba929598ee127b112c) with a new LOIO.
  2. Refer to the section "Structure of the Commercial Information Page" to identify which sections should be displayed for your service.
  3. The section "Guidelines" details how each part of the commercial information page should be filled.

Location

Example

TopicLocationExample

Example

TopicLocationExample_CoreGuide

Topic Title

Examples

TopicTitleExample

Structure of the Commercial Information Page

This table lists all available sections of the commercial information page along with the description of each section's content, whether the section applies to your service, and the stakeholders to contact to get
the information you need to fill the section.

Note that not all sections apply to all services. Check the When to Use column to know whether the section should appear in the commercial information page related to your service.

Check these examples for reference:

<div> <div>Section Name</div> <div>Description</div> <div>When to Use</div> <div>Stakeholders</div> </div> <div> <div>No title (short description)</div> <div>Description of the page and its usefulness</div> <div>Mandatory for all services</div> <div>UA</div> </div> <div> <div>Service | Overview</div> <div>Graphical representation of the service for each consumption model</div> <div>Mandatory for all services</div> <div> <p>Service owner</p> <p>Holger Neuert</p> <p>Anett Richel</p> </div> </div> <div> <div>Service plans | Discovery Center: Service Plans</div> <div>Table with the names of the Service plans displayed in the Discovery Center and the link to their description in the Discovery Center</div> <div> <p>.</p> <p>Only applies to services when</p> <ul> <li>there is no technical implementation of the service plan in the BTP Cockpit,</li> <li>the relationship between services plan in the Discovery Center and the BTP Cockpit is n-1.</li> </ul> </div> <div>Service owner</div> </div> <div> <div>Service Plans | BTP Cockpit: Service Plans</div> <div>Table with the names and descriptions of the service plans displayed in the BTP Cockpit.</div> <div>Mandatory for all services</div> <div>Service owner</div> </div> <div> <div>Metrics</div> <div> <p>Table with the names and descriptions of the metrics used by your service.</p> <p>Examples of usage</p> </div> <div>Mandatory for all services</div> <div>Service owner</div> </div> <div> <div>Backward Calculation</div> <div> <p>Formula for the backward calculation</p> <p>Explanation of the underlying metrics</p> <p>Example of use</p> </div> <div> <p>.</p> <p>Only applies to services using capacity unit as a metric.</p> </div> <div>Service owner or developer</div> </div> <div> <div>Calculator</div> <div> <p>What the calculator is for</p> <p>List of information the customer needs to use it</p> <p>How to understand the results</p> <p>Link to the calculator</p> </div> <div> <p>.</p> <p>Only applies to services using capacity unit as a metric.</p> </div> <div>Service owner or developer</div> </div> <div> <div>Supplemental Terms & Conditions</div> <div>Link to the supplemental terms & conditions</div> <div>Mandatory for all services</div> <div>Service owner</div> </div> <div> <div>Service Specifics</div> <div>Details of specific behaviors</div> <div>Only applies to services having a different behavior from other services, be it commercially or technically.</div> <div>Service owner</div> </div> <div> <div>Glossary</div> <div>Link to the list of terms used in the commercial infopage with their definitions</div> <div>Mandatory for all services</div> <div>Provided</div> </div>

Guidelines

Introduction

This section is mandatory.

Enter the page introduction in the topic short description. Use the following text:

This page explains the relationship between the service plans in the SAP Discovery Center and those in the SAP BTP Cockpit, and provides information to help you understand how the service is billed.

Section "Service"

Section "Overview"

This section is mandatory.

If you need assistance to create the graphic, please contact Holger Neuert (holger.neuert@sap.com) or Anett Richel (anett.richel@sap.com).

  1. Use the template CostUsageTransparency_Graph_Template.pptx to create the graph corresponding to the relationship between the service plans listed in the Discovery Center and their technical counterpart in the BTP Cockpit.
Overview of the Graph Template

Graphic_template

CostUsageTransparency_Graph_Template.pptx

354 KB

pptx

2. Import the Powerpoint file in the CMS as a graphic.

3. Add the note:

For more information, please refer to Commercial Models.

Note for New Services

The relationship between Service plan in the Discovery Center and the service plans in the BTP Cockpit should be:

1To1relation_example

1To1relation_example

1 to 2 if there is an instance and a user interface. For example:

1To2relation_example

1To2relation_example

Section "Service Plans"

Section "Discovery Center: Service Plans"

This section is optional. Only add it if there is a discrepancy between the service plans in the SAP Discovery Center and the service plans in the SAP BTP Cockpit, such as no service plans in the SAP BTP cockpit.

  1. Re-use the names from the Service Plan section of the service Data Sheet to fill the Name column.
  2. If needed, add a comment explaining the relationship between the service plan in the Discovery Center and what is displayed in the BTP Cockpit.
  3. Enter the link to the Discovery Center corresponding to each service plan.

Example

<div> <div>Name</div> <div>Comment</div> <div>Link to the SAP Discovery Center</div> </div> <div> <div>Standard</div> <div>There is no technical implementation for this service plan in the SAP BTP Cockpit. It is activated by default.</div> <div><a href="https%3A%2F%2Fdiscovery-center.cloud.sap%2FserviceCatalog%2Fcloud-foundry-runtime%3Fregion%3Dall%255C%255C%26tab%3Dservice%255C%255C_plan%255C%255C%26commercialModel%3Dbtpea">https://discovery-center.cloud.sap/serviceCatalog/cloud-foundry-runtime?region=all\\&tab=service\\_plan\\&commercialModel=btpea</div> </div>

Section "BTP Cockpit: Service Plans"

This section is mandatory.

  1. In the Name column of the table template, enter the names of the service plans listed in the BTP Cockpit.
  2. For each entered name, enter in the Discovery Center column the corresponding service plan name from the Discovery Center.
  3. For each entered name, enter in the Description column the service plan description. The description must be aligned with the one on the BTP Cockpit.
  4. Below the table, add a link to your product pricing page in the Discovery Center.
  5. Add the note
    For more information regarding the consumption motels, please check Commercial Models.

Example

<div> <div><strong>Name in</strong><br><strong>SAP BTP Cockpit</strong></div> <div>Service Plan Name<br>in Discovery Center</div> <div>Description</div> </div> <div> <div>standard</div> <div>n/a</div> <div>Allows you to create a service instance when coupled with the free (Application) or standard (Application) entitlements. You must select this entitlement to fully use all capabilities of SAP Build Process Automation. When using it with the free (Application) entitlement, no additional costs are charged.</div> </div> <div> <div>standard (application)</div> <div>n/a</div> <div>Subscribe to the production service. Note that to fully use all capabilities of SAP Build Process Automation, you also must subscribe to the standard entitlement at no additional cost.</div> </div> <div> <div>free</div> <div>Free</div> <div>Only community support is available for free tier service plans and these are not subject to SLAs. Use of free tier service plans are subject to additional terms and conditions as provided in the Business Technology Platform Supplemental Terms and Conditions linked in the Additional Links tab displayed in the Service tile. Subscribe to the free service. To fully use all capabilities of SAP Build Process Automation, you also must subscribe to the standard entitlement at no additional cost.</div> </div>

Section "Metrics"

This section is mandatory.

How to fill the metrics table

  1. Identify the metrics corresponding to your service in the Metrics Reference Table. They should correspond to the ones displayed in the Service Overview schema (section 1.1)

  2. If your service uses a recommended term:

    1. Copy/paste the line corresponding to your metric in the metrics table of the commercial information page.

  3. If your service uses a deprecated term or a variant:

    1. Copy/paste the line corresponding to the recommended term.
    2. In the Metric column, replace the metric name by the term actually used for your service.

  4. Delete the column Examples of Services Using this Metric.

Specifics for New Services

Choosing the Metrics when Creating a New Service

  1. Review the metric list in the section Metrics Reference Table below.
  2. Identify the best fitting metrics.

Recommendations

Example of a Metrics Table on a Service Commercial Information Page

<div> <div>Metric</div> <div>Definition</div> </div> <div> <div>Active Users</div> <div> <p>Individuals that access the Cloud Service at any time during a calendar month.</p> <p>Note that a user is only counted on a Global Account level. For example, if a user accesses the Cloud Service on sub-account A and on sub-account B, it will only be counted as one active user in the month.</p> </div> </div> <div> <div>Users</div> <div> <p>Individuals authorized to access the Cloud Service. For purposes of</p> <p>Platform cloud services, users include individuals authorized to access a</p> <p>platform application.</p> </div> </div>

Metrics Reference Table Presentation

<div> <div>Column Name</div> <div>Content</div> <div>Recommendations</div> <div>To Display<br>on Infopage</div> </div> <div> <div></div> <div>Metric name</div> <div> <p>Recommended terms are signaled in bold, allowed variants in normal font and deprecated terms in italics.</p> <p>- When creating a service, do not use a metric listed as deprecated, choose the recommended term instead.</p> </div> <div>Yes</div> </div> <div> <div></div> <div>Official metric definition</div> <div> <p>As provided in the SAP Business Technology Platform Service Description Guide.</p> <p>If your service uses a metric marked as deprecated, use the definition listed for the referenced term.</p> </div> <div>Yes</div> </div> <div> <div></div> <div></div> <div>Examples of services using this metric. These service names are provided to the UA developer as examples, especially when looking for metrics for a new service.</div> <div>No</div> </div>

Metrics Reference Table

<div> <div>Metric</div> <div>Definition</div> <div>Examples of Services Using this Metric<br>(column not displayed on the commercial information page)</div> </div> <div> <div></div> <div>Individuals that access the Cloud Service at any time during a calendar month.</div> <div> <p>Work Zone, standard ed.</p> <p>Work Zone, advance ed.</p> </div> </div> <div> <div>Additional Connections</div> <div>Variant - See</div> <div></div> </div> <div> <div></div> <div>Calls made between a customer application or a back-end data source and a cloud service API to send any user action or system action.</div> <div> <p>Data Quality Management</p> <p>Alert Notification</p> <p>Automation Pilot</p> <p>SAP Responsibility Management</p> <p>Document Management</p> </div> </div> <div> <div>API Calls (in blocks of n)</div> <div>Variant - see</div> <div></div> </div> <div> <div></div> <div>Amount of data traffic transmitted and received by the Cloud Service.</div> <div> <p>Transport Management</p> <p>Event Mesh</p> <p>Private Link</p> </div> </div> <div> <div></div> <div> <p>If a technical plan has more then 3-4 metrics, you should consider using capacity units as metric. For example, Cloud Service has compute, storage and memory but in different sizes e.g. XS, S, M, L, XL and XXL capacity units could be the better fit.</p> <p>If capacity units are chosen, a Calculator needs be provided and a backward calculation with the underlying usage (e.g. compute, storage, etc) for calculating and understanding the capacity units.</p> </div> <div> <p>SAP HANA Cloud</p> <p>SAP Kyma</p> </div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Consumption of a build running on a virtual machine with minimum x cores and y GB RAM.</div> <div> <p>Document Information Extraction</p> <p>Continuous Integration and Delivery</p> </div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Linkage between the Cloud Service and another system/technology.</div> <div> <p>SAP Build Process Automation</p> <p>Work Zone, standard ed.</p> <p>Work Zone, advance ed.</p> </div> </div> <div> <div>Connections (in blocks of n)</div> <div>Variant - See</div> <div></div> </div> <div> <div></div> <div> <p>An individual, unstructured data object managed via the Cloud Service.</p> <p>Note:</p> <ul> <li>A document consists of a single file up to 250KB</li> <li>For PDF and TIFF documents one document can consist of a maximum three pages</li> </ul> </div> <div></div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div> <p>Temporary memory bank where computers store data that needs to be retrieve and processed quickly.</p> <p>The memory represents the size of the data that can be processed , and CPU represents the speed at which the data can be retrieved.</p> </div> <div> <p>SAP HANA Cloud</p> <p>Kyma</p> <p>Datasphere</p> <p>Redis</p> </div> </div> <div> <div></div> <div>Deprecated - see</div> <div></div> </div> <div> <div></div> <div>Trained machine learning models that are available as an engine for prediction and classification via the corresponding API endpoint. Per every model used you will pay additional fee at hourly rate.</div> <div> <p>Personalized Recommendation</p> <p>Data Attribute Recommendation</p> <p>Business Entity Recognition</p> </div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div> <p>Individual, structured data objects managed via the Cloud Service, such as characters, objects, tasks, jobs.</p> <p>For this Cloud Service, a record is a line-item in the input to the reconciliation process.</p> </div> <div> <p>Intercompany reconciliation</p> <p>Personalized Recommendation</p> <p>Data Attribute Recommendation</p> <p>Task Center</p> </div> </div> <div> <div></div> <div>Unique individual or non-human asset accessing or being managed by the cloud service</div> <div>SAP Mobile</div> </div> <div> <div></div> <div>Amount of cloud storage</div> <div> <p>Document Management</p> <p>Kyma</p> <p>Object Store</p> <p>PostgreSQL</p> </div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Deprecated - See</div> <div></div> </div> <div> <div></div> <div>Customer-specific instance of the Cloud Service</div> <div> <p>Data Privacy Integration</p> <p>Personal data management</p> </div> </div> <div> <div></div> <div>Any message, job, action, response, and/or task processed via the Cloud Service</div> <div></div> </div> <div> <div></div> <div>Individuals authorized to access the Cloud Service. For purposes of Platform cloud services, users include individuals authorized to access a platform application.</div> <div> <p>Business Application Studio</p> <p>UI5 flexibility for key Users</p> </div> </div>

Section "Backward Calculation"

This section is mandatory for services using Capacity Unit as a metric, and optional for others.

Metrics in the discovery center can be split in different metrics in the cockpit, so you need to provide the customer with a way to calculate the usage and the cost so that they understand the relationship between both and why they've been billed that way.

Section "Formula"

Section "Underlying Metrics"

Section "Example"

Section "Calculator"

This section is mandatory for services using Capacity Unit as a metric, and optional for others.

To find this information you need to get familiar with your service calculator by getting in contact with the developer who created the calculator, understand how it is build, find if they used the same terms, same units, and so on.

Section "Supplemental Terms & Conditions"

This section is mandatory.

  1. Go to the SAP Business Technology Platform Service Description Guide.

  2. In the SAP Business Technology Platform Service Description Guide, search for your service name.

  3. If the terms and conditions are listed in the description guide,

    1. In the information page, create a link with the name SAP Business Technology Platform Service Description Guide as text and https://www.sap.com/about/trust-center/agreements/cloud/cloud-services.html?sort=latest_desc&search=SAP%20Business%20Technology%20Platform%20Service%20Description%20Guide&tag=language:english as the address.
      Note - Do not link the document directly since it may be updated often, and the link would have to be maintained regularly in the commercial information page.
    2. Specify the name of the section as stated in the SAP Business Technology Platform Service Description Guide.

  4. If the section about your service states "The Cloud Service is subject to the “<Service name>” Supplemental Terms and Conditions, published on the SAP Agreements website, referenced in the Order Form, and is not subject to the SAP Business Technology Platform Supplemental Terms and Conditions.":

    1. In the search engine, search for <Service name> as mentioned in the section about your service.
    2. Copy the search URL from the address bar.
    3. In the information page, create a link with the name of the supplement as text and the search URL as address. Do not link the document directly since it may be updated often, thus changing the link.

Examples

Service listed in the Service Description Guide

For additional information, please refer to the SAP Business Technology Platform Service Description Guide, section SAP BUILD PROCESS AUTOMATION.

Service not listed

For additional information, please refer to the SAP Data Intelligence, cloud edition Supplement.

Section "Service Specifics"

This section is optional. You can use it to provide information on the service behavior if is different from other services, be it commercially or technically.

Examples

Kyma

Cloud Foundry

Section "Glossary"

This section is mandatory.