No Custom Parameters
Queries one or more users, determining which device(s) each user is logged into.
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.
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.
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
System.Collections.ArrayList.ToArray(System.Type) in a C# action parameter (which allows one to use an ArrayList variable). Both samples are listed below:
Example 12.4. Using
ToArray() to convert an
ArrayList to a
(string) myArrayListVar.ToArray( typeof(string) )
This action will invoke the QueryUsers Extension Mobility API method by communicating to the specified Cisco Unified Communications Manager node.
|Parameter Name||.NET Type||Default||Description|
|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 |
|Users *||The ID(s) of the user(s)|
|Url||The URL for the Extension Mobility Service. This field should only be specified if the Extension Mobility Service is in a non-default location. This field is also completely ignored if any non-null value is specified as the |
|CallManagerHost||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||Undefined||The version of Cisco Unified Communications Manager. This version is used in conjuction with |
|Parameter Name||.NET Type||Description|
|QueryUsersResult||A complex variable type containing the data returned by this action. It is populated only on success. It can be parsed easily by using the |
|ErrorMessage||This error message maps almost exactly to the standard Cisco Unified Communications Manager Extension Mobility API error messages. The one exception is if the service returns |