This documentation supports the 19.05 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 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>
    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. Cosmina florentina Rinciog

    You should update the documentation: in this version 18.08, there is no more connect.properties, you have renamed the file to connect-dwp.properties.

    Nov 26, 2018 07:48
    1. Olga Kutetska

      Hello!

      Thank you very much for pointing to the problem. We will update the page as required.


      Nov 26, 2018 07:57
  2. Stefan Koenig

    Is it possible to change the content of the mail which is send? As described here, it is only possible to change the subject of the mail.

    Feb 19, 2019 06:03
    1. Ravee Panjwani

      That is correct, Stefan. It is not possible to change the content of the email at this point.

      Thanks, Ravee

      Mar 01, 2019 12:33