Cisco Systems OL-20949-01 manual AppactionpriorityidleTimerapplicationId

Chapter 5 Internal URI Features

Application Management URIs

This prevents open, but not active, applications which are buried on the application “stack” from closing the entire application context which would also close the active application, potentially disrupting the user’s interaction with the application. This also means that if an application closes or becomes non-active (for example, if user navigates out of an application, or a new application is pushed to the context) any pending Application URI requests are immediately cancelled.

Note The 6900 series IP phones cannot add phone service under application due to hardkey mapping.

URI Format

App:action:priority:idleTimer:applicationId

Where

action = action to be taken with the application. Values include:

•RequestFocus—Makes a request to the application manager to bring the application context (window) containing this application into focus (maximize). This is a request, not a demand, as higher priority applications may prevent the application from actually gaining focus. Applications must use onAppFocusGained event handlers (see the “Application Event Handlers” section on page 3-22) to know when focus is actually gained.

–If the requested application is Open, but not currently Active, this request will not succeed (error response).

–If the application already has focus, the request has no effect.

•ReleaseFocus—Makes a request to the application manager to relinquish focus to another application context (essentially, a “move-to-back” request). Applications must use onAppFocusLost event handlers to know when focus is actually lost (see the “Application Event Handlers” section on page 3-22).

–If the application does not have focus, the request has no effect.

–If there are no other applications open (available to receive focus) then this application will retain focus.

•Minimize—Makes a request to the application manager to minimize the application context containing this application. This request always results in the application (eventually) being minimized. If the application has focus when this URI executes, the onAppFocusLost event handler will be invoked first, then the onAppMinimize handler (see the “Application Event Handlers” section on page 3-22).

–If the requested application is Open, but not currently Active, this request will not succeed (error response).

–If the application is already minimized, the request has no effect.

•Close—Makes a request to the application manager to close the application context containing this application.

–If the requested application is open, but not currently active, this request will not succeed (error response). This request will result in the application context (and all applications within that context) being closed.

–If the application has focus when this URI executes, the onAppFocusLost event handler will be invoked prior to the onAppClosed event handler (which will always be invoked).

priority = priority at which the action should be take. Values include:

	Cisco Unified IP Phone Services Application Development Notes
OL-20949-01		5-19