This documentation supports the 19.08 version of BMC Digital Workplace Advanced.

To view an earlier version, select the version from the Product Version menu.

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

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.

  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. 

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:

  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.

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Daniel Soto

    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

    Nov 19, 2019 05:24