Create or Change Range Sets in a Range Table

Service Operation (WS)

Definition

To create or change range sets in a range table.

Technical Data

Software Product and Version	SAP Convergent Charging 5.0
Technical Details	rangeTableRangeSetMaintain
Namespace	http://catalog.v3.ws.highdeal.com/
Proxy Instance in SAP CC System	Updater
Service Operation Version	0
User Operation Auditing	Yes
Audit Domain	CATALOG
Application Area	IS-CC
Direction	inbound
Mode	synchronous
Idempotency	true

Business Context and Use

This service operation is used to create or to change range sets in a range table in the pricing catalog of a service provider.

Product Modeling

Your CRM application or another provisioning system manages master data related to the modeling of commercial products. SAP CC extends this master data with pricing information to dynamically compute price amounts related to the usage of a customer service. This information is stored in a pricing catalog owned by the service provider.

CRM retrieves pricing information stored in SAP CC to combine charge plans in the definition of a commercial product. CRM can maintain or replicate some pricing data stored in SAP CC in a pricing catalog of the service provider: mapping tables and range tables .

Related Operations

You can use the following operation to cancel range sets in a range table related to a catalog:

Cancel range sets in a range table

Features

This operation creates or modifies one or several range sets of a range table.
This operation takes as inputs:

The date from which the modification is applied (optional)
The ID of the range table to be modified
The range sets to be created or modified in this range table

A range set must include:

A range set key consisting of a list of input values
All the corresponding ranges (a range has an upper bound and some output values)

Each range set is identified by its range set key:

If the range set key does not exist in the table revision effective at the date specified in the operation, the range set is created.
If the range set key already exists in the table revision effective at the date specified in the operation, the range set is modified.

Note

If the date is not specified in the operation, the last table revision is modified and replaces all the existing revisions. If the date is specified, the revision effective at this date is modified and replaces all the existing revisions starting after the date.

Note

You cannot use this operation to modify range sets of a range table with no input columns. Use the operation Create or change a range table for this purpose.

Caution

Make sure you will not lose the data. The SAP CC system will remove and replace all the revisions already configured after the date specified in the operation request.

Authorizations

To know the role that is expected in the user profile of the SAP CC user specified in your request messages, refer to the SAP CC Security Guide .

Error Handling

The SAP CC system may return an error classified into a category and an error stack detailing the issue and its cause.

Categories and Treatments to Implement

Consider the following error categories to design and implement the appropriate behavior of your connected application or system:

Error Category	Description	Error Handling
Already Exists	The data has to be created but another data already exists in the connected SAP CC system with the same type and the same identifier.	Applicable for this service operation: You implement the logging of this error to enable a system administrator or a consultant to investigate and resolve the issue. Data replication or data synchronization mechanisms may failed.
Does Not Exist	The data to be modified or deleted does not exist in the connected SAP CC system.	Applicable for this service operation:
Invalid	The request or the data is invalid.	Applicable for this service operation: Next follows a non-exhaustive list of errors related to the Invalid category: The range table identifier is not set. The number of input values in the range set key is incorrect. The same range set cannot be modified twice in the same operation. The upper bound is invalid: missing upper bound duplicate upper bound no unbounded range more than one unbounded ranges
Incompatible Configuration	The configuration of the connected SAP CC system is not compatible with the data specified in the operation request and the scope of the request. Creating or correcting the prerequisite configuration data (master data, business data) has to be done in the SAP CC system with the Core Tool user interface or within your connected application or system.	Applicable for this service operation:
Prerequisite Missing	Another data mandatory for the operation is not available or is not compatible with the data specified in the operation request. Create a prerequisite for the data.	Applicable for this service operation: The prerequisite data is managed outside the SAP CC system. Next follows a non-exhaustive list of errors related to the Prerequisite Missing category: The range table does not exist.
Illegal State	The operation request is valid but was rejected because of the current state of the data in the connected SAP CC system which prevents the execution of the request. The current state of the complete system can be also the origin of the error.	Applicable for this service operation: The request will not succeed without a required manual correction or change in the SAP CC system. You implement error logging and manual retry mechanisms.
Temporary Illegal State	The valid request was rejected because of the temporarilly illegal state of the data in the connected SAP CC system. The data state may automatically change without any further notification. This is a subcategory of Illegal State category. The state of a data is temporarilly illegal but the operation request can be sent again after a waiting period. The current state of the complete system can be also the origin of the error.	Applicable for this service operation: You can implement an automated resend function.

Note

This list of errors is not exhaustive: consider the technical details of the operation response.

Troubleshooting

Refer to the SAP CC Error Code Reference ( SAP Site ) for more information about a returned error code and the corrective actions necessary for troubleshooting your implementation project.

Message Types

Consult the structures of the message types related to this service operation :

Prerequisites

The range table containing range sets to be created or modified must exist in SAP CC and be located in a pricing catalog accessible to the user of the Web Services.

The range table must have input columns.

Integration

There is no specific integration information.

Constraints and Integrity Conditions

There is no specific constraint.

Notes on SAP CC Implementation

You must have installed and configured the SAP CC Core Server system.

Configuration

Consult the SAP CC Configuration and Implementation Guide to know the necessary configuration or Customizing of the SAP CC system.

Before implementing SAP Convergent Charging in your SAP system landscape, you must configure the systems and the data (master data, business data).