Provider
Synchronous
No Custom Parameters
TriggeringSubscribe will register for status changes with a presence server; the status changes will result in triggering events.
TriggeringSubscribe is used to cause another script to initiate every time a watched presentity changes status by firing a triggering Notify event.
You can end a subscription by using the Unsubscribe action.
TriggeringSubscribe and NonTriggeringSubscribe offer the same feature from the perspective that both provide a means to watch for presence changes of a presentity. The difference is that one action creates a triggering timer, and the other creates a non-triggering timer. Because script instances are a licensable resource and should be managed closely, the developer of the application must carefully consider which action is more appropriate.
If the TriggeringSubscribe is successful, and the subscription is later ended by either the application with Unsubscribe or by the presence server, then the SubscriptionTerminated will be sent as a triggering event as well.
The Presence Provider stores registrations only in memory. If the provider is disabled, or if the Cisco Unified Application Server service is restarted, all outstanding subscriptions will be lost.
If the notify event results in a no handler, then the Presence Provider will remove the subscription automatically.
Often an application will wish to be subscribed to a presentity for the duration of the application being installed and running. If building an application like that has this requirement, StaticConstruction is most likely the best-fit for reaching this requirement. Specifically, such an application can issue TriggeringSubscribe or NonTriggeringSubscribe in the StaticConstruction-triggered script to set up the subscription once the application is loaded.
| Parameter Name | .NET Type | Default | Description |
|---|---|---|---|
| Timeout | System.Int32 | The Timeout property specifies to the Application Runtime Environment how long
to wait for a response from the provider for the current action.
The ReturnValue returned in this case is Timeout. The value must be a literal value in milliseconds. | |
| RequestUri * | System.String | The URI of the presentity to be watched. | |
| Subscriber * | System.String | The identity of the watcher. | |
| Password * | System.String | The password of the watcher. |
| Parameter Name | .NET Type | Description |
|---|---|---|
| ResultCode | System.Int64 | The result code of the subscribe operation. The following are the possible values:
|
Branch Conditions
No description.
No description.
No description.