Registering sample process applications with governance event types

To receive email messages for governance events and to approve information governance rules for publication, register the sample process applications with specific event types.

About this task

Before you can use applications in subscriptions to governance events, you must use the istool event registerCallback command to register the applications.

IBM® InfoSphere® Information Governance Catalog provides the following sample process applications that work with governance event types and use IBM Business Process Manager:
Governance Rule Approval
Use this application to manage approval of information governance rules in IBM Stewardship Center. The application sends email to selected users when information governance rules are set to the Pending Approval status. It creates tasks for approval actions in IBM Stewardship Center.
Email Notification
Use this application to send email to selected users when governance assets are created, modified, or subject to a workflow action. You must register the application separately for each event type that you want to receive notification about.

For details about the sample process applications, see Sample stewardship processes for governance events.

For details about the types of governance events, see Governance event types and their properties.

Procedure

  1. Register the IGC_BUSINESSRULE_EVENT event type with the Governance Rule Approval sample process application by using the event registerCallback command:
    event registerCallback 
    authentication parameters
    generic parameters
    -eventTypeName IGC_BUSINESSRULE_EVENT  
    -callbackType HTTP_POST
    -callbackName "Governance Rule Approval"
    -callbackService "https://BPM_Server:SSL_Port/rest/bpm/wle/v1
    /service/IIGC@StartRuleApproval?action=start"
    -callbackDescription "This application sends email to selected users when the 
    governance event type IGC_BUSINESSRULE_EVENT occurs for a SEND_FOR_APPROVAL action. 
    You can use the application to track approval of information governance rules."
    

    Authentication parameters specify the IBM InfoSphere Information Server services tier to connect to. For details, see Table 2 in Commands and common parameters for istool.

    Generic parameters are parameters that can be used in any istool command. For details, see Table 3 in Commands and common parameters for istool.

    BPM_Server:SSL_Port specifies the server and port where IBM BPM is installed.

  2. Register the IGC_BUSINESSTERM_EVENT event type with the Email Notification sample application by using the event registerCallback command:
    event registerCallback 
    authentication parameters
    generic parameters
    -eventTypeName  IGC_BUSINESSTERM_EVENT  
    -callbackType  HTTP_POST
    -callbackName  "Email Notification"
    -callbackService  "https://BPM_Server:SSL_Port/rest/bpm/
    wle/v1/service/IIGC@StartEMail?action=start"
    -callbackDescription "This application sends email to selected users when any 
    governance event type except IGC_GLOSSARY_IMPORT_EVENT occurs. The application 
    is invoked for all action types except deletion of an asset."
    
  3. Repeat step 2 to register the Email Notification sample process application for each event type that you want to receive notifications about. Change the value of -eventTypeName for each command.
    You can script the commands.

What to do next

After you register an application for an event type, create a subscription in Subscription Manager that links the event type to the process. When actions occur in InfoSphere Information Governance Catalog that generate governance events of the type that you subscribe to, the events are processed by the sample applications.