Howto:How to monitor configuration changes in the SOAP Api interface

From innovaphone-wiki

Jump to: navigation, search

The SOAP interface allows you to query updates to the busy status of users.


Applies To

This information applies to

  • PBX SOAP API, V5.01 and V6

More Information

The SOAP interface allows you to query updates to the busy status of users. There is also a way to query configuration changes. Here is how.

Problem Details

To get notified about user busy status updates, you would subscribe for UserInfo updates using the Initialize() method and retrieve those using Poll(). Unfortunately, the UserInfo record does not include full configuration data. For example, call forwarding information is missing. However, when such data changes, a UserInfo is still sent to all subscribers. To obtain the current configuration, you would use the Admin() function with an XML argument of

<show><user cn=”….”/></show>

The result includes the full configuration as storein the PBX’s LDAP database.

You don't need to use Admin() each time you receive an UserInfo record. Instead, you do this only if the cfg flag is set in the UserInfo .

Known Problems

No UserInfo is sent when a diversion is cleared from a phone using SIP/H.323 methods. You will learn about the change only when an UserInfo is generated due to other reasons (e.g. because of an incoming call).

Related Articles

Howto:Authentication in the SOAP interface

Reference:SOAP API

Howto:Using the SOAP Admin Function

Howto:Clear a call completely with SOAP using UserClear

Howto:PBX SOAP Api C-sharp sample code

Personal tools