[This is pre-release documentation and subject to change in future releases. This topic's current status is: Milestone-Ready]

Topic Last Modified: 2010-07-05

Follow the steps below if you want to define a translation rule by entering a set of values in the Build a Translation Rule tool and allowing Communications Server Control Panel to generate the corresponding matching pattern and translation rule for you. Alternatively, you can a write regular expression manually to define the matching pattern and translation rule. For more information, see Create or Modify a Translation Rule Manually.

Important:
To begin defining a translation rule, follow the procedure to create or edit a trunk configuration, and create or edit a translation rule as explained in those procedures. For more information, see Configure Media Bypass on a Trunk or Configure a Trunk Without Media Bypass.

To define a rule by using the Build a Translation Rule tool

  1. In the Name field on the New Translation Rule or Edit Translation Rule dialog box, type a name that describes the number pattern being translated.

  2. (Optional) In Description field, type a description of the translation rule, for example US International long-distance dialing.

  3. In the Build a Translation Rule section of the dialog box, enter values in the following fields:

    • Starting digits: You can optionally specify the leading digits of numbers you want the pattern to match. For example, enter + in this field to match numbers in E.164 format (which begin with +).

    • Length: Specify the number of digits in the matching pattern and select whether you want the pattern to match numbers that are this length exactly, at least this length, or any length. For example, enter 11 and select At least in the drop-down list to match numbers that are at least 11 digits in length.

    • Digits to remove: You can optionally specify the number of starting digits to be removed. For example, enter 1 to strip out the + from the beginning of the number.

    • Digits to add: You can optionally specify digits to be prepended to the translated numbers. For example, enter 011 if you want 011 to be prepended to the translated numbers when the rule is applied.

    The values you enter in these fields are reflected in the Pattern to match and Translation rule fields. For example, if you specify the example values shown above, the resulting regular expression in the Pattern to match field is:

    ^\+(\d{9}\d+)$

    The Translation rule field specifies a pattern for the format of translated numbers. This pattern has two parts:

    • A value (for example, $1) that represents the number of digits in the matching pattern

    • A value you can optionally prepend by entering it in the Digits to add field

    Using the example values shown above, 011$1 appears in the Translation rule field.

    When this translation rule is applied, +441235551010 becomes 011441235551010.

  4. Click OK to save the translation rule.

  5. Click OK to save the trunk configuration.

Any time you create or modify a translation rule, you must run the Commit All command to publish the configuration change. For more information, see Publish Pending Changes to the Voice Routing Configuration.

If you are in the process of defining a translation rule for a new trunk connection that enables media bypass, continue configuring media bypass by choosing between Global Media Bypass Options.

See Also