C_UpcgSrvcContrItemQuery
Upcoming Service Contract Item - Query
C_UpcgSrvcContrItemQuery (Consumption)
Package: Explore, extend and adapt the SAP S/4HANA Cloud Public Edition with built-in and side-by-side extension capabilities.
Sales
C_UpcgSrvcContrItemQuery is a Consumption CDS View that provides data about "Upcoming Service Contract Item - Query" in SAP S/4HANA. It reads from 1 data source (I_UpcgSrvcContrItemCube) and exposes 36 fields with key fields ServiceContract, ServiceContractItem. Part of development package CRMS4_ANALYTICS_SERVICE_CONTR.
SAP Help Documentation
| Category | Service Monitoring and Analytics |
|---|---|
| Data Category | Consumption |
| Status | Item Life Cycle Status |
| Corresponding DataSource | 2CCUPCGCITEMQRY |
Purpose
This CDS view belongs to Service Contracts Dashboard app and can be used both as an embedded and standalone edition. This CDS view is used to define the service contract KPIs such as net value/number of service contract items, expiring service contract items (in next 6 months) and expired/canceled service contract items (in last 6 months). The Upcoming Service Contract Item - Cube ( I_UpcgSrvcContrItemCube ) view is used to consume the KPIs defined in this query view. This CDS view provides the data to answer the following business questions: What is the total net value of the service contracts for a particular time period (month, quarter and year) in the system? How many service contract items are active for a particular time period in the system? How many service contract items will be expiring in next 6 months? What is the total value of these expiring service contract items? Who are my top performing customers in terms of service contract value and their top selling products? To help you decide which CDS view to use for your purposes, SAP has introduced the annotation ObjectModel.supportedCapabilities that indicates the most appropriate use cases for each CDS view. To find out what use cases are best supported by this CDS view, access the entry of the CDS view in the View Browser app and find the values for this annotation under the Annotation tab. For more information, see Supported Capabilities for CDS Views .
Prerequisites
Authorizations The following business catalog needs to be assigned to a user to be able to use this CDS view: Service - Service Management Analytics ( SAP_S4CRM_BC_SRV_ANA_PC ) Users who want to use this CDS view must have a role that includes authorization based on the business catalog listed above.
Structure
Parameters The parameters of the CDS view are as follows: P_DisplayCurrency used to specify the target currency for currency conversion. Fields used for filtering Important fields in this view include the following: Field Name Description Measure or Attribute ServiceContractItemNetAmount Net Value of Service Contract Items Measure NmbrOfServiceContractItems No. of Service Contract Items Measure ExprgSrvcContrItemNetAmount Net Value of Expiring Service Contract Items (in next 6 months) Measure CancldSrvcContrItemNetAmount Net Value of Canceled Service Contract Items Measure ServiceContract Service Contract Attribute ServiceContractItemStatus Item Life Cycle Status Attribute SoldToParty Sold-To Party Attribute SrvcContrStartYear Calendar Start Year Attribute
This CDS view belongs to Service Contracts Dashboard app and can be used both as an embedded and standalone edition. This CDS view is used to define the service contract KPIs such as net value/number of service contract items, expiring service contract items (in next 6 months) and expired/canceled service contract items (in last 6 months). The Upcoming Service Contract Item - Cube ( I_UpcgSrvcContrItemCube ) view is used to consume the KPIs defined in this query view. This CDS view provides the data to answer the following business questions: What is the total net value of the service contracts for a particular time period (month, quarter and year) in the system? How many service contract items are active for a particular time period in the system? How many service contract items will be expiring in next 6 months? What is the total value of these expiring service contract items? Who are my top performing customers in terms of service contract value and their top selling products? To help you decide which CDS view to use for your purposes, SAP has introduced the annotation ObjectModel.supportedCapabilities that indicates the most appropriate use cases for each CDS view. To find out what use cases are best supported by this CDS view, access the entry of the CDS view in the View Browser app and find the values for this annotation under the Annotation tab. For more information, see Supported Capabilities for CDS Views .
Prerequisites
Authorizations The following business catalog needs to be assigned to a user to be able to use this CDS view: Service - Service Management Analytics ( SAP_S4CRM_BC_SRV_ANA_PC ) Users who want to use this CDS view must have a role that includes authorization based on the business catalog listed above.
Structure
Parameters The parameters of the CDS view are as follows: P_DisplayCurrency used to specify the target currency for currency conversion. Fields used for filtering Important fields in this view include the following: Field Name Description Measure or Attribute ServiceContractItemNetAmount Net Value of Service Contract Items Measure NmbrOfServiceContractItems No. of Service Contract Items Measure ExprgSrvcContrItemNetAmount Net Value of Expiring Service Contract Items (in next 6 months) Measure CancldSrvcContrItemNetAmount Net Value of Canceled Service Contract Items Measure ServiceContract Service Contract Attribute ServiceContractItemStatus Item Life Cycle Status Attribute SoldToParty Sold-To Party Attribute SrvcContrStartYear Calendar Start Year Attribute
SAP API Hub
| Category | Consumption |
|---|---|
| State | C1 |
| Line of Business | Sales |
| Application Component | CRM-S4-ANA-CDS-2CL |
| Capabilities | Analytical Query |
| Extensible (Key User) | No |
| Extensible (Developer) | No |
| Release State (Key User) | Released |
| Release State (Developer) | Not Released |
| Package | Sales for SAP S/4HANA Cloud Public Edition |
Documentation
- Analytics with CDS Views — Build Analytics for S/4HANA Cloud Public Edition ABAP CDS views replicated to SAP Cloud Platform
- CDS Views on SAP Business Accelerator Hub — Explore SAP S/4HANA Cloud Public Edition CDS Views on SAP Business Accelerator Hub
- Create CDS View as API — Create CDS views in SAP S/4HANA Cloud Public Edition and consume them as APIs
- Custom CDS Views — Access data using a Custom Core Data Service view (Custom CDS view)
- Custom Communication Scenarios — Create custom communication scenarios to configure custom communication arrangement
- Key User Extensibility Tools — The Key User Extensibility Tools of S/4HANA
- SAP S/4HANA Extensibility — SAP S/4HANA Extensibility Tutorial
- VDM View Types — The Virtual Data Model in SAP S/4HANA Cloud Public Edition
- View Browser — Search, browse and tag CDS Views
Data Sources (1)
| Source | Alias | Join Type |
|---|---|---|
| I_UpcgSrvcContrItemCube | I_UpcgSrvcContrItemCube | from |
Parameters (1)
| Name | Type | Default |
|---|---|---|
| P_DisplayCurrency | vdm_v_display_currency |
Annotations (16)
| Name | Value | Level | Field |
|---|---|---|---|
| EndUserText.label | Upcoming Service Contract Item - Query | view | |
| ClientHandling.algorithm | #SESSION_VARIABLE | view | |
| VDM.viewType | #CONSUMPTION | view | |
| VDM.lifecycle.contract.type | #PUBLIC_LOCAL_API | view | |
| AccessControl.authorizationCheck | #PRIVILEGED_ONLY | view | |
| AbapCatalog.sqlViewName | CUPCGCITEMQRY | view | |
| AbapCatalog.compiler.compareFilter | true | view | |
| AbapCatalog.preserveKey | true | view | |
| ObjectModel.usageType.dataClass | #MIXED | view | |
| ObjectModel.usageType.serviceQuality | #D | view | |
| ObjectModel.usageType.sizeCategory | #XXL | view | |
| ObjectModel.modelingPattern | #ANALYTICAL_QUERY | view | |
| Metadata.ignorePropagatedAnnotations | true | view | |
| Analytics.query | true | view | |
| OData.publish | true | view | |
| Analytics.settings.olapPushdown | #OFF | view |
Fields (36)
| Key | Field | Source Table | Source Field | Description |
|---|---|---|---|---|
| KEY | ServiceContract | ServiceContract | Service Contract | |
| KEY | ServiceContractItem | ServiceContractItem | Shortened Item Number in Document | |
| ServiceDocument | ServiceDocument | Service Transaction | ||
| ServiceContractType | ServiceContractType | Business Transaction Type | ||
| ServiceContractDescription | ServiceContractDescription | Service Contract Description | ||
| ServiceContractItemProduct | ServiceContractItemProduct | Product | ||
| ServiceContractItemStartDate | ServiceContractItemStartDate | Service Contract Item Start Date | ||
| ServiceContractItemEndDate | ServiceContractItemEndDate | Service Contract Item End Date | ||
| SrvcContrStartMonth | SrvcContrStartMonth | Calendar Month (Start) | ||
| SrvcContrStartQuarter | SrvcContrStartQuarter | Calendar Quarter (Start) | ||
| SrvcContrStartYear | SrvcContrStartYear | Calendar Year (Start) | ||
| SrvcContrEndMonth | SrvcContrEndMonth | Calendar Month (End) | ||
| SrvcContrEndQuarter | SrvcContrEndQuarter | Calendar Quarter (End) | ||
| SrvcContrEndYear | SrvcContrEndYear | Calendar Year (End) | ||
| ServiceDocItemCreationDate | ServiceDocItemCreationDate | Created On | ||
| PostingDate | PostingDate | Posting Date for a Business Transaction | ||
| ServiceContractItemStatus | ServiceContractItemStatus | Item Life Cycle Status | ||
| ServiceContractItemCanclnParty | ServiceContractItemCanclnParty | Cancellation Party | ||
| ServiceContractItmCanclnReason | ServiceContractItmCanclnReason | CRM Service : Reason for Cancellation | ||
| ProfitCenter | ProfitCenter | Profit Center | ||
| ControllingArea | ControllingArea | Controlling Area | ||
| PurchaseOrderByCustomer | PurchaseOrderByCustomer | Sold-To Party's External Reference Number | ||
| SoldToParty | SoldToParty | Sold-to Party | ||
| RespEmployeeBusinessPartnerId | RespEmployeeBusinessPartnerId | Employee Responsible | ||
| RefBusinessSolutionOrder | RefBusinessSolutionOrder | Reference Solution Order ID | ||
| SoldToPartyCountry | SoldToPartyCountry | Country/Region | ||
| SoldToPartyRegion | SoldToPartyRegion | Region (State, Province, County) | ||
| SalesOrganization | SalesOrganization | Sales Organization | ||
| DistributionChannel | DistributionChannel | Distribution Channel | ||
| Division | Division | Internal Division ID | ||
| SalesOffice | SalesOffice | Sales Office | ||
| SalesGroup | SalesGroup | Sales Group | ||
| DisplayCurrency | ||||
| NmbrOfServiceContractItems | NmbrOfServiceContractItems | No. of Service Contract Items | ||
| NrOfExprgServiceContractItems | NrOfExprgServiceContractItems | No. of Expiring Service Contract Items in Next 6 Months | ||
| NrOfCancldServiceContractItems | NrOfCancldServiceContractItems | No. of Canceled Service Contract Items |
Derived SQL interpretation, reconstructed from the parsed view metadata (data sources, associations, and field mappings). SAP annotations are omitted and the structure is reformulated as SQL — this is a functional approximation, not the verbatim SAP source.
-- Derived SQL interpretation of CDS view C_UpcgSrvcContrItemQuery.
-- Reconstructed from parsed metadata (data sources, associations, fields).
-- SAP annotations are omitted and the structure is reformulated as SQL;
-- this is a functional approximation, not the verbatim SAP source. Some join
-- conditions may be unavailable and a few CDS constructs are kept as-is.
-- Parameters: P_DisplayCurrency : vdm_v_display_currency
CREATE VIEW C_UpcgSrvcContrItemQuery AS
SELECT
ServiceContract,
ServiceContractItem,
ServiceDocument,
ServiceContractType,
ServiceContractDescription,
ServiceContractItemProduct,
ServiceContractItemStartDate,
ServiceContractItemEndDate,
SrvcContrStartMonth,
SrvcContrStartQuarter,
SrvcContrStartYear,
SrvcContrEndMonth,
SrvcContrEndQuarter,
SrvcContrEndYear,
ServiceDocItemCreationDate,
PostingDate,
ServiceContractItemStatus,
ServiceContractItemCanclnParty,
ServiceContractItmCanclnReason,
ProfitCenter,
ControllingArea,
PurchaseOrderByCustomer,
SoldToParty,
RespEmployeeBusinessPartnerId,
RefBusinessSolutionOrder,
SoldToPartyCountry,
SoldToPartyRegion,
SalesOrganization,
DistributionChannel,
Division,
SalesOffice,
SalesGroup,
$parameters.P_DisplayCurrency AS DisplayCurrency,
NmbrOfServiceContractItems,
NrOfExprgServiceContractItems,
NrOfCancldServiceContractItems
FROM I_UpcgSrvcContrItemCube
;Learn More
- VDM (Virtual Data Model) in SAP S/4HANA Explained
- Types of CDS Views: Basic, Composite, Consumption, and Transactional
- CDS View Annotations — A Complete Guide
- What Is a CDS View in SAP S/4HANA?
- SAP Tables vs CDS Views — Key Differences
- Understanding Data Lineage in SAP S/4HANA
- CDS View Field Mapping and Associations
- Understanding the SAP S/4HANA Data Model
- CDS View Extensions and Custom Fields in SAP S/4HANA
- Released APIs and Stability Contracts in SAP S/4HANA
- BSEG to ACDOCA: The Universal Journal Migration
- Business Partner Migration: KNA1/LFA1 to BUT000
- Material Document Migration: MSEG/MKPF to MATDOC
- How to Find the Right CDS View for an SAP Table
- BW Extractor to CDS View Migration Guide
- S/4HANA CDS View Deprecation: What You Need to Know
- ABAP CDS View Tutorial — From Basics to Real-World Examples
- RAP and CDS Views — Building Transactional Apps in SAP S/4HANA
- Sales Document Status Migration: VBUP/VBUK Removal in S/4HANA
- CO Tables in S/4HANA: COEP, COBK, COSS, COSP to ACDOCA