cisco.uc.cuae.legacy
Class BaseCiscoExtensionMobilityServer

java.lang.Object
  cisco.uc.cuae.legacy.BaseCiscoExtensionMobilityServer

All Implemented Interfaces:

CiscoExtensionMobility, CiscoExtensionMobilityServer, CuaeCommon, CuaeCommonServer, etch.bindings.java.support.ObjSession

public class BaseCiscoExtensionMobilityServer
extends java.lang.Object
implements CiscoExtensionMobilityServer, etch.bindings.java.support.ObjSession

Base implementation of CiscoExtensionMobilityServer, with default method implementations which throw UnsupportedOperationException. Extend this class to provide implementations of messages from the client.

See Also:

ImplCiscoExtensionMobilityServer

Nested Class Summary

Nested classes/interfaces inherited from interface cisco.uc.cuae.legacy.CiscoExtensionMobility

CiscoExtensionMobility.Device, CiscoExtensionMobility.LoginOptions, CiscoExtensionMobility.LoginResult, CiscoExtensionMobility.LogoutOptions, CiscoExtensionMobility.LogoutResult, CiscoExtensionMobility.QueryDevicesOptions, CiscoExtensionMobility.QueryDevicesResult, CiscoExtensionMobility.QueryDevicesResultData, CiscoExtensionMobility.QueryUsersOptions, CiscoExtensionMobility.QueryUsersResult, CiscoExtensionMobility.QueryUsersResultData, CiscoExtensionMobility.User, CiscoExtensionMobility.Version

Nested classes/interfaces inherited from interface cisco.uc.cuae.legacy.CuaeCommon

CuaeCommon.CuaeResult

Nested classes/interfaces inherited from interface cisco.uc.cuae.legacy.CuaeCommon

CuaeCommon.CuaeResult

Constructor Summary

BaseCiscoExtensionMobilityServer()

Method Summary

void	_sessionControl(java.lang.Object control, java.lang.Object value)
void	_sessionNotify(java.lang.Object event)
java.lang.Object	_sessionQuery(java.lang.Object query)
CiscoExtensionMobility.LoginResult	login(java.lang.String sessionId, java.lang.String userId, java.lang.String deviceName, java.lang.String callManagerIP, CiscoExtensionMobility.Version version, java.lang.String appId, java.lang.String appCertificate, CiscoExtensionMobility.LoginOptions options) Logs a user into a device with a device profile.
CiscoExtensionMobility.LogoutResult	logout(java.lang.String sessionId, java.lang.String deviceName, java.lang.String callManagerIP, CiscoExtensionMobility.Version version, java.lang.String appId, java.lang.String appCertificate, CiscoExtensionMobility.LogoutOptions options) Logs out a user from a device.
CiscoExtensionMobility.QueryDevicesResult	queryDevices(java.lang.String sessionId, java.lang.String[] deviceNames, java.lang.String callManagerIP, CiscoExtensionMobility.Version version, java.lang.String appId, java.lang.String appCertificate, CiscoExtensionMobility.QueryDevicesOptions options) Queries one or more devices, determining which user, if any, is currently logged into it.
CiscoExtensionMobility.QueryUsersResult	queryUsers(java.lang.String sessionId, java.lang.String[] users, java.lang.String callManagerIP, CiscoExtensionMobility.Version version, java.lang.String appId, java.lang.String appCertificate, CiscoExtensionMobility.QueryUsersOptions options) Queries one or more users, determining which device(s) each user is logged into.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BaseCiscoExtensionMobilityServer

public BaseCiscoExtensionMobilityServer()

Method Detail

_sessionQuery

public java.lang.Object _sessionQuery(java.lang.Object query)
                               throws java.lang.Exception

Specified by:

_sessionQuery in interface etch.bindings.java.support.ObjSession

Throws:

java.lang.Exception

_sessionControl

public void _sessionControl(java.lang.Object control,
                            java.lang.Object value)
                     throws java.lang.Exception

Specified by:

_sessionControl in interface etch.bindings.java.support.ObjSession

Throws:

java.lang.Exception

_sessionNotify

public void _sessionNotify(java.lang.Object event)
                    throws java.lang.Exception

Specified by:

_sessionNotify in interface etch.bindings.java.support.ObjSession

Throws:

java.lang.Exception

login

public CiscoExtensionMobility.LoginResult login(java.lang.String sessionId,
                                                java.lang.String userId,
                                                java.lang.String deviceName,
                                                java.lang.String callManagerIP,
                                                CiscoExtensionMobility.Version version,
                                                java.lang.String appId,
                                                java.lang.String appCertificate,
                                                CiscoExtensionMobility.LoginOptions options)

Description copied from interface: CiscoExtensionMobilityServer

Logs a user into a device with a device profile. This action will invoke the Login Extension Mobility API method by communicating to the specified Cisco Unified Communications Manager node. The Login action will log a user into a device using a device profile. The device profile can either already be associated with the user account, in which case the DeviceProfile action parameter need not be specified, or the action can explicitly specify a device profile that is not associated with the user.

Specified by:

login in interface CiscoExtensionMobilityServer

Parameters:

sessionId - The session Id for this method call

userId - The user to log in the specified device.

deviceName - The name of the device, of the form SEPXXXXXXXXXXXX

callManagerIP - The IP address and port of a CallManager node with the Extension Mobility service running, in the form '[IP]:[Port]'. Note that the Extension Mobility service is on port 80 by default in 3.x/4.x, and on port 8080 by default in 5.x/6.x.

version - The version of Cisco Unified Communications Manager. This version is used in conjuction with CallManagerHost to build the URL of the Extension Mobility Service. The possible values are described below: other - Specifiy other if the Cisco Unified Communications Manager version is anything above 3.3. v333 - Specify v333 if the Cisco Unified Communications Manager version is 3.3.3, 3.3.4, or 3.3.5. Undefined - This is the default value to when nothing is specified for the Version field. It is strongly recommended that this value not be used because the behavior is undefined as well.

appId - The name of a user configured in Cisco Unified Communications Manager that has the necessary permissions to invoke methods on the Extension Mobility service.

appCertificate - The password of the user specified by AppId.

options - An object holding all the optional parameters

logout

public CiscoExtensionMobility.LogoutResult logout(java.lang.String sessionId,
                                                  java.lang.String deviceName,
                                                  java.lang.String callManagerIP,
                                                  CiscoExtensionMobility.Version version,
                                                  java.lang.String appId,
                                                  java.lang.String appCertificate,
                                                  CiscoExtensionMobility.LogoutOptions options)

Description copied from interface: CiscoExtensionMobilityServer

Logs out a user from a device. This action will invoke the Logout Extension Mobility API method by communicating to the specified Cisco Unified Communications Manager node. The Logout action will log a user out of a device, if the user's device profile is currently logged into a device.

Specified by:

logout in interface CiscoExtensionMobilityServer

Parameters:

sessionId - The session Id for this method call

deviceName - The name of the device to log the user out of. This value is typically of the form SEPXXXXXXXXXXXX.

callManagerIP - The IP address and port of the publisher CallManager IP, in the form '[IP]:[Port]'. Note that the Extension Mobility service is on port 80 by default in 3.x/4.x, and on port 8080 by default in 5.x/6.x.

version - The version of Cisco Unified Communications Manager. This version is used in conjuction with CallManagerHost to build the URL of the Extension Mobility Service. The possible values are described below: other - Specifiy other if the Cisco Unified Communications Manager version is anything above 3.3. v333 - Specify v333 if the Cisco Unified Communications Manager version is 3.3.3, 3.3.4, or 3.3.5. Undefined - This is the default value to when nothing is specified for the Version field. It is strongly recommended that this value not be used because the behavior is undefined as well.

appId - The name of a user configured in Cisco Unified Communications Manager that has the necessary permissions to invoke methods on the Extension Mobility service.

appCertificate - The password of the user specified by AppId.

options - An object holding all the optional parameters

queryDevices

public CiscoExtensionMobility.QueryDevicesResult queryDevices(java.lang.String sessionId,
                                                              java.lang.String[] deviceNames,
                                                              java.lang.String callManagerIP,
                                                              CiscoExtensionMobility.Version version,
                                                              java.lang.String appId,
                                                              java.lang.String appCertificate,
                                                              CiscoExtensionMobility.QueryDevicesOptions options)

Description copied from interface: CiscoExtensionMobilityServer

Queries one or more devices, determining which user, if any, is currently logged into it. This action will invoke the QueryDevices Extension Mobility API method by communicating to the specified Cisco Unified Communications Manager node. Devices in Cisco Unified Communications Manager can potentially be logged into by a single, Extension Mobility-enabled user. QueryDevices is a means to discover this relationship. The action will query the Extension Mobility service to determine which user, if any, is logged into the specified device(s) at that moment in time. The QueryDevices action returns a complex data type that, without any help, requires a substantial amount of C# to parse. To alleviate the demand for repetitive C#, you can use the GetDeviceStatus action, which will help determine if a user is logged into a particular device. The Devices action parameter is of type string[], which does not map to a native type. There are two options for creating this type within a Cisco Unified Application Designer-based application. One is to create the string[] in a C# snippet in the action parameter, the other is to use the null () in a C# action parameter (which allows one to use an ArrayList variable). Both samples are listed below: Creating a string[] Dynamically Using ToArray() to convert an ArrayList to a string[]

Specified by:

queryDevices in interface CiscoExtensionMobilityServer

Parameters:

sessionId - The session Id for this method call

deviceNames - The name(s) of the device(s)

callManagerIP - The IP address and port of a CallManager node with the Extension Mobility service running, in the form '[IP]:[Port]'. Note that the Extension Mobility service is on port 80 by default in 3.x/4.x, and on port 8080 by default in 5.x/6.x.

version - The version of Cisco Unified Communications Manager. This version is used in conjuction with CallManagerHost to build the URL of the Extension Mobility Service. The possible values are described below: other - Specifiy other if the Cisco Unified Communications Manager version is anything above 3.3. v333 - Specify v333 if the Cisco Unified Communications Manager version is 3.3.3, 3.3.4, or 3.3.5. Undefined - This is the default value to when nothing is specified for the Version field. It is strongly recommended that this value not be used because the behavior is undefined as well.

appId - The name of a user configured in Cisco Unified Communications Manager that has the necessary permissions to invoke methods on the Extension Mobility service.

appCertificate - The password of the user specified by AppId.

options - An object holding all the optional parameters

queryUsers

public CiscoExtensionMobility.QueryUsersResult queryUsers(java.lang.String sessionId,
                                                          java.lang.String[] users,
                                                          java.lang.String callManagerIP,
                                                          CiscoExtensionMobility.Version version,
                                                          java.lang.String appId,
                                                          java.lang.String appCertificate,
                                                          CiscoExtensionMobility.QueryUsersOptions options)

Description copied from interface: CiscoExtensionMobilityServer

Queries one or more users, determining which device(s) each user is logged into. This action will invoke the QueryUsers Extension Mobility API method by communicating to the specified Cisco Unified Communications Manager node. Users in Cisco Unified Communications Manager with Extension Mobility profiles can log into one or more devices. QueryUsers is a means to discover this relationship. The action will query the Extension Mobility service to determine which devices one or more users are logged into at that moment in time. The QueryUsers action returns a complex data type that, without any help, requires a substantial amount of C# to parse. To alleviate the demand for repetitive C#, you can use the GetUserDevices action, which will help determine which device(s) a single user is logged into. The Users action parameter is of type string[], which does not map to a native type. There are two options for creating this type within a Cisco Unified Application Designer-based application. One is to create the string[] in a C# snippet in the action parameter, the other is to use the null () in a C# action parameter (which allows one to use an ArrayList variable). Both samples are listed below: Creating a string[] Dynamically Using ToArray() to convert an ArrayList to a string[]

Specified by:

queryUsers in interface CiscoExtensionMobilityServer

Parameters:

sessionId - The session Id for this method call

users - The ID(s) of the user(s)

callManagerIP - The IP address and port of a CallManager node with the Extension Mobility service running, in the form '[IP]:[Port]'. Note that the Extension Mobility service is on port 80 by default in 3.x/4.x, and on port 8080 by default in 5.x/6.x.

version - The version of Cisco Unified Communications Manager. This version is used in conjuction with CallManagerHost to build the URL of the Extension Mobility Service. The possible values are described below: other - Specifiy other if the Cisco Unified Communications Manager version is anything above 3.3. v333 - Specify v333 if the Cisco Unified Communications Manager version is 3.3.3, 3.3.4, or 3.3.5. Undefined - This is the default value to when nothing is specified for the Version field. It is strongly recommended that this value not be used because the behavior is undefined as well.

appId - The name of a user configured in Cisco Unified Communications Manager that has the necessary permissions to invoke methods on the Extension Mobility service.

appCertificate - The password of the user specified by AppId.

options - An object holding all the optional parameters