© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-1 Enabling Single-Site On-Net Calling Implementing Cisco Unified Communications Manager Digit Manipulation

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-2 Outline  Cisco Unified Communications Manager Digit Manipulation Cisco Unified Communications Manager Digit Manipulation Flow  Cisco Unified Communications Manager Digit Manipulation Configuration Elements  Cisco Unified Communications Manager External Phone Number Mask  Cisco Unified Communications Manager Digit Prefix and Stripping  Cisco Unified Communications Manager Transformation Masks  Cisco Unified Communications Manager Translation Patterns  Cisco Unified Communications Manager Significant Digits  Cisco Unified Communications Manager Digit Manipulation Summary

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-3 Cisco Unified Communications Manager Digit Manipulation Overview

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-4 Digit Manipulation Cisco IP Phones CCM1-1 SIP 3rd party IP Phone T1/E1 Off-Net Calls Local Gateways PSTN DID: to 1003 How to Manipulate Calling and Called Number?  Expand calling directory number to fully qualified PSTN number  Strip access code 9 dialed internally for PSTN access On-NetOff-Net Calling Called CCM2-1

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-5 Digit Manipulation Requirements RequirementCall TypeHow Expand calling-party directory number to full E.164 PSTN number Internal to PSTN Use calling party’s external phone number mask or calling party transformation in route pattern or route list Strip PSTN access code “9”Internal to PSTN Use Digit Stripping in Route Pattern or Route List Expand abbreviated number (e.g., “0” for operator) Internal to Internal Use Called Party Transformation in Translation Pattern Convert E.164 PSTN called- party directory number to internal number PSTN to Internal Use Called Party Transformation in Translation Pattern, or use Significant Digits Overlapping endpoint directory number Internal to Internal PSTN to Internal Use Called Party Transformation in Translation Pattern

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-6 Cisco Unified Communications Manager Digit Manipulation Flow

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-7 PSTN xx GW is calling Dials: Digit Manipulation Flow Example (Outgoing Call to PSTN) StepDescription 1Extension 1005 dials Dialed number matches 9.! Route pattern configured with the following: – Called party transformations > Discard digits: PreDot – Calling party transformations: XX – Route to GW 3 Unified CM strips off (discards) digit 9 from the dialed number and sends to PSTN via the GW after modifying the calling party number from 1005 to PSTN phone rings and sees as the calling number

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-8 Digit Manipulation Flow Example (Incoming Call from PSTN) StepDescription 1PSTN phone dials , PSTN switch routes the call to GW/Unified CM 2 Incoming call dialed number matches XX translation pattern configured with the following: – Called Party transformation > Called Party Transform Mask: 10XX – (Optional) Calling Party transformation > Prefix Digit: 91 3 – Unified CM translates to 1010 – Unified CM looks up 1010 and finds a registered phone with that directory number 4 Unified CM presents the call to extension It will (optionally, see Step 2) prefix the calling number with 91 to make it easier for the internal user to call back the PSTN caller from IP phone Directory button (no need to manually add 91) PSTN xx GW Dials:

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-9 Cisco Unified Communications Manager Digit Manipulation Configuration Elements

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-10 Digit Manipulation Configuration Elements Digit Manipulation ElementCharacteristics External Phone Number Mask Designates the fully qualified E.164 address for the user extension – Part of Calling/Called Transformation settings. Digit Prefix and Stripping Prefix or strip dialed digits from a route or translation pattern for outbound calls – Part of Calling/Called Transformation settings. Transformation Masks Manipulate the dialed digits or calling party number – Part of Calling/Called Transformation settings. Translation Pattern When dialed digits match the translation pattern, Unified CM performs the translation first and then routes the call again. Make use of the Calling/Called Transformation settings for digit manipulation. Significant Digits Strip off digits received by Unified CM for incoming calls from a PSTN gateway or from a trunk.

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-11 Cisco Unified Communications Manager External Phone Number Mask

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-12 External Phone Number Masks  Designates the fully qualified E.164 address for the user extension  Used to format caller ID information for external (outbound) calls that are made from the internal devices  Configured under Line Configuration settings, but enabled as part of Calling Party Transformations settings.

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-13 Configuring External Phone Number Mask  Go to Device > Phone > Find and select the corresponding phone  Under Association Information, click the corresponding Line  Scroll down to Line x on Device configuration (see picture)  Type full E.164 PSTN number in the External Phone Number Mask field  In the Route Patterns that point to PSTN (e.g. 9.! or scroll to Calling Party Transformations  Check the Use Calling Party's External Phone Number Mask option

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-14 External Phone Number Mask Example StepDescription 1Extension 1005 configured with external phone number mask XX 2 Route pattern 9.! configured with – Calling party transformations: Use Calling Party's External Phone Number Mask option is checked – Discard dialed digit 9, and route to gateway 3 Extension 1005 dials Unified CM replaces calling party number to , strips off 9 from the dialed digits and sends call to PSTN gateway 4PSTN phone rings and sees as the calling number PSTN xx GW is calling Dials:

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-15 Cisco Unified Communications Manager Digit Prefix and Stripping

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-16 Digit Prefix  Prepend digits to the pattern  Valid entries include the digits 0 through 9, *, and #  Part of Calling/Called Transformations settings

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-17 Digit Stripping  Used to strip digits from a pattern  Part of Called Party Transformations settings (Discard Digits field)  A discard digits instruction (DDI) removes a portion of the dialed digit string before passing the number on  If sign (numbering plan) is used in route pattern, only the following DDIs are supported: –PreDot –NoDigits DDI

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-18 Discard Digits Instructions (DDIs) For example, If the pattern is InstructionsDiscarded DigitsUsed for PreDot Removes access code digit(s) delimited by. sign PreAt Removes all digits that are in front of a valid numbering plan pattern Removes PreDot/PreAt digits and local or long-distance area code Removes long distance area code identifier (1) IntlTollBypass # Removes international access (011) and following country code Dialing Removes carrier access (1010) and following carrier ID code Trailing-# # Removes of dialed # sign (to terminate dialing without timeout)

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-19 Using PreDot DDIs PBX Unified CM Match: 9.8XXX Discard: PreDot Called Party: 8123 User Dials: 98123

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-20 Using Compound DDIs Use DDIs to remove carrier selection from dialed number. Carrier selection consists of:  Carrier Access Code: 1010  Carrier Identification Code: 3 digits Match: Discard: PreDot Dialing User Dials: Called Party: Unified CM PSTN

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-21 Cisco Unified Communications Manager Transformation Masks

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-22 Transformation Masks  Modify either the calling number or called number (dialed digits)  Can contain digits 0–9, *, #, and X  Applied to a number to extend or truncate it  Part of Calling/Called Party Transformations settings XXX XXX An X in a mask lets digits pass through Digits in masks replace number digits Blanks block number digits _____ Mask

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-23 Configuring Transformation Masks  Configured under Translation Pattern, Route Pattern, or Route List settings  Transformation masks configured at route list level have priority over those configured at route pattern level

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-24 Cisco Unified Communications Manager Translation Patterns

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-25 Translation Patterns  Very powerful tool to manipulate dialed digits and calling party number for any type of call.  Can be used to either route or block certain patterns.  When the digits match the translation pattern, Cisco Unified Communications Manager does not route the call to an outside entity (e.g., a gateway); instead, it performs the translation first and then routes the call (to another translation pattern or to a route pattern).

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-26 Pattern type? Digits Apply calling and called party transformations Extend call to destination Route pattern Digits Find best match Pattern type? Translation pattern Translation Patterns (Cont.)

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-27  Go to Call Routing > Translation Pattern > Add New  Enter the Translation Pattern, including numbers and wildcards (do not use spaces)  Choose a Partition and CSS (to be discussed in the next module) or choose  Choose the Route Option to indicate this pattern is to be used for routing or for blocking calls (the “blocking” option provides similar functionality as in the Route Pattern configuration)  Specify the Calling/Called Party Transformation settings (applicable only if “Route the pattern” is selected above) Pattern Route option Transformation settings Configuring Translation Pattern

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-28 Employee Phones Attendant (4111) San Jose Internal Extensions 4XXX PSTN DID Range XXX PSTN DID range does not match internal range Translation Pattern = XXX Called-Party Transform Mask = 4XXX Send calls to unassigned DID numbers to attendant (operator) Translation Pattern = XXXX Called Party Transform Mask = 4111 Unified CM uses longest match, so XXXX will match any nonconfigured number and get sent to 4111 (attendant). Translation Pattern Example PSTN

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-29 Cisco Unified Communications Manager Significant Digits

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-30 Significant Digits  Instruct Cisco Unified Communications Manager to pay attention to only the least-significant N digits of the called number for incoming calls from PSTN or from another Cisco Unified Communications Manager cluster  Part of gateway and trunk configuration  Affects all incoming calls received by the gateway or trunk; not recommended for variable-length extension numbers

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-31 Configuring Significant Digits  Go to Gateway or Trunk Configuration > Call Routing Information – Inbound Calls  In the Significant Digits field, specify the last N digits of the called number that you want Cisco Unified Communications Manager to process for inbound calls received by the gateway or trunk

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-32 Significant Digits Example StepDescription 1PSTN phone dials PSTN switch routes the call to gateway. 2 PSTN gateway device configured with the following: – Significant Digits = 4 3 Cisco Unified Communications Manager will ignore all but the last 4 digits of the called number (1010). 4 Cisco Unified Communications Manager looks up 1010 and finds a registered phone with that directory number and presents the call to extension PSTN xx Dials: GW

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-33 Cisco Unified Communications Manager Digit Manipulation Summary

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-34 Transformation Settings  Calling Party Transformations control the adaptation of calling party numbers from enterprise format to PSTN format  Called Party Transformations manipulate the dialed digits, Number Type, and Numbering Plan.

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-35 Calling Party Transformation Order 40885XX000 1.Apply the external phone number mask 2.Apply the calling party transformation mask 3.Apply prefix digits XXXXX 40885XX Directory Number External Phone Number Mask Calling-Party Transformation Mask Caller ID √

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-36 Called Party Transformation Order 1.Apply discard digits 2.Apply the called-party transformation mask 3.Apply prefix digits Dialing XXXXXXXXXX Dialed Number Discard Digits Called-Party Transformation Mask Prefix Digits Called Number

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-37 Route PatternDDI Transform Calling Number Transform Called Number User Dial Numbers Users 9.1XXX A B C A B C Discard “9” Wildcards allow all dialed numbers to match one route pattern User Dialed Numbers A – 1234 B – 1324 C – 1432 “X000” User Directory Numbers A – 5000 B – 5000 C – 5000 “X000” User Dialed Numbers Caller ID A – 1000 B – 1000 C – 1000 To: 1000 From: 5000 Extension 1000 Rings Transformation Example

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-38 Summary  In many call scenarios, it is required to manipulate the calling and called (dialed) string before routing the call.  Cisco Unified Communications Manager digit manipulation configuration main elements are: External Phone Number Mask, Digit Prefix and Stripping, Transformation Masks, Translation Pattern, and Significant Digits.  Cisco Unified Communications Manager External Phone Number Mask designates the fully qualified E.164 address for the user’s extension and is used to format Caller-ID information for outbound calls from the internal devices.

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-39 Summary (Cont.)  Digit Prefix prepends digits to a pattern, Digit Stripping strips digits from a pattern.  Transformation Masks modify either the calling number or the called number (dialed digits).  Translation Pattern can be used to either route or block certain patterns. When the digits match the translation pattern, Cisco Unified Communications Manager performs the translation first before routing the call to another translation pattern or to a route pattern.  Significant Digits instruct Cisco Unified Communications Manager to pay attention to only the least-significant N digits of the called number for incoming calls from PSTN or from another Cisco Unified Communications Manager cluster.

© 2008 Cisco Systems, Inc. All rights reserved.CIPT1 v6.0—4-40