cisco.uc.cuae.legacy
Class RemoteCiscoExtensionMobilityServer

java.lang.Object
  etch.bindings.java.support.RemoteBase
      cisco.uc.cuae.legacy.RemoteCiscoExtensionMobility
          cisco.uc.cuae.legacy.RemoteCiscoExtensionMobilityServer

All Implemented Interfaces:

CiscoExtensionMobility, CiscoExtensionMobilityServer, CuaeCommon, CuaeCommonServer

public final class RemoteCiscoExtensionMobilityServer
extends RemoteCiscoExtensionMobility
implements CiscoExtensionMobilityServer

Call to message translator for CiscoExtensionMobilityServer.

Nested Class Summary

class

RemoteCiscoExtensionMobilityServer._Async Asynchronous implementation of service methods.

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

CiscoExtensionMobility.Device, CiscoExtensionMobility.LoginOptions, CiscoExtensionMobility.LoginResult, CiscoExtensionMobility.LogoutALLOptions, CiscoExtensionMobility.LogoutALLResult, CiscoExtensionMobility.LogoutOptions, CiscoExtensionMobility.LogoutResult, CiscoExtensionMobility.QueryDeviceProfilesOptions, CiscoExtensionMobility.QueryDeviceProfilesResult, 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

Field Summary

RemoteCiscoExtensionMobilityServer._Async	_async RemoteCiscoExtensionMobilityServer._Async class instance used to hide asynchronous message implementation.
RemoteCiscoExtensionMobilityServer._Async	_inner Deprecated.

Constructor Summary

RemoteCiscoExtensionMobilityServer(etch.bindings.java.support.DeliveryService svc, etch.bindings.java.msg.ValueFactory vf)
Constructs the RemoteCiscoExtensionMobilityServer.

Method Summary

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.LogoutALLResult	logoutALL(java.lang.String sessionId, java.lang.String callManagerIP, CiscoExtensionMobility.Version version, java.lang.String appId, java.lang.String appCertificate, CiscoExtensionMobility.LogoutALLOptions options) Logs out a user from a device.
CiscoExtensionMobility.QueryDeviceProfilesResult	queryDeviceProfiles(java.lang.String sessionId, java.lang.String[] userId, java.lang.String callManagerIP, CiscoExtensionMobility.Version version, java.lang.String appId, java.lang.String appCertificate, CiscoExtensionMobility.QueryDeviceProfilesOptions options) Queries one or more devices, determining which user, if any, is currently logged into it.
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 etch.bindings.java.support.RemoteBase

_begincall, _endcall, _newMessage, _send, _start, _startAndWaitUp, _stop, _stopAndWaitDown, _transportControl, _transportNotify, _transportQuery, _waitDown, _waitUp, toString

Methods inherited from class java.lang.Object

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

Field Detail

_async

public final RemoteCiscoExtensionMobilityServer._Async _async

RemoteCiscoExtensionMobilityServer._Async class instance used to hide asynchronous message implementation. Use this to invoke the asynchronous message implementations.

_inner

@Deprecated
public final RemoteCiscoExtensionMobilityServer._Async _inner

Deprecated.

RemoteCiscoExtensionMobilityServer._Async class instance used to hide asynchronous message implementation. This is here for backwards compatibility only, use _async instead.

Constructor Detail

RemoteCiscoExtensionMobilityServer

public RemoteCiscoExtensionMobilityServer(etch.bindings.java.support.DeliveryService svc,
                                          etch.bindings.java.msg.ValueFactory vf)

Constructs the RemoteCiscoExtensionMobilityServer.

Parameters:

svc -

vf -

Method Detail

queryDeviceProfiles

public final CiscoExtensionMobility.QueryDeviceProfilesResult queryDeviceProfiles(java.lang.String sessionId,
                                                                                  java.lang.String[] userId,
                                                                                  java.lang.String callManagerIP,
                                                                                  CiscoExtensionMobility.Version version,
                                                                                  java.lang.String appId,
                                                                                  java.lang.String appCertificate,
                                                                                  CiscoExtensionMobility.QueryDeviceProfilesOptions 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 QueryDeviceProfiles 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 QueryDeviceProfiles 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:

queryDeviceProfiles in interface CiscoExtensionMobilityServer

Parameters:

sessionId - The session Id for this method call

userId - The names of one or more Users

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

login

public final 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 final 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

logoutALL

public final CiscoExtensionMobility.LogoutALLResult logoutALL(java.lang.String sessionId,
                                                              java.lang.String callManagerIP,
                                                              CiscoExtensionMobility.Version version,
                                                              java.lang.String appId,
                                                              java.lang.String appCertificate,
                                                              CiscoExtensionMobility.LogoutALLOptions options)

Description copied from interface: CiscoExtensionMobilityServer

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

Specified by:

logoutALL in interface CiscoExtensionMobilityServer

Parameters:

sessionId - The session Id for this method call

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 final 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 final 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