Chapter 5 Internal URI Features

Application Management URIs

Condition

Status

Data

 

 

 

Phone is temporarily unable to execute URI due to

6 (Internal error)

<Failure>

some other transient issue

 

 

 

 

 

Application Management URIs

These sections describe the application management URIs:

Init

Notify

Application

Init

The Init URI allows an application to initialize a feature or data with the argument that is passed with the URI.

URI Format

Init:o

Where

o = the Object name.

Valid object name:

CallHistory—When the phone encounters an Init:CallHistory URI, it clears the internal call history logs that are stored in the phone. This action initializes Missed Calls, Received Calls, and Placed Calls.

Services—When the phone encounters an Init:SERVICES URI, it closes the Services application. If Services is not currently open, it has no effect.

Messages—When the phone encounters an Init:Messages URI, it closes the Messages application. If Messages is not currently open, it has no effect.

Directories—When the phone encounters an Init:Directories URI, it closes the Directories application. If Directories is not currently open, it has no effect.

Notify

The Notify URI generates network notifications to back-end applications. This feature is most useful for XSI objects that support action handlers (such as displayable XSI objects and RTP streams). For example, use the Notify URI to deliver notifications to back-end applications when an XSI application is closed or when an RTP stream is terminated.

You can also specify the Notify URI in place of most fields that accept a generic URI, including softkeys and menu items. For example, you can call the Notify URI from a softkey or menu item to trigger a back-end event that does not require an interface change, such as manipulating the state of audio streams or other non-visual resources. The Notify URI also works in conjunction with the QueryStringParam URI, such that the exact contents of the QueryStringParam data will be used as the Notify URI data.

 

Cisco Unified IP Phone Services Application Development Notes

5-16

OL-20949-01

Page 64
Image 64
Cisco Systems OL-20949-01 manual Application Management URIs, Init, Notify