8 Service Management
This chapter explains the service management section of CCS.
This chapter contains the following topics.
Service Management Module
The Service Management screen enables you to configure the service management section of CCS. It contains these tabs:
Accessing the Service Management screen
Follow these steps to open the Service Management screen.
-
Select the Services menu from the SMS main screen.
-
Select Prepaid Charging > Service Management.
Result: You see the Service Management screen.
Configuration sequence
This table lists the configuration sequence required to correctly set up the service management part of CCS.
Note: Same numbers indicate configuration independence within the sequence.
Sequence | Data Type |
---|---|
1 | Domain |
1 | Currency Code |
2 | Currency |
3 | Global Configuration |
3 | Resource Limits |
4 | Exchange Rates |
4 | Capability |
5 | Product Type |
6 | Barred List |
6 | Number Translation List |
6 | Security |
6 | Splash Screen Configuration |
6 | Balance Type Mapping |
6 | Channel |
Domain
You use the Domain tab to configure the following types of domains:
-
VWS (Voucher and Wallet Server)
-
DIAMETER
-
Third-party
-
BRM
The tab displays a list of the domains that have been configured. You can configure new domains, and edit, or delete exiting domains.
Topics:
About Domain Configuration Issues
When you add a new domain or edit an existing domain, the system displays a list of issues in the Configuration Issues area of the Domain screen, for any domains that are incorrectly configured. The system automatically updates this list as you resolve the issues by updating the domain configuration. You must resolve all the domain configuration issues before saving the domain.
The following table lists the possible configuration issues, and their resolutions:
Configuration Issue | Resolution |
---|---|
Invalid Name | Specify a unique name for the domain in the Name field. |
Not Enough Checkboxes | Select the check boxes in the Manages area for the features you require. You must select at least one check box. |
Invalid Maximum Accounts | Specify a valid number in the Maximum Accounts field. |
Invalid Maximum Queue Messages | If specified, the value for Maximum Queue Messages must be greater than the value for Minimum Queue Messages. |
Not Enough Domain Nodes | For VWS and DIAMETER domains, you must configure at least one domain node in the Nodes / Realms area. |
Invalid Username | For BCD domains, you must specify a valid user name of at least one character. |
Invalid Password | For BCD domains, you must specify a valid password of at least one character. |
Domain fields
This table describes the domain fields in the BE area of the Domain screen.
Field | Description |
---|---|
Name | (Required) The unique name of the domain. |
Type |
(Required) Sets the domain type for this domain. The domain type defines the network element type (such as a Voucher and Wallet Server) for the domain nodes in this domain. The list of available domain types is populated when applications are installed. The domain type for the Voucher and Wallet Server is always available. Once you have added a node to a domain, this field becomes non-editable. For more general information about domain types, see Domain Types. For information about the domain type to choose for an additional installed application, see the application's technical guide. |
Maximum Accounts | (Required) Sets the maximum number of subscriber accounts that can be supported by the domain. |
Update Username and Password | Select to allow a BCD Client to connect to the BRM communication managers. |
Username | Sets the username to use to connect to the BRM communication managers. |
Password | Sets the username's password. |
Wallet Management Charging |
Whether or not wallet management charging functionality is supported for this domain. 'Y’ means wallet management charging functionality is supported by the domain and ‘N’ means it is not. For more information about wallet functionality, see: |
Wallet Management Tracking |
Whether or not wallet management tracking functionality is supported for this domain. 'Y’ means wallet management tracking functionality is supported by the domain and ‘N’ means it is not. Note: Wallet management tracking is only available to UBE domain types. |
Voucher Management |
Whether or not voucher management (including voucher redemption) is supported for this domain. ‘Y’ means voucher functionality is supported by the domain and ‘N’ means it is not. For more information about voucher functionality, see Voucher Management. |
Third-Party domain fields
This table describes the fields in the Third-Party area of the Domain screen. For details on a particular field, see the technical documentation for the application that provides connectivity with the required network element.
Field | Description |
---|---|
Minimum Queue Messages | Minimum queue messages value for third-party billing. |
Maximum Queue Messages | Maximum queue messages allowed before the connection is deemed congested. |
Allow Adaption | Select if adaption is required for third party billing. |
Connection Retry | The number of connection retries allowed. |
Enable Guidance | Select if guidance is required for third-party billing. The guidance cache size field becomes enabled. |
Message Timeout | Message timeout value for third-party billing. |
Guidance Cache Size | Guidance cache size for third-party billing. |
Creating a Domain
When you add a new domain, the system displays a list of issues in the Configuration Issues area of the Domain screen, warning you about any configuration that is incorrect. The system automatically updates this list as you configure the domain. For more information about configuration issues, see About Domain Configuration Issues.
Follow these steps to add a new domain.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Click New on the Domain tab.
Result: The New Domain screen displays.
For information about the fields and check boxes in the New Domain screen, see Domain fields.
-
In the Name field, enter a unique name for the domain.
-
From the Type list, select one of the following domain types:
-
UBE
-
A third-party type BE
-
A domain type with a DIAMETER prefix
-
BCD (for BRM)
The domain type you select determines which fields are enabled. Fields that are disabled, appear grayed out.
Note: The domain type for the Voucher and Wallet Server is UBE.
-
-
Complete the fields as required. For details about the data to enter for the type of domain you want to create, see:
-
Click Save.
Result: The new domain is saved, and listed on the Domain tab.
Related topic
Specifying a UBE Domain
To specify a UBE domain, complete the following fields:
-
Type the number of allowed accounts in the Maximum Accounts field.
-
Select the Manages check boxes for the features you require.
-
Add at least one domain node to this domain. See Adding nodes to domains.
You can edit or delete domain nodes as required. For information about editing domain nodes, see Editing domain nodes. For information about deleting domain nodes, see Deleting domain nodes or realms.
For more information about the fields and check boxes on the Domain screen, see Domain fields.
Specifying a Third-Party Domain
To specify a third-party domain, complete the following fields:
-
Type the number of allowed accounts in the Maximum Accounts field.
-
Select the Manages check boxes for the features you require.
-
In the Third-Party area, fill in the relevant fields, as described in Third-Party domain fields.
-
Add at least one domain node to this domain. See Adding nodes to domains.
You can edit or delete domain nodes as required. For information about editing domain nodes, see Editing Domains. For information about deleting domain nodes, see Deleting domain nodes or realms.
For more information about the non-third-party fields and check boxes on the Domain screen, see Domain fields.
Specifying a Diameter Domain
To specify a Diameter domain, complete the following fields:
-
Type the number of allowed accounts in the Maximum Accounts field.
-
Select the Manages check boxes for the required features.
-
In the Third-Party area, fill in the Minimum Queue Messages, Maximum Queue Messages and Connection Retry fields, as described in Third-Party domain fields.
-
Add at least one realm to this domain. See Adding realms to domains.
You can edit or delete realms as required. For information about editing domain realms, see Editing domain realms. For information about deleting domain realms, see Deleting domain nodes or realms.
For more information about the non-third-party fields and check boxes on this screen, see Domain fields.
Specifying a BRM Domain
To specify a BRM domain, complete the following fields:
-
In the Name field, enter
BRM
-
From the Type list, select BCD
-
In the Maximum Accounts field, enter the maximum number of accounts in this domain.
-
Select the Update Username and Password check box and enter values for Username and Password, which are used by the BCD Client to connect to the BRM communication managers.
-
(Optional) In the Manages area, select the Charging and Voucher Management check boxes.
For more information about the fields and check boxes on the Domain screen, see Domain fields.
Adding nodes to domains
Follow these steps to add a node to a domain.
-
From either the New Domain or Edit Domain screen, click New.
Result: The New Domain Node screen appears.
-
Type a unique name for the node in the Name field.
-
Select the Node Number from the drop down list (the node number must be unique). This is a required field for UBE domains, and optional for third-party domains.
Notes:
-
Where there is more than one node for a domain, the primary node has the lower number.
-
UBE is the domain type for a Voucher and Wallet Server.
-
-
Type the IP address for the node in the Address field.
Note: This field is automatically populated if you select a Node Number. You can edit this address if required.
-
Type the client port address in the Client Port field.
-
Type the internal port address in the Internal Port field.
-
If this is a third-party domain, enter values for the following fields. See the relevant third-party billing technical documentation for more information:
-
Minimum Weight
-
Maximum Weight
-
Stable Weight
-
Unstable Weight
Note: These fields appear grayed out for UBE domain nodes.
-
-
Click Save.
Result: The new node is saved and then listed in the Nodes / Realms area of the New or Edit Domain screen.
Related topic
Adding realms to domains
Follow these steps to add a realm to a diameter domain.
-
From either the New Domain or Edit Domain screen, click New.
Result: The New Domain Realm screen appears.
-
Type a unique name for the realm in the Name field.
-
Type the identity of the realm in the Identity field.
Example:
realm1.telcoexample.com
-
(Optional) Enter a value in the Stable Weight field. Defaults to 1.
-
Click Save.
Result: The new realm is saved and then listed in the Nodes / Realms area of the New or Edit Domain screen.
Related topic
Editing Domains
When you edit a domain, the system displays a list of issues in the Configuration Issues area of the Domain screen, warning you about any configuration that is incorrect. The system automatically updates this list as you edit the domain configuration. For more information about configuration issues, see About Domain Configuration Issues.
Follow these steps to edit a domain.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the domain to edit from the table in the Domain tab.
-
Click Edit.
Result: The Edit Domain screen appears.
-
Change the following fields as required:
-
Domain name in the Name field
-
Maximum number of accounts in the Maximum Accounts field
-
Wallet Management Charging and Wallet Management Tracking check boxes (Tracking is not available when Domain Type is BCD)
-
Voucher Management check box.
See Domain fields for a description of these fields and check boxes.
-
-
If this is a non-UBE domain, you may also change the following fields as required. If the domain is:
-
BCD:
-
Update Username and Password check box
-
Username
-
Password
-
-
third-party:
-
Minimum Queue Messages
-
Maximum Queue Messages
-
Connection Retry
-
Allow Adaptation check box
-
Message Timeout
-
Enable Guidance check box and Guidance Cache Size
-
-
DIAMETER:
-
Minimum Queue Messages
-
Maximum Queue Messages
-
Connection Retry
-
For details, see the relevant BCD, third-party billing or Diameter technical documentation.
Note: UBE is the domain type for a Voucher and Wallet Server.
-
-
Depending on the type of domain:
-
For UBE and third-party domains, you can edit the domain nodes as required. See Adding nodes to domains, Editing domain nodes or Deleting domain nodes or realms procedures.
-
For DIAMETER domains, you can edit the domain realms as required. See Adding realms to domains, Editing domain realms, or Deleting domain nodes or realms.
-
-
Click Save.
Result: The domain changes are saved and reflected in the Domain tab table.
Related topic
Editing domain nodes
Follow these steps to edit a domain node.
-
From the table in the Nodes / Realms area in either the New Domain or Edit Domain screen, select the node you want to update and click Edit.
Result: The Edit Domain Node screen appears.
-
Update the following fields as required:
-
Node address in the Address field
-
Client port address in the Client Port field
-
Internal port address in the Internal Port field
-
-
If this is a third-party domain, update the following fields as required. See the relevant third-party billing technical documentation for more information:
-
Minimum Weight
-
Maximum Weight
-
Stable Weight
-
Unstable Weight
Note: These fields appear grayed out for UBE domain nodes.
-
-
Click Save.
Result: The node is saved.
Related topic
Editing domain realms
Follow these steps to edit a domain realm.
-
From the table in the Nodes / Realms area of either the New Domain or Edit Domain screen, select the realm you want to update and click Edit.
Result: The Edit Domain Realm screen appears.
-
Update the following fields as required:
-
Identity
-
Stable Weight
-
-
Click Save.
Result: The realm is saved.
Related topic
Deleting domains
Follow these steps to delete a domain.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the domain to delete from the table in the Domain tab.
-
Click Delete.
Result: The Delete Confirmation screen appears.
-
Click OK.
Result: The domain is deleted from the Domain tab table.
Related topic
Deleting domain nodes or realms
Follow these steps to delete a node or a realm from a domain.
-
From the table in the Nodes / Realms area of either the New Domain, or Edit Domain screen, select the node or realm that you want to delete, and click Delete.
Result: The delete confirmation screen appears.
-
Click Apply.
Result: The node or realm is marked for deletion. It is then deleted from the database when you click Save in the Edit or New Domain screen.
Note: To be able to save the domain in the Domain screen, the domain must have at least one node or realm configured.
Related topic
Currency Code
The Currency Code tab enables you to view, create, edit and delete the currency codes that are available in the system.
Topics:
Adding a Currency Code
Follow these steps to add a new currency code.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On the Currency Code tab, click New.
Result: You see the New Currency Code screen.
-
Enter the three-letter currency code in the Code field.
-
Enter a description of the currency code in the Description field.
-
Click Save.
Related topic
Editing a Currency Code
Follow these steps to edit an existing currency code.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the currency code to edit from the table on the Currency Code tab.
-
Click Edit.
Result: You see the Edit Currency Code screen.
-
If required, change the three-letter currency code in the Code field.
-
If required, change the description of the currency code in the Description field.
-
Click Save.
Related topic
Deleting a Currency Code
Follow these steps to delete an existing currency code.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the currency code to delete from the table on the Currency Code tab.
-
Click Delete.
Result: The Delete Confirmation prompt appears.
-
Click OK to delete the record from the database.
Result: The record is deleted and the Currency prompt is displayed.
-
Click OK.
Related topic
Currency
The Currency tab enables you to:
-
Configure the default system currency
-
View currencies which have been set up in the system
When setting up the system for the first time, it is important to set the default currency before configuring the rest of the system (and after configuring the VWSs).
For each new currency entered into the system, a rate of exchange between the new currency and the system currency must be set. This exchange rate is set on the Exchange Rates tab of the Service Management screen.
Topics:
Currency entry components
When adding a new currency to CCS, a number of inter-related components must be completed before the new currency can be used.
These components are configurable from the New Currency and Edit Currency screens, and are as follows:
-
Configure Announcements
-
Configuring Recharge Options 1-5
-
Configuring Recharge Options 6-9
Recharging Credit Cards - required components
The following currency components are required for recharging credit cards.
-
Configuring Recharge Options 1-5
-
Configuring Recharge Options 6-9
The actual recharge options are defined in the Product Type tab, Creditcard Recharge Rules.
Each caller has a maximum of nine recharge options per currency available. The announcement entry and set are selected for each option. The option announcements work as follows:
Caller options | The system will play the balance announcement... |
---|---|
1 | followed by the “Press * to cancel” as defined by the announcement set selected in the One option section. |
2 | followed by the “Press * to cancel” as defined by the announcement set selected in the Two options section. |
3 | followed by the “Press * to cancel” as defined by the announcement set selected in the Three options section. |
4 | followed by the “Press * to cancel” as defined by the announcement set selected in the Four options section. |
5 | followed by the “Press * to cancel” as defined by the announcement set selected in the Five options section. |
6 |
as defined by the announcement set selected in the Five options and on section. Plus the recharge announcement set selected in the Recharge option six section followed by the “Press * to cancel” |
7 |
as defined by the announcement set selected in the Five options and on section. Plus the recharge announcement set selected in the Recharge options 6-7 section followed by the “Press * to cancel” |
8 |
as defined by the announcement set selected in the Five options and on section. Plus the recharge announcement set selected in the Recharge options 6-8 section followed by the “Press * to cancel” |
9 |
as defined by the announcement set selected in the Five options and on section. Plus the recharge announcement set selected in the Recharge options 6-9 section followed by the “Press * to cancel” |
Example announcements
A caller has six options for their account.
The first announcement, defined in the Five options and on field, is configured to play the following:
"Your balance is x
Big_Currency
and y
Small_Currency
To recharge by Recharge_Option_1
Big_Currency
, press 1
To recharge by Recharge_Option_2
Big_Currency
, press 2
To recharge by Recharge_Option_3
Big_Currency
, press 3
To recharge by Recharge_Option_4
Big_Currency
, press 4
To recharge by Recharge_Option_5
Big_Currency
, press 5"
The next announcement, defined in the Recharge option six field, will play the following:
"To recharge by Recharge_Option_6
Big_Currency,
press 6
Press * to cancel."
If Big_Currency
is dollars and Small_Currency
is
cents, the announcements played would be like this:
"Your balance is two dollars and twenty five cents
To recharge by five dollars press 1
To recharge by ten dollars press 2
To recharge by twenty dollars press 3
To recharge by fifty dollars press 4
To recharge by one hundred dollars press 5"
"To recharge by two hundred dollars, press 6
Press * to cancel.”
Currency details
All configuration options must be completed to finalize a currency so it can be used. However, the configuration can be saved at any point by clicking Save.
To configure a currency as a default currency for the system, configure the currency here, and then set it as the default in the Global Configuration screen.
Follow these steps to add currency details for a new currency.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On the Currency tab, click New.
Result: The New Currency screen displays with the Currency options.
-
Enter the symbol that represents the main unit of the currency in the Big Symbol field (for example,
€
for euros). -
Enter the symbol that represents the subunit of the currency in the Little Symbol field (for example,
c
for cents). -
Select the currency name from the Name drop down box.
Note: Only valid currency names are available from the list.
Result: The Currency Code field is populated by the system. This shows the currency code that identifies the currency.
-
Enter the separator used to separate the main unit from the subunit of the currency in the Separator field.
Examples: In the currency of:
-
Euros - the separator is a comma (for example, 3,20)
-
Dollars - the separator is a decimal point (for example, $4.00)
-
-
Enter the ratio of subunits to main units of currency in the Base field.
Example: 100 cents per euro = a ratio of 100.
-
Click Save.
-
Configure the Announcements.
-
Configure the announcements for Recharge options 1-5.
-
Configure the announcements for Recharge options 6-9.
Related topic
Announcements
Follow these steps to add the confirmation prompt announcement for a new currency.
-
Select the Configure Announcements option in the New Currency screen.
Result: You see the Configure Announcements option, displaying the Confirmation Prompt configuration.
-
Select from the Confirmation Prompt section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller when prompting for caller confirmation of a recharge
-
-
Click Save.
Recharges 1-5
Follow these steps to add the announcements for recharge options 1-5 for a new currency.
-
Select the Recharge options 1-5 option in the New Currency screen.
Result: You see the Recharge options 1-5, displaying announcements for currency Recharge one to five, plus more than five.
-
Select from the One option section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have one recharge option
-
-
Select from the Two options section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have two recharge options.
-
-
Select from the Three options section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have three recharge options.
-
-
Select from the Four options section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have four recharge options.
-
-
Select from the Five options section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have five recharge options.
-
-
Select from the Five options and on section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have more than five recharge options.
-
-
Click Save.
Recharges 6-9
Follow these steps to add the announcements for recharge options 6-9 for a new currency.
-
Select the Recharge options 6-9 option from the New Currency screen.
Result: You see the Recharge options 6-9, displaying announcements for currency recharge six to nine.
-
Select from the Recharge option six section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have six recharge options.
This will include the announcements set from Five options and on.
-
-
Select from the Recharge options 6-7 section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have seven recharge options.
This will include the announcements set from Five options and on.
-
-
Select from the Recharge options 6-8 section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have eight recharge options.
This will include the announcements set from Five options and on.
-
-
Select from the Recharge options 6-9 section:
-
The Announcement Set from the Set drop down box
-
The Announcement Entry from the Entry drop down box that is to be played to a caller if they have nine recharge options.
This will include the announcements set from Five options and on.
-
-
Click Save.
Editing a currency
Follow these steps to edit the details of an existing Currency record.
To configure a Currency as a Default Currency for the system, configure the Currency here, and then set it as the default in the Global Configuration screen.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record o edit from the Currency tab table.
-
Click Edit.
Result: The Edit Currency screen displays, showing the Currency options.
-
Edit the currency details as described in Currency details.
Warning: You cannot change the Base once set.
-
Click Save.
Related topic
Deleting a currency
Follow these steps to delete an existing currency configuration record.
To remove a currency as a default currency for the system, see the Global Configuration screen.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to delete from the Currency tab table.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK to delete the record from the database.
Result: The record is deleted and the Currency prompt displays.
-
Click OK.
Related topic
Global Configuration
You set the following global configuration on the Global Configuration tab in the Service Management window:
-
The system currency. The required currency must have already been added to the system using the procedures in Currency.
-
The mapping of languages that the system currency is announced in. See Adding or editing a language map and Deleting a language map.
-
Whether EDR auditing is required. See EDR Auditing and Reporting for more information.
-
The global masking configuration for displaying EDR fields in the EDR Viewer. See Editing a masking rule for more information.
You set the following global maximums on the Global Configuration tab:
-
Credit cards per subscriber
-
Subscribers per credit card
For details, see Setting global credit card maximums.
Topics:
Adding or editing a language map
Adding or editing a language map
Language maps determine what language the system currency is announced in.
Follow these steps to add a new, or edit an existing language map.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Global Configuration tab, click Edit.
Result: You see the Edit Global Configuration screen.
-
Select the Language Menu Option Mapping option.
Result: The screen displays the Language menu option mapping section.
-
To add a new mapping:
-
Click Insert
To edit an existing mapping:
-
Select the Language item to change from the table
-
Click Edit
Result: You see the Edit/Insert screen.
-
-
Select the Language from the drop down list.
-
For a new mapping, enter the key mapping number in the Key Mapping field.
Warning: This cannot be changed once saved.
-
Click Save to update the table.
-
Click Save to the details to the database.
Related topic
Deleting a language map
Follow these steps to delete a language map.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Global Configuration tab, click Edit.
Result: You see the Edit Global Configuration screen.
-
Select the Language Menu Option Mapping option.
Result: The screen displays the Language menu option mapping section.
-
Select the Language item to delete from the table.
-
Click Delete.
-
Click Save to the details to the database.
Related topic
EDR Auditing and Reporting
The EDR auditing feature keeps track of changes to subscriber data. When EDR auditing is enabled, a user who is updating a subscriber record is forced to enter a reason in a special Change Reason dialog box each time they change the financial status of a subscriber; for example, when:
-
Updating a subscriber's wallets
-
Updating a subscriber's credit cards
The reason for the change, and the user who made the change are reported in the Change Reason, and Operator Name fields in the VWS EDR. You can view this information by displaying the VWS EDR in the EDR Viewer.
To enable EDR auditing, select the EDR Auditing Required check box in the Edit Global Configuration dialog.
Note: The EDR Auditing Required profile field in the CCS global profile block is set to true when you enable EDR auditing. For more information about the CCS global profile block, see CCS Technical Guide.
Setting global credit card maximums
Follow these steps to set the global maximum number of credit cards per subscriber and subscribers per credit card.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Global Configuration tab, click Edit.
The Edit Global Configuration screen displays.
-
Select the Credit Cards option.The screen displays the Credit Cards option, limits section.
-
In the fields, select the maximum:
-
Credit cards per subscriber
-
Subscribers per credit card
-
-
Click Save to save the details to the database.
Note: You can also set credit card maximums per service provider on the Resource Limits tab in the Service Management window. The maximums you set for a service provider override the global credit card maximums.
Related topic
Editing EDR Viewer Display Masking
The EDR Viewer Display Masking option allows you to globally configure the masking rules that should be applied to EDR fields for which masking is specified. See EDR Elements tab for more information about specifying which EDR fields require masking.
Follow these steps to edit the options for EDR Viewer Display Masking.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Global Configuration tab, click Edit.
Result: You see the Edit Global Configuration screen.
-
On the Edit Global Configuration screen, select EDR Viewer Display Masking.
Result: You see the EDR Viewer Display Masking configuration options.
-
Select the masking options you want to use, or select No Masking if you do not want to apply masking to EDR fields.
-
If you selected the Last Characters masking option, then enter the number of characters at the end of the EDR field to mask in the Last Characters field.
-
If you selected the Regular Expression masking option then perform the following steps:
-
Enter the regular expression to use to match the characters to be masked in the Pattern field.
-
Enter the characters to use as replacements in the Replacement field.
-
-
Click Save to save the masking rule.
Exchange Rates
The Exchange Rates tab allows you to view, add, edit and delete the Exchange Rates that are available in the system.
Account balances are stored in the System Currency, then converted to the user’s selected Currency by the indirect rate of exchange set in this tab.
Topics:
Adding an exchange rate
Follow these steps to add a new Exchange Rate record.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Exchange Rates tab, click New.
Result: The New Exchange Rate screen appears with the default System Currency displayed in the System Currency field.
-
Select the Currency to convert the System Currency to from the Currency drop down box. The list will display all available Currencies that are set up on the Currency tab.
-
Type the value which the System Currency will be multiplied by to establish the Currency value in the Indirect Rate of Exchange field.
The indirect rate of exchange is the value of 1 unit of System Currency in the selected Currency.
Example: If the Indirect Rate of Exchange is set to 4, 1 unit of the System Currency will result in 4 of the configured Currency units. Consequently if an Account Balance is 100 Zloty, and the Exchange Rate to Euros is set at 0.22, the Account Balance will be converted to 22 Euros.
-
Click Save.
Related topic
Editing an exchange rate
Follow these steps to edit an existing Exchange Rate.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Exchange Rates tab, select the Exchange Rate to edit.
-
Click Edit.
Result: The Edit Exchange Rate screen appears.
-
Enter the value which the System Currency will be multiplied by to establish the Currency value in the Indirect Rate of Exchange field.
The indirect rate of exchange is the value of 1 unit of System Currency in the selected Currency.
Example: If the Indirect Rate of Exchange is set to 4, 1 unit of the System Currency will result in 4 of the configured Currency units. Consequently if an Account Balance is 100 Zloty, and the Exchange Rate to Euros is set at 0.22, the Account Balance will be converted to 22 Euros.
-
Click Save.
Related topic
Deleting exchange rates
Follow these steps to delete an existing Exchange Rate record.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Exchange Rates tab, select the Exchange Rate to delete.
-
Click Delete.
Result: The Delete Confirmation prompt appears.
-
Click OK to delete the record from the database.
Result: The record is deleted and you see the Exchange Rate successfully deleted message.
-
Click OK.
Related topic
Resource Limits
The Resource Limits screens enable the service provider's resource limits to be specified. These limits prevent a service provider from using more than the specified number of:
-
Product types
-
Voucher types
-
Rate tables
All configuration options must be completed to finalize a resource limit; however the configuration can be saved at any point by clicking Save.
Notes:
-
All service providers must have resource limits configured for them.
-
Resource limits can only be set for existing service providers. Service providers are added as ACS customers in the ACS Customers screen. For more information about adding new service providers, see ACS User's Guide.
Topics:
Editing EDR Viewer Display Masking
Resource Limits tab fields
The Resource Limits tab contains display-only fields, showing the limits and the current usage of the resource. The following table shows where you set the value in each limit field.
Field | Where Set |
---|---|
Maximum Product Types Maximum Voucher Types Maximum Rate Tables Grace Period (seconds) Maximum Bad PIN Count |
Edit Resource Limits screen, Limits option. |
Number of Product Types Used | Subscriber Management screen, Product Type tab. |
Number of Voucher Types Used | Voucher Management screen, Voucher Types tab. For more information about the Voucher Types tab, see Voucher Type. |
Number of Rate Tables Used | Rating Management screen, Rate Tables tab. |
Number of Promotion Notifications Sent | Subscriber Management, Adding Product Types screen, Activation Credits option. |
Number of Promotion SMSs Sent | Displays number of promotion SMS messages that have been sent. |
Global Business Prefix Account Number Prefix |
Edit Resource Limits screen, Business Prefix option. |
EDR Viewer Display Masking Last Characters Pattern Replacement |
Edit Resource Limits screen, EDR Viewer Display Masking. See Editing EDR Viewer Display Masking. |
Maximum Credit Cards Per Subscriber Maximum Subscribers Per Credit Card |
Edit Resource Limits screen, Setting Subscriber Credit Card Limits option. |
Configuration options summary
This table lists all the resource limits configuration options and their functionality.
Note: The service provider is also known as the customer in ACS.
Option | Description |
---|---|
Limits | Sets the resource limits for a service provider that prevent the service provider from using more than the specified number of product types, voucher types and rate tables. |
Business Prefix |
Sets:
|
Sets | Sets which public resource sets are available to a service provider. |
Call Barring | Sets the numbers that are allowed or barred at service provider level. |
Number Translations | Sets number translation mappings for the service provider, and displays them in the Short Codes list. The service short codes are mapped to termination numbers. When the short code is dialed, the call is routed to the termination number. |
Bypass Numbers | Sets the bypass numbers that are allowed or barred at service provider level. A bypass number is a number that has a discount applied to it. The discount that applies to bypass numbers is set in the Bypass Discount panel. |
Bypass Number Discounts |
Sets the allowed bypass number discounts. To use this feature you must include the Set Discount feature node in the control plan. For more information, see the Feature Nodes Reference Guide. |
Profile Group Limitations |
Sets default limits for LNSTRING and LOPREFIX profile group fields. The limits set for the product type will override the limits set here. For more information about setting product type limits, see Subscriber Profile Limitations. |
Promotions |
Lists the global limited liability status for all the available promotions for the service provider. You configure promotions in Promotion Manager. |
EDR Viewer Display Masking | Defines the masking rules that apply on a service provider basis when you display EDRs in the EDR Viewer. You set whether to apply the masking rules to an individual EDR tag in the EDR tag configuration. For more information, see EDR Management. |
Credit Cards | Sets the maximum number of credit cards per subscriber and maximum number of subscribers per credit card at a service provider level. |
For information on setting each resource limit, see Editing resource limits.
Editing resource limits
Follow these steps to edit an existing resource limit.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Click Edit on the Resource Limits tab.
The Edit Resource Limits screen displays.
-
Select the required options and edit the details of the record. See:
-
Click Save.
Related topic
Limits
Follow these steps to add limits to Resource Limits for a service provider.
-
Select the customer from the Service Provider drop down box.
-
From the Resource Limits tab of the Resources screen, click Edit.
The configurable limits display in the Edit Resource Limits screen. For more information, see Resource Limits tab fields.
-
In the relevant fields, set the maximum number of the following resources that the service provider may use:
-
Product types
-
Voucher types
-
Rate tables
Tip: It is not possible to set the resources allowed to a value lower than the number of resources already used, as displayed on the Resource Limits tab. To reduce the numbers that the service provider may use in the case where the maximum number has been reached, you must first reduce the number that the service provider uses.
-
-
In the Grace Period (seconds) field, type the period of time (in seconds) to elapse before a call begins to be charged. If a call ends before the grace period has been reached, the call is free.
If a call continues beyond the grace period, the whole call incurs a charge, including the grace period. The grace period applies on a per customer basis.
-
Set the maximum number of times that an invalid PIN may be entered into the system in the Maximum Bad PIN Count field. If a customer exceeds this number of attempts in a 24 hour period, their account is frozen.
-
Click Save.
Related topic
Business Prefix
Follow these steps to configure the Global Business Prefix number for the service provider.
-
Select Business Prefix in the left hand menu in the Edit Resource Limits screen.
The Business Prefix option fields display.
-
(Optional) Specify the global business prefix by entering the digits and special characters for the prefix in the Global Business Prefix field. You can include any of the following allowed values in the prefix: 0-9, #, and *.
The subscriber must enter this prefix at the beginning of a dialed telephone number to enable the call to be charged to their business wallet instead of their personal wallet.
You must include the Business Prefix Branch feature node in the control plan to enable the global business prefix feature. For more information about control plans, see the CPE User's Guide. For more information about the Business Prefix Branch feature node, see Feature Nodes Reference Guide.
-
(Optional) Specify the prefix that will be prepended to a subsriber's card ID by entering the two digit prefix in the Account Number Prefix field. Specify a value between 10 and 99 that is unique to this service provider, or leave blank if you do not want to use account number prefixes.
-
Click Save.
Related topic
Sets
Follow these steps to configure private reusable data set limits for service providers.
-
Select the Sets option from the left hand menu in the Edit Resource Limits screen.
The Sets option displays, and shows a list of all the public data sets.
-
In the Allocation Public Geography Sets section, select the check box for each geography set that you want to make available to the service provider.
You create geography sets on the Geography tab of the ACS Configuration screen.
-
In the Allocate Public Announcement Sets section, select the check box for each announcement set that you want to make available to the service provider.
You create announcement on the Announcements tab of the ACS Configuration screen.
-
In the Allocate Public Holiday Sets section select the check box for each holiday set that you want to make available to the service provider.
You create holiday sets on the Holidays tab of the ACS Configuration screen.
-
Click Save.
For more information about the ACS Configuration screen, see ACS User's Guide.
Related topic
Call Barring
This manages allowed/ barred lists for service providers.
Allowed/barred lists can also be set at these levels:
-
System-wide
-
Product type (see the New or the Edit Product Type screen Call Barring option)
-
Subscriber account (see the New or the Edit Subscriber screen, Call Barring option)
Follow these steps to configure call barring for customers.
-
Select the Call Barring option from the left hand menu in the Edit Resource Limits screen.
The Call Barring option displays, showing the Allowed/Barred List configuration for the service provider.
-
Select whether the listed numbers will be allowed or barred from the List Type drop down list in the Service Allowed/Barred List section.
Note: All numbers in the list are allowed, or all numbers are barred, according to the list type. It is not possible to have some allowed and some barred numbers in the list.
-
Select the Ignore check box if you want the service to ignore the allowed/barred list.
-
Edit the number list in the Service Provider Allowed/Barred List section. To:
-
Add numbers to the list:
-
In the New Number field, enter the number
-
Click Add.
-
-
Delete numbers from the list:
-
Select the number in the Number List field
-
Click Delete.
-
-
-
If required, repeat step 4 until the number list is complete.
-
Click Save.
Related topic
Number Translations
This manages number translation lists for service providers.
You can also set number translations at these levels:
-
Global
-
Product type
-
Subscriber account
Follow these steps to configure the number translation list limits for the service provider.
-
Select the Number Translations option from the left hand menu in the Edit Resource Limits screen.
The Number Translations option displays, listing the configured short codes.
-
Edit the number list in the Short Codes section.
To add a number to the list:
-
In the In field, enter the service short code to translate.
-
In the Out field, enter the termination number that the short service code translates to.
-
Click Add.
To delete a number from the list:
-
Select the number in the Number List table.
-
Click Delete.
-
-
Repeat step 2 until all the codes are included.
-
Click Save.
Related topic
Bypass Numbers
Follow these steps to configure the bypass numbers at a service provider level.
Tip: Bypass Numbers can also be configured at the following levels:
-
Global
-
Product type
-
Select the Bypass Numbers option from the left hand menu in the Edit Resource Limits screen.
The Bypass Numbers option displays, showing the bypass numbers configuration for the service provider.
-
Select the List Type from drop down box in the Service Provider Bypass Numbers section.
Note: The list type determines whether the listed bypass numbers are all barred, or all allowed.
-
Select the Ignore check box if the service is to ignore the number list.
-
Edit the number list in the Service Provider Bypass Numbers section.
To add a number to the list:
-
Enter a bypass number in the New Number field
-
Click Add.
To delete a number from the list:
-
Select the number from the Number List
-
Click Delete.
-
-
Repeat step 4 until the number list is complete.
-
Click Save.
Related topic
Bypass Number Discount
Follow these steps to configure the limits for bypass number discounts.
Tip: To enable bypass number discounts limits, you must include the Set Discount feature node in the control plan. For more information about the Set Discount feature node, see Feature Nodes Reference Guide.
-
Select the Bypass Number Discount option from the left hand menu in the Edit Resource Limits screen.
The Bypass Number Discount option displays, showing the bypass number discount configuration for the service provider.
-
Select the currency code in which the Max. Charge field will be displayed from the Display Currency list.
-
Type the percentage discount to apply during the first discount period in the Period One % field.
-
Type the percentage discount to apply during the second discount period in the Period Two % field.
-
Type the maximum total charge to charge the subscriber for any one call in the Max. Charge field.
-
Click Save.
Related topic
Profile Group Limitations
Follow these steps to configure the service provider-level limits for LNSTRING and LOPREFIX profile field types.
Tip: You can override the limits set here by setting the profile field type limits for the product type.
-
Open the Profile Group Limitations group in the Edit Resource Limits screen, and select the profile field that you want to set limits for.
The Profile Group Limitations option displays the configuration for the selected field.
-
Select the Ignore Limitations check box if required:
-
When selected, the limits are ignored and the system default resource limits are used.
-
When not selected, the limits set here are used.
-
-
In the Max Number of Entries field, if present, type the maximum number of prefixes that may be included in the Number List. Defaults to 100 if no value is specified.
Note: This field is only available for LOPREFIX type fields.
-
In the Min Number Length field type the minimum numeric value for the Profile Group Field. Defaults to zero if no value is specified.
-
In the Max Number Length field type the maximum numeric value for the profile group field. Defaults to 255 if no value is specified.
-
Select the Limitation Prefix Tree Type from the drop down list. If you select:
-
Allowed – The profile group field value must match an entry in the Number List.
-
Barred – The profile group field value must not match an entry in the Number List.
-
-
Edit the Number List.
To add a number to the list:
-
Enter a required number in the New Number field.
-
Click Add.
To delete a number from the list:
-
Select the number from the Number List, select the number.
-
Click Delete.
-
-
Repeat step 7 until the number list is complete.
-
Click Save.
Related topic
Promotions
Follow these steps to view the global limited liability status of the promotions defined for the currently selected service provider.
-
Select the Promotions option from the left hand menu in the Edit Resource Limits screen.
The Promotions option displays, listing the promotions for the current service provider.
-
Click Save.
Related topic
Editing EDR Viewer Display Masking
The EDR Viewer Display Masking option allows you to set rules on a service provider basis pertaining to masking EDR fields in the EDR Viewer. See EDR Elements tab for information about specifying which EDR fields require masking.
Follow these steps to edit the options for EDR Viewer Display Masking
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Resource Limits tab, click Edit.
Result: The Edit Resource Limits screen displays.
-
Select EDR Viewer Display Masking.
Result: The EDR Viewer Display Masking screen configuration options display in the Edit Resource Limits screen.
-
Select the masking option you want, or select Global Masking to apply the global masking rules set on the Global Configuration tab.
-
Click Save to save the masking limits.
Setting Subscriber Credit Card Limits
To set the maximum number of credit cards per subscriber and the maximum subscribers per credit card for the service provider:
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the Resource Limits tab, click Edit.
The Edit Resource Limits screen displays.
-
Select the Credit Cards option.
-
Set the required maximums for the selected service provider in the following fields:
-
Maximum Credit Cards Per Subscriber
-
Maximum Subscribers Per Credit Card
Note: The maximums you set for a service provider override the global credit card maximums. See Setting global credit card maximums.
-
-
Click Save to save the details to the database.
Related topic
Barred List
The Barred List tab enables you to view, add or delete numbers that are either allowed or barred from use.
This list manages allowed/ barred lists system wide.
You can also set barred allowed lists at these levels:
-
Service provider
-
Product type. See Call Barring.
Topics:
Adding numbers to the barred list
Follow these steps to edit the service allowed/barred numbers list.
-
From the Barred List tab, click Edit.
Result: You see the Edit Service Allowed/Barred Numbers List screen.
-
In the Service Allowed/Barred List section, select the List Type from the drop down list. This determines whether the listed numbers will be allowed or barred.
Note: All numbers in the list are allowed, or all numbers are barred, according to the list type. It is not possible to have some allowed and some barred numbers in the list.
-
If you want the service to ignore the allowed/barred list, select the Ignore check box.
-
To edit the Number List:
-
Add a number:
-
Enter the number to add in the New Number field
-
Click Add
-
-
Delete a number:
-
Select the number to remove from the list
-
Click Delete
-
-
-
If required, repeat step 4 until all the numbers are listed.
-
Click Save.
Related topic
Capability
The Capability tab allows you to define global capabilities. You can specify the default control plan for the capability, the service trigger, called party number, and the EDR type to output.
Capabilities are associated with control plans in the Product Type screen. See Control Plans.
The default capabilities are VOICE_MO (originating) and VOICE_MT (terminating).
Topics:
Capability fields
This table describes the function of each field.
Field | Description |
---|---|
Name |
The name given to this capability definition. The name is used as the identifier in the Control Plans option in the Product Type screen. |
Service |
The service name that triggers this capability. Service names are defined in /IN/service_packages/ACS/etc/acs.conf For more information about configuring service names, see ACS Technical Guide. |
CdPN (Called Party Number on New and Edit screens) | The called party number used when matching the capability definition. (Optional.) |
Default Control Plan |
The default control plan invoked by this capability definition. The default control plan is run when the calling party number is not a known subscriber. The control plan drop down list displays all the control plans a subscriber can use. Tip: This list can be shortened by using the Search By field and then Search. |
Search By |
Use initial characters of the control plan name or combine with % (match on any number of characters), or _ (match on a single character). Examples: Search for Search for The list can be further restricted by entering a maximum number of names to show in the Max Rows field. |
Statistics Category |
In license reports, calls on this capability will be reported against the service specified in this field. For more information about License reports, see License. |
Statistics Protocol | In license reports, calls on this capability will be reported against the protocol specified in this field. |
Bearer Capability | The bearer capability (InitialDP itc field (information transfer capability)) used when matching the capability definition. (Optional.) |
CDR Type | The regular call EDR type to use for the capability. |
In-Session Notifications | You can select an in-session notifications trigger for the call capability, if required. The trigger defines the control plan to invoke, and the associated session data to pass to it to handle in-session notifications reported by the charging system. |
Adding a capability
Follow these steps to add a new Capability definition.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On the Capability tab, click New.
Result: You see the New Capability screen.
-
Configure this record by entering data in the fields on this screen.
For more information about the fields on this screen, see Capability fields.
-
Click Save.
Warning: You must restart the SLEE in order for the changes to take effect. For more information about restarting the SLEE, see SLEE Technical Guide.
Related topic
Editing a capability
Follow these steps to edit a Capability definition.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On table on the Capability tab select the record to edit and click Edit.
Result: You see the Edit Capability screen.
-
Edit the fields to reflect the required changes.
For more information about the fields on this screen, see Capability fields.
-
Click Save.
Warning: The SLEE will need to be restarted in order for the changes to take effect.
Related topic
Deleting a capability
Follow these steps to delete an existing Capability definition.
Warning: Caution should be used when deleting existing capabilities as the system may become unstable if a capability is deleted that is used by a configured service, such as CCS_BPL.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to delete from the table on the Capability tab.
-
Click Delete.
Result: The Delete Confirmation displays.
-
Click OK.
Results:
-
The record is deleted from the database.
-
The Capability confirmation prompt displays.
-
-
Click OK.
Warning: The SLEE will need to be restarted in order for the changes to take effect.
Related topic
Number Translation List
The Number Translation List tab enables you to view, add, edit and delete the service short codes that are mapped to specific termination numbers within the CCS service.
In this tab, the numbers which are displayed in the In column are service short codes which are mapped to the termination numbers displayed in the Out column. Incoming calls use the service short codes, which are then routed to the outgoing termination numbers.
This manages number translation lists system-wide.
The translation list exists at three other levels, in the order they are set. These are:
-
Level 1 Service Provider
-
Level 2 Product Type
-
Level 3 Subscriber account Level
These are checked in the order they are placed in the control plan.
Topics:
Editing numbers in the translation list
Follow these steps to edit the numbers on the Number Translation List.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
From the Number Translation List tab, click Edit.
Result: You see the Edit Service Short Codes/Number Translation List screen.
-
In the Service Short Codes section, edit the Number List as required. To:
-
Add a number pair:
-
In the In field, enter the service short code you want to map to a termination number
-
In the Out field, enter the termination number you want to translate the short service code to
-
Click Add
-
-
Delete a number pair:
-
In the Number List table, select the number
-
Click Delete.
-
-
-
If required, repeat step 3 to add/delete more numbers in the Number List.
-
Click Save.
Related topic
MFile Generation
MFiles are used to store data which is not changed very often (for example, tariffs). MFiles are compiled on the Voucher and Wallet Server nodes to provide a fast lookup for a subset of the data in the E2BE database. You can generate a separate CCS Rating MFile and CCS Product Catalogue MFile for each service provider. This enables you to manage MFiles separately for each service provider. You generate MFiles from the MFile Generation tab.
Note: All the relevant tariff information must be established before the MFile Generation tab is available.
For more information about MFiles, see VWS Technical Guide.
Topics:
MFile distribution process
This topic describes the MFile distribution process.
-
Through the New or Edit MFile Generation screen, the administrator updates the details contained in the MFile and clicks Save.
Result: The data and an update request are transferred to the VWS nodes.
-
When the update request arrives on the VWS, ccsMFileCompiler:
-
Creates a new MFile from the updated data in the E2BE database
-
Sends a request to the beServer to reload the MFile
-
Then ccsMFileLoader:
-
Reloads the new MFile
-
Updates the E2BE database to indicate that the new MFile has been reloaded
MFile Fields
This table describes the function of each field.
Field | Description |
---|---|
Domain |
The Voucher and Wallet Server pair you will send the MFile to. This field is populated by the Domain tab. This field cannot be edited once it is initially saved. |
Description | The description of the MFile. |
Request Date |
The date the MFile was last requested to run. Note: This field is only available on the Edit MFile screen. |
Type |
Whether the MFile is for:
|
Adding an MFile
Follow these steps to add a new MFile for a selected service provider.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
From the MFile Generation tab, click New.
Result: You see the New MFile Configuration screen.
-
Configure this record by entering data in the fields on this screen.
For more information about the fields on this screen, see MFile Fields.
-
Click Save.
Result: ccsMFileCompiler on the VWS nodes within the chosen domain builds up a new MFile and notifes the VWS processes.
Related topic
Editing an MFile
Follow these steps to edit an existing MFile generation record.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the table on the MFile Generation tab, select the MFile generation record to edit.
-
Click Edit.
Result: You see the Edit MFile Configuration screen.
-
In the Description field, update the description of the MFile.
For more information about the fields in this screen, see MFile Fields.
-
Click Save.
Related topic
Deleting an MFile
Follow these steps to delete an existing MFile generation record.
Note: There must be a current MFile when the Voucher and Wallet Servers are restarted.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the table on the MFile Generation tab, select the MFile to delete.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK.
Result: You see the MFiles confirmed delete prompt.
-
Click OK.
Related topic
Balance Type Mapping
The Balance Type Mapping tab is used for:
-
Mapping third-party balance types to NCC balance types (for example, from ECE balance types to NCC balance types)
-
Filtering wallet recharges for wallets distributed across a third-party charging domain and a VWS tracking domain
Balance type mapping allows the feature nodes that operate against Balance Types to function for third-party balance types as well as those on the VWS.
Note: If balance type mapping is not defined for a Balance Type, wallet recharges are sent to the VWS by default.
Topics:
Balance type mapping fields
This table describes the function of each field.
Field | Description |
---|---|
Balance Type |
List of available balance types. This list is restricted to chargeable balance types. When you select None, NCC uses the balance type mapping configuration for filtering wallet recharges through the charging and/or tracking domain. See Scenarios. |
Third-Party Resource |
The third-party balance ID to map to the NCC balance type. This text field accepts letters, digits, and spaces. |
Third-Party Resource Scale |
The scaling factor for converting balance values between NCC balance types and third-party balance types. For example, if NCC uses hundredths of seconds for time balances, but the BRM equivalent uses seconds, the scaling factor converts the BRM seconds to the NCC hundredths of seconds. Note: This field accepts:
|
Domain Type | List of available non-VWS domain types. This field associates the balance type mapping configuration with the specified domain. |
Scenarios
This table describes the results of voucher redemptions in different balance type mapping scenarios.
Voucher Type | Result |
---|---|
Subscriber applies a split domain voucher type |
Given a subscriber who has a wallet in both the VWS and BCD domains and a balance type that has balances defined in both domains: When the voucher is applied to the subscriber's wallet, the balances in both domains are modified at the same time. |
Subscriber applies a VWS domain voucher type |
Given a subscriber who has a wallet in both the VWS and BCD domains and a voucher that has balances only in the VWS domain: When the voucher is applied to the subscriber's wallet, only balances in the VWS domain are modified. |
typeSubscriber applies BCD domain voucher type |
Given a subscriber who has a wallet in both the VWS and BCD domains and a voucher type that has balances in the BCD wallet domain: When the voucher is applied to the subscriber's wallet, only the balances in the BCD domain are modified. |
This table describes the results of actions by a screen user who wants to associate a chargeable balance type with a domain.
Scenario | Result |
---|---|
Create a new mapping between a chargeable balance type and a domain | When the user selects a chargeable balance type and a domain type and clicks the Save button, the balance type will be associated with the domain type. |
Creating a new mapping between a chargeable balance type and a non-VWS domain | When the user selects a chargeable balance type and a non-VWS domain and clicks the Save button, the balance type will be associated with the domain type. |
Adding balance type mapping
Follow these steps to add a new balance type mapping.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On the Balance Type Mapping tab, click New.
Result: You see the New Balance Type Mapping Configuration screen.
-
Configure this record by entering data in the fields on this screen.
For more information about these fields, see Balance type mapping fields.
-
Click Save.
Related topic
Editing balance type mapping
Follow these steps to edit an existing balance type mapping.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to edit from the table on the Balance Type Mapping tab.
-
Click Edit.
Result: You see the Edit Balance Type Mapping Configuration screen.
-
Edit the fields to reflect the required changes.
For more information about this screen, see Balance type mapping fields.
-
Click Save.
Related topic
Deleting balance type mapping
Follow these steps to delete an existing balance type mapping.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to delete from the table on the Balance Type Mapping tab.
-
Click Delete.
Result: The Delete Confirmation displays.
-
Click OK.
Related topic
Security
The Security tab allows you to configure the security for vouchers and credit cards.
Please select which security function you wish to view the help for.
Select from:
About Voucher Security
Authentication rules are used to ensure voucher security. Authentication rules must be created before they can be used for voucher batches.
For more information about vouchers, see Voucher Manager User's Guide.
The CB-10 voucher security features enable you to define authentication rules for CB-10 HRN SHA256, CB-10 HRN SHA512 and CB-10 HRN AES256 encryptions. Specify the encryption method when creating voucher batches and redeeming vouchers.
Ensure the following are installed and activated on your system to be visible on your screens:
-
CB-10 voucher security features
-
CB10 HRN SHA256 authentication module
-
CB10 HRN SHA512 authentication module
-
CB10 HRN AES256 authentication module
Note: CB-10 voucher security will only be available to you if you have an appropriate license. For more information about activation, see CCS Installation and Removal Guide.
Security fields
This table describes the function of each field.
Note: The S, R1, R2, and R3 fields apply to CB10 HRN and SDK-developed PAMs only and will only be visible in the screens if the CB-10 Voucher Security features have been activated. For more information about how these fields are related to each other, and how they are used in CB-10 authentication rules, see CB-10 field relationship diagram.
Field | Description |
---|---|
Name | Name for the authentication rule. Maximum length 50 characters. |
PAM |
Pluggable Authentication Module name. This field is populated by the system with the PAMs which have been enabled on this platform. Note:
|
Number Length |
Voucher number length. This field may only be edited for DES/DES Deprecated PAMs. See the following table for valid number lengths. |
PIN Length | Voucher PIN length (digits). If the PAM is AltAuthMod then this field is automatically set to 0. For DES/DES Deprecated PAMs enter a value between 4 to 20. |
Salt |
This field applies to DES rule definition only. It is used to generate the voucher pin and will be automatically generated if left blank. It can be set to any 2 alpha-numeric characters. This field is not used with authentication rules that specify a CB10 HRN or SDK-developed PAM. |
S | Length of the serial number (the number must be between 0 and 20). |
R1 | Length of the first redundancy layer (must be between 0 and 20). A higher number provides a greater level of security. |
R2 | Length of the second redundancy layer (must be between 0 and 20). A higher number provides a greater level of security. |
R3 | Length of the third redundancy layer (must be set to 0, 1 or 2). A higher number provides a greater level of security. |
SDK P1 | Optional integer field that is passed as part of the Authentication Rule information given to an SDK ccsAuth plugin and can be used to supply extra parameters used when generating a secret (HRN). |
SDK P2 | Optional integer field that is passed as part of the Authentication Rule information given to an SDK ccsAuth plugin and can be used to supply extra parameters used when generating a secret (HRN). |
SDK P3 | Optional integer field that is passed as part of the Authentication Rule information given to an SDK ccsAuth plugin and can be used to supply extra parameters used when generating a secret (HRN). |
SDK Custom Secret Length |
The length of the string to produce for the final HRN. This is used when the SDK ccsAuth plugin is implementing a custom method for generating an HRN (on top of the product-provided CB10 algorithm). Note: It is enabled only if the plugin has been installed in the database specifying CustomHRN as Y in the database installer specification XML file. |
The following table shows the valid number length values for PAMs:
PAM | Valid Values | Automatically Generated? |
---|---|---|
AltAuthMod | 14 | Yes |
DES DES Deprecated |
4 - 20 | No |
CB10 HRN SDK-developed |
4 - 22 |
Yes. This field is set to: S+R1+R2+R3 |
Authentication rules
Authentication rules are used by the voucher batch creation and voucher redemption processes. The authentication rule associated with a voucher batch determines which encryption algorithm to use when generating the voucher numbers in the batch. Following encryption algorithms are supported:
-
CB10 HRN SHA256
-
CB10 HRN SHA512
-
CB10 HRN AES256
Note: You cannot edit or delete an authentication rule that is used to create a voucher batch. Voucher batches created in previous versions of the product can continue to use the old rules they were created with. Old authentication rules are not available for new voucher batches.
CB-10 HRN Creation
The CB10 HRN creation provided by the CB10 HRN authentication module generates voucher numbers using the:
-
CB-10 HRN private keys (K1, K2 and K3) for the service provider
-
S, R1, R2 and R3 security parameters defined for the authentication rule
The CB-10 HRN creation algorithm does not support voucher PINs and therefore the PIN length is always set to 0.
A unique set of CB-10 HRN private keys (K1, K2 and K3) is required for each service provider. These keys are generated in one of the following ways:
-
Generated automatically when a new service provider is created
-
Generated or regenerated for service providers who existed before the CB-10 HRN authentication was activated using the Generate button for one of the CB10 HRN SHA or AES PAM modules
Note: If a voucher batch is already created for a service provider using the CB-10 creation algorithm then you cannot:
-
Regenerate the K1, K2, and K3 private keys for the selected service provider
-
Edit the associated authentication rule
CB-10 HRN SHA Hashing
CB-10 HRN private keys are created when:
-
a new service provider is created
-
a Generate button is clicked for a CB10 or SDK PAM Authentication module and the service provider does not have any CB-10 vouchers created yet
Clicking a Generate button also generates hash/encryption keys for the specific PAM Authentication module that are used for hashing/encrypting the CB10 or SDK-created HRN. Generate buttons are disabled if the service provider already has a voucher batch created using the specific PAM Authentication module.
For example, after a voucher batch is created for a service provider using an authentication rule specifying a PAM of CB10 HRN SHA256, you cannot change or update the hash key for CB10 HRN SHA256.
PAMs that use SHA hashing can specify the number of hash iterations to apply, the default is 1 iteration.
Decryption to retrieve the HRN is not supported for SHA-based PAMs as the SHA operation is not reversible.
CB-10 HRN AES Encryption
Similar to CB-10 HRN SHA hashing, AES encryption keys are created when the Generate button for the CB10 HRN AES256 PAM or a SDK-developed PAM using AES Encryption is clicked.
Once a service provider has a voucher batch created with Authentication Rules using the PAM, the Generate button for the PAM is no longer enabled.
PAMs that use AES encryption do not use iterations and in this case the Iterations field for the Authentication Rule is set to 1.
Because AES-256 is a symmetric encryption algorithm, its encrypted value can be decrypted. If the capability of decrypting voucher private secrets is required those vouchers must be created using an Authentication rule that specifies either a PAM of CB10 HRN AES256 or an SDK-developed PAM that supports decryption.
Generating CB-10 HRN keys and SHA/AES hash/encryption keys
Follow these steps to generate or regenerate CB-10 HRNGEN private keys, SHA hash keys and AES keys for a service provider.
-
Select the customer from the Service Provider drop down box.
-
On the Security tab, click Generate for one of the following:
-
CB10 HRN SHA256 Key Generation
-
CB10 HRN SHA512 Key Generation
-
CB10 HRN AES256 Key Generation
-
SDK
Display Name
Key Generation
-
-
Note:
Display Name
is the chosen name for a PAM plugin developed with the SDK. The buttons are visible on the tab if the CB-10 Voucher Security features are activated. Generate buttons are disabled if a voucher is already created for the service provider using the associated voucher authentication PAM module.Result: You see the appropriate Key Generation completed message box appear.
-
Click OK.
Rule priority
When redeeming vouchers the different encryption algorithms are matched against the voucher HRN (hidden resource number) based on the length of the HRN. If the length of the HRN cannot be uniquely matched to an encryption algorithm, then an attempted match is made against each authentication rule in turn. The priority given to each authentication rule is determined by the order in which they appear in the table in the tab.
Changing rule priority
Follow these steps to change the order of priority for an authentication rule.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the table on the Voucher Security tab, select the authentication rule to move.
-
Click:
-
Up - to move the rule up one row and raise its priority
-
Down - to move the rule down one row and lower its priority
-
-
Click Save.
Adding an authentication rule
Follow these steps to add a new authentication rule.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On the Security tab, select the Voucher Security tab, then click New.
Result: You see the New Authentication Rule screen.
-
Configure this record by entering data in the fields on this screen.
For more information about the fields on this screen, see Security fields.
Notes:
-
To use the selected PAM, you must first complete key generation. See Generating CB-10 HRN keys and SHA/AES hash/encryption keys.
-
Different fields will be enabled depending on which authentication module you select and in the case of an SDK-developed authentication module how that module has been configured.
-
-
Click Save.
Related topic
Editing an authentication rule
Follow these steps to edit an authentication rule.
Note: You will not be able to edit a rule for which there is an associated voucher batch.
-
Select the Service Provider from the drop down box.
-
Select the rule to edit from the table on the Voucher Security tab.
-
Click Edit.
Result: You see the Edit Authentication Rule screen.
-
Edit the fields to reflect the changes you need to make.
For more information about the fields on this screen, see Security fields.
Note: Different fields will be enabled depending on which authentication module you select.
-
Click Save.
Related topic
Deleting an authentication rule
Follow these steps to delete an existing authentication rule.
Note: You will not be able to delete a rule for which there is an associated voucher batch.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the table on the Voucher Security tab, select the authentication rule to delete.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK.
Related topic
About Credit Card Security
About Masking Rules for Credit Card Security
You configure masking rules for credit card security to prevent full credit card numbers from being displayed. A global masking rule is configured at installation. You can modify the global masking rule, if required, but you cannot delete it.
You can also define masking rules for service providers. A service provider masking rule is used instead of the global masking rule. You define masking rules on the Security tab in the Service Management window.
Global Masking Rule
The global masking rule is configured at installation to use the following defaults:
- Four digit suffix length
- No prefix
- Star (*) pad character to mask the credit card number display
- Allow tokenized card number searches
When displaying a credit card number, the total length of the number is 19 characters, including masked characters. For example, if the full credit card number is 4535123456789876, then the number displayed after applying the global masking rule is ***************9876.
Credit card security fields
This table describes the function of each field and area.
Field | Description |
---|---|
Warning label | Indicates that a rule has a prefix + suffix length greater than 12. |
Table | Shows the current masking rules, one per row. The table shows rules for this service provider plus the global masking rule. |
Name |
The generated name of the masking rule, in the format - Prefix: value/Suffix: value |
Suffix Length | The number of digits displayed at the end of the display number. Valid values are numbers 1 through 10. |
Prefix Length | The number of digits displayed at the start of the display number. Valid values are numbers 1 through 9. Optional, defaults to no value. |
Pad Character | The pad character, which is the substitute character to display in the display number when not in the prefix or suffix. Valid values are any non-numeric character. Optional. Default is *. |
Searchable Tokenised Number | The tokenized credit card number can be searched for the rule if a tick is displayed. You can search on the Credit Cards tab, for example. See Searching for credit cards. |
Adding a masking rule
Follow these steps to add a masking rule.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On the Security tab, select the Credit Card Security tab, then click New.
Result: You see the New Masking Rule screen.
-
Configure this record by entering data in the fields on this screen.
For more information about the fields on this screen, see Credit card security fields.
-
Click Save.
Related topic
Editing a masking rule
Follow these steps to edit a masking rule.
-
Select the Service Provider from the drop down box.
-
Select the rule to edit from the table on the Credit Card Security tab.
-
Click Edit.
Result: You see the Edit Masking Rule screen.
-
Edit the fields to reflect the changes you need to make.
For more information about the fields on this screen, see Credit card security fields.
-
Click Save.
Related topic
Deleting a masking rule
Follow these steps to delete an existing masking rule.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
In the table on the Credit Card Security tab, select the rule to delete.
-
Click Delete.
Result: You see the Delete Confirmation prompt.
-
Click OK.
Related topic
Splash Screen Configuration
The Splash Screen Config tab enables you to configure the splash screens which are displayed when a user logs into the Customer Care Portal.
Note: You can only configure one message of the day and one security warning message for a service provider. This means that you may not be able to add a splash screen configuration record, or you may not be able to change the message type of an existing message.
Splash Screen configuration fields
This table describes the function of each field.
Field | Description |
---|---|
Message Type |
The type of splash screen message to configure. Note: There are only two options in this field. The system only supports one message of each type. You can only select a value in this field when no splash screen config is currently configured. Otherwise, this field will automatically be populated with the available value. |
Message Text (HTML Editor) | The source html markup and text which defines the message which is displayed on the splash screen message when users log into the Customer Care Portal. |
Adding splash screen configuration
Follow these steps to add a new splash screen configuration.
-
Select the Service Provider from the drop down box.
-
On the Splash Screen Configuration tab, click New.
Result: You see the New Splash Screen Configuration screen.
-
Configure this record by entering data in the fields on this screen.
For more information about the fields on this screen, see Splash Screen configuration fields.
-
You can load the message from an external file. For more information, see Importing a message from file.
-
You can preview the message. For more information, see Previewing the message.
-
Click Save.
Related topic
Importing a message from file
Follow these steps to import the source html markup and text from an external file.
Note: The Message Text (HTML Editor) does not:
-
Support any non-standard HTML 3.2 constructs
-
Handle any complex HTML generated by Microsoft Word.
-
On the Splash Screen Configuration screen, click Load.
Result: You will see the Open screen.
-
Browse to the file which holds the html to import and select it.
-
Click Open.
Result: The html from the file will be displayed in the Message Text (HTML Editor) screen.
Previewing the message
Follow these steps to view an example of how the message will look to users who are logging into the CCP.
-
To see what the splash screen will look like, click Preview.
Result: The Splash Screen Configuration Preview window opens displaying the splash screen. Close the screen when you have finished checking the message.
-
When you have finished viewing the preview, close the window by clicking the x in the top right corner of the screen.
Editing splash screen configuration
Follow these steps to edit an existing splash screen configuration record.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
On table on the Splash Screen Configuration tab select the record to edit and click Edit.
Result: You see the Edit Splash Screen Configuration screen.
-
Edit the fields to reflect the changes you need to make.
For more information about the fields in this screen, see Splash Screen configuration fields.
-
You can load the new message from an external file. For more information, see Importing a message from file.
-
You can preview the message. For more information, see Previewing the message.
-
Click Save.
Related topic
Deleting splash screen configuration
Follow these steps to delete an existing splash screen configuration.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to delete from the table on the Splash Screen Configuration tab.
-
Click Delete.
Result: The Delete Confirmation displays.
-
Click OK.
Results: The record is deleted from the database.
Related topic
Channel
The Channel tab allows you to configure the promotion channels for the Balance Recharge event in Promotion Manager.
Security fields
This table describes the function of each field.
Note: The S, R1, R2, and R3 fields apply to CB10 HRN and SDK-developed PAMs only and will only be visible in the screens if the CB-10 Voucher Security features have been activated. For more information about how these fields are related to each other, and how they are used in CB-10 authentication rules, see CB-10 field relationship diagram.
Field | Description |
---|---|
Name | Name for the authentication rule. Maximum length 50 characters. |
PAM |
Pluggable Authentication Module name. This field is populated by the system with the PAMs which have been enabled on this platform. Note:
|
Iterations | The number of hash iterations to use for PAM of CB10 HRN SHA256 or CB10 HRN SHA512. Default is 1. Can be a positive number up to 99999. This field is used if a CB10 HRN SHA PAM is selected. |
Number Length | Voucher number length. This field is non-editable and is calculated for a PAM of CB10 HRN SHA256 or CB10 HRN SHA512 as the sum of S+R1+R2+R3. |
PIN Length | Voucher PIN length (digits). This field is available only for existing vouchers and is non-editable. |
Salt | This field applies to DES rule definition only. This field is available only for existing vouchers and is non-editable. |
S | Length of the serial number (the number must be between 0 and 20). |
R1 | Length of the first redundancy layer (must be between 0 and 20). A higher number provides a greater level of security. |
R2 | Length of the second redundancy layer (must be between 0 and 20). A higher number provides a greater level of security. |
R3 | Length of the third redundancy layer (must be set to 0, 1 or 2). A higher number provides a greater level of security. |
Channel fields
This table describes the function of each field.
Field | Description |
---|---|
Channel |
The name of the promotional channel. The following global channels are preconfigured upon installation:
|
Description | A description of the channel |
Global | If selected, the channel is global, rather than specific to the selected service provider. |
Adding a Channel
Follow these steps to add a new channel.
-
Select the Service Provider from the drop down box.
-
On the Channel tab, click New.
Result: You see the New Channel screen.
-
Configure this record by entering data in the fields on this screen.
For more information about the fields on this screen, see Channel fields.
-
Click Save.
Related topic
Editing a Channel
Follow these steps to edit an existing channel.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to edit from the table on the Channel tab.
-
Click Edit.
Result: You see the Edit Channel screen.
-
Edit the fields to reflect the changes you need to make.
For more information about the fields on this screen, see Channel fields.
-
Click Save.
Related topic
Deleting a Channel
Follow these steps to delete an existing channel.
-
Select the service provider from the Service Provider list in the Service Management screen.
-
Select the record to delete from the table on the Channel tab.
-
Click Delete.
Result: The Delete Confirmation displays.
-
Click OK.
Results: The record is deleted from the database.
Related topic