Cisco: Translation Patterns - Cisco Unified Communication Manager ( CUCM )

Translation Patterns
Translation patterns are one of the most powerful tools in Unified CM to manipulate digits for any type of call. They follow the same general rules and use the same wildcards as route patterns. As with route patterns, you assign a translation pattern to a partition. However, when the dialed digits match the translation pattern, Unified CM does not route the call to an outside entity such as a gateway; instead, it performs the translation first and then routes the call again, this time using the calling search space configured within the translation pattern.
——————————————————————————————————————–
Translation Pattern: 5546525XXX
Called-Party Transformation Mask: 2XXX
Resulting Phone Number: 2XXX
If a call came into the DID 5546525111, CallManager would convert the dialed digits to 2111
——————————————————————————————————————–

Non-Urgent Translation Patterns
In earlier releases of Cisco Unified Communications Manager (and Cisco Unified CallManager), Cisco Unified Communications Manager prioritized translation patterns as urgent; that is, Cisco Unified Communications Manager routed the call as soon as digit analysis identified a match with the translation pattern. Because Cisco Unified Communications Manager 7.0 supports local route groups, calling party normalization, and the international escape character +, which allow you to globalize, route, and localize calling party numbers, you can configure translation patterns as urgent or non-urgent to ensure that Cisco Unified Communications Manager does not route the call before it should be routed.
For example, if a caller in the 408 area code dials 95551212, this number gets globalized to +14085551212 through the use of translation patterns; that is, digit analysis does a pattern match for that string to determine where to route the call. In this example, a translation pattern takes 9.[2-9]XXXXXX, translates that string to +1408XXXXXXX, and then maps that value to a calling search space that contains the globalized patterns. This example works as long as you do not use variable-length dialing, as is the case with international calls. If you want to route an international call, you need a translation pattern for 9011.! that disregards the predot and adds the prefix +. If you configure the translation pattern as urgent priority, 9011! matches with the first digit after the 9011, and Cisco Unified Communications Manager attempts to route the call without waiting to match more digits. As a result, international and any other variable length calls do not route correctly.

Translation patterns vs Transformation patterns
Many new Cisco CallManager administrators get the translation and transformation terms confused. Cisco CallManager allows you to create translation patterns that contain both calling- and called-party transformation masks to modify the caller ID or dialed-number information. Translation patterns are usually used to transform dialed digits, so the called-party transformation masks are more frequently used.

Transformation Masks
Dialing transformations allow the call-routing component to modify either the calling number or the dialed digits of a call.
Transformations that modify the calling number are calling-party transformations; transformations that modify the dialed digits are called-party transformations.
Calling-party transformation settings allow you to manipulate the appearance of the calling-party number for outgoing calls.
Called-party transformation settings allow you to manipulate the dialed digits, or called-party number, for outgoing calls.
Configuration Settings Table describes the available fields in the Translation Pattern Configuration window.

Field	Description
Pattern Definition
Translation Pattern	Enter the translation pattern, including numbers and wildcards (do not use spaces), in the Translation Pattern field. For example, for the NANP, enter 9.@ for typical local access or 8XXX for a typical private network numbering plan. Valid characters include the uppercase characters A, B, C, and D and \+, which represents the international escape character +. If you leave this field blank, you must select a partition from the Partition drop-down list box.Note Ensure that the translation pattern, which uses the chosen partition, route filter, and numbering plan combination, is unique. Check the route pattern/hunt pilot, translation pattern, directory number, call park number, call pickup number, or meet-me number if you receive a message that indicates duplicate entries. Alternatively, check the route plan report if you receive a message that indicates duplicate entries.
Partition	Choose a partition. If you do not want to assign a partition, choose<None>. If you choose <None>, you must enter a value in the Translation Pattern field.You can configure the number of partitions that display in this drop-down list box by using the Max List Box Items enterprise parameter. If more partitions exist than the Max List Box Items enterprise parameter specifies, the Find button displays next to the drop-down list box. Click the Find button to display the Find and List Partitions window. Note To set the maximum list box items, choose System > Enterprise Parameters and choose CCMAdmin Parameters.Note Make sure that the combination of translation pattern, route filter, and partition is unique within the Cisco Unified Communications Manager cluster.
Description	Enter a description for the translation pattern. The description can include up to 50 characters in any language, but it cannot include double-quotes (“), percentage sign (%), ampersand (&), or angle brackets (<>).
Numbering Plan	Choose a numbering plan.If your translation pattern includes the @ wildcard, you may choose a numbering plan. The optional act of choosing a numbering plan restricts certain number patterns.
Route Filter	Choosing an optional route filter restricts certain number patterns.The route filters that display depend on the numbering plan that you choose from the Numbering Plan drop-down list box.If more than 250 route filters exist, the Find button displays next to the drop-down list box. Click the Find button to display the Select Route Filters window. Enter a partial route filter name in the List items where Name contains field. Click the desired route filter name in the list of route filters that displays in the Select item to use box and click Add Selected.Note To set the maximum list box items, choose System > Enterprise Parameters and choose CCMAdmin Parameters.
MLPP Precedence	Choose an MLPP precedence setting for this translation pattern from the drop-down list box:• Executive Override—Highest precedence setting for MLPP calls.• Flash Override—Second highest precedence setting for MLPP calls.• Flash—Third highest precedence setting for MLPP calls. • Immediate—Fourth highest precedence setting for MLPP calls. • Priority—Fifth highest precedence setting for MLPP calls. • Routine—Lowest precedence setting for MLPP calls. • Default—Does not override the incoming precedence level but rather lets it pass unchanged.
Resource-Priority Namespace Network Domain	Choose an already configured Resource-Priority Namespace Network Domain from the drop-down list box.
Route Class	Choose a route class setting for this translation pattern from the drop-down list box:• Default• Voice• Data • Satellite Avoidance • Hotline voice • Hotline data The route class is a DSN code that identifies the class of traffic for a call. The route class informs downstream devices about special routing or termination requirements. The Default setting uses the existing route class of the incoming call. You should only use non-default route class settings to translate an inbound T1 CAS route class digit into a Cisco Unified Communications Manager route class value (and strip off the digit). You should not need to assign a non-default route class setting to any other inbound calls that use pattern configuration.
Calling Search Space	From the drop-down list box, choose the calling search space for which you are adding a translation pattern, if necessary.You can configure the number of calling search spaces that display in this drop-down list box by using the Max List Box Items enterprise parameter. If more calling search spaces exist than the Max List Box Items enterprise parameter specifies, the Find button displays next to the drop-down list box. Click the Find button to display the Find and List Calling Search Space window. Find and choose a calling search space name Note To set the maximum list box items, choose System > Enterprise Parameters and choose CCMAdmin Parameters.
External Call Control Profile	In Cisco Unified Communications Manager, you enable external call control by assigning an external call control profile to a translation pattern. If the translation pattern has an external call control profile assigned to it, when a call occurs that matches the translation pattern, Cisco Unified Communications Manager immediately sends a call-routing query to an adjunct route server, and the adjunct route server directs Cisco Unified Communications Manager on how to handle the call. From the drop-down list box, choose the external call profile that you want to assign to the translation pattern.
Route Option	The Route Option designation indicates whether you want this translation pattern to be used for routing calls (such as 9.@ or 8[2-9]XX) or for blocking calls. Choose the Route this pattern or Block this pattern radio button.If you choose the Block this pattern radio button, you must choose the reason for which you want this translation pattern to block calls. Choose a value from the drop-down list box:• No Error• Unallocated Number • Call Rejected • Number Changed • Invalid Number Format • Precedence Level Exceeded
Provide Outside Dial Tone	Outside dial tone indicates that Cisco Unified Communications Manager routes the calls off the local network. Check this check box for each translation pattern that you consider to be off network.
Urgent Priority	If the dial plan contains overlapping patterns, Cisco Unified Communications Manager does not route the call until the interdigit timer expires (even if it is possible to dial a sequence of digits to choose a current match). Check this check box to interrupt interdigit timing when Cisco Unified Communications Manager must route a call immediately.Tip By default, the Urgent Priority check box displays as checked.Unless your dial plan contains overlapping patterns or variable length patterns that contain !, Cisco recommends that you do not uncheck the check box.
Route Next Hop By Calling Party Number	Check this box to enable routing based on the calling party number, which is required for call screening based on caller ID information to work between clusters.
Calling Party Transformations
Use Calling Party’s External Phone Number Mask	Check the check box if you want the full, external phone number to be used for calling line identification (CLID) on outgoing calls.
Calling Party Transform Mask	Enter a transformation mask value. Valid entries for the NANP include the digits 0 through 9, and the wildcard characters asterisk (*) and octothorpe (#); the international escape character +; and blank. If this field is blank and the preceding field is not checked, no calling party transformation takes place.
Prefix Digits (Outgoing Calls)	Enter prefix digits. Valid entries for the NANP include the digits 0 through 9, and the wildcard characters asterisk (*) and octothorpe (#); the international escape character +.Note The appended prefix digit does not affect which directory numbers route to the assigned device.
Calling Line ID Presentation	Cisco Unified Communications Manager uses calling line ID presentation (CLIP/CLIR) as a supplementary service to allow or restrict the originating caller phone number on a call-by-call basis.Choose whether you want the Cisco Unified Communications Manager to allow or restrict the display of the calling party phone number on the called party phone display for this translation pattern.Choose Default if you do not want to change calling line ID presentation. Choose Allowed if you want Cisco Unified Communications Manager to allow the display of the calling number. Choose Restricted if you want Cisco Unified Communications Manager to block the display of the calling number.
Calling Name Presentation	Cisco Unified Communications Manager uses calling name presentation (CNIP/CNIR) as a supplementary service to allow or restrict the originating caller name on a call-by-call basis.Choose whether you want the Cisco Unified Communications Manager to allow or restrict the display of the calling party name on the called party phone display for this translation pattern.Choose Default if you do not want to change calling name presentation. Choose Allowed if you want Cisco Unified Communications Manager to display the calling name information. Choose Restricted if you want Cisco Unified Communications Manager to block the display of the calling name information.
Calling Party Number Type	Choose the format for the number type in calling party directory numbers.Cisco Unified Communications Manager sets the calling directory number (DN) type. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because Cisco Unified Communications Manager does not recognize European national dialing patterns. You can also change this setting when you are connecting to a PBX that expects the calling directory number to be encoded to a non-national numbering plan type.Choose one of the following options:• Cisco Unified Communications Manager—The Cisco Unified Communications Manager sets the directory number type. • Unknown—The dialing plan is unknown. • National—Use when you are dialing within the dialing plan for your country. • International—Use when you are dialing outside the dialing plan for your country. • Subscriber—Use when you are dialing a subscriber by using a shortened subscriber number.
Calling Party Numbering Plan	Choose the format for the numbering plan in calling party directory numbers.Cisco Unified Communications Manager sets the calling DN numbering plan. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because Cisco Unified Communications Manager does not recognize European national dialing patterns. You can also change this setting when you are connecting to PBXs by using routing as a non-national type number.Choose one of the following options:• Cisco Unified Communications Manager—Use when the Cisco Unified Communications Manager sets the Numbering Plan in the directory number. • ISDN—Use when you are dialing outside the dialing plan for your country. • National Standard—Use when you are dialing within the dialing plan for your country. • Private—Use when you are dialing within a private network. • Unknown—Use when the dialing plan is unknown.
Connected Party Transformations
Connected Line ID Presentation	Cisco Unified Communications Manager uses connected line ID presentation (COLP/COLR) as a supplementary service to allow or restrict the called party phone number on a call-by-call basis.Choose whether you want Cisco Unified Communications Manager to allow or restrict the display of the connected party phone number on the calling party phone display for this translation pattern.Choose Default if you do not want to change the connected line ID presentation. Choose Allowed if you want to display the connected party phone number. Choose Restricted if you want Cisco Unified Communications Manager to block the display of the connected party phone number.
Connected Name Presentation	Cisco Unified Communications Manager uses connected name presentation (CONP/CONR) as a supplementary service to allow or restrict the called party name on a call-by-call basis.Choose whether you want Cisco Unified Communications Manager to allow or restrict the display of the connected party name on the calling party phone display for this translation pattern.Choose Default if you do not want to change the connected name presentation. Choose Allowed if you want to display the connected party name. Choose Restricted if you want Cisco Unified Communications Manager to block the display of the connected party name.
Called Party Transformations
Discard Digits	Choose the discard digits instructions that you want to be associated with this translation pattern.Note The discard digits that display depend on the numbering plan that you choose from the Numbering Plan drop-down list box.
Called Party Transform Mask	Enter a transformation mask value. Valid entries for the NANP include the digits 0 through 9, and the wildcard characters asterisk (*) and octothorpe (#); the international escape character +; and blank. If the field is blank, no transformation takes place. The dialed digits get sent exactly as dialed.
Prefix Digits (Outgoing Calls)	Enter prefix digits. Valid entries for the NANP include the digits 0 through 9, and the wildcard characters asterisk (*) and octothorpe (#);the international escape character +; and blank.Note The appended prefix digit does not affect which directory numbers route to the assigned device.
Called Party Number Type	Choose the format for the number type in called party directory numbers.Cisco Unified Communications Manager sets the called directory number (DN) type. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because Cisco Unified Communications Manager does not recognize European national dialing patterns. You can also change this setting when you are connecting to a PBX that expects the called directory number to be encoded to a non-national type numbering plan.Choose one of the following options:• Cisco Unified Communications Manager—Use when the Cisco Unified Communications Manager sets the directory number type. • Unknown—Use when the dialing plan is unknown. • National—Use when you are dialing within the dialing plan for your country. • International—Use when you are dialing outside the dialing plan for your country. • Subscriber—Use when you are dialing a subscriber by using a shortened subscriber number.
Called Party Numbering Plan	Choose the format for the numbering plan in called party directory numbers.Cisco Unified Communications Manager sets the called DN numbering plan. Cisco recommends that you do not change the default value unless you have advanced experience with dialing plans such as NANP or the European dialing plan. You may need to change the default in Europe because Cisco Unified Communications Manager does not recognize European national dialing patterns. You can also change this setting when you are connecting to PBXs by using routing as a non-national type number.Choose one of the following options:• Cisco Unified Communications Manager—Use when the Cisco Unified Communications Manager sets the Numbering Plan in the directory number. • ISDN—Use when you are dialing outside the dialing plan for your country. • National Standard—Use when you are dialing within the dialing plan for your country. • Private—Use when you are dialing within a private network. • Unknown—Use when the dialing plan is unknown.

Reference:
1.  Translation Patterns
http://smbitsolutions.wordpress.com/2011/08/15/translation-patterns/