Products
- Sentinel 100
- Sentinel 400
- Mediatrix S7 and S7 LP Series
- Mediatrix G7 Series
- Mediatrix C7 Series
- Mediatrix 4100 Series
- Mediatrix 3000 Series
- Mediatrix 4400 Series
- Mediatrix LP Series
A DTMF map (also called digit map or dial map) allows you to compare the number users just dialed to a pattern string. Depending on the DTMF maps, the call can be accepted or rejected.
When a number is dialed, it is compared to the numbers of the DTMF maps:
Note
The table has precedence over the Allowed DTMF Map table.
The order in which the DTMF maps are used is very important. You must use specific DTMF maps first and then more generic ones. Otherwise you may end up with all calls being directed the same way. This is true when creating the DTMF maps in the Allowed DTMF Map table and in the field of this table.
For example, lets say
If you put the DTMF map for management calls first,
[1-3]x9 [1-3]xxcalls made to a managers, will always be redirected to the Manager's assistant extension.
On the other hand, if you put the DTMF for extension redirections before the DTMF for management redirection,
[1-3]xx [1-3]x9managers will always directly receive their calls without going through the Manager's assistant extension.
When creating DTMF maps to allow or refuse calls, the DTMF maps must be written and a transformation to be applied to the dialed number may be required.
The DTMF map is used to recognise the dialed numbers and the transformation modifies the dialed numbers before sending the call. A transformation is not mandatory, it depends if the dialed number must be changed or not before the call is made.
For example, when the dialed number is the extension of a colleague, no transformation is required. The DTMF map will recognise that the dialed numbers are the allowed extension of a colleague, and the call will be made with the dialed number.
However, in the example where calls made to management extensions are redirected to the management's assistant, a transformation is required. For example, if the DTMF is xx9 and the transformation 123, this means that whenever an extension finishing by 9 is dialed, the call is sent to extension 123.
The permitted DTMF map syntax is taken from the core MGCP specification, RFC 2705, section 3.4:
DigitMap = DigitString / '(' DigitStringList ')' DigitStringList = DigitString 0*( '|' DigitString ) DigitString = 1*(DigitStringElement) DigitStringElement = DigitPosition ['.'] DigitPosition = DigitMapLetter / DigitMapRange DigitMapLetter = DIGIT / '#' / '*' / 'A' / 'B' / 'C' / 'D' / 'T' DigitMapRange = 'x' / '[' 1*DigitLetter ']' DigitLetter ::= *((DIGIT '-' DIGIT ) / DigitMapLetter)
Note
the Transformation field is not required if you are not changing the dialed number before making the call. For example, when the dialed number is the extension of a colleague. However, if the dialed number must be transformed, for example to add a 0 at the beginning of the dialed number, then a transformation is required. Refer to Basic DTMF Transformations
Note
the Transformation field is not required if you are not changing the dialed number before making the call. For example, when the dialed number is the extension of a colleague. However, if the dialed number must be transformed, for example to add a 0 at the beginning of the dialed number, then a transformation is required. Refer to Basic DTMF Transformations
DTMF maps use specific characters and digits in a particular syntax
Character | Use |
---|---|
Digits (0, 1, 2... 9) | Indicates specific digits in a telephone number expression. |
T | The Timer indicates that if users have not dialed a digit for the time defined, it is likely that they have finished dialing and the SIP Server can make the call. |
x | Matches any digit, excluding “#” and “*”. |
| | Indicates a choice of matching expressions (OR). Note Enclose the DTMF map in parenthesis when using the “|” option. |
. | Matches an arbitrary number of occurrences of the preceding digit, including 0. |
[ | Indicates the start of a range of characters. |
] | Indicates the end of a range of characters. |
Note
xT indicates that the number will be dialed after the delay set for the timer, (T)
Note
When making the actual call and dialing the number, the Mediatrix unit automatically removes the “T” found at the end of a dialed number, if there is one (after a match). This character is for indication purposes only; no transformation is required to remove it.
Note
The DTMF map is enclosed in parentheses when using the “|” option.
Note
The DTMF map is enclosed in parentheses when using the “|” option.
Note
The DTMF map is enclosed in parentheses when using the “|” option.
Note
When making the actual call and dialing the number, the Mediatrix unit automatically removes the “T” found at the end of a dialed number, if there is one (after a match). This character is for indication purposes only; no transformation is required to remove it.
DTMF Transformations will modify the dialed number. For example, let's say that the dialed number is 18195551111#.
Action | Transformation | Result |
---|---|---|
Add the prefix “0” to the dialed number | 0x | 018195551111# |
Remove the suffix “#” from the dialed number | x{#} | 018195551111 |
Remove the first four DTMFs from the dialed number | (4)x | 5551111# |
Remove the international code and termination and replace the area code by another one | (1){819}514x{#} | 5145551111 |
Replace the signalled DTMFs by a extension "123" | 123 | 123 |
If you are not familiar with the meaning of the fields and buttons, click Show Help, located at the upper right corner of the Web page. When activated, the fields and buttons that offer online help will change to green and if you hover over them, the description will be displayed.
Mediatrix units are supplied with an exhaustive set of documentation.
Mediatrix user documentation is available on the Documentation Portal .
Several types of documents were created to clearly present the information you are looking for. Our documentation includes:
Copyright © 2019 Media5 Corporation.
This document contains information that is proprietary to Media5 Corporation.
Media5 Corporation reserves all rights to this document as well as to the Intellectual Property of the document and the technology and know-how that it includes and represents.
This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever, without written prior approval by Media5 Corporation.
Media5 Corporation reserves the right to revise this publication and make changes at any time and without the obligation to notify any person and/or entity of such revisions and/or changes.