Translation Element - Incoming

 

 

The Translation Element pane is configured under the Translation Table object. The Translation Element adds an entry to the Translation Table being configured for translating digits on the incoming leg of a channel group. Once the translation table (incoming) is created, each Translation Element configured under it will define the digit processing attributes that the IMG 2020 uses to process digit strings on the incoming leg of a channel group. The Translation Element defines the mechanism that the IMG 2020 uses for matching and translating digits on the incoming leg of a channel group. Once the incoming translation element pane has been added to a Translation Table, the Translation Table can be assigned to a specific channel group. The IMG 2020 supports creating up to 20 translation tables, with each table allowing up to 200 translation elements added to its list.

The translation fields which include the String field, the Dialed Number Translation field, and the Billing Number Translation field all support a maximum of 32 digits.

Web GUI Page

Dialogic > Routing Configuration > Incoming Translation Tables > Translation Table > New Translation Element

Maximum Objects

Up to 200 Translation Elements can be created per Translation Table

Related Topics and Dependencies

The Translation Element Pane differs depending on whether the entry being created is associated with an incoming or outgoing Translation Table. The Incoming Translation Element supports both translation and error detection whereas the Outgoing Translation Element supports only translations. The Translation Element information below is for incoming translations. For information on outgoing translation entry see Translation Element - Outgoing.

Once the Translation Table and its elements have been created and configured the Translation Table will be selectable in either the incoming or outgoing translation table field within the Channel Group object. The next few topics below explain digit translation on the IMG 2020. It is highly recommended that they be read before proceeding on to configuring a Translation Element

Translation Profiles

Translation Table

IMG 1010 - Digit Translation

Configure Digit Matching and Translation 

Field Descriptions

ID

The ID field is automatically populated with the next available ID and cannot be modified. This ID is used internally to identify this translation table entry.

Enable

Each individual Translation Element can be configured to be enabled or not. With this option an element can be created but does not need to be utilized. Any translation entry can be enabled and disabled at any time. Select from a drop down menu either True or False.

True (Default) - If True is selected then the translation element is available for use on incoming leg of a channel group.

False - If False is selected then the translation element is not available for use on incoming leg of a channel group.

Translation Profile

The Translation Profile field is a drop down menu displaying all the Translation Profiles created under the Profiles object. The Translation Profiles in the pull down menu allow the user to add different Translation Profiles to the Translation Element object that is being created. Information such as Advanced Dialed Number Parameters, Advance Originating Number Parameters, and a host of other parameters having to do with the translation of parameters from one protocol to the other are added through this field.

Type of Operation

On the incoming side the IMG 2020 can be configured to perform translations on all incoming channel groups. Below are the selections in the drop down menu.

Translation - On an incoming call, match on either a Dialed Number, Originating Number, or Generic Number. Once the digits have been matched with the String to Match and String fields below, translate or modify the number. Once number has been translated, the modified number is transmitted to an outgoing Channel Group that the translation table is associated with.

String to Match

A call coming into the IMG 2020 will contain either a Dialed Number, an Originating Number, Generic Number or some combination of the three. In order to translate an incoming number, the IMG 2020 needs to know which number the translation process will occur on. Select from drop down menu one of the options below. Once the String to Match field is configured, then the String field below can be populated with the actual digit string the IMG 2020 needs to match on.

Dialed Number - Match the Dialed Number Parameter against the value in the String field below. The Dialed Number is the called party number.

Originating Number - Match the Originating Number Parameter against the value in the String field. The originating number is generally the calling party number.

Generic Number - Match the Generic Number Parameter against the value in the String field below. The Generic Number is offered to callers who wish to use a presentation/display number which is different than their main number.

String

The digit string mask entered in the String field is compared to the incoming Dialed, Originating, or Generic Number. If the string entered in the String field matches the incoming Dialed, Originating, or Generic Number then the number will be translated to the value which is entered in the Dialed # Translation, Originating # Translation, or the Generic Number Translation fields described below. The Digit String Mask supports the use of wild–cards within the string. Below is short explanation on how to use wild–cards in the String field. For more information on using wild–cards in the String field see Wildcards for Translation.

Digits and wild-cards can be used in the string field. The values entered in this field are processed as strings not numbers. Enter values accordingly.

  • The pound (#) character is generally used to terminate a digit string.

  • The asterisk () character is generally used to trigger a service, such as *70 to disable call waiting.

Internally the IMG 2020 maps the asterisk () character to a value of hexadecimal 0x0e and the pound (#) character to hexadecimal 0x0f. This mapping can sometimes result in improper digit processing if your digit strings contain hexadecimal 0x0e or 0x0f.

  • The ampersand (&) specifies that all remaining digits can have any value. Ex. 508&

Match Channel Group

If there are any channel groups created this field becomes a drop down menu with all the Channel Groups configured. The IMG 2020 supports matching both the incoming string along with the Channel Group. For a translation to occur the String field would have to match an incoming number and, the call would have to come in on a specific channel group which is configured in the Match Channel Group as Well. The choices in the drop down menu are either None or an incoming channel group that is already configured.

Not Used - This feature will not be used. The Channel group the call comes in on does not affect how the call will be translated.

List of all Channel Groups Configured - List of all the Channel Groups configured in ascending order starting with lowest ID:

Any Outgoing Only Channel Groups will not be included in this list.

Match Nature of Address (Incoming Only)

When a call comes in to a channel group the IMG 2020 supports matching the Nature of Address along with matching the channel group and any specific digit strings. This option could be used to route international calls away from a particular channel group. Click in the Match Nature of Address as well field and a drop down menu with the selections below will appear. Select from drop down menu.

Not Used (Default) - This feature will not be used. The Nature of address parameter on the incoming call does not affect how the call will be translated.

Nature Of Address Parameters

000 - Reserved

001 - Subscriber Number

002 - Unknown - National Use

003 - National Number

004 - International Number

005 - Network Specific number

006 to 112 - Unknown NOA

113 - Subscriber Number - Operator Requested

114 - National Number - Operator Requested

115 - International Number - Operator Requested

116 - No Number Present - Operator Requested

117 - No Number Present - Cut Through

118 - 905 Call

119 - Test Call

120 to 127 - Unknown NOA

Dialed # Translation

When the String To Match and String fields above match on an incoming Dialed, Generic, or Originating Number the string entered into the Generic Number Translation field will either translate an existing incoming Dialed Number or add a Dialed Number to the outgoing ISUP IAM message. If this field is left empty then the translation would result in a null string. Refer to the Advanced Dialed Number Parameter topic for more information on translating specific parameters such as Nature Of Address, Numbering Plan Indicator, or INN Indicator within the Generic Number.

Originating # Translation

When the String To Match and String fields above match on an incoming Dialed, Generic, or Originating Number the string entered into the Originating Number Translation field will either translate an existing incoming Originating Number or add an Originating Number to the outgoing ISUP IAM message. If this field is left empty then the translation would result in a null string. Refer to the Advanced Originating Number Parameter topic for more information on translating specific parameters such as the Nature Of Address, Numbering Plan Indicator, Calling Party Category, Number Incomplete Indicator, Screening Indicator, or Presentation Indicator within the Originating Number.

The IMG 2020 has an added feature which allows an incoming ANI (Originating Number) to be translated when it is blank or null. Follow the steps below to translate a blank or null originating number parameter on incoming call to the value entered in the 'Originating # Translation' field.

  • Select Originating Number from the drop down menu of the String to Match field.

  • Enter the wildcard v option in the String field.

  • Enter the new digits in the Originating # Translation field.

Once accomplished the IMG 2020 will translate a blank or null ANI into the number entered in the Originating # Translation field.

Generic Number Translation

When the String To Match and String fields above match on an incoming Dialed, Generic, or Originating Number the string entered into the Generic Number Translation field will either translate an existing incoming Generic Number or add a Generic Number to the outgoing ISUP IAM message. Refer to the Advanced Generic Number Translation topic for more information on translating specific parameters such as Number Qualifier Indicator, Nature Of Address, Numbering Plan Indicator, Number Incomplete Indicator, Screening Indicator, or Presentation Indicator within the Generic Number.

Billing Number Translation

When the String To Match and String fields above match on an incoming Dialed, Generic, or Originating Number the string entered into the Billing Number Translation field will either translate an existing incoming Billing/Charge Number or add a Billing/Charge Number to the outgoing ISUP IAM message. Refer to the Advanced Billing Number Parameter Translation topic for more information on translating specific parameters such as Nature of Address, Numbering Plan, or International Number Indicator.

Carrier Number Translation

When the String To Match and String fields above match on an incoming Dialed, Generic, or Originating Number the string entered into the Carrier Translation field will be inserted into the Transient Network Selection (TNS) parameter in the outgoing SS7 IAM message. The digits entered into the Carrier Number Translation field replaces the incoming Carrier Number digits. Refer to the Advanced Carrier Number Parameter Translation topic for more information on replacing specific parameters such as Network Identification, Network Plan Identification, or Circuit Code.

Info Digits Translation

When the String To Match and String fields above match on an incoming Dialed, Generic, or Originating Number the string entered into the INFO Digits Translation field will get inserted into the Originating Line Info Parameter (OLIP) in the outgoing SS7 IAM message. The digits entered into the INFO Digits Translation field replaces the incoming OLIP parameter.

Re-Run Option

The Re-run field gives the IMG 2020 the ability to match on two separate parameters and then translate each. The way in which the re-run option functions is as described below:

  1. A call would come into the IMG 2020. The IMG 2020 is configured so that the incoming String To Match is a Dialed Number and that string is 508$. The call comes into the IMG 2020 and the dialed number gets translated to 617&.

  2. A second Translation Entry must be configured within the same translation table that has the string to match field set to either Originating Number or Generic Number. All fields in this second translation entry must be configured to translate either the Generic Number or Originating Number.

  3. If the Re-run option is set to Originating Number then a second translation would take place on the Originating number using the second translation entry which has the originating number being translated. The same would be true if Generic Number was selected in the re-run option.

The Re-run option is valid only if the Type of Operation field in both Translation Entries is set to Translation and the first translation on the incoming call is executed on a Dialed Number. Click in the Re-Run option field and a drop down menu will offer the following selections:

None (Default) - This is the default. The Re-run functionality is disabled.

Originating Number - After the initial Dialed Number translation, look through all entries under the translation table for one that is translating the Originating Number. Once this translation entry is identified, execute the translation.

Generic Number - After the initial Dialed Number translation, look through all entries under the translation table for one that is translating the Generic Number. Once this translation entry is identified, execute the translation.

See Advanced Generic Number Translation link for an example on how the Re-run option is configured.

Second String for Translation

The info digits are included within the Originating Line Info Parameter (OLIP) that is received from the SS7 side. ANSI protocol variants require including the Charge Number parameter whenever the Originating Line Info Parameter is included in the IAM. The IMG 2020 can also match on the Info digits received within the ISUP MIME body included in a SIP message when SIP-T is enabled.

Second String

This field is not selectable unless either Info Digits or Originating Number Category is selected from the previous field labeled Second String for Translation. Enter a string to represent either the Info Digits or the Originating Number Category. Valid characters are J and K. The Info Digits may appear anywhere in the translation numbers, however if the same variable is repeated, JJ or KK, the digits must appear together in the translation numbers. To identify and treat the Info Digits separately, they must be defined as JK or KJ.

Service Routing (Incoming Only)

Select a previously configured route table element from drop down menu. The Service Route Table elements in the drop down menu were configured under the Service Route Table object to implement Pre-Call Announcements. Refer to the Announcements - Pre-Call - Destination Number and Route Table Element pane.

Match (+) (Incoming Only)

In the SIP protocol a + sign is used to indicate an international number. On an incoming call, this feature allows the IMG 2020 to either append or strip digits based upon the presence or absence of the +. When a call comes in from SIP with the + sign, the IMG 2020 can do one of the following:

Matching on Dialed Number:

If the String to Match field is set to Dialed Number, the IMG 2020 will allow matching the Dialed Number in either the SIP URI Header or the To Header. If user selects both SIP URI Header and To Header, this becomes an OR condition. The Dialed Number matching can happen on either the SIP URI Header or the To Header but not both.

Matching on Originating Number:

If the String to Match field is set to Originating Number, the IMG 2020 will allow matching the Originating Number in the From Header only.

To select the SIP URI Header, click on the SIP URI Header entry in the table. To select both the SIP URI Header and the To Header hold down the <CRTL> key while clicking on the two entries. This will allow the user to enable both entries at the same time.

Append (+) for Headers

The Append (+) for Headers field is used to alter the incoming header and add a + sign to it. If the SIP Header comes in to the IMG 2020 and doesn't have the + symbol, the IMG 2020 will append the + symbol to it. Appending a + symbol can be done to the following Header fields below. To select one header, simply click on the entry to highlight it. To select more than one entry, click on each entry while holding down the <CTRL key. This will allow the user to append the + symbol to more than one type of header. Below is a list of the headers displayed in the Web GUI page.

Supported Headers

SIP URI Header

From Header

To Header

P-Asserted Header

P-Preferred Header

Remote-Party-ID-Header

Remove (+) for Headers

The Remove (+) for Headers field is used to alter the incoming header and remove the + from an incoming INVITE. This can also be used in the case that the incoming side is not SIP. Removing a + sign can be done to the following Header fields below. To select one header, simply click on the entry to highlight it. To select more than one entry, click on each entry while holding down the <CTRL key. This will allow the user to remove the + symbol from more than one type of header. Below is a list of the headers displayed in the Web GUI page.

Supported Headers

SIP URI Header

From Header

To Header

P-Asserted Header

P-Preferred Header

Remote-Party-ID-Header

 

Return to Documentation Home I Return to Sangoma Support