Native
Synchronous
No Custom Parameters
The QueryByPool action is used for querying the device information cache located on the Cisco Unified Application Server using the device pool as the search criteria, in order to retrieve information on one or more devices.
QueryByPool performs a search against Registered devices with a device pool and returns the results in a System.Data.DataTable variable. A common practice is to pass this variable into a CustomCode block for parsing the data within it.
The resulting DataTable is an object comprised of rows and columns, with the number of resulting rows corresponding to the number of devices matched by the query. The name of the colums correspond to device attributes retrieved from the device cache database. The following list is the name of the columns comprising each row in the DataTable, which one would use when using C# to parse out the results from the table:
The name of the device, such as SEPXXXXXXXXXXXX. This should not ever be null.
The IP address of the device. This will be "" if undefined.
The description of the device. This will be "" if undefined.
The Calling Search Space of the device. This will be "" if undefined.
The Device Pool of the device. This will be "Unknown" if undefined.
The Status of the device. This will be "0" if undefined.
The type of the device. This will be "1" if undefined.
The IP address of the publisher node of the cluster that the device is registered to. This should not ever be null.
The DeviceListX provider polls every 2 hours (configurable). This means that the local Cisco Unified Application Environment device cache can be out of date with current phone information. If testing and developing with a phone that has just come online, manually invoke a refresh of the database by navigating to mceadmin > Providers > Cisco DeviceListX Provider > Invoke Extension to re-synchronous the cache.
| Parameter Name | .NET Type | Default | Description |
|---|---|---|---|
| DevicePool * | System.String | The DevicePool action parameter can be used to restrict the query to devices with a configured Device Pool matching the specified value. | |
| CallManagerIP | System.String | The CallManagerIP action parameter can be used to restrict the query to devices matching the specified Cisco Unified Communications Manager publisher IP address. |
| Parameter Name | .NET Type | Description |
|---|---|---|
| ResultData | System.Data.DataTable | A .NET System.Data.DataTable that contains rows and columns corresponding to the devices and attributes returned for the query. |
| ResultCount | System.Int32 | The number of devices returned in the query. |
Branch Conditions
No description.
No description.