BAT Tool to update device profile Soft Key Template

Unanswered Question
Sep 22nd, 2008
User Badges:

I've been using the BAT tool to update the Soft Key Templates (SKT)as we are excited to use the new DND features of 6.12 however I cant seem to find a way to update our Device Profiles with the BAT utility. If anyone could point me in the right direction it would be greatly appreciated.


  • 1
  • 2
  • 3
  • 4
  • 5
Overall Rating: 0 (0 ratings)
Rob Huffman Tue, 09/23/2008 - 05:55
User Badges:
  • Super Blue, 32500 points or more
  • Hall of Fame,

    Founding Member

  • Cisco Designated VIP,

    2017 IP Telephony, Unified Communications

Hi Andrew,

This will be a two-stage process, here is how to create the new Softkey Template (using the default Template as your starting point). Anyways here are the 2 methods involved;(1 to change existing non-standard softkey template and 2 to change the softkey template that a group of phones is using - with BAT)

**You can make changes to custom, nonstandard softkey templates that you create**

Updating a Softkey Template

Use this procedure to update a nonstandard softkey template that you created. You can update the template name, description, application soft keys that are supported, and the softkey layout.



Step 1 Find the softkey template by using the procedure in the "Finding a Softkey Template" section.

Step 2 From the list of matching records, choose the softkey template that you want to update.


Note You can update only softkey templates that display a check box in the left column. All other softkey templates are standard, read-only templates.


The Softkey Template Configuration window displays.

Step 3 Update the settings that you want changed (such as adding an application softkey set or the softkey layout). See the "Adding Application Softkeys to Nonstandard Softkey Templates" section and the "Configuring Softkey Positions in a Nonstandard Softkey Template" section.

Step 4 Click the Update button.

The Softkey Template Configuration window redisplays with the softkey template updated.


Note After making updates to a softkey template, you must restart devices that are using the template.


Step 5 Click the Restart Devices button to apply the updated softkey template.

From this doc;

Cisco Unified CallManager Bulk Administration Guide, Release 6.0(1)

Updating Phones ******(This is the Readers digest version)

Choose Bulk Administration > Phones > Update Phones> Query

Choosing the Update Parameters

After you have defined the query or custom file to search for phones, use this procedure to choose parameters and define values for updating phones.



Step 1 In the Update Phones Query window, click Next. The Update Phones shows the type of query that you chose. If you want to change the type of query, click Back.

Step 2 Specify the setting that you want to update for all the records that you have defined in your query or custom file. You can choose multiple parameters to update.

Field Descriptions for Update Phones

Softkey Template

Choose the softkey template to be used for all phones in this group (Query).

From this doc;

Hope this helps!


whatuusay1 Tue, 09/23/2008 - 06:03
User Badges:

Thank you everyone for your pointers, I've sucessfully updated the phones however I can't seem to search on device profiles though. Is there something special / specific I can search on? I've been reading the BAT guide and it appears that I can get Choose Bulk Administration > User Device Profiles > User Device Profile Template. However no way to update existing profiles (we have several hundred). I've confirmed that the profile soft key template will take presidence over the phones soft key templete so even though I've updated the phones the profiles must have a soft key template with DND enabled as well.

Thanks again for the assistance.

Aaron Harrison Thu, 09/16/2010 - 09:58
User Badges:
  • Super Bronze, 10000 points or more
  • Community Spotlight Award,

    Member's Choice, May 2015


I wrote a little utility you can use to push single property changes for a list of devices in to CCM from a CSV. Take a  look here:

Basically for an input file you would need a line for each device profile like so



Hope this helps


Please rate helpful posts...

Aaron Harrison Mon, 11/28/2011 - 10:29
User Badges:
  • Super Bronze, 10000 points or more
  • Community Spotlight Award,

    Member's Choice, May 2015


The AXL query required to update a Display field (which is a property of the line appearance, which is a combination of the device and the DN) is a little more complex than what that little tool was designed to do. It's certainly possible with AXL, it would just need some time spending on it.

You may be able to do what you want by doing an 'Export All UDPs' from BAT, modifying the exported file, and re-importing it. Take care when editing it, often apps like Excel will mess up the format even if you save it back as a CSV.



This Discussion