Forwarding notifications to email

You can configure IBM Software Hub to forward notifications that are generated by services to one or more users or groups.

Before you begin

This feature is available only if you installed a service with a dependency on the IBM Software Hub common core services.

About this task

A target is a list of users or groups that you want to forward notifications to. You can configure multiple targets if you want to forward information about different events to different users.

You can send notifications only to IBM Software Hub users. To receive notifications, a user must have an email address associated with their username.

Procedure

  1. Log in to the web client.
  2. From the navigation menu, select Administration > Configurations and settings.
  3. Click Notification forwarding.
  4. Click New target.
  5. Specify a name and description for the target.
  6. Choose Email recipients. Then, click Create.
  7. On the Events tab, click Add events and select the type of event or events that you want to forward notifications for. Then, click Add.
    You can forward notifications for:
    • Changes to assets in a catalog
    • Changes to data quality SLA violation information in a catalog
    • Changes to data quality SLA assessments in a catalog
    • Changes to assets in a project
    • Changes to data quality SLA violation information in a project
    • Changes to data quality SLA assessments in a project
    • Changes to projects
    • Changes to project members
    • Changes to jobs
    • Changes to job runs
    • Changes to data quality
    • Changes to governance artifacts
    • Changes to metadata imports
  8. By default, all of the events in all workspaces trigger notification forwarding. However, you can specify the criteria under which you want the notifications to be forwarded. Click the Edit icon icon to change the relevant criteria.
    If you modify the criteria, keep the following restrictions in mind:
    • For some criteria, you cannot revert to the event to the default settings. You must re-add the event.
    • You can choose exactly one option for each criteria. For example, you can choose to forward notifications that are associated with a specific catalog. If you want to forward notifications from multiple catalogs to the same target, you must add an event for each catalog.

    The following table specifies which criteria can be modified.

    Event type Workspace Workspace criteria Additional criteria
    Asset Catalogs You can choose a catalog.
    Assets
    You can choose an asset.
    Asset actions
    You can choose an action.
    Data quality SLA violation Catalogs You can select catalogs. You can select assets.
    Data quality SLA assessment Catalogs You can select catalogs. You can select assets.
    Data quality issue Data quality You cannot modify the workspace. You can choose an area.
    Job Jobs You cannot modify the workspace. You can choose a job
    Job run Jobs You cannot modify the workspace. You can choose a job.
    Asset Projects You can choose a project.
    Assets
    You can choose an asset.
    Asset actions
    You can choose an action.
    Project Projects You can choose a project. No additional criteria.
    Project members Projects You can choose a project. No additional criteria.
    Data quality SLA violation Projects You can select projects. You can select assets.
    Data quality SLA assessment Projects You can select projects. You can select assets.
  9. On the Email recipients tab, click Add recipients to specify the users or groups that you want to forward the notifications to.
    Remember: You can forward notifications only to IBM Software Hub users who have an email address associated with their username. If you choose a user who does not have an email address associated with their user name, the user is not added to the mailing list.
    You can use the Send test email button if you want to confirm that the specified users can receive notifications. The test email contains the following message:
    This is a test email
  10. By default, the notification emails are in English. If you want the notifications to be translated into another language, choose the language to use in the email.
  11. Click Save.
  12. Click Activate to start forwarding notifications to the specified users and groups.