migration generateCIPackageReport

Definition

To generate a report for migrating chargeable item packages into chargeable item classes

Command Usage

Syntax

MS Windows: setup.bat migration generateCIPackageReport <TO_FILE_PATH>

UNIX and Linux: ./setup.sh migration generateCIPackageReport <TO_FILE_PATH>

Command Arguments
Name Definition
<TO_FILE_PATH> The name and the path of the XML file that will contain the report

Detailed Information

The generateCIPackageReport command verifies that chargeable item packages are stored in the back-end database system and generates a report to convert them into chargeable item classes.

You generate reports each time they include issues to solve.

As of release 4.0 for SAP Convergent Charging, this master data is revoked. Application administrators must migrate this data and pricing specialists must adapt some charges in the service pricing catalogs.

Upgrade Operations

When you upgrade an SAP CC system landscape from release 3.0 to 4.0, you must remove the chargeable item packages from the existing service pricing catalogs.

Data Migration Preparations

As an application administrator for SAP CC, you:

  • Generate the first report.
  • Validate and complete its content.
  • Correct the issues (see below).
  • Ask the pricing specialists to modify the signaled charges in their catalogs.
  • Generate the report again, if necessary.

When done, you are ready to stop the updater instances in the Core Server system and execute the final report with the executeCIPackageReport command of Setup Tool. See this command, its procedure details, and prerequisites.

File Format (XML)

The report is in XML format and is generated in the file specified with the command. The migrateChargeableItemClass XML element represents a chargeable item defined in a chargeable item package and converted into an independent chargeable item class. This element contains the following attributes:

  • currentProductCode: The identification code of the chargeable item package (aka "product" in SAP CC 1.0) defining the current chargeable item class
  • currentClassId: The identifier of the chargeable item class that is currently defined inside the chargeable item package
  • newClassId: The identifier given to the new chargeable item class after the report is executed by Setup Tool

Possible Issues

If a naming conflict prevents the use of the same identifier for some of the chargeable item classes to create, the newClassId XML attributes of the corresponding entries in the report will contain an empty value.

You must specify a new identifier for these chargeable item classes by modifying the values of these XML attributes in the report file and by complying with the following constraints:

  • The new identifiers must not already be used by a chargeable item class defined in a chargeable item package.
  • The new identifiers must not already be used by a chargeable item class.
  • The new identifiers must be different from each other.
  • The new identifiers must not be longer than 256 characters.

The values of the newClassId XML attributes that are already set must not be modified.

If necessary, contact your SAP Support Team.

Authorization

To work with this command, you must have the Administrator role in your SAP CC user profile.

Refer to the SAP CC 5.0 Security Guide for more user assistance and information about the necessary authorizations.

In Scope

Migration of deprecated master data and configuration changes
generateCIPackageReport - To generate a report for migrating chargeable item packages into chargeable item classes
executeCIPackageReport - To execute a report for migrating chargeable item packages into chargeable item classes
increaseCounterSnapshotCount - To increase the number of counter snapshots stored for each subscription/charging contract
deactivateRecharging - To deactivate the recharging operations that are based on counter snapshots
deactivatePrepaid - To deactivate the Prepaid Accounts Management feature
CC40SP08_GetAccessMigrationStatus - To get the status of the migration operation related to accesses
CC40SP08_ExecuteAccessMigration - To execute the migration operation related to accesses
CC40SP08_CompleteAccessMigrationForGuiders - To complete the migration of accesses for guider instances
CC40SP08_CompleteAccessMigrationForRaters - To complete the migration of accesses for rater instances