WSO2 Governance Registry v3.0.2

• Home
• Release Note

Downloads

• Releases

Documentation

• Index
• Installation Guide
• Quick Start
• User Guide
• Developer Guide
• Provisioning Guide
• External Articles

Samples

• Samples Guide

Getting Help

• Mailing Lists
• Wiki
• Forum
• Library

Get Involved

• Checkout the Source
• Mailing Lists

Project Information

• Issue Tracking
• License

WSO2 Governance Registry - User Guide [ Documentation Index ]

WSO2 Governance Registry - User Guide

WS-Eventing and Notifications

The Notifications feature can be used to generate notifications for events that occur as a result of performing operations. In order to receive notifications, users will have to create a subscription to a particular event along with a specified notification method (which can be an e-mail alert or a SOAP message). Each subscription is associated with a resource or collection on the registry. The Manage Notifications page can be used to create, edit, or delete subscriptions to notifications on various operations performed on resources and collections stored in the registry.

The Governance Registry supports a predefined set of events to which notifications can be generated, and also allows a developer to add several others through the OSGi service. 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.
• 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.
• Change LC State - Represents an event of changing a lifecycle state.
• Update - Represents an event of updating a resource or collection.

Please note that some of these events may not be available for certain types resources and collections. We support a variety of notification methods as well.

• E-mail - Any valid e-mail address.
• HTML/Plain-Text - 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.

There are two main ways made available to subscribe to notifications generated by the registry. You can either use the resource browser's Subscriptions portlet, or you can go to the notifications configuration page. The WSO2 Governance Registry makes use of WS-Eventing to generate notifications and publish in various formats. Figure 24: Manage Notifications To send e-mail notifications, you need to configure the mail transport in axis2. This can be done by adding the following configuration to the axis2_client.xml file found in CARBON_HOME/conf.

    <transportSender name="mailto" class="org.apache.axis2.transport.mail.MailTransportSender">
        <parameter name="mail.smtp.host">smtp.gmail.com</parameter>
        <parameter name="mail.smtp.port">587</parameter>
        <parameter name="mail.smtp.starttls.enable">true</parameter>
        <parameter name="mail.smtp.auth">true</parameter>
        <parameter name="mail.smtp.user">USERNAME</parameter>
        <parameter name="mail.smtp.password">PASSWORD</parameter>
        <parameter name="mail.smtp.from">USERNAME@gmail.com</parameter>
    </transportSender>