Technical Helpweb

- more articles

How to use SIPcontrol Address Maps

The Dialogic® Diva® SIPcontrol™ Software Address Maps functionality allows you to change phone number and name data by means of regular expressions. While it is not mandatory to have Address Maps configured, they are useful in cases where the automatic normalisation handling using a Dialplan is not sufficient and additional number manipulation is required.

Using an Address Map consists of 2 steps:
1) defining the Address Map in the Address Maps configuration section
2) assigning the Address Map to the path of the call. This can be done anywhere along the path of the call depending on what stage the address should be changed.

Click on the following image to view it full size 

SIPcontrol Address Maps use the style of regular expressions used by Perl.

SIPcontrol 2.5.1 introduced the concept of enhanced configurations which is enabled by default and is recommended to use.

Click on the following image to view it full size

The concept of the enhanced configuration is to replace the number type flags literals

+
N
S

used in earlier versions of SIPcontrol with Number Type Conditions and Results

International Number Type
National Number Type
Subscriber Number Type

Furthermore additional filtering options for calls from PSTN are included for more fine-grained filtering options.

Please note:
The + sign at the beginning of a number is considered as a type flag and represents an international number.
One or more 0s at the beginning of a number are considered as prefixes. For prefix-numbers the number type is usually unknown.

Thus if you want to convert an E.164 number to a prefix-based number, the number type result should be set to unknown and the address result field should include the 0s.

Examples:

PSTN inbound / PSTN outbound Address Maps

• Task: Calls to Lync should not be displayed as 'Anonymous is calling'

Example: Network signals a call to the DMG4000 SBA without a calling number (i.e. the call comes from an analog phone, or the caller has CLI suppressed).
In this case the DMG4000 SBA signals the call to Lync as From: Anonymous.

Calling Address Condition: ^$
Calling Address Result:  <static number>  i.e. Address Result: 0123456789
Apply this address map as PSTN Interface > Details > Address Map Inbound.

So each call without calling party number is signalled as From: +44123456789 if a UK Dialplan is used.

• Task: n digits should be replaced by m digits

Example: 5587 xxx --> 78 xxx

Address Condition: ^5587
Address Result:78

• Task: first n digits should remain, next m should be replaced with 7, next x should be kept, last y should be prefixed with 99

Example: 0251 15 468 12 -->  0251 7 468 99 12

Address Condition: ^([0-9]{4})(.{2})(.{3})(.{2})$ 
Address Result: ($1)7($3)99$4

• Task: Number normalisation from Lync to PSTN using number prefixes.
  

Example: DMG4000 SBA behind local PBX is located in UK with country code 44, area code 1628, branch code 384, number of extensions 3.
Calls from Lync are signalled in E.164 format and should be send to the PSTN as phone numbers using prefixes. Calls to internal extensions should use only the extension number.

Create a new Address Map with three rules. Select this Address Map as Address Map outbound in the PSTN Interface Details page

1^st rule: Calling Party Number
Calling Address Condition ^.*
Calling Number Type Condition: International
Calling Address Result: 00$&
Calling Number Type Condition: Unknown
Stop on Match: NOT checked

2^nd rule: StripToExtensionsForPBX
Called Address Condition: ^441628384
Called Number Type Condition: International
Called Address Result:
Called Number Type Result: Unknown
Stop on Match: True
  This will match +441628384xxx and uses xxx as the called number

3^rd rule: National Calls
Called Address Condition: ^44
Called Number Type Condition: International
Called Address Result: 0
Called Number Tyoe Result: Unknown
Stop on Match: True
   This will match any calls to the UK and replaces +44 with 0. For instance +441628641792 -> 01628641792

4^th rule:  International Calls
Called Address Condition ^.*
Called Number Type Condition: International
Called Address Result: 00$&
Called Number Type Condition: unknown
Stop on Match: True
    This will match any other calls that start with + and replace them with 00. For instance +49123456789 -> 0049123456789

• Task: Number normalisation from Lync to PSTN using number type flags.
  

Example: DMG4000 SBA behind local PBX is located in UK with country code 44, area code 1628, branch code 384, number of extensions 3.
Calls from Lync are signalled in E.164 format and should be send to the PSTN as phone numbers using type flags. Calls to internal extensions should use only the extension number.

Create a new Address Map with four rules. Select this Address Map as Address Map outbound in the PSTN Interface Details page

1^st rule: Calling Party Number
Calling Address Condition ^.*
CallingNumber Type Condition: International
Calling Address Result: $&
Calling Number Type Condition: no change or International
Stop on Match: NOT checked

2^nd rule: StripToExtensionsForPBX
Called Address Condition: ^441628384
Called Number Type Condition: International
Called Address Result:
Called Number Type Result: Subscriber
Stop on Match: checked
  This will match +441628384xxx and uses xxx as the called number

3^rd rule: National Calls
Called Address Condition: ^44
Called Number Type Condition: International
Called Address Result:
Called Number Tyoe Result: National
Stop on Match: checked
   This will match any calls to the UK and removes the +44 prefix. For instance +441628641792 -> 1628641792  Type of Number: national

4^th rule:  International Calls
Called Address Condition ^.*
Called Number Type Condition: International
Called Address Result: $&
Called Number Type Condition: no change or International
Stop on Match: checked
    This will match any other calls but does not change number or number type. For instance +49123456789 -> 49123456789  Type of Number: international

• Task: Change extension numbers based on input

Example: Change extension numbers 111 to 123 and 333 to 456

Address Condition: (111)$|(333)$
Address Result: (?1(123))(?2(456))

The result replaces the extension with 123 if the first condition is true (extension = 111) or if the second condition is true the extension is replaced by 333.

SIP inbound / SIP oubound Address Maps

•  Task: Number normalisation from PSTN to Lync

Example: DMG4000 SBA behind local PBX is located in UK with country code 44, area code 1628, branch code 384, number of extensions 3.
Calls from the PBX are signalled using prefixes and should be send to Lync as E.164 phone numbers. The called party number is delivered as 3 digit internal extension.

Create a new Address Map with five rules. Select this Address Map as Address Map outbound in the SIP Peer Details page of the Lync peer.

1^st rule: CalledPartyNumber
Called Address Condition: ^(\d{3})$
Called Number Type Condition: All checked
Called Address Result: 441628384$1
Called Number Type Result: International
Stop on Match: NOT checked

2^nd rule: CallingPartyInternal

Calling Address Condition: ^(\d{3})$
Number Type Condition: All checked
Calling Address Result: 441628581384$1
Number Type Result: International
Stop on Match: checked

3^rd rule: CallingPartyLocal
Calling Address Condition: ^([1-9].*)$
Number Type Condition: All checked
Calling Address Result: 441628$1
Number Type Result: International
Stop on Match: checked

4^th rule: CallingPartyNational

Calling Address Condition: ^0([1-9].*)$
Number Type Condition: All checked
Calling Address Result: 44$1
Number Type Result: International
Stop on Match: checked

5^th rule: CallingPartyInternational

Calling Address Condition: ^00(.*)$
Number Type Condition: All checked
Calling Address Result: $1
Number Type Result: International
Stop on Match: checked

• Task: Set SIP Display Name

Example: Regardless of whether a display name is present or not, set John Smith as the calling person.

Calling Address Condition: .*
Calling Address Result: "John Smith"

• Task: Change SIP Display Name

Example: John Smith -> John Cougar Smith

Calling Address Condition: (John)( Smith)
Calling Address Result: $1"Cougar" $2