de.starface.integration.uci.java.v30.messages.requests
Interface UciFunctionKeyRequests


@UciService(value="ucp.v30.requests.functionKey")
@RpcInterface(value="ucp.v30.requests.functionKey")
@RpcValueTranslation(version=30)
public interface UciFunctionKeyRequests

This interface defines the function key requests provided by the UCI server.


Method Summary
 FunctionKeySearchResult getAllFunctionKeys()
          This request allows the UCI client to retrieve all function keys.
 List<CallInfo> getCallInfoForKey(String functionKeyId)
          This request allows the UCI client to query information about the calls currently being held or received by the user or group the key of type FunctionKeyType.BUSY_LAMP_FIELD shows the status of.
 ContactInfo getContactInfoForKey(String functionKeyId)
          This request allows the UCI client to query the contact information of the user or group the key of type FunctionKeyType.BUSY_LAMP_FIELD shows the status of.
 List<FunctionKey> getFunctionKeys()
          This request allows the UCI client to retrieve the function keys of the current user.
 Image getImageForKey(String functionKeyId)
          This request allows the UCI client to query the image of the key.
 List<RedirectSetting> getRedirectSettingsForKey(String functionKeyId)
          This request allows the UCI client to query which redirect always settings have been activated by the user or group the key of type FunctionKeyType.BUSY_LAMP_FIELD shows the status of.
 void pressKey(String functionKeyId, Object... parameters)
          This request allows the UCI client to virtually press a function key of the current user.
 FunctionKeySearchResult searchFunctionKeys(String searchTerm, String searchId)
          This request allows the UCI client to retrieve the function keys containing the given term in name or phone number.
 FunctionKeySearchResult searchFunctionKeysByEmail(String emailAddress, String searchId)
          This request allows the UCI client to retrieve the function keys by email address.
 FunctionKeySearchResult searchFunctionKeysByJabberId(String jabberId, String searchId)
          This request allows the UCI client to retrieve the function keys by jabber id.
 void terminateSearchRequest(String searchId)
          To unsubscribe a search Request.
 

Method Detail

getFunctionKeys

List<FunctionKey> getFunctionKeys()
                                  throws UciException
This request allows the UCI client to retrieve the function keys of the current user.

Returns:
A List of FunctionKey containing the function keys
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if the request is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected ( UcpNotConnectedException).

getAllFunctionKeys

FunctionKeySearchResult getAllFunctionKeys()
                                           throws UciException
This request allows the UCI client to retrieve all function keys.

Returns:
A List of FunctionKey containing the function keys
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if the request is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected ( UcpNotConnectedException).

searchFunctionKeys

FunctionKeySearchResult searchFunctionKeys(String searchTerm,
                                           String searchId)
                                           throws UciException
This request allows the UCI client to retrieve the function keys containing the given term in name or phone number.

Parameters:
searchId - an existing search id or null if requesting a new one
searchTerm - string to search for in name or phone number
Returns:
A List of FunctionKey containing the function keys
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if the request is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected ( UcpNotConnectedException).

searchFunctionKeysByJabberId

FunctionKeySearchResult searchFunctionKeysByJabberId(String jabberId,
                                                     String searchId)
                                                     throws UciException
This request allows the UCI client to retrieve the function keys by jabber id. It is necessary to search with the whole jabberId.

Parameters:
jabberId - string to search for in jabber id
searchId - an existing search id or null if requesting a new one
Returns:
A List of FunctionKey containing the function keys
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if the request is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected ( UcpNotConnectedException).

searchFunctionKeysByEmail

FunctionKeySearchResult searchFunctionKeysByEmail(String emailAddress,
                                                  String searchId)
                                                  throws UciException
This request allows the UCI client to retrieve the function keys by email address. It is necessary to search with the whole email address.

Parameters:
emailAddress - string to search for in email address
searchId - an existing search id or null if requesting a new one
Returns:
A List of FunctionKey containing the function keys
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if the request is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected ( UcpNotConnectedException).

terminateSearchRequest

void terminateSearchRequest(String searchId)
                            throws UciException
To unsubscribe a search Request.

Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if the request is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected ( UcpNotConnectedException).

pressKey

void pressKey(String functionKeyId,
              Object... parameters)
              throws UciException
This request allows the UCI client to virtually press a function key of the current user. A function key press usually leads to an action on the server depending on the FunctionKeyType of the key.

Parameters:
functionKeyId - the id of the function key to be pressed.
parameters - additional parameters used to modify the behavior of the action to be activated upon the key press. The meaning of the parameters depends on the function key to be pressed. It is documented together with the FunctionKeyType.
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if one of the request's arguments has an illegal value ( UciIllegalArgumentException) or if the request with the given parameters is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected (UcpNotConnectedException).

getRedirectSettingsForKey

List<RedirectSetting> getRedirectSettingsForKey(String functionKeyId)
                                                throws UciException
This request allows the UCI client to query which redirect always settings have been activated by the user or group the key of type FunctionKeyType.BUSY_LAMP_FIELD shows the status of.

Parameters:
functionKeyId - the id of the function key to obtain the settings for
Returns:
a list with the redirect settings
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if one of the request's arguments has an illegal value ( UciIllegalArgumentException) or if the request with the given parameters is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected (UcpNotConnectedException).

getContactInfoForKey

ContactInfo getContactInfoForKey(String functionKeyId)
                                 throws UciException
This request allows the UCI client to query the contact information of the user or group the key of type FunctionKeyType.BUSY_LAMP_FIELD shows the status of.

Parameters:
functionKeyId - the id of the function key to obtain the contact information for
Returns:
the contact information of the user or group
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if one of the request's arguments has an illegal value ( UciIllegalArgumentException) or if the request with the given parameters is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected (UcpNotConnectedException).

getCallInfoForKey

List<CallInfo> getCallInfoForKey(String functionKeyId)
                                 throws UciException
This request allows the UCI client to query information about the calls currently being held or received by the user or group the key of type FunctionKeyType.BUSY_LAMP_FIELD shows the status of.

Parameters:
functionKeyId - the id of the function key to obtain the call information for
Returns:
the information about the calls in a list
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if one of the request's arguments has an illegal value ( UciIllegalArgumentException) or if the request with the given parameters is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected (UcpNotConnectedException).

getImageForKey

Image getImageForKey(String functionKeyId)
                     throws UciException
This request allows the UCI client to query the image of the key. A key has an image if its property FunctionKeyProperties.imageHash is not empty. Currently only keys of type FunctionKeyType.BUSY_LAMP_FIELD that show the status of a user can have an image which then is the avatar image of the user.

Parameters:
functionKeyId - the id of the function key to obtain the image for
Returns:
the avatar image of the user
Throws:
UciException - if the request is not valid as defined by the UCI specification. This may be the case if one of the request's arguments has an illegal value ( UciIllegalArgumentException) or if the request with the given parameters is not allowed to the user (UciIllegalAccessException) or if the request is placed while the UCI client is not connected (UcpNotConnectedException).


Copyright © 2012 STARFACE GmbH. All rights reserved.