Bulk Administration Tool User Guide, Release 4.2(1)
Working with Phones, CTI Ports, and User Combinations
Downloads: This chapterpdf (PDF - 313.0KB) The complete bookPDF (PDF - 1.52MB) | Feedback

Working with Phones, CTI Ports, and User Combinations

Table Of Contents

Working with Phones, CTI Ports, and User Combinations

Adding Phones or CTI Ports

Creating a BAT Phone Template

Adding or Updating Lines to a BAT Phone Template

Adding or Updating Services to a BAT Phone Template

Adding or Updating Speed Dials to a BAT Phone Template

Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users

Understanding the BAT.xlt File

Creating a CSV File for Phones, Phones/Users, CTI Ports-Users, or CTI Ports Using BAT.xlt

Creating a Text-Based CSV Text File

Adding Phones or CTI Ports to Cisco CallManager

Adding Phones and Users or CTI Ports and Users to Cisco CallManager

Copying a BAT Phone Template

Updating Phone Records

Updating Lines

Viewing a List of Phones with Dummy MAC Addresses

Deleting Phones

Deleting Templates

Field Descriptions

Field Descriptions for Adding a BAT Phone Template

Field Descriptions for Adding a Line to a BAT Phone Template


Working with Phones, CTI Ports, and User Combinations


BAT helps you bulk-add, bulk-update, or bulk-delete large numbers of phones, CTI ports, and user combinations such as phones and users or CTI ports and users.

Related Topics

Adding Phones or CTI Ports

Creating a BAT Phone Template

Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users

Adding Phones or CTI Ports to Cisco CallManager

Adding Phones and Users or CTI Ports and Users to Cisco CallManager

Viewing a List of Phones with Dummy MAC Addresses

Updating Phone Records

Deleting Phones

Deleting Templates

Field Descriptions

Adding Phones or CTI Ports

You can use BAT to add Cisco IP Phones to the Cisco CallManager database in batches, rather than individually.

BAT can also associate the phones to existing users. BAT also allows you to "Enable CTI Application Use" while associating CTI ports to existing users. This ability proves useful if you are adding users who will have applications that require a CTI port, such as Cisco IP SoftPhone.

To add phones to the Cisco CallManager database in bulk, you must perform these steps:

1. Create a BAT phone template to define common values for a set of phones. You can specify services, speed dials, and lines.

2. Create a comma separated values (CSV) file to define individual values for each phone you want to add. We recommend you create the CSV file using the Excel file, BAT.xlt.

3. Insert the BAT template and CSV file to add the phones or phone/user combination to the Cisco CallManager database.

4. Plug in the phones and apply power.

5. (Optional) Update the phones using TAPS if you created dummy MAC addresses in the CSV file. You must make sure auto-registration is enabled in Cisco CallManager to use this feature.

Related Topics

Chapter 6, "Working with TAPS"

Creating a BAT Phone Template

Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users

Adding Phones or CTI Ports to Cisco CallManager

Adding Phones and Users or CTI Ports and Users to Cisco CallManager

Creating a BAT Phone Template

The BAT phone template and CSV file work together in bulk transactions. Based on the type of phone you want to add in a batch, you can create a template that has features that are common to all the phones in that batch, such as model, device pool, and so on. The system stores these templates, so they are reusable for future bulk transactions. For example, you can configure a template for the Cisco IP Phone 7960 with two lines and another Cisco IP Phone 7960 template with four lines configured. Then when you need to add a large number of phones with the same configuration, you can reuse the existing template.

The CSV file stores the details for each individual phone, such as its MAC address, description, and so on. See "Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users" section for more details about CSV files. Because you customize CSV files for each bulk transaction, you are less likely to reuse them than BAT templates.

You create a phone template by specifying values in the phone template fields. You can also specify lines attributes, Cisco IP Phone services, and speed dials, if applicable. The phone settings for the BAT phone template require similar values to those you enter when adding a phone in Cisco CallManager Administration. However, you must use the BAT phone template when performing bulk operations in BAT.

Prerequisite

Make sure phone settings such as device pool, location, calling search space, and button template have already been configured in Cisco CallManager Administration prior to creating the template. You cannot create new settings in BAT.

To create the phone template, perform the following steps. You can then add lines, services, and speed dials. If you have already created the template but did not add lines, skip to Adding or Updating Lines to a BAT Phone Template.

Procedure


Step 1 Start BAT. (See Starting BAT, page 1-4 for complete information about how to start BAT.)

Step 2 Click Configure > Template > Phone.

Step 3 In the Device Information area, enter the settings for the phone model for which you are creating the template. See Field Descriptions for Adding a Phone Template, for more information.

Step 4 Click Insert to create the BAT phone template.

Step 5 Click Insert.

If an insert was not successful, you can view details about the insert attempt in the log file.

Step 6 Once the status indicates the insert completed, scroll down the page to the Line Details area to add line attributes, if applicable. If the phone template you created does not have any lines, then you have successfully created the template and do not need to complete the remaining step.

If the template does have lines, skip to Step 4 in the "Adding or Updating Lines to a BAT Phone Template" section.\


Related Topics

Adding or Updating Lines to a BAT Phone Template

Adding or Updating Services to a BAT Phone Template

Adding or Updating Speed Dials to a BAT Phone Template

Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users

Copying a BAT Phone Template

Adding or Updating Lines to a BAT Phone Template

You can add one or more lines to the phones in the BAT template, or update existing lines, by following this procedure. The button template in use for this BAT template determines number of lines you can add or update.

Procedure


Step 1 Start BAT. (See Starting BAT, page 1-4 for complete information about how to start BAT.)

Step 2 Click Configure > Template > Phone.

Step 3 From the list of templates, choose the template for which you want to add line(s).

Step 4 Scroll down to the bottom of the template and click Add Line.

A popup window displays.


Note The maximum number of lines that appear for a BAT template depends on which model and button template you chose when creating the BAT phone template.


Step 5 Enter or choose the appropriate values for the line settings described in Field Descriptions for Adding a Line to a BAT Phone Template. Remember that the settings that you choose here will be used by all phones in this batch for this line. All fields are optional.

Step 6 Click Insert and Close.

BAT inserts the line settings to the database, and the popup window closes.

Step 7 Repeat Steps 4 through 6 to add settings for any additional lines.

Step 8 If you want to add Cisco IP Phone services to the template (Cisco IP Phone models 7960 and 7940 only), skip to Step 4 in the "Adding or Updating Services to a BAT Phone Template" section.


Adding or Updating Services to a BAT Phone Template

You can subscribe Cisco IP Phone services to the phones. Only Cisco IP Phone models 7960 and 7940 include this feature.


Step 1 Start BAT. (See Starting BAT, page 1-4 for complete information about how to start BAT.)

Step 2 Click Configure > Template > Phone.

Step 3 From the list of templates, choose the template for which you want to add service(s).

Step 4 Click Update Services in upper, right corner of the window.

A popup window displays. In this window, you can subscribe to Cisco IP Phone services. Only for Cisco IP Phone models 7960 and 7940 provide services.

Step 5 In the Select a Service box, choose a service to which you want all phones to be subscribed. The Service Description box displays details about the service you selected.

Step 6 Click Continue.

Step 7 Repeat Steps5 and 6 to set speed dials for any Expansion Modules, if applicable.

Step 8 In the Service Name field, you can modify the name of the service, if desired.

Step 9 Click Subscribe to subscribe all phones to this service.

Step 10 Repeat Steps 5 through 8 to add more services.

Step 11 Close the popup window.

Step 12 If you want to add speed dials to the template, skip to Step 4 in the "Adding or Updating Speed Dials to a BAT Phone Template" section.


Adding or Updating Speed Dials to a BAT Phone Template

You can designate speed dials for the phones if the Phone Button Template has provided speed dial buttons.


Step 1 Start BAT. (See Starting BAT, page 1-4 for complete information about how to start BAT.)

Step 2 Click Configure > Template > Phone.

Step 3 From the list of templates, choose the template for which you want to add speed dial(s).

Step 4 Click Update Speed Dial Buttons in the upper, right corner of the window.

A pop-up window displays. In this window, you can designate speed dial buttons for base Cisco IP Phones and expansion modules. The number of speed dial buttons available for this template depends on the Phone Button Template in use for this BAT template. Expansion module sections do not display for phone models other than 7960 and 7940.

Step 5 In the Speed Dial Settings for Base Phone area, enter the number in the Speed Dial Number fields, including any access or long distance codes.

Step 6 In the Speed Dial Label fields, enter a corresponding label for each speed dial number you entered.

Step 7 Repeat Steps 5 and 6 to set speed dials for any Expansion Modules, if applicable (Cisco IP Phone 7960 templates only).

Step 8 Click Update and Close.

BAT inserts the speed dial buttons to the database, and the popup window closes.


Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users

The CSV file for phones or CTI ports contains information about each phone or port as a record. Make sure all phones in a CSV file are the same model and have the same number of configured lines. For CTI ports, enter device names instead of MAC addresses. You can also enable CTI applications while associating a new CTI port to an existing user.

You can associate the phones to an existing user. To associate more than one phone to an existing user, you need to write the required information in separate records. For example, to associate two new Cisco IP Phone 7960s to an existing user, you need to write two records in the CSV file, one for each Cisco IP Phone 7960 but each with the same user ID.

The CSV file contains duplicates of some of the values from the BAT template. Values in the CSV file override any values set in the BAT phone template. For example, you can set speed dial buttons and labels in the BAT phone template, as well as in the CSV file. This override feature allows for special configuration in some cases. For example, if you want most of the phones in the bulk-add transaction to be redirected to voice mail, you can set the Call Forward Busy and Call Forward No Answer fields to the voice mail number. But for a few phones in the bulk-add transaction, you want the calls to be redirected to a secretary instead of voice mail; for only those phones, you can specify the secretary's directory number in the Call Forward Busy (CFB) and Call Forward No Answer (CFNA) fields in the CSV file. This allows most of the phones to use the CFB and CFNA values from the BAT phone template, but select phones use the secretary's directory number as specified in the CSV file instead.

The CSV file for phones can contain multiple directory numbers depending on whether the BAT phone template in question supports multiple lines.


Note The number of directory numbers entered in the CSV file must equal the number of lines configured in the phone template, or an error will result.


You can create a CSV file two ways. You can use the Microsoft Excel template called BAT.xlt or create the CSV using a sample text file. Cisco recommends you use the BAT.xlt template because the data is validated automatically when you export to CSV format.

The BAT.xlt file provides data file templates with macros, support for multiple phone lines, and error checking, and exports the values into CSV files for phones, users, CTI ports, phone/user combinations, CTI port/user combinations, Cisco VG200 gateways, and FXS ports on Cisco Catalyst 6000 analog interface modules.

For instructions on creating the CSV file, see

Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users (recommended method)

Creating a Text-Based CSV Text File

Understanding the BAT.xlt File

The BAT.xlt file simplifies the creation of CSV files. It provides validation and error checking automatically to help reduce configuration errors. The BAT.xlt file provides several tabs (along the bottom edge of the file) that allow you to create CSV files for the various devices and user combinations in BAT.

To use the BAT.xlt file to create a CSV file, first click the tab for the type of device with which you want to work. For example, to add phones and users all at once, click the tab marked Phones-Users. Each tab provides the field name, whether it is a required or optional field, and the maximum number of characters allowed.

The CSV file works in combination with the BAT template. For example, on the Phone tab in the BAT.xlt file, you can leave Location, Forward Busy Destination, or Call Pickup Group for any record on the CSV file blank, and the values from the BAT phone template will be used for these fields. However, if you specify values in the CSV file for those fields, those values override the values for these fields that were set in the BAT phone template.

Creating a CSV File for Phones, Phones/Users, CTI Ports-Users, or CTI Ports Using BAT.xlt

Follow this procedure to create the CSV file for adding phones or phones and users together. The information you provide here, in combination with the information provided in the BAT template for phones, is used to add the Cisco IP Phones to the Cisco CallManager database.

Procedure


Step 1 The BAT.xlt file resides on the Publisher database server. However, you normally would not have Microsoft Excel running on the Publisher database server. In that case, you must copy the file from the Publisher database server to the local machine on which you plan to work.

Using a floppy disk or a mapped network drive, open the path C:\CiscoWebs\BAT\ExcelTemplate on the Publisher database server, and copy the file BAT.xlt to a local machine where Microsoft Excel is installed.

Step 2 Double-click BAT.xlt.

Step 3 When prompted, click Enable Macros.

Step 4 Click the tab for the type of CSV file you want to add.

Click the Phones tab at the bottom of the sheet to add phones.

Click the Phones-Users tab at the bottom of the sheet to add phones and users all at once.

Click the CTI Port tab at the bottom of the sheet to add CTI ports.

Click the CTI Port-Users tab at the bottom of the sheet to add CTI ports and users all at once.

Step 5 Scroll to the right side of the template until you see the Number of Phone Lines box. In that box, enter the number of lines equal to the number of directory numbers.


Note The number of lines you specify here must match the number of lines configured in the BAT template, or an error will result when you attempt to insert a BAT phone template and CSV with mismatched number of lines.


Step 6 If you are creating a Phones or Phones-Users file, in the Number of Speed Dials box, enter the number of speed dial buttons that are configured on the BAT phone template. This check box does not display on the CTI Port and CTI Port-Users tabs.


Note The number of speed dials you specify here cannot exceed the number of speed dials configured in the BAT template, or an error will result when you attempt to insert the BAT phone template and CSV file.


Step 7 Complete all mandatory fields and any relevant optional fields. Each column heading specifies the length of the field and whether it is required or optional. If you have multiple devices, several fields will appear multiple times, once for each device.


Note The system treats blank rows in the spreadsheet as "End of File" and discards subsequent records.


In each row, provide the following information. Because these instructions apply to four different tabs, complete only the fields for the tab you are adding. You can determine which fields apply because each field is prefaced with the name of the tab in the BAT.xlt file (such as Phones or CTI-Users), "All" to indicate a field common to all tabs under discussion, "All Phone Types" to indicate those fields that display on both the Phones and the Phones-User tabs, or "All CTI Types" for those fields that display on both the CTI Port and CTI Port-Users tabs.

(Phones-Users, CTI Port-Users) In the First Name field, enter the first name of the user to whom this phone will be issued, up to 50 characters.

(Phones-Users, CTI Port-Users) In the Last Name field, enter the last name of the user to whom this phone will be issued, up to 50 characters.

(Phones-Users, CTI Port-Users) In the User ID field, enter the user ID for the user to whom this phone will be issued.

(Phones-Users, CTI Port-Users) In the Password field, enter the password the user needs to access the Cisco IP Phone User Options web page.

Although considered optional in the CSV file, you must provide a password. You can specify the password either on the CSV file or during user insertion in BAT. If you want to apply individual passwords for each user, specify the password in the CSV file. If you want to use a default password that can be used by all users, do not specify the password in the CSV and instead provide this information when you insert the users in BAT.

(Phones-Users, CTI Port-Users) In the Manager field, enter manager's user ID for the user to whom this phone will be issued.

(Phones-Users, CTI Port-Users) In the Department field, enter the department number for the user to whom this phone will be issued.

(Phones-Users, CTI Port-Users) In the PIN field, enter the personal identification number (PIN) to be used for extension mobility.

Although considered optional in the CSV file, you must provide a PIN. You can specify the PIN either on the CSV file or during user insertion in BAT. If you want to apply individual PINs for each user, specify the PIN in the CSV file. If you want to use a default PIN that can be used by all users, do not specify the PIN in the CSV and instead provide this information when you insert the users in BAT.

(Phones-Users, CTI Port-Users) In the User Device Profile, enter the user device profile for this user. A user device profile specifies basic device information, such as the phone button template, and is used in connection with the extension mobility feature.

(All CTI Types) In the Device Name field, enter a unique identifier for the CTI port. You can check the Crete Dummy MAC Addresses box to automatically generate unique device identifiers.

(All Phone Types, CTI Port) In the MAC Address field, enter the MAC address. This is optional if you plan to use dummy MAC addresses.

(All) In the Description field, enter a description of the phone, such as the MAC address preceded with "SEP," or something more descriptive like "Conference Room A" or "John Smith" if the phone is going to be placed in a conference room or given to a specific user.

(All) In the Location field, enter the location. If you provided a location in BAT phone template, you can leave this field blank to use the value in the BAT phone template. A location indicates the remote location accessed using restricted bandwidth connections.

(All) In the Directory Number field, enter the directory number for the phone.

(All) In the Voice Message Box field, enter the directory number used to access voice mail.

(All) In the Display field, enter the text that you want to appear on the called party's phone display, such as the user's name (John Smith) or phone's location (Conference Room 1).

(All) In the Forward Busy Destination field, enter the directory number to which calls should be forwarded when the phone is busy. To use the value provided in the BAT phone template, leave this field blank.

(All) In the Forward No Answer Destination field, enter the directory number to which calls should be forwarded when the phone is not answered. To use the value provided in the BAT phone template, leave this field blank.

(All) In the Call Pickup Group field, enter the number that can be dialed to answer calls to this directory number. To use the value provided in the BAT phone template, leave this field blank.

(All) In the User ID field, enter the user ID for the user to whom this phone will be issued.

(All Phone Types) In the Speed Dial field, enter the complete number, including access or long distance codes, that you want users to be able to dial at the press of the speed dial button.

(All Phone Types) In the Speed Dial Label field, enter a description of the speed dial number; for example, "555-1234," "Security," or "Cafeteria."

Step 8 (Optional) To use the dummy MAC address option, check the Create Dummy MAC Address box.

You must enter the MAC address or use the dummy MAC address option. If you choose the dummy MAC address option, you can update the phones later with the correct MAC address by manually entering this information into Cisco CallManager Administration for each phone or by using the TAPS tool. See Chapter 6, "Working with TAPS", for more information about TAPS.

If you are adding CTI ports, the dummy MAC address option provides a unique device name for each CTI port in the form of fake MAC addresses.

Step 9 Click Export to BAT Format to transfer the data from the BAT Excel spreadsheet into a CSV file.

The system saves the file to C:\XLSDataFiles (or to your choice of another existing folder) as

tabname#timestamp.txt

where "tabname" represents the type of CSV file you created (such as phones, phones-users), and "timestamp" represents the precise date and time the file was created.

Step 10 To be accessed by BAT, the CSV file must reside on the Publisher database server. However, you normally would not have Microsoft Excel running on the Publisher database server. So this step assumes that you have saved the CSV file to the local machine (not the Publisher database server). In that case, you must copy the file to Publisher database server.

Using a floppy disk or a mapped network drive, copy the CSV file from C:\XLSDataFiles\ to the appropriate C:\BATFiles\ folder on the server running the Publisher database for Cisco CallManager. For phones or CTI ports, you would copy the CSV file to C:\BATFiles\Phones; for phones and users combination, or CTI ports and users combination, you would copy the CSV file to C:\BATFiles\PhonesUsers; for users, you would copy the CSV file to C:\BATFiles\Users.

Step 11 For information on how to read the exported CSV file, click the link to View Sample File in the Insert Phones window in BAT (Configure > Phones).


Creating a Text-Based CSV Text File

If you do not use the BAT.xlt file for data input when adding phones, phones and users, CTI ports, or CTI ports and users, you must create the CSV file using lines of ASCII text with values separated by commas. You do not need to follow the instructions in this section if you created the CSV file using the BAT.xlt file.


Tips Use the BAT.xlt file to input data because data validation is performed on that file.


The comma separated values (CSV) file provides a common textual way of providing tabular information. You can create a data file using any file format, such as Microsoft Notepad, Microsoft Word, and so on. Save the CSV file to C:\BATFiles\Phones\ on the server running the Publisher database for Cisco CallManager.

Procedure

To create a CSV text file for phones, phones/users combination, CTI ports, or CTI ports/users combination, perform the following steps:


Step 1 Open a text editor (such as Notepad) or any application that allows you to export or create a CSV file.

Step 2 Using a separate line for each phone, enter the values for each phone, CTI port, or user combination you want to add to Cisco CallManager. See Tips for Creating a Text-Based CSV File, for detailed information about the formatting you must use in the text-based CSV file.


Note An error occurs upon insertion if any blank lines exist in the CSV file.


Step 3 Save or copy the file to C:\BATFiles\ (in the folder named for the type of CSV file you are creating: phones, CTI port-users, and so on) on the server running the Publisher database for Cisco CallManager.


Note You cannot use CSV files saved anywhere except the proper folder under C:\BATFiles\ on the server running the Publisher database for Cisco CallManager for BAT inserts.



Tips for Creating a Text-Based CSV File

The following example format shows the fields, field length, and whether the field is optional or mandatory. A few examples are also provided.

Some fields labeled optional in the CSV file are actually mandatory when certain conditions are met. For example, you must specify password and PIN fields, but they are shown as optional in the CSV file because you can specify them in BAT when you insert the CSV file. Directory number, also shown as optional, becomes mandatory if your corresponding phones or phones-users BAT template has one or more lines configured. In that case, directory number is mandatory, and the number of directory number fields you supply in the CSV file must match the number of lines configured in the BAT template.

Phones only:

MAC Address(Mandatory, 12 characters),Description (Optional, up to 50 characters),Location (Optional, up to 50 characters),Directory Number (Optional, up to 50 numerals),Voice Message Box, (Optional, up to 24 numerals),Display (Optional, up to 30 characters),Forward Busy Destination (Optional, up to 50 numerals and special characters),Forward No Answer Destination(Optional, up to 50 numerals and special characters),Call Pickup Group (Optional, up to 50/50 characters),User ID (Optional, up to 30 characters),Speed Dial (Optional, up to 50 numerals and special characters),Speed Dial Label(Optional, up to 30 characters)

For example:

1231123245AB,SEP1231123245AB,Dallas,9725557154,9725557100,John Smith,
9725557100,9725557100,9725557121/TollByPass,johns,557200,Cafeteria

Phones and Users combination:

First Name(Mandatory, 1 to 50 characters),Last Name(Mandatory, 1 to 50 characters),User ID(Optional, 1 to 30 characters),Password(Optional, 4 to 20 characters),Manager(Optional, up to 30 characters),Department(Optional, up to 50 characters),PIN(Optional up to 20 numerals),User Device Profile(Optional, up to 50 characters),MAC Address (Mandatory, 12 characters),Description (Optional, up to 50 characters),Location (Optional, up to 50 characters),Directory Number (Optional, up to 50 numerals),Voice Message Box, (Optional, up to 24 numerals),Display (Optional, up to 30 characters),Forward Busy Destination (Optional, up to 50 numerals and special characters),Forward No Answer Destination(Optional, up to 50 numerals and special characters),Call Pickup Group (Optional, up to 50/50 characters),Speed Dial (Optional, up to 50 numerals and special characters),Speed Dial Label(Optional, up to 30 characters)

For example:

John,Smith,johns,abc123de,karend,0012055,9989,johns,1231123245AB,
SEP1231123245AB,Dallas,9725557154,9725557100,John Smith,9725557100,
9725557100,9725557121/TollByPass,557200,Cafeteria

CTI ports:

Device Name(Mandatory, up to 15 characters),Description (Optional, up to 50 characters),Location (Optional, up to 50 characters),Directory Number (Optional, up to 50 numerals),Voice Message Box(Optional, up to 24 numerals),Display (Optional, up to 30 characters),Forward Busy Destination (Optional, up to 50 numerals and special characters),Forward No Answer(Optional, up to 50 numerals and special characters),Call Pickup Group (Optional, up to 50/50 characters),User ID(Optional, 1 to 30 characters)

For example:

TAPS port 1,CTI TAPS port 1,Dallas,9725557154,9725557100,John Smith,
9725557100,9725557100,9725557121/TollByPass

CTI ports and users combination:

First Name(Mandatory, 1 to 50 characters),Last Name(Mandatory, 1 to 50 characters),User ID(Mandatory, 1 to 30 characters),Password(Optional, 4 to 20 characters),Manager(Optional, up to 30 characters),Department(Optional, up to 50 characters),PIN(Optional up to 20 numerals),User Device Profile(Optional, up to 50 characters),Device Name(Mandatory, up to 15 characters),Description (Optional, up to 50 characters),Location (Optional, up to 50 characters),Directory Number (Optional, up to 50 numerals),Voice Message Box(Optional, up to 24 numerals),Display (Optional, up to 30 characters),Forward Busy Destination (Optional, up to 50 numerals and special characters),Forward No Answer(Optional, up to 50 numerals and special characters),Call Pickup Group (Optional, up to 50/50 characters)

For example:

John,Smith,johns,abc123de,karend,0012055,9989,johns,TAPS port 1,
CTI TAPS port 1,Dallas,9725557154,9725557100,John Smith,9725557100,
9725557100,9725557121/TollByPass

Always include comma separators, even if a field is blank. Specify Call Pickup Group as either a Directory Number or Directory Number/Route Partition Name, if the access to the call pickup group is restricted by a Route Partition. Specify the user ID if the phone is to be associated to a user.

Refer to the following examples and sample CSV records when creating CSV files. The examples are for phones CSV files, but the same principles apply to all CSV file formats.


Tips You must specify PIN and Password values, either on the CSV file or when you add the users to Cisco CallManager. If you want to apply individual PINs or passwords for each user, specify the PIN and password information in the CSV file. If you want to use a default PIN and password that can be used by all users, do not specify PIN or password values in the CSV and instead provide this information when you use BAT to add the users to Cisco CallManager.



Tips Directory Number fields are only optional if you are creating the CSV file for use with a BAT template that has no lines. If lines are configured on the BAT phone template, you must supply an equal number of directory numbers in the CSV file for each device.


Phone CSV File Examples

If Forward Busy Destination is 3001 on a phone template, all records in a CSV file that have no value for Forward Busy Destination use 3001.

1231123245AB,SEP1231123245AB,Dallas,9725557154,9725557100,John Smith,,
9725557100,9725557121/TollByPass,johns,557200,Cafeteria

If the description for a phone is blank

1231123245AB,,Dallas,9725557154,9725557100,John Smith,9725557100,
9725557100,9725557121/TollByPass,johns,557200,Cafeteria

If no active line is required and the location is also blank

1231123245AB,SEP1231123245AB,,,9725557100,John Smith,,9725557100,
9725557121/TollByPass,johns,557200,Cafeteria

If two active lines are required

1231123245AB,SEP1231123245AB,Dallas,9725557154,9725557100,John Smith,
9725557100,9725557100,9725557121/TollByPass,9725557155,9725557100,
John Smith,9725557100,9725557100,9725557121/TollByPass,johns,557200,
Cafeteria


Note For the MAC Address, enter MAC address values or check the option for creating dummy MAC addresses.


If one line is required and you want to include only the required values and none of the optional values

1231123245AB,,,9725557154,,,,,,

If the option is checked for a dummy MAC address and you want one line

,SEP1231123245AB,Dallas,9725557154,9725557100,John Smith,9725557100,
9725557100,9725557121/TollByPass,johns,557200,Cafeteria

Adding Phones or CTI Ports to Cisco CallManager

Follow this procedure to bulk-add phones or CTI ports to Cisco CallManager.

Before You Begin

You must create a CSV file before you attempt to add phones or CTI ports to Cisco CallManager.

If you are adding phones, you must create a BAT phone template before you attempt to add phones to Cisco CallManager.

Procedure


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Click Configure > Phones.

The Insert Phones window displays.

Step 3 In the File Name field, choose the CSV file that you created for this type of bulk transaction.

Step 4 In the Phone Template Name field, choose the BAT template that you created for this type of bulk transaction.


Note If you want to insert phones that require different phone templates, you must create separate CSV files. The Line Details link shows how many lines are configured for the selected template.


Step 5 If you did not enter individual MAC addresses in the CSV file, you must check the Create Dummy MAC Address check box. You can update the phones or devices later with the correct MAC address using TAPS or by manually entering this information into Cisco CallManager Administration for each phone. See Chapter 6, "Working with TAPS", for more information about TAPS.

If you are adding CTI ports, the dummy MAC address option provides a unique device name for each CTI port in the form of fake MAC addresses. If you did not provide device names in the CSV file, then you must check the Create Dummy MAC Address box.

This field automatically generates fake MAC addresses in the following format:
XXXXXXXXXXXX
where X is any 12-character, hexadecimal (0-9 and A-F) number.

Choose this option only when auto-registration is enabled.

Chose this option if you do not know the MAC address of the phone that will be assigned to the user. Once the phone is plugged in, a MAC address registers for that device.

Do not choose this option if you supplied MAC addresses or device names in the CSV file.

When phones are given to users, remember to update the phone records with the valid MAC address either by using TAPS or by manually updating in Cisco CallManager Administration.

Step 6 Check the Enable CTI Application Use check box to enable use of applications such as Cisco IP SoftPhone.

Step 7 Click Insert.

A message displays advising you of approximately how long it will take to insert the records to the Cisco CallManager database. You can cancel the transaction if you feel it may cause performance degradation.

Step 8 Click OK to insert the phones or click Cancel to cancel the transaction.

If you clicked OK, a Transaction Status window displays. You can click the Show Latest Status button to see the transaction in progress.


Note If any line information for a phone record fails, BAT does not insert that phone record.


When the transaction completes, you can click View Latest Log File to see a log file indicating the number of records added and the number of records failed, including an error code. For more information on log files, see Chapter 7, "Troubleshooting BAT and TAPS".


Adding Phones and Users or CTI Ports and Users to Cisco CallManager

Follow this procedure to bulk-add phones and users or CTI ports and users to Cisco CallManager.

Before You Begin

You must create a Phones-Users or CTI Port-Users CSV file before you attempt to add phones and users or CTI ports and users to Cisco CallManager.

If you are adding phones and users, you must create a BAT phone template before you attempt to add phones and users to Cisco CallManager.

Procedure


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Click Configure > Phones/Users.

The Insert Phones/Users window displays.

Step 3 In the File Name field, choose the CSV file you created for this type of bulk transaction.

Step 4 In the Phone Template Name field, choose the BAT template you created for this type of bulk transaction.


Note If you want to insert phones that require different phone templates, you must create separate CSV files. The Line Details link shows how many lines are configured for the selected template.


Step 5 If you did not enter individual MAC addresses in the CSV file, you must check the Create Dummy MAC Address check box. You can update the phones or devices later with the correct MAC address using TAPS or by manually entering this information into Cisco CallManager Administration for each phone. See Chapter 6, "Working with TAPS", for more information about TAPS.

If you are adding CTI ports, the dummy MAC address option provides a unique device name for each CTI port in the form of fake MAC addresses. If you did not provide device names in the CSV file, you must check the Create Dummy MAC Address box.

This field automatically generates fake MAC addresses in the following format:
XXXXXXXXXXXX
where X is any 12-character, hexadecimal (0-9 and A-F) number.

Choose this option only when auto-registration is enabled.

Choose this option if you do not know the MAC address of the phone that will be assigned to the user. Once the phone is plugged in, a MAC address registers for that device.

Do not choose this option if you supplied MAC addresses or device names in the CSV file.

When phones are assigned to users, remember to update the phone records with the valid MAC address either by using TAPS or by manually updating in Cisco CallManager Administration.

Check the Enable Authentication Proxy Rights check box if you want all users added in this transaction to be able to log on to a phone on behalf of someone else. Users with authentication proxy rights enabled are considered "super users" or "admin users" who act as the single point of authentication through which all users connect for extension mobility. Further configuration is required in Application Administration on the Cisco CRA server.

Step 6 Check the Enable CTI Application Use check box to enable use of applications such as Cisco IP SoftPhone.

Step 7 (Optional) In the User Default Values area, provide the following information if you have not already done so in the CSV file.

Password—Enter the password that users should provide when logging on to the Cisco IP Phone User Options web page. You should only specify a value here when you want to specify the default password for access to the Cisco IP Phone User Options web page and when you have not already specified individual passwords for each user in the CSV file. Password values specified in the CSV file take precedence over any values you enter here.

Confirm Password—Reenter the password.

PIN—Enter the PIN that users should provide when logging in to a Cisco IP Phone 7960 or 7940 for extension mobility. You should only specify a value here when you want to specify the default PIN for extension mobility and when you have not already specified individual PINs for each user in the CSV file. PIN values specified in the CSV file take precedence over any values you enter here.

Confirm PIN—Reenter the PIN.

Step 8 Click Insert.

A message displays advising you of approximately how long it will take to insert the records to the Cisco CallManager database. You can cancel the transaction if you feel it may cause performance degradation.

Step 9 Click OK to insert the phones and users or click Cancel to cancel the transaction.

If you clicked OK, a Transaction Status window displays. You can click the Show Latest Status button to see the transaction in progress.


Note If any line information for a phone record fails, BAT does not insert that phone record.


When the transaction completes, you can click View Latest Log File to see a log file indicating the number of records added and the number of records failed, including an error code. For more information on log files, see Chapter 7, "Troubleshooting BAT and TAPS".


Related Topics

Creating CSV Files for Phones, Phones and Users, CTI Ports, and CTI Ports and Users

Updating Phone Records

Copying a BAT Phone Template

You can copy the properties of a phone template into a new phone template. This is useful when you have similar bulk-add transactions and only a few details need to be changed.


Note The template you want to create from the original must be the same device type, such as Cisco IP Phone 7960. You cannot change device type in the copy of the template.


Procedure

To copy an existing BAT phone template, perform the following steps:


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Choose Configure >Template > Phones.

The Phone Template Configuration window displays.

Step 3 In the Phone Templates column on the left, click on the template you want to copy.

The selected template details display in the Phone Template Configuration window.

Step 4 Verify that this is the template you want to copy, and click Copy.

A copy of the template is reproduced. The copy duplicates all the values that were specified in the original template.

Step 5 In the Phone Template Name field, enter a new template name.

Step 6 Update the fields as needed for the new template.

Step 7 Click Insert.

The template is added to BAT and displays in the Phone Templates column on the left.

Step 8 Click Add Line to provide line attributes, if applicable. See the "Adding or Updating Lines to a BAT Phone Template" section for more information.You can also define services and speed dial buttons.


Related Topics

Adding Phones or CTI Ports

Adding or Updating Services to a BAT Phone Template

Adding or Updating Speed Dials to a BAT Phone Template

Updating Phone Records

You can bulk-update phone records in the Cisco CallManager database. This is useful when you want to change one of the settings for many like phones, such as device pool or calling search space.

You can create a query to update a set of phone records. Creating a query requires defining a filter. You can also create complex queries by clicking either the AND or the OR button.

Procedure

To create a query, perform the following steps:


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Choose Configure > Phones and click the link to Update Phones in upper, right corner of the window.

The Update Phones window displays. To locate the records you want to update, define the filter.


Caution If no filter is defined, BAT applies the changes to all phone records.

Step 3 In the first drop-down list box, choose the field to query such as Model, Device Name, and so on.

Step 4 In the second drop-down list box, choose the search criteria such as begins with, contains, is empty, and so on.

Step 5 In the search field/list box, either choose or enter the value that you want to locate, such as a specific phone model.

Step 6 Click Add To Query to add the defined filter to the query. Click AND or OR to add multiple filters and repeat Steps 2 through 5 to further define your query.

If you make a mistake, click the Clear Query button to remove the query; then return to Step 3 and start over.

Step 7 Click View Query Result to display the records that are going to be affected.

Specify the setting you want to update for all the records you have defined in your query.

Step 8 In the Parameter list box, choose a setting from the list box.

Step 9 In the Value field, enter the new value or choose a value from the list box.

Step 10 Click the arrow pointing toward the Set Values box to add the specified parameter and value to the Set Value box. Values in the Set Value box will be applied to the records you have defined in your query. You can remove values by choosing the value you want to remove from the Set Values box and clicking the arrow facing the Value field.

You can choose multiple parameters to update. Repeat Steps 7 through 10 to add more parameters.

Step 11 (Optional) Check the Reset devices after update box to reset (power-cycle) the phones as soon as the update completes (if you are updating the device pool) or check the Restart devices after update box if you want to reset phones without power-cycling (for update of fields other than device pool).


Note If you want to reset or restart the devices at a later time, do not check either check box. When you click Run, the records update with the specified parameters; however, no changes take effect until the devices are reset or restarted.


Step 12 Click Run to apply the updates to the records.


Related Topics

Adding Phones or CTI Ports

Updating Lines

Deleting Phones

Viewing a List of Phones with Dummy MAC Addresses

Updating Lines

You can use BAT to bulk-update line attributes for a select group of devices.

Procedure

To update lines, perform the following steps:


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Click Configure > Phones and click the link to Update Lines in the upper, right corner of the window.

The Update Lines window displays. To locate the records you want to update, define the filter.


Caution If no filter is defined, BAT applies the changes to all lines.

Step 3 In the first drop-down list box, choose the field to query such as Device Pool, Calling Search Space, or Line Number. Line Number designates the actual line number on the phone, such as line 1 or line 2. It does not specify the directory number associated with the line.

Step 4 In the second drop-down list box, choose the search criteria such as begins with, contains, is empty, and so on.

Step 5 In the search field/list box, either choose or enter the value that you want to locate, such as a specific calling search space.

Step 6 Click Add To Query to add the defined filter to the query. You can click AND or OR to add multiple filters and repeat Steps 3 through 6 to further define your query.

If you make a mistake, click the Clear Query button to remove the query; then return to Step 3 and start over.

Step 7 Click View Query Result to display the records that are going to be affected.

Specify the setting you want to update for all the records you have defined in your query.

Step 8 In the Parameter list box, choose a setting from the list box.

Step 9 In the Value field, enter the new value or choose a value from the list box.

Step 10 Click the arrow pointing toward the Set Values box to add the specified parameter and value to the Set Value box. Values in the Set Value box will be applied to the records you have defined in your query. You can remove values by choosing the value you want to remove from the Set Values box and clicking the arrow facing the Value field.

You can choose multiple parameters to update. Repeat Steps 8 through 10 to add more parameters.

Step 11 Click Run to update the lines and restart the affected phones.

A message displays advising you of approximately how long it will take to update the records in the Cisco CallManager database and that the phones with the affected lines restart automatically. Restarting the phone cause any active calls to be dropped. You can cancel the transaction or click OK to continue.

Related Topics

Adding Phones or CTI Ports

Updating Phone Records

Deleting Phones


Viewing a List of Phones with Dummy MAC Addresses

You can use BAT to view a list of all phones using a dummy MAC address. The following steps tell you how to search for phones with dummy MAC addresses, but you can modify these procedures and use them to help you find phones using any of the search criteria provided below.

Procedure

Use the following steps to generate a list of phones using dummy MAC addresses.


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Click Configure > Phones and then click the link to Update Phones in the upper, right corner of the window.

The Update Phones window displays.

Step 3 In the first drop-down list box, choose Device Name.

Step 4 In the second drop-down list box, choose begins with.

Step 5 All phones added with a dummy MAC address have device names that begin with BAT. In the field, type BAT.

Step 6 Click Add To Query.

Step 7 Click View Query Results.

The window displays all phone records that were added to the Cisco CallManager database using a dummy MAC address. You can print the list by right-clicking inside the window and choosing Print or by using the keyboard shortcut Ctrl + P.

Deleting Phones

You can bulk-delete phones from the Cisco CallManager database using the following procedure.

Procedure


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Click Configure > Phones and then click the link to Delete Phones in the upper, right corner of the window.

The Delete Phones window displays.

Step 3 In the first drop-down list box, choose the field to query such as Model, Device Name, and so on.

Step 4 In the second drop-down list box, choose the search criteria such as begins with, contains, is empty, and so on.

Step 5 In the search field/list box, either choose or enter the value that you want to locate, such as a specific phone model.

Step 6 Click Add To Query to add the defined filter to the query. You can click AND or OR to add multiple filters and repeat Steps 3 through 6 to further define your query.

If you make a mistake, click the Clear Query button to remove the query; then return to Step 3 and start over.

Step 7 Click View Query Result to verify the records that are going to be deleted.


Caution If no information is entered into the query text box, the system deletes all phone records.

Step 8 Click Run to delete the records.

A message displays advising you of approximately how long it will take to delete the records from the Cisco CallManager database. You can cancel the transaction or click OK to continue.

After the phones are deleted, BAT generates a log file indicating the number of records deleted and the number of records failed, including an error code. For more information on log files, see Chapter 7, "Troubleshooting BAT and TAPS".


Related Topics

Adding Phones or CTI Ports

Updating Phone Records

Updating Lines

Deleting Templates

You can delete BAT templates when you no longer require them.

Procedure

To delete a template, perform the following steps:


Step 1 Start BAT. (See Starting BAT, page 1-4, for complete information about how to start BAT.)

Step 2 Choose Configure >Template > the type of template you want to delete, such as Phone or VG200 Gateway.

The Template Configuration window displays.

Step 3 In the Templates column on the left, click on the template you want to delete.

The selected template details display in the Template Configuration window.

Step 4 Verify that this is the template you want to delete, and click Delete.

A message displays asking you to confirm the delete operation.

Step 5 Click OK to delete the template, or click Cancel to cancel the delete operation without deleting the template.

The template is deleted from BAT and can no longer be used in bulk transactions.


Field Descriptions

The following sections provide descriptions for fields you may encounter while adding or updating values.

Field Descriptions for Adding a BAT Phone Template

Table 3-1 describes the fields you may encounter when adding a BAT phone template.


Note Values appear in the Device Type, Device Pool, Calling Search Space, Media Resource Group List, User Hold Audio Source, Network Hold Audio Source, Location, Phone Button Template, and Phone Load Name fields. Configure these values in the system through Cisco CallManager Administration.

Table 3-1 Field Descriptions for Adding a Phone Template 

Field
Description

Phone Template Name

Enter a name for this BAT template, up to 50 alphanumeric characters. This name identifies the unique phone template used only in BAT; for example, BAT 7960.

Device Type

Choose CTI port or the type of Cisco IP Phone.

Note BAT does not support Cisco IP Phone models 12S or 12SP.

After you choose the device type, BAT refreshes the window and displays the fields that apply to the chosen device type.

Device Pool

Choose the device pool to which this group of phones/ports should belong.

A device pool defines sets of common characteristics for devices, such as region, date/time group, Cisco CallManager group, and calling search space for auto-registration.

Calling Search Space

This is an optional field. Choose the calling search space to which this group of phones/ports should belong.

A calling search space specifies the collection of Route Partitions that are searched to determine how a dialed number should be routed.

Media Resource Group List

This is an optional field. Choose the media resource group list (MRGL) to which this group of phones/ports should belong.

An MRGL specifies a list of prioritized media resource groups. An application can select required media resources among the available ones according to the priority order defined in the MRGL.

User Hold Audio Source

This is an optional field. Choose the user hold audio source that this group of phones/ports should utilize.

The user hold audio source specifies the audio source from which music is played when a user places a call on hold.

Network Hold Audio Source

This is an optional field. Choose the network hold audio source that this group of phones/ports should utilize.

The network hold audio source specifies the audio source from which music is played when the system places a call on hold, such as when the user transfers or parks a call.

Location

This is an optional field. Choose the location to which this group of phones/ports should belong.

A location indicates the remote location accessed using restricted bandwidth connections.

In the Phone Button Template and Expansion Module Template Information area, enter the settings for the phone model for which you are creating the template.

Note Values appear in the Phone Button Template and Expansion Module fields. Configure these templates in the system through Cisco CallManager Administration.

Phone Button Template

Choose the button template to be used for all phones in this group. This field does not apply if you selected CTI Ports in the Model field.

Button templates determine the configuration of buttons on a phone and identify which feature (line, speed dial, and so on) each button designates.

Expansion Module 1

This is an optional field. (Cisco IP Phone 7960 only) Choose the button template to be used for the first expansion module.

Expansion Module 2

This is an optional field. (Cisco IP Phone 7960 only) Choose the button template to be used for the second expansion module.

In the Firmware Load Information area, enter the settings for the phone model for which you are creating the template, or leave the fields blank to use the default values.

Phone Load Name

This is an optional field. This field does not apply for CTI ports. Be aware that any value entered in this field overrides the default value for the selected model and specifies the custom software for a Cisco IP Phone. Enter the custom phone load, if applicable.

Expansion Module 1 Load Name

This is an optional field. (Cisco IP Phone 7960 only) Enter the firmware load for the first Cisco IP Phone Expansion Module 7914, if applicable. Leave this field blank to use the default load.

Expansion Module 2 Load Name

This is an optional field. (Cisco IP Phone 7960 only) Enter the firmware load for the second Cisco IP Phone Expansion Module 7914, if applicable. Leave this field blank to use the default load.

In the Cisco IP Phone - External Data Locations area, enter the settings for the phone model for which you are creating the template or leave the fields blank to use the default values. This area displays only if you are configuring Cisco IP Phone models 7960 or 7940. Skip these fields if you are configuring this template for any other phone model.

Information

This is an optional field. Enter the help text URL for the information button for Cisco IP Phone models 7960  and 7940 only.

Directory

This is an optional field and applies only to Cisco IP Phone models 7960  and 7940. Enter the URL of the directory server.

Messages

This is an optional field and applies only to Cisco IP Phone models 7960 and 7940. Enter the voice mail access pilot number.

Services

This is an optional field and applies only to Cisco IP Phone models 7960  and 7940. Enter the URL for the services menu.

Authentication Server

This is an optional field. Enter the URL the phone uses to validate requests made to the phone's web server. If you do not provide an authentication URL, the advanced features on the 7960 and 7940 that require authentication will not function. Leave this field blank to accept the default setting.

By default, this URL accesses a Cisco IP Phone User Options web page configured during installation.

Proxy Server

This is an optional field. Enter the host and port (for example, proxy.cisco.com:80) used to proxy HTTP requests for access to non-local host addresses from the phone's HTTP client.

If the phone receives a URL such as www.cisco.com in a service and the phone is not configured in the cisco.com domain, the phone uses the proxy server to access the URL. If the phone is configured in the cisco.com domain, the phone accesses the URL without using the proxy because it is in the same domain as the URL.

If you do not configure this URL, the phone attempts to connect directly to the URL. Leave this field blank to accept the default setting.

Idle

This is an optional field. Enter the URL to display on the Cisco IP Phone window when the phone has not been used for the time specified in the Idle Time field. For example, you can display a logo on the window when the phone has not been used for 5 minutes. Leave this field blank to use the default value.

Only Cisco IP Phone models 7960 and 7940 use this field.

Idle Timer

This is an optional field. Enter the amount of time in seconds that you want to elapse before the phone displays the URL specified in the Idle field. Leave this field blank to use the default value.

Only Cisco IP Phone models 7960 and 7940 use this field.

In the Extension Mobility (Device Profile) Information area, enter the settings for the phone model for which you are creating the template or leave the fields blank to use the default values. This area displays only if you are configuring Cisco IP Phone models 7960 or 7940. Skip these fields if you are configuring this template for any other phone model.

Enable Extension Mobility Feature

This is an optional box. Check this check box if you want to enable the extension mobility feature. Extension mobility allows a user to log in and out of a Cisco IP Phone model 7960 or 7940. See the Cisco CallManager Administration System Guide for more information about extension mobility.

Log Out Profile

This is an optional field. Choose the profile a phone should load when a user logs out. You must configure log out profiles in Cisco CallManager Administration.

Choosing <Use Current Device Settings> creates an autogenerated device profile as the default device profile.

If you choose <Select a User Device Profile>, you can then assign a user device profile that has already been defined; this user device profile becomes the default device profile for this device.

If a user device profile is chosen as the default device profile, that user device profile is loaded onto the device when the device is logged out (when no user is logged in).

In the Product Specific Configuration area, enter the settings for the phone model for which you are creating the template or leave the fields blank to use the default values. This area displays only if you are configuring Cisco IP Phone models 7960, 7940, or 7910. Skip these fields if you are configuring this template for any other phone model.

Forwarding Delay

This is a mandatory field. (Cisco IP Phone models 7960 or 7940 only) Check Enabled if you want the port to wait a few seconds prior to forwarding a call.

Disable Speakerphone

This is an optional box. (Cisco IP Phone models 7960 or 7940 only) Check this box to disable the speakerphone functionality for all phones added using this BAT template.

Disable Speakerphone and Headset

This is an optional box. (Cisco IP Phone models 7960 or 7940 only) Check this box to disable the speakerphone and headset functionality for all phones added using this BAT template.



Field Descriptions for Adding a Line to a BAT Phone Template

Table 3-2 describes the fields for adding line details on a BAT phone template.

All fields are optional.

Table 3-2 Field Descriptions for Adding a Line to a BAT Phone Template 

Field
Description

Directory Number

Partition

Choose a partition. A partition indicates the route partition to which the directory number belongs.

Note The directory number can appear in more than one partition; however, make sure the directory number and Partition combination is unique.

Directory Number Settings

Default Voice Message Box to Directory Number

Check this box to make the voice message box number the same as the directory number for this line. This is useful if you do not have a voice mail server configured for this phone.

Calling Search Space

This field contains a collection of partitions that are searched for numbers that are called from this directory number.

Note Changes cause an update of the numbers listed in the Call Pickup Group field. The setting applies to all devices using this directory number.

User Hold Audio Source

This field specifies the music on hold audio source to be played when the user places a call on hold (presses the Hold button or soft key).

Network Hold Audio Source

This field specifies the music on hold audio source to be played when the system places a call on hold (such as when user transfers a call or initiates a conference or call park).

Call Waiting

The selection you make in this field applies to all devices using this directory number and specifies whether this directory number uses call waiting when a line is busy (On), responds with a busy signal (Off), or uses the system-wide default setting (Default).

Activate Auto Answer for this Directory Number

(Not used for CTI ports) Check this box if you want all phones added using this BAT template to use the auto answer feature. With auto answer, Cisco CallManager automatically answers calls when a headset is in use. A zip tone plays to alert the user that an incoming call has connected.

Call Forward and Pickup Settings

Forward All Destination

This field indicates the directory number to which all calls are forwarded.

Note Setting applies to any dialable phone number, including an outside destination unless restricted, and to all devices using this directory number.

Forward All Calling Search Space

This is an optional field. This setting applies to all devices using this directory number and indicates the calling search space to use when forwarding to the specified destination.

Forward Busy Destination

This field indicates the directory number to which a call is forwarded when the line is in use.

Note This setting applies to any dialable phone number, including an outside destination unless restricted, and to all devices using this directory number.

Forward Busy Calling Search Space

This setting applies to all devices using this directory number and indicates the calling search space to use when forwarding to the specified destination.

Forward No Answer Destination

This field indicates the directory number to which a call is forwarded when the phone is not answered.

Note Setting applies to any dialable phone number, including an outside destination unless restricted, and to all devices using this directory number.

Forward No Answer Calling Search Space

This setting applies to all devices using this directory number and indicates the calling search space to use when forwarding to the specified destination. The setting appears only if configured in the system.

Forward on Failure Destination

(CTI ports only) Enter the directory number to which a call should be forwarded to when a phone or CTI application fails.

Forward on Failure Calling Search Space

(CTI ports only) This setting applies to all devices using this directory number and indicates the calling search space to use when forwarding to the specified destination. The setting appears only if configured in the system.

Call Pickup Group

This field indicates a number that can be dialed to answer calls to this directory number (in the specified partition); for example, 3003/Partitionl.

Line Settings for this Phone

External Phone Number Mask

This setting indicates the phone number (or mask) used to send Caller ID information when a call is placed from this line. This setting uses a maximum of 30 number and "X" characters; the X characters must appear at the end of the pattern.

Disable ring on this line

This setting applies only to the current device and stops the phone from ringing to indicate incoming calls. This setting is not available for CTI ports.