Configuring Per-project and Per-Component Email Notifications

This topic describes how to configure email notifications on a project-specific and component-specific basis using the change request component as an example. You should have already enabled email support and email notification messages.

  1. Navigate to the Notifications folder installed with StarTeam Server. The Notifications folder installs as a subfolder of your StarTeam Server installation. By default, StarTeam Server is installed in the C:\Program Files\Micro Focus\StarTeam Server <version> folder.
    Tip: Make a copy of the Notifications folder before making any modifications. You can revert to this copy if you make any undesirable changes.
  2. You can edit the component-specific *.xml file for the component (change request, task, topic, requirement) that you want to use for project-specific notifications. Open ChangeRequest.xml and type the following rules for a specific project:
    <rule-list>
     <rule project=”MyProject” event=”new” template=”MyProject-cr-new-txt”/>
     <rule project=”MyProject” event=”modified” template=”MyProject-cr-modified-txt”/>

    In the above example, “MyProject” corresponds to your specific project name. These entries must go before the following default <rule project="*" event="new" template="cr-new-html"/> and <rule project="*" event="modified" template="cr-modified-html"/> entries.

  3. Enter the template information used for your project under the <template-list> tag. For example,
    <template-list>
      <template-id=”MyProject-cr-new-txt”>
        <subject>New Change Request #~~ChangeNumber~~</subject>
        <body content-type>”text/plain” template-file=”.\MyProject-cr-new.txt”/>
      </template>
      <template-id=”MyProject-cr-modified-txt”>
        <subject>Modified Change Request #~~ChangeNumber~~</subject>
        <body content-type>”text/plain” template-file=”.\MyProject-cr-modified.txt”/>
      </template>
  4. Save the changes and close the template files.
  5. Copy your new template files and updated ChangeRequest.xml file to the Notifications folder in your repository.