This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Managing Subscriptions

The "Subscriptions" panel allows you to add subscriptions to resources and collections. If you have already had any subscriptions, they will be listed in a table displayed within this panel.

Adding a Subscription

1. Click on the "Add Subscription" link.

2. The form which allows users to create new subscriptions appears. For a resource the form would appear as below where the event type and the notification method.

For a collection the form would appear as below. Users can either add a subscription to the selected collection or can define a hierarchical subscription which would effect on the collection and its children. 

The event types supported by default are as follows:

  • Check LC Item - Represents an event that fires when a item is checked in a lifecycle check-list.
  • Uncheck LC Item - Represents an event that fires when a item is unchecked in a lifecycle check-list.
  • Create Child - Represents an event of creating a resource (or collection) within an existing collection.
  • Delete Child - Represents an event of deleting a resource (or collection) within an existing collection.
  • Delete - Represents an event of deleting a resource (or collection).
  • Create LC - Represents an event of creating a lifecycle.
  • Delete LC - Represents an event of deleting a lifecycle.
  • Change LC State - Represents an event of changing a lifecycle state.
  • Update - Represents an event of updating a resource or collection.

Note

Some of these events may not be available for certain types resources and collections.

The following notification methods are available:

  • E-mail - Any valid e-mail address.
  • REST - An endpoint accepting HTML or text content
  • SOAP - An endpoint accepting notifications as a SOAP message.
  • User Profile - A valid user's profile. Notifications will be sent to the e-mail address specified on the user's default profile.
  • Group Profile - A valid group's profile. Notifications will be sent to the e-mail address specified on the group's default profile.
  • Management Console With a valid role Notifications will be sent to work-list of the role.
  • JMX  Notifications will be sent via JMX.
One Time Email Verification

When adding subscriptions to different resources defining the same email address as the notification method, for each subscription users will receive verification email with a link to verify the subscription. The subscription will get active only if the user clicks the verification URL. But if the user starts the server as ./wso2server.sh -Donetime.email.verification=true  the email verification would only happen once when the particular email address is used for first time.

The frequency is available:

  • Hourly
  • Daily
  • Weekly
  • Fortnightly
  • Monthly

A Hierarchical subscription method can be defined for Collections. Given below are the provided hierarchical subscription methods. 

  • Collection only - The subscription will be effected on the selected collection only.
  • Collection and Children only - The subscription will be effected on the selected collection and its immediate child resources only.
  • Collection,Children and Grand Children - The subscription will be effected on the selected collection and its all child resources .

Based on the notification method you select, you may be required to provide additional information such as the e-mail address, role name, user name, endpoints etc. Given below image illustrates adding an Update type subscription to a resource, choosing email as the notification type. 

And a similar kind of subscription is added to a collection where even a hierarchical subscription method is chosen. 

3. Having done this step, click on the "Subscribe" button to add a subscription.

Tip

Use the "Delete" link in the "Actions" column to delete a subscription.

Subscriptions can also be added from Configure > Notifications. Please refer Notifications to get a better understanding about subscriptions. Please also read the Notification E-mail Customization Sample to learn how to customize the E-mail notification template in Governance Registry.