7 Configuring Value Maps

Learn how to configure value maps in Pricing Design Center (PDC) to group event attributes into manageable categories in Oracle Communications Billing and Revenue Management (BRM).

Topics in this document:

• About Value Maps

• Loading the Sample Value Map into the Database

• Configuring Value Maps Using SampleValueMap.XML

About Value Maps

You create value maps to associate zone names with values that apply to a single event attribute, such as an area code or an IP address. This allows you to set up services for location-based charging, which charges your customers based on their location.

You can configure value maps in PDC using the SampleValueMap.xml file and ImportExportPricing utility. For custom zones, use the SampleValueMap.xml as a template to map your zone names with a list of event attributes.

Table 7-1 lists the elements that are supported in the sample value map XML file, the usage of each element, and a description of how to specify each element in the XML file.

Table 7-1 Elements Supported in the Sample Value Map XML File

Element	Syntax	Description
valueMap	<valueMap>	The root element of the SampleValueMap.xml file.
name	<name>valueMapName</name>	valueMapName specifies the name of the value map.
description	<description>valueMapDescription</description>	valueMapDescription specifies the description of the value map.
priceListName	<priceListName>PriceListName </priceListName>	PriceListName specifies the price list name. BRM uses only one internal price list. The only value is Default.
obsolete	<obsolete>BooleanValue</obsolete>	Boolean flag to obsolete the promoted objects.
exactMatch	<exactMatch>BooleanValue</exactMatch>	Boolean value. When true, the event attribute when compared with keyName or valueMapValue, must be an exact match. If false, the event attribute contains keyName or valueMapValue.
validityPeriod	<validityPeriod>	Root key of the validity period.
validFrom	<validFrom>value</validFrom>	Value describes the start time for the value map. If value is set to zero, there is no start time. Otherwise, it is in the format of YYYYMMDD (For example: 20240131).
valueMapKey	<valueMapKey>	valueMapKey contains the keyName and 0 or more valueMapKey entries.
keyName	<keyName>keyName</keyName>	keyName describes the group name for the list of valueMapValue entries. This is a required field.
valueMapValue	<valueMapValue>value</valueMapValue>	value describes the value to be compared. This is a required field.

Loading the Sample Value Map into the Database

To load the SampleValueMap.xml file:

1. Go to the PDC_home/apps/Samples/Examples directory.

2. Import the SampleValueMap.xml file into the PDC database by running the following command:

   ImportExportPricing -import -config /SampleValueMap.xml -ow

The sample value map is imported into the PDC database and the existing mapping in the BRM database is overwritten.

Configuring Value Maps Using SampleValueMap.XML

To configure value maps:

1. Make a copy of the PDC_home/apps/Samples/Examples/SampleValueMap.xml file to customize.

2. Open the file in a text editor or XML editor.

3. Add or modify the elements as required. See Table 7-1 for the usage and description of each element.

4. Save and close the file.

   Note:

   You can save the file with a different name and location or use the original file.

5. Go to the directory where you have saved the file.

6. Import the value map from the customized XML file into the PDC database by running the following command:

   ImportExportPricing -import -config FileOrDirectoryName

   where FileOrDirectoryName specifies either the full path and file name of the import XML file or the directory in which the import XML files reside.