Table Of Contents
Cisco IP Phone Services Configuration
Adding a Cisco IP Phone Service
Updating a Cisco IP Phone Service
Deleting a Cisco IP Phone Service
Cisco IP Phone Service Configuration Settings
Adding a Cisco IP Phone Service Parameter
Updating a Cisco IP Phone Service Parameter
Deleting a Cisco IP Phone Service Parameter
Cisco IP Phone Service Parameter Settings
Cisco IP Phone Services Configuration
Using Cisco CallManager Administration, you define and maintain the list of Cisco IP Phone Services to which users can subscribe at their site. Cisco IP Phone Services comprise XML applications that enable the display of interactive content with text and graphics on Cisco IP Phones 7960/7940.
Cisco CallManager provides sample Cisco IP Phone Services applications. You can also create customized Cisco IP Phone applications for your site.
After you configure the list of services, you can add services to the phones in the database. In Cisco CallManager Administration, you can view and modify settings for phones and device profiles. Users can log on to the Cisco IP Phone User Options application and subscribe to these services for their Cisco IP Phones.
This section covers the following topics:
•
Adding a Cisco IP Phone Service
•Updating a Cisco IP Phone Service
•Deleting a Cisco IP Phone Service
•Cisco IP Phone Service Configuration Settings
•Adding a Cisco IP Phone Service Parameter
•Updating a Cisco IP Phone Service Parameter
•Deleting a Cisco IP Phone Service Parameter
•Cisco IP Phone Service Parameter Settings
Adding a Cisco IP Phone Service
Perform the following steps to add a Cisco IP Phone Service.
Caution Do not put Cisco IP Phone Services on any Cisco CallManager server at your site or any server that is associated with Cisco CallManager, such as the TFTP server or directory database publisher server. This precaution eliminates the possibility that errors in a Cisco IP Phone Service application will have an impact on Cisco CallManager performance or interrupt call-processing services.
Procedure
Step 1 Choose Features > Cisco IP Phone Services.
Step 2 Enter the appropriate settings as described in Table 35-1.
Step 3 To add the service, click Update.
After the service is added to the list, you can add and configure parameters for the service. See the "Adding a Cisco IP Phone Service Parameter" section for more information.
Related Topics
•Deleting a Cisco IP Phone Service
•Updating a Cisco IP Phone Service
•Adding a Cisco IP Phone Service Parameter
•Cisco IP Phone Service Configuration Settings
Updating a Cisco IP Phone Service
Perform the following steps to update a Cisco IP Phone Service (for example, to change the service URL or other information).
Note If you change the service URL, remove a Cisco IP Phone Service parameter, or change the name of a phone service parameter for a phone service to which users are subscribed, be sure to click Update Subscriptions to update all currently subscribed users with the changes. If you do not do so, users must resubscribe to the service to rebuild the URL correctly.
Procedure
Step 1 Choose Features > Cisco IP Phone Services.
Step 2 From the Cisco IP Phone Services list, choose the Cisco IP Phone Service that you want to update.
Step 3 Update the appropriate settings as described in Table 35-1.
Step 4 Add, update, or delete parameters as needed as described in "Adding a Cisco IP Phone Service Parameter" section, "Updating a Cisco IP Phone Service Parameter" section, and "Deleting a Cisco IP Phone Service Parameter" section.
Step 5 To apply the changes, update the Cisco IP Phone Services Configuration window:
•If the service was modified after subscriptions existed, click Update Subscriptions to rebuild all user subscriptions. You must update subscriptions if you changed the service URL, removed a phone service parameter, or changed the Parameter Name for a phone service parameter.
•If the service is new and you do not need to rebuild user subscriptions, click Update.
Related Topics
•Deleting a Cisco IP Phone Service
•Adding a Cisco IP Phone Service Parameter
•Cisco IP Phone Service Configuration Settings
Deleting a Cisco IP Phone Service
Perform the following steps to update a Cisco IP Phone Service.
Note When you delete a Cisco IP Phone service, Cisco CallManager removes all service information, user subscriptions, and user subscription data from the database.
Procedure
Step 1 Choose Features > Cisco IP Phone Services.
Step 2 From the Cisco IP Phone Services list, choose the name of the Cisco IP Phone Service that you want to delete.
Step 3 Click Delete.
Related Topics
•Adding a Cisco IP Phone Service
•Updating a Cisco IP Phone Service
•Cisco IP Phone Service Configuration Settings
Cisco IP Phone Service Configuration Settings
Table 35-1 describes the Cisco IP Phone service configuration settings.
Table 35-1 Cisco IP Phone Service Configuration Settings
Field
|
Description
|
Service Name
|
Enter the name of the service as it will display on the menu of available services in the Cisco IP Phone User Options application. Enter up to 32 characters for the service name.
|
Service Description
|
Enter a description of the content that the service provides.
|
Service URL
|
Enter the URL to the server where the Cisco IP Phone Services application is located. Make sure that this server remains independent of the servers in your Cisco CallManager cluster. Do not specify a Cisco CallManager server or any server that is associated with Cisco CallManager (such as a TFTP server or directory database publisher server).
For the services to be available, the phones in the Cisco CallManager cluster must have network connectivity to the server.
To see a sample service application, go to the following URL:
http://<Server>/ccmuser/sample/sample.asp
where <Server> is a fully qualified domain name or an IP address.
|
Character Set
|
If you are using a language other than English for Service Name and Description, choose the character set for that language. Text displays incorrectly if the wrong character set is chosen.
|
Related Topics
•Adding a Cisco IP Phone Service
•Deleting a Cisco IP Phone Service
Adding a Cisco IP Phone Service Parameter
Use the following procedure to add and configure Cisco IP Phone Service parameters. Add the phone service before you configure parameters. Refer to the documentation for the individual Cisco IP Phone Service for specific information about whether the service uses parameters, how those parameters should be configured, and whether you should provide optional parameter definitions.
Procedure
Step 1 Choose Features > Cisco IP Phone Services.
The Cisco IP Phone Services Configuration window displays.
Step 2 From the Cisco IP Phone Services list, choose the service to which you want to add parameters.
Step 3 Click the New button to the right of the Parameters list box.
The Cisco IP Phone Service Parameter Configuration dialog appears.
Step 4 Enter the appropriate settings as described in Table 35-2.
Step 5 To add the new parameter, click Insert.
Step 6 To add additional parameters, if needed, repeat Step 3 and Step 5.
Step 7 To add the last parameter, click Insert and Close.
Related Topics
•Adding a Cisco IP Phone Service
•Deleting a Cisco IP Phone Service
•Updating a Cisco IP Phone Service
•Updating a Cisco IP Phone Service Parameter
•Deleting a Cisco IP Phone Service Parameter
•Cisco IP Phone Service Parameter Settings
Updating a Cisco IP Phone Service Parameter
Perform the following steps to update a service parameter for a specific Cisco IP Phone Service.
Note If you remove a Cisco IP Phone Service parameter or change the parameter name of a phone service for a phone service to which users are subscribed, be sure to click Update Subscriptions to update all currently subscribed users with the changes. If you do not do so, users must resubscribe to the service to rebuild the URL correctly.
Procedure
Step 1 Choose Features > Cisco IP Phone Services.
Step 2 From the Cisco IP Phone Services list, choose the phone service that you want to update.
Step 3 In the Parameters list box, choose the name of the parameter that you want to update.
Step 4 Click Edit.
Step 5 Update the appropriate settings as described in Table 35-2.
Step 6 To apply the changes click Update, or to apply the changes and close the dialog, click Update and Close.
Step 7 To apply the changes, update the Cisco IP Phone Services Configuration window:
•If the service was modified after subscriptions existed, click Update Subscriptions to rebuild all user subscriptions. You must update subscriptions if you changed the service URL, removed a phone service parameter, or changed the name for a phone service parameter.
•If the service is new and you do not need to rebuild user subscriptions, click Update.
Related Topics
•Deleting a Cisco IP Phone Service Parameter
•Cisco IP Phone Service Configuration Settings
Deleting a Cisco IP Phone Service Parameter
Perform the following steps to delete a Cisco IP Phone Service.
Note If you remove a phone service parameter or modify the Parameter Name of a phone service parameter for a phone service to which users are subscribed, you must click Update Subscriptions to update all currently subscribed users with the changes. If you do not do so, users must resubscribe to the service to rebuild the URL correctly.
Procedure
Step 1 Choose Features > Cisco IP Phone Services.
Step 2 From the Cisco IP Phone Services list, choose the phone service whose parameters you want to delete.
Step 3 In the Parameters list box, choose the name of the parameter that you want to delete.
Step 4 Click Delete.
Step 5 To confirm the deletion, click OK.
Step 6 To apply the changes, update the Cisco IP Phone Services Configuration window:
•If the service was modified after subscriptions existed, click Update Subscriptions to rebuild all user subscriptions. You must update subscriptions if you changed the service URL, removed a phone service parameter, or changed the Parameter Name for a phone service parameter.
•If the service is new and you do not need to rebuild user subscriptions, click Update.
Related Topics
•Updating a Cisco IP Phone Service Parameter
•Adding a Cisco IP Phone Service Parameter
•Deleting a Cisco IP Phone Service
•Cisco IP Phone Service Parameter Settings
Cisco IP Phone Service Parameter Settings
Table 35-2 describes the Cisco IP Phone service parameter settings.
Table 35-2 Cisco IP Phone Service Parameter Settings
Field
|
Description
|
Parameter Name
|
Enter the exact query string parameter to use when you build the subscription URL; for example, symbol.
|
Parameter Display Name
|
Enter a descriptive parameter name to display to the user in the Cisco IP Phone User Options application; for example, Ticker Symbol.
|
Default Value
|
Enter the default value for the parameter. This value displays to the user when a service is being subscribed to for the first time; for example, CSCO.
|
Parameter Description
|
Enter a description of the parameter. The user can access the text that is entered here while the user is subscribing to the service. The parameter description should provide information or examples to help users input the correct value for the parameter.
|
Parameter is Required
|
If the user must enter data for this parameter before the subscription can be saved, check the Parameter is Required box.
|
Parameter is a Password (mask contents)
|
You can mask entries in the Cisco IP Phone User Options application, so asterisks display rather than the actual user entry. You may want to do this for parameters such as passwords that you do not want others to be able to view. To mask a parameter entry, check the Parameter is a Password (mask contents) check box in the Configure Cisco IP Phone Service Parameter window in Cisco CallManager Administration.
|
