Configuring email notifications

To allow end users receive email notifications for services, a system administrator must configure your company's mail server information and verify that users have valid email accounts with the specified server. A BMC Digital Workplace administrator must configure the Backend URL in Admin console to point to the required host.

Users can then enable email notifications for specific events in their BMC Digital Workplace console. For more information about notification events and types of notifications for end users, see Configuring status updates and notifications.

To configure BMC Digital Workplace to work with your email server

1. From the BMC Digital Workplace server, open the TomcatInstallFolder/external-conf/connect-dwp.properties file in a text editor.

2. Add the following parameters, and provide the values for your company.

   Note

   The smtp.account and smtp.pwd parameters are optional.

   
   The file includes these sample parameters that are commented out.  

   Email server properties

   smtp.host=<mailhost>.<domain>
   smtp.port=<portNumber>
   smtp.account=<accountname>@<domain>
   smtp.pwd=<password>

   If you use the Gmail SMTP server, add the following parameters: 

   Gmail SMTP server properties

   smtp.host=smtp.gmail.com 
   smtp.port=465 
   smtp.account=xxxxxxxxxxxx 
   smtp.pwd=xxxxxxx
   mail.smtp.ssl.enable=true

   Example email settings

   smtp.host=mailhost.calbro.com
   smtp.port=25
   #To enable SSL connection, use 465 port. To enable TLS connection, use 587 port. 
   smtp.account=dwp@calbro.com
   smtp.pwd=calpass

3. Restart the Tomcat server.

To verify that users have valid email accounts

1. From the Application Administration Console, click the Custom Configuration tab.

2. From the Application Settings list, select Foundation > People > People, and then click Open. 

3. Verify the email address on the General tab.

   

To configure the email notifications content 

As the BMC Digital Workplace administrator, you must configure the Backend URL to point to your host. Email notifications include deep links that open the applicable area of BMC Digital Workplace. For example, an email notification about a service status change includes a link to the service profile in BMC Digital Workplace. 

To configure the Backend URL, perform the following actions:

1. In BMC Digital Workplace Admin console, go to Configuration > Email.
2. In the Backend URL field, provide a link that points to your host, as shown in the following illustration:
   
   
   
   

Optionally, you can configure the following custom subjects for email notifications:

• Email notifications about a service status change.
• Email notifications about mentions (with the @ symbol) in the BMC Digital Workplace posts.
  The following illustration shows an example of such mentions:
  
  

To configure the custom subjects, perform the following actions:

1. In BMC Digital Workplace Admin console, go to Configuration > Email.
2. In the Service Change Email Subject field, provide a custom subject. 
   You can use the following placeholders: $serviceName$, $serviceNewStatus$, $serviceOldStatus$. 
   For example, you can provide the following custom subject: $serviceName$ status has changed from $serviceOldStatus$ to $serviceNewStatus$.
3. In the Microblog Activity Email Subject field, provide a custom subject for the mentions in posts.