☰
Navigation :

Normalisation and Denormalisation

Overview

Normalisation and denormalisation rules may be defined for the DSG-SCP. These rules exist within the config block, e.g.:

<?xml version="1.0" encoding="utf-8"?>
<n2svcd>
  ...
  <applications>
    ...
    <application name="<application name>" module="DsgScpApp">
      ...
      <config>
        ...
        <normalisation>
          <!-- Normalisation rules for the DSG-SCP -->
        </normalisation>
        <denormalisation>
          <!-- Denormalisation rules for the DSG-SCP -->
        </denormalisation>
      </config>
    </application>
    ...
  </application>
  ...
</n2svcd>

Configuration Details

Within each block, normalisation rules may be configured within specific sub-sections:

Attribute Type Description
.normalisation Object Container for called and called party number normalisation rules for inbound InitialDP.
.called_party Array Array of normalisation rules for InitialDP.calledPartyNumber from Digits and NoA to digits-only.
.rule Object Provisions a called party normalisation rule.
.called_party_bcd Array Array of normalisation rules for InitialDP.calledPartyBCDNumber from Digits and NoA to digits-only.
.rule Object Provisions a called party BCD normalisation rule.
.calling_party Array Array of normalisation rules for InitialDP.callingPartyNumber from Digits and NoA to digits-only.
.rule Object Provisions a calling party normalisation rule.
.denormalisation Object Container for called and called party number denormalisation rules for outbound Connect.
.called_party Array Array of denormalisation rules for Connect.destinationRoutingAddress from digits-only to Digits and NoA.
.rule Object Provisions a called party denormalisation rule.
.calling_party Array Array of denormalisation rules for Connect.callingPartyNumber from digits-only to Digits and NoA.
.rule Object Provisions a calling party denormalisation rule.

Normalisation Rule

Each Normalisation Rule defines a rule for the normalisation of an inbound number. For each inbound InitialDP the relevant normalisation list is traversed until a matching rule is found. That rule is then applied and no other rule will apply. The following inbound numbers are normalised:

Each rule Object in the config.normalisation.called_party and config.normalisation.calling_party Array lists has the following structure.

Attribute Type Description
leading Hex Digits [Required] A prefix match string containing none or more characters from [0-9][a-f].
For the called_party_bcd rules the permitted characters are [0-9][a-c] plus and #.
An empty string matches all digits. The match is case-insensitive.
A rule matches if leading and noa both match.
noa 0-127 A numeric Nature of Address (NoA) to match against the input address.
A rule matches if leading and noa both match. Note that for called_party_bcd this is actually the “Type of Number”, although the configuration parameter is still named noa.
(Default = 2 for calling_party and called_party).
(Default = 0 for called_party_bcd).
min_len Integer The minimum length of the digit string which this rule will match.
(Default = same as the length of leading).
max_len Integer The maximum length of the digit string which this rule will match.
(Default = no maximum length, match all digit strings).
trim Integer The number of leading digits to trim when normalising.
(Default = 0, do not trim).
prepend Hex Digits The digit string to prepend (after trimming) when normalising. None or more characters from [0-9][a-f].
For the called_party_bcd rules the permitted characters are [0-9][a-c] plus and #.
(Default = do not prepend).

Denormalisation Rule

Each Denormalisation Rule defines a rule for the denormalisation of an outbound calling or calling number. For each outbound Connect the relevant denormalisation list is traversed until a matching rule is found. That rule is applied. No other rule will apply. The following outbound addresses are normalised:

Note that the callingPartyNumber is not always present in the outbound Connect. It is present only when expressly requested by the service logic, and when not prohibited by the inbound presentation indicators.

Each rule Object in the config.denormalisation.called_party and config.denormalisation.calling_party Array lists has the following structure.

Attribute Type Description
leading Hex Digits [Required] A prefix match string containing none or more characters from [0-9][a-f].
An empty string matches all digits. The match is case-insensitive.
A rule matches if leading matches.
min_len Integer The minimum length of the digit string which this rule will match.
(Default = same as the length of leading).
max_len Integer The maximum length of the digit string which this rule will match.
(Default = no maximum length, match all digit strings).
noa 0-127 A numeric Nature of Address (NoA) to set for the output address.
(Default = 2).
trim Integer The number of leading digits to trim when denormalising.
(Default = 0, do not trim).
prepend Hex Digits The digit string to prepend (after trimming) when denormalising.
(Default = do not prepend).