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
- From the BMC Digital Workplace server, open the TomcatInstallFolder/external-conf/connect-dwp.properties file in a text editor.
Add the following parameters, and provide the values for your company.
Note
The
smtp.account
andsmtp.pwd
parameters are optional.
The file includes these sample parameters that are commented out.Email server propertiessmtp.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 propertiessmtp.host=smtp.gmail.com smtp.port=465 smtp.account=xxxxxxxxxxxx smtp.pwd=xxxxxxx mail.smtp.ssl.enable=true
Example email settingssmtp.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
- Restart the Tomcat server.
To verify that users have valid email accounts
Note
Notifications use the work email address defined in the CTM:People form of BMC Remedy ITSM. If a user specifies an additional email address in the BMC Digital Workplace settings, this email address is not used for notifications.
To enable end users to update their work email address from their profile on BMC Digital Workplace, you must enable the User Profile Data Editing setting in the BMC Digital Workplace Admin console. When this setting is enabled, the work email address updated in BMC Digital Workplace is synchronized with the CTM:People form. For more information about this setting, see Changing client functionality options.
- From the Application Administration Console, click the Custom Configuration tab.
From the Application Settings list, select Foundation > People > People, and then click Open.
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.
Important
Configuration of the Backend URL is a mandatory step in enabling email notifications for end users. If the Backend URL is not configured, end users do not receive email notifications.
To configure the Backend URL, perform the following actions:
- In BMC Digital Workplace Admin console, go to Configuration > Email.
- 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:
- In BMC Digital Workplace Admin console, go to Configuration > Email.
- 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$. - In the Microblog Activity Email Subject field, provide a custom subject for the mentions in posts.
Comments
If you are using Gmail's smtp server, these are the lines you need to add to connect-dwp.properties
smtp.host=smtp.gmail.com smtp.port=465 smtp.account=xxxxxxxxxxxx smtp.pwd=xxxxxxx mail.smtp.ssl.enable=true