Application management uris, Init, Notify – Cisco OL-20949-01 User Manual

Page 64: Notify” section on

Advertising
background image

5-16

Cisco Unified IP Phone Services Application Development Notes

OL-20949-01

Chapter 5 Internal URI Features

Application Management URIs

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.

Phone is temporarily unable to execute URI due to
some other transient issue

6 (Internal error)

<Failure>

Condition

Status

Data

Advertising