Subscribing to governance events

You can use the Subscription Manager to send notifications to an application whenever governance events of various types are generated.

Before you begin

To use the sample process applications that are provided by IBM® InfoSphere® Information Governance Catalog, download, import, and configure the Email Notification and the Governance Rule Approval applications.

To use the default email notification option in Subscription Manager, you must configure the email provider. This prerequisite does not apply to using the Email Notification sample process application.

To subscribe to governance events, you must have the following roles and credentials:
  • To open Subscription Manager, you must have the InfoSphere Information Server suite user role or higher.
  • To create subscriptions that use the sample process applications or any other IBM Business Process Manager applications, you must specify the user name and password of an IBM BPM user of the computer where IBM Stewardship Center is installed.

About this task

Most governance event types can use the Email Notification sample process application, which provides more information on governance assets than the default email notification option in Subscription Manager. The sample process application sends notifications to selected users by using IBM BPM.

To use the Governance Rule Approval sample process application, you create a subscription to the event type IGC_BUSINESSRULE_EVENT.

Procedure

  1. Open Subscription Manager.
  2. On the Subscriptions tab, click Add.
  3. In the Add Subscription window, enter a name for the subscription.
  4. Select a governance event type.
  5. Select and configure the form of notification.
    Option Description
    To use the sample Email Notification or Governance Rule Approval sample process applications, or any other application that uses IBM BPM
    1. Select Application
    2. Select an application that is registered for your event type and specify your IBM BPM user name and password.
    .
    To use the default Subscription Manager email notification for the event type IGC_GLOSSARY_IMPORT_EVENT or any other event type
    1. Select Email
    2. (Optional) Specify other suite users to receive copies.
    .
  6. Filter the events that you receive due to this subscription. Click Filter event type and specify valid values for any properties of the event type that you want to filter on.
    By filtering, you subscribe to only those events that are important to you. If you specify multiple values, your subscription includes only those events for which all specified values are true.
    • To use the Governance Rule Approval sample process application, filter on the action SEND_FOR_APPROVAL.
    • To use the Email notification process, filter on one of the following actions: CREATE, MODIFY, SEND_FOR_APPROVAL, RETURN_TO_DRAFT, ADD_COMMENT, APPROVE, PUBLISH. The DELETE and DISCARD actions are not supported for the Email Notification application.

Examples of creating a subscription

Subscription to notify users of pending approval for an information governance rule

A steward modified an information governance rule. The modified rule must be approved before it can be moved to the catalog in InfoSphere Information Governance Catalog. Workflow is enabled in InfoSphere Information Governance Catalog.

The steward uses the istool event registerCallback command to register the Governance Rule Approval application to work with IGC_BUSINESSRULE_EVENT.

In Subscription Manager, the steward creates a subscription to IGC_BUSINESSRULE_EVENT, selects Application as the notification type, selects the Governance Rule Approval sample process application and specifies IBM BPM credentials. The steward filters the events by typing SEND_FOR_APPROVAL as the value for the ACTION property.

When the information governance rule is set to Pending Approval in InfoSphere Information Governance Catalog, the subscription notifies the specified email recipients to approve or reject the modified rule.

Subscription to notify users of changes in terms

A steward wants to use the Email Notification sample process application to handle any events in which terms are modified in InfoSphere Information Governance Catalog. She uses the istool event registerCallback command to register the application to work with the IGC_BUSINESSTERM_EVENT.

In the Subscription Manager, the steward creates a subscription to IGC_BUSINESSTERM_EVENT. She selects Application as the notification type, and selects Email Notification as the application. She filters the event type on the ACTION property, specifying the value MODIFY. When terms are modified in InfoSphere Information Governance Catalog, her subscription notifies the specified users by email.