Description
Component name |
Normalizer |
---|---|
Applicable contexts |
|
Features using component |
The Sentinel Normalizer normalizes International, Unknown, National, or Subscriber NADI format addresses into either:
-
international address format — starting with CC + MNC
-
national format — starting with MNC
where MNC is specified in the NetworkDialingCode configuration setting.
The Sentinel Normalizer may decide to not normalize the address if the address is either:
-
shorter than the
MinNormalizableLength
-
an entry in the
SkipNormalizationAddressList
This allows for short codes and specific longer length numbers to avoid normalization.
The SkipNormalizationAddressList
is a configurable address list scoped by the Sentinel selection key; it is only used by the SIP normalization component.
Normalization is invoked by the call type specific normalization features Voice Call Normalization Feature, SMS Normalization Feature and SIP Normalization Feature. It is also invoked by the XCAP Server to reject requests containing numbers which are not normalizable. Furthermore, MMTelCDIV, MMTelICB and MMTelOCB use the normalization component to normalize numbers in outgoing requests, and when comparing numbers.
Support for formatting of special characters in SS7 signalling (such as: * → B, # → C) is provided by the SS7 Prefix and Suffix Analysis Feature. Sentinel supports special character mapping only if they are prefixes or suffixes. |
Configuration
Parameter | Type | Description |
---|---|---|
NationalPrefix |
String |
National dialling prefix (for example, 0) |
CountryCode |
String |
Country code |
NetworkDialingCode |
String |
Network dialling code, used as the MNC |
InternationalEscapeCode |
String |
Escape code for dialing international numbers (for example, 00) |
NormalizeTo |
String |
Indicates the default format of Nature of Address Indication (NADI); one of: [international, national] |
ProfileVersion |
Integer |
The current profile’s version (used for determining if reloading is required) |
MinNormalizableLength |
Integer |
The minimum length of an address for it to be normalizable. |
Normalization address list configuration
The SkipNormalizationAddressList
address list uses the standard Address list entry.
Addresses that prefix match against entries in the list are not normalized.
Using the 'SkipNormalizationAddressList' to avoid normalizing numbers is only supported by the (SIP) SipNormalization and the SCCCamelToIMSReOriginationSIPFeature in Sentinel-Volte. |
Configuration profile naming
Configuration Profile Table Name | Description | Profile naming |
---|---|---|
NormalizationFeatureConfigProfileTable |
Normalization parameter configuration |
SentinelSelectionKey (for example, |
${PLATFORMOPERATOR}_Sentinel_AddressListConfigurationTable |
Address list configuration |
|
${SELECTIONKEY}:Normalizer:SkipNormalizationAddressList |
${PLATFORMOPERATOR}_Sentinel_AddressListEntryTable |
Feature specific Address List entry table |
Provisioning interfaces
The Normalizer component is provisioned using the Managing Normalization web interface.
Behaviour
The Normalizer component normalizes addresses based on its configuration.
Initially the address to normalize is checked for length against the MinNormalizableLength
, and against the SkipNormalizationAddressList
.
If the address is under the MinNormalizableLength
, or matches the prefix list, normalization is skipped.
Then the configuration of the component is checked to determine whether the address should be normalized to national or international format.
-
If the number should be normalized to international format
-
if the number is in national format, the configured
CountryCode
will be prepended to the address. -
if the number is in subscriber format, the
CountryCode
and the configuredNetworkDialingCode
will be prepended to the address. -
If the current format of the number is unknown, the format will be determined by checking against the configured
InternationalEscapeCode
andNationalPrefix
, and then normalizing as appropriate. If neither of those prefixes match the address, it will be returned unchanged.
-
-
If the number should be normalized to national format
-
if the number is in international format, the length of the configured
CountryCode
will be removed from the start of the address. -
if the number is in subscriber format, the configured
NetworkDialingCode
will be prepended to the address. -
If the current format of the number is unknown, the format will be determined by checking against the configured
InternationalEscapeCode
andNationalPrefix
, and then normalizing as appropriate. If neither of those prefixes match the address, it will be returned unchanged.
-