Voice Translation RulesDocument ID:

Voice Translation Rules

Document ID: 61083

Contents

Introduction
Prerequisites
Requirements
Components Used
Conventions
Simple Match and Replace
Pattern Match with Wildcards
Number Slice
Number Type and Plan
Reject Calls
Apply Rules
More Examples
Truncate Numbers Down to the Last Two Digits
Remove Unwanted Digits in a Number
Related Information
Introduction

This document discusses how to define voice translation rules.

Note: The syntax used throughout this document is:

•rule precedence /match pattern/ /replacement pattern/

Note: / −− / delimits the whole number.

Prerequisites

Requirements

There are no specific requirements for this document.

Components Used

This document is not restricted to specific software and hardware versions.

Conventions

Refer to Cisco Technical Tips Conventions for more information on document conventions.

Simple Match and Replace

Example 1

This example replaces the first occurrence of the number "123" with "456".

voice translation−rule 1
rule 1 /123/ /456/

These are test voice translation−rule examples:

router#test voice translation−rule 1 123
Matched with rule 1
Original number: 123 Translated number: 456

router#test voice translation−rule 1 1234
Matched with rule 1
Original number: 1234 Translated number: 4564

router#test voice translation−rule 1 6123
Matched with rule 1
Original number: 6123 Translated number: 6456

router#test voice translation−rule 1 6123123
Matched with rule 1
Original number: 6123123 Translated number: 6456123
Original number type: none Translated number type: none
Original number plan: none Translated number plan: none

In this example, the rule matches the first occurrence of the number that contains the pattern "123" anywhere
in the number. Specifically, you can use the start and end of number indicators. The Example 2 and Example
3 sections show this.

Example 2

This example shows how to replace any occurrence of "123" at the start of a number with "456".

voice translation−rule 1
rule 1 /^123/ /456/

These are test voice translation−rule examples.

router#test voice translation−rule 1 123
Matched with rule 1
Original number: 123 Translated number: 456

router#test voice translation−rule 1 1234
Matched with rule 1
Original number: 1234 Translated number: 4564

router#test voice translation−rule 1 6123
6123 Didn't match with any of rules

Example 3

If you want only the match of an exact number, specify both the start and end number indicators:

voice translation−rule 1
rule 1 /^123$/ /456/

router#test voice translation−rule 1 123
Matched with rule 1
Original number: 123 Translated number: 456


router#test voice translation−rule 1 1234
1234 Didn't match with any of rules

router#test voice translation−rule 1 6123
6123 Didn't match with any of rules

Pattern Match with Wildcards

These tables define wildcard and wildcard combinations and show some examples.

Wildcard
Definition
.
Any single digit
0 to 9,*,#
Any specific character
[0−9]
Any range or sequence of characters
*
Modifiermatch none or more occurrences
+
Modifiermatch one or more occurrences
?
Modifiermatch none or one occurrence
Wildcard
Combination


.*



.+


^$

Example 1

Definition
Any digit followed by none or more
ocurrences. This is effectively anything,
including null.
Any digit followed by one or more
ocurrences. This is effectively anything,
except null.

No digits, null


This example replaces any five−digit number that begins with "40" with the number "6666000".

voice translation−rule 1
rule 1 /^40.../ /6666000/

router#test voice translation−rule 1 40123
Matched with rule 1
Original number: 40123 Translated number: 6666000

Example 2

This example replaces all numbers with "5554000".

voice translation−rule 2
rule 1 /.*/ /5554000/

router#test voice translation−rule 2 123
Matched with rule 1
Original number: 123 Translated number: 5554000

router#test voice translation−rule 2 86573


Matched with rule 1
Original number: 86573 Translated number: 5554000

router#test voice translation−rule 2 ""
Matched with rule 1
Original number: Translated number: 5554000

Example 3

This example replaces all numbers, except null, with "5554000".

voice translation−rule 2
rule 1 /.+/ /5554000/

router#test voice translation−rule 2 123
Matched with rule 1
Original number: 123 Translated number: 5554000

router#test voice translation−rule 2 ""
Didn't match with any of rules

Example 4

This example replaces any number that starts with a combination of zeros (0, 00, and so forth) with "909".

voice translation−rule 5
rule 1 /^0+/ /909/

router#test voice translation−rule 5 0123456
Matched with rule 1
Original number: 0123456 Translated number: 909123456

router#test voice translation−rule 5 00123456
Matched with rule 1
Original number: 00123456 Translated number: 909123456

router#test voice translation−rule 5 000123456
Matched with rule 1
Original number: 000123456 Translated number: 909123456

router#test voice translation−rule 5 123456
123456 Didn't match with any of rules

Number Slice

You can use number slice when you need to copy parts of a matched number across to the replacement
number. You slice the matched number into sets that you can keep or ignore.

Character
Description







( )

In the match pattern, indicates where to slice up the
number.
In the replacement pattern, indicates where to copy
the sets to keep.
Indicates which sets in the matched number to
keep.



Character Usage



Description


(a)
b
1


Keep expression "a".
Ignore expression "b".
Copy the first set into the replacement
number.


Generic Example

This example provides a general explanation.

/ (x) y (z) / /w12/

Split the matched number into three sets of x, y, and z. The backward slash () indicates the places to slice up
the number. The brackets () indicate which sets you want to reuse in the replacement pattern. The w represents
additional digits to insert into the replacement number.

•Set 1 becomes expression x.
•Set 2 becomes expression z.
•Expression y is ignored.

The replacement number is a concatenated number: wxz.

Specific Example

This example provides further detail:

voice translation−rule 1
rule 1 /^(12)3(45)$/ /612/

•Set 1: 12
•Set 2: 45
•Ignore: 3

router#test voice translation−rule 1 12345
Matched with rule 1
Original number: 12345 Translated number: 61245

Number Type and Plan

You can restrict matches to particular number or plan types. Also, you can alter the replacement plan or type.

Example 1

In this example, if a number starts with "4" and the type is "national", the rule adds "90" as a prefix. If the
type is "international", the rule adds "900" as the prefix.

voice translation−rule 7
rule 1 /^4/ /904/ type national national
rule 2 /^4/ /9004/ type international international

router#test voice translation−rule 7 493456567 type national
Matched with rule 1
Original number: 493456567 Translated number: 90493456567
Original number type: national Translated number type: national
Original number plan: none Translated number plan: none


router#test voice translation−rule 7 493456567 type international
Matched with rule 2
Original number: 493456567 Translated number: 900493456567
Original number type: international Translated number type: international
Original number plan: none Translated number plan: none

This is useful when telephone companies (Telcos) remove access codes on national and international
numbers. You can add the correct prefix with the number type as a basis.

Example 2

This example changes the number type and plan.

voice translation−rule 8
rule 1 /^2(...$)/ /017793451/ type unknown national plan unknown isdn

This rule matches any four−digit number that starts with "2". The rule removes the "2", adds the number
"01779345" as a prefix, and sets the plan to "isdn" and the type to "national".

router#test voice translation−rule 8 2001 type unknown plan unknown
Matched with rule 1
Original number: 2001 Translated number: 01779345001
Original number type: unknown Translated number type: national
Original number plan: unknown Translated number plan: isdn

Reject Calls

Use the reject keyword to reject calls that match. This example rejects all calls that start with "234".

rule 1 reject /^234/

router#test voice translation−rule 10 1234
1234 Didn't match with any of rules

router#test voice translation−rule 10 2345
blocked on rule 1

Apply Rules

Voice Translation Rules are applied to Voice Translation Profiles. These profiles are then applied to dial peers
or voice ports. Profiles can be applied to VoIP or POTS dial peers or voice ports, and can be applied to
inbound or outbound calls. A profile can translate Called, Calling, or Redirecting numbers.

voice translation−rule 3
rule 1 /123/ /456/

voice translation−profile profile1
translate calling 3

dial−peer voice 10 pots
translation−profile outgoing profile1

More Examples

Truncate Numbers Down to the Last Two Digits

rule 1 /^.*(..)/ /1/

This is a number divided into one set and one ignored statement.

•Ignored: ^.* None or more digits from the beginning of number

Set 1: .. two digits

The replacement statement specifies Set 1. This rule copies the last two digits of the number.

router#test voice translation−rule 9 12345
Matched with rule 1
Original number: 12345 Translated number: 45

router#test voice translation−rule 9 123456
Matched with rule 1
Original number: 123456 Translated number: 56

Remove Unwanted Digits in a Number

This example is useful because certain Telcos have been known to insert hypens into calling party numbers.
Since this is against standards, it causes the calling party number to be ignored. The Telco sends the calling
numbers in two formats, with one hypen and sometimes with two. Two

Kết quả (Việt) 1:

Giọng nói dịch quy tắcTài liệu ID: 61083Nội dungGiới thiệu Điều kiện tiên quyết Yêu cầu Thành phần được sử dụng Công ước Đơn giản phù hợp và thay thế Mô hình phù hợp với ký tự đại diện Số lát Số loại và kế hoạch Từ chối cuộc gọi Áp dụng quy tắc Ví dụ khác Truncate số xuống cuối hai chữ số Loại bỏ chữ số không mong muốn trong một số Thông tin liên quanGiới thiệuTài liệu này thảo luận về làm thế nào để xác định giọng nói dịch quy tắc.Lưu ý: Cú pháp được sử dụng trong tài liệu này là:•Rule ưu tiên /match mẫu / mô hình /replacement /Lưu ý: / −− / delimits số nguyên.Điều kiện tiên quyếtYêu cầuKhông có không có yêu cầu cụ thể cho tài liệu này.Thành phần được sử dụngTài liệu này không phải là giới hạn phiên bản phần cứng và phần mềm cụ thể.Công ướcTham khảo Cisco kỹ thuật Mẹo quy ước cho thêm thông tin về tài liệu quy ước.Đơn giản phù hợp và thay thế Ví dụ 1Ví dụ này thay thế sự xuất hiện đầu tiên của số "123" với "456".tiếng nói translation−rule 1 quy tắc 1 /123/ /456/Đây là thử nghiệm bằng giọng nói translation−rule ví dụ:bộ định tuyến #test thoại translation−rule 1 123Phù hợp với quy tắc 1Ban đầu số: 123 dịch số: 456bộ định tuyến #test thoại translation−rule 1 1234Phù hợp với quy tắc 1Ban đầu số: 1234 dịch số: 4564bộ định tuyến #test thoại translation−rule 1 6123Phù hợp với quy tắc 1Ban đầu số: 6123 dịch số: 6456bộ định tuyến #test thoại translation−rule 1 6123123Phù hợp với quy tắc 1Ban đầu số: 6123123 dịch số: 6456123Ban đầu số loại: không có dịch số loại: không cóKế hoạch số ban đầu: không có kế hoạch số dịch: không cóTrong ví dụ này, quy tắc phù hợp với sự xuất hiện đầu tiên của số có chứa mẫu "123" bất cứ nơi nàotrong số. Cụ thể, bạn có thể sử dụng sự bắt đầu và kết thúc của số chỉ số. Ví dụ 2 và ví dụ3 phần Hiển thị này.Ví dụ 2Ví dụ này cho thấy làm thế nào để thay thế bất kỳ sự xuất hiện của "123" lúc bắt đầu của một số với "456".tiếng nói translation−rule 1 quy tắc 1 / ^ 123 / /456/Đây là thử nghiệm bằng giọng nói translation−rule ví dụ.bộ định tuyến #test thoại translation−rule 1 123Phù hợp với quy tắc 1Ban đầu số: 123 dịch số: 456bộ định tuyến #test thoại translation−rule 1 1234Phù hợp với quy tắc 1Ban đầu số: 1234 dịch số: 4564bộ định tuyến #test thoại translation−rule 1 61236123 không phù hợp với bất kỳ quy tắcVí dụ 3Nếu bạn muốn chỉ phù hợp với một số chính xác, xác định cả hai các bắt đầu và kết thúc số chỉ số:tiếng nói translation−rule 1 quy tắc 1 / ^ 123$ / /456/bộ định tuyến #test thoại translation−rule 1 123Phù hợp với quy tắc 1Ban đầu số: 123 dịch số: 456 bộ định tuyến #test thoại translation−rule 1 12341234 không phù hợp với bất kỳ quy tắcbộ định tuyến #test thoại translation−rule 1 61236123 không phù hợp với bất kỳ quy tắcMô hình phù hợp với ký tự đại diệnCác bảng xác định ký tự đại diện và kết hợp ký tự đại diện và hiển thị một số ví dụ.Ký tự đại diệnĐịnh nghĩa.Bất kỳ chữ số duy nhất0-9, *, #Bất kỳ nhân vật cụ thể[0−9]Bất kỳ phạm vi hoặc chuỗi ký tự*Modifiermatch không có hoặc thêm các sự kiện+Modifiermatch một hoặc nhiều mục lặp lại?Modifiermatch không có hoặc một lầnKý tự đại diệnKết hợp .*.+^$Ví dụ 1 Định nghĩaBất kỳ chữ số theo sau là không có hoặc nhiều hơnocurrences. Điều này là có hiệu quả bất cứ điều gì,bao gồm cả null.Bất kỳ chữ số theo sau là một hoặc nhiềuocurrences. Điều này là có hiệu quả bất cứ điều gì,Ngoại trừ null.Không có chữ số, null Ví dụ này thay thế bất kỳ five−digit số bắt đầu với "40" với số lượng "6666000".tiếng nói translation−rule 1 quy tắc 1 / ^ 40... / /6666000/bộ định tuyến #test thoại translation−rule 1 40123Phù hợp với quy tắc 1Ban đầu số: 40123 dịch số: 6666000Ví dụ 2Ví dụ này thay thế tất cả các số với "5554000".tiếng nói translation−rule 2 quy tắc 1 /. * / /5554000/bộ định tuyến #test thoại translation−rule 2 123Phù hợp với quy tắc 1Ban đầu số: 123 dịch số: 5554000bộ định tuyến #test thoại translation−rule 2 86573 Phù hợp với quy tắc 1Ban đầu số: 86573 dịch số: 5554000bộ định tuyến #test thoại translation−rule 2 ""Phù hợp với quy tắc 1Ban đầu số: dịch số: 5554000Ví dụ 3Ví dụ này thay thế tất cả các số, ngoại trừ null, với "5554000".tiếng nói translation−rule 2 quy tắc 1 /. / /5554000/bộ định tuyến #test thoại translation−rule 2 123Phù hợp với quy tắc 1Ban đầu số: 123 dịch số: 5554000bộ định tuyến #test thoại translation−rule 2 "" Không phù hợp với bất kỳ quy tắcVí dụ 4Ví dụ này thay thế bất kỳ số nào bắt đầu với một sự kết hợp của zeros (0, 00, và vv) với "909".tiếng nói translation−rule 5 quy tắc 1 / ^ 0 / /909/bộ định tuyến #test thoại translation−rule 5 0123456Phù hợp với quy tắc 1Ban đầu số: 0123456 dịch số: 909123456bộ định tuyến #test thoại translation−rule 5 00123456Phù hợp với quy tắc 1Ban đầu số: 00123456 dịch số: 909123456bộ định tuyến #test thoại translation−rule 5 000123456Phù hợp với quy tắc 1Ban đầu số: 000123456 dịch số: 909123456bộ định tuyến #test thoại translation−rule 5 123456123456 không phù hợp với bất kỳ quy tắcSố látBạn có thể sử dụng số lát khi bạn cần phải sao chép một phần của một số lần xuất hiện trên để thay thếsố. Bạn cắt số phù hợp vào bộ bạn có thể giữ hoặc bỏ qua.Nhân vậtMô tả \( ) Trong mô hình phù hợp, chỉ ra nơi để cắt cácsố.Trong mô hình thay thế, chỉ ra nơi để sao chépbộ để tiếp tục.Chỉ ra mà bộ trong số phù hợp đểgiữ. Sử dụng ký tự Mô tả (a)b\1 Giữ cho biểu hiện "a".Bỏ qua các biểu hiện "b".Sao chép các thiết lập đầu tiên vào thay thếsố. Ví dụ chungVí dụ này cung cấp một lời giải thích chung./ (x) y (z) / / w12 / Phân chia số phù hợp vào bộ ba của x, y, và z. Dấu gạch chéo ngược () cho thấy những nơi để lát lênsố. Các dấu ngoặc () cho biết mà bạn muốn sử dụng lại trong các mô hình thay thế. Đại diện cho wThêm chữ số để chèn vào số thay thế.•Set 1 trở thành biểu hiện x.•Set 2 trở thành biểu hiện z.•Expression y được bỏ qua.Thay thế số là một số nhiều: wxz.Ví dụ cụ thểVí dụ này cung cấp thêm chi tiết:tiếng nói translation−rule 1 quy tắc 1 / ^ (12)3(45)$ / / 612 /•Set 1:12•Set 2:45•Ignore: 3bộ định tuyến #test thoại translation−rule 1 12345Phù hợp với quy tắc 1Ban đầu số: 12345 dịch số: 61245Số loại và kế hoạchBạn có thể hạn chế kết quả phù hợp để loại số hoặc kế hoạch cụ thể. Ngoài ra, bạn có thể thay đổi các kế hoạch thay thế hoặc loại.Ví dụ 1Trong ví dụ này, nếu một số bắt đầu với "4" và loại là "quốc gia", các quy tắc cho biết thêm "90" như là một tiền tố. Nếu cácloại là "quốc tế", các quy tắc cho biết thêm "900" như tiền tố.tiếng nói translation−rule 7 quy tắc 1 / ^ 4 / /904/ nhập quốc gia quốc gia cai trị 2 / ^ 4 / /9004/ gõ quốc tế quốc tếbộ định tuyến #test thoại translation−rule 7 493456567 loại quốc giaPhù hợp với quy tắc 1Ban đầu số: 493456567 dịch số: 90493456567Ban đầu số loại: quốc gia dịch loaïi soá: quốc giaKế hoạch số ban đầu: không có kế hoạch số dịch: không có bộ định tuyến #test thoại translation−rule 7 493456567 loại quốc tếPhù hợp với quy tắc 2Ban đầu số: 493456567 dịch số: 900493456567Ban đầu số loại: quốc tế dịch loaïi soá: quốc tếKế hoạch số ban đầu: không có kế hoạch số dịch: không cóĐiều này là hữu ích khi công ty điện thoại (Telcos) loại bỏ mã truy cập vào quốc gia và quốc tếsố điện thoại. Bạn có thể thêm tiền tố chính xác với loaïi soá làm cơ sở.Ví dụ 2Ví dụ này thay đổi các loại số và kế hoạch.tiếng nói translation−rule 8 quy tắc 1 / ^ 2(...$) / / 017793451/loại quốc gia không biết kế hoạch không rõ isdnQuy tắc này phù hợp với bất kỳ four−digit số mà bắt đầu với "2". Các quy tắc loại bỏ "2", cho biết thêm số"01779345" như là một tiền tố, và thiết lập kế hoạch để "isdn" và kiểu "quốc gia".bộ định tuyến #test thoại translation−rule 8 năm 2001 loại không biết kế hoạch không rõPhù hợp với quy tắc 1Ban đầu số: 2001 dịch số: 01779345001Ban đầu số loại: chưa biết dịch loaïi soá: quốc giaKế hoạch ban đầu số: không biết kế hoạch số dịch: isdnTừ chối cuộc gọiSử dụng từ khóa từ chối để từ chối cuộc gọi phù hợp với. Ví dụ này từ chối tất cả cuộc gọi đó bắt đầu với "234".cai trị từ chối 1 / ^ 234 /bộ định tuyến #test thoại translation−rule 10 12341234 không phù hợp với bất kỳ quy tắcbộ định tuyến #test thoại translation−rule 10 2345 bị chặn trên quy tắc 1Áp dụng quy tắcGiọng nói dịch quy tắc được áp dụng cho giọng nói dịch hồ sơ. Những hồ sơ này sau đó được áp dụng để quay số đồng nghiệphoặc cổng thoại. Cấu hình có thể được áp dụng cho VoIP hoặc chậu quay số đồng nghiệp hoặc cổng thoại, và có thể được áp dụng chocuộc gọi trong nước hoặc nước ngoài. Một hồ sơ có thể dịch Called, gọi điện thoại, hoặc chuyển hướng số.tiếng nói translation−rule 3 quy tắc 1 /123/ /456/tiếng nói translation−profile profile1 Dịch gọi 3Dial−peer thoại 10 chậu Translation−Profile đi profile1Ví dụ khác Truncate số xuống cuối hai chữ sốquy tắc 1 / ^. * (...)/ /1/Đây là một số chia thành một tập hợp và một trong những bỏ qua tuyên bố.•Ignored: ^. * không có hoặc thêm chữ số từ đầu sốĐặt 1:... hai chữ sốTuyên bố thay thế chỉ định thiết lập 1. Quy tắc này sao cuối hai chữ số của số.bộ định tuyến #test thoại translation−rule 9 12345Phù hợp với quy tắc 1Ban đầu số: 12345 dịch số: 45bộ định tuyến #test thoại translation−rule 9 123456Phù hợp với quy tắc 1Ban đầu số: 123456 dịch số: 56Loại bỏ chữ số không mong muốn trong một sốVí dụ này rất hữu ích vì Telcos nhất định đã được biết đến để chèn hypens vào gọi số điện thoại bên.Do đây là chống lại tiêu chuẩn, nó gây ra số bên kêu gọi để được bỏ qua. Viễn thông gửi các cuộc gọisố điện thoại trong hai định dạng, với một hypen và đôi khi với hai. Hai