Setting up email for mailing reports

After generating a report, you can send it to multiple recipients via email as a PDF file or as an attached zipped HTML file. You can also publish a generated report. For more information, see Publishing a report.

From the Mail tab, you can define the settings, like encryption type, user name, and password, for the email that contains your generated report. See detailed description of the mail settings in Managing email settings.

As reports can be assigned to several groups, every recipient in the distribution group receives the email with the report designated for that group. Each email specifies the group name and the attachment in the following format: 

  • Subject: <subject text> <group name>
  • Attachment: <report name>.<group name>.<file extention>

For Example:

Subject: Have a look at this!

All Devices with Agent Attachment: Hardware Summary List. All Devices with Agent.html

Before you begin 

Before you can send an email to a specific recipient, an administrator, or an administrator group, you must ensure that the email is set up for the BMC Client Management. For more information, see Managing email settings.

To set up the email for mailing reports

  1. In the left window pane of the BMC Client Management application select Reports and then select the required report from the list.
  2. In the right window pane, select the Mail tab.
  3. Select Edit > Add email
    The Define Mail dialog box is displayed.
  4. To add recipients, click To , CC , BCC.
    The Select an Address dialog box is displayed.
  5. Perform one of the following actions:

    ActionPurposeDescription
    Select from ListTo select an administrator or an administrator groupIf you select an administrator group as recipient, the email will be sent to all members having a valid email address specified in their respective General tab.
    Select ManuallyTo enter any valid email address into designated text boxYou can enter more than one email address by using a semicolon as separator. For example: scotty@enterprise.com;kirk@enterprise.com
  6. (Optional) Enter a subject in the Subject text box.
    This text box can contain up to 256 characters. If this text box is left empty, the subject of the email will only consist of the Group's name the respective report is assigned to.

  7. (Optional) Enter a message into the designated text box. You can use up to 2000 characters. 

  8. From the Export Format list, select the format of the attached report .
  9. (Optional) Clear the Attach Report to Mail check box.
    If you clear this check box, the email will only contain a link to the storing location of the respective report in the Report Portal of the agent interface.

  10. To confirm the data for the email and add it to the list, click OK.

To enable HTML reports to be displayed in the email body for Windows

After 21.02.03 patch for on-premises installations you can generate an HTML report that will be sent in the email as an attached zipped file. In order to activate this option, you need to install Node.js. Users with limited system access or permissions find HTML reports more convenient than receiving files.

  1. Download Node.js from the official Node.js website Open link . You should choose the most suitable LTS version; 16.x is recommended. Install it by using the wizard.



  2. From Windows PowerShell terminal, run the npm install -g puppeteer@18.2.1 command.

  3. Set NODE_PATH in the System environment variable with the complete path of the node_modules folder containing the puppeteer module. The default path for Windows is C:\Users\<user>\AppData\Roaming\npm\node_modules, where <user> stands for the current Windows logged in user.





  4. To enable attached html email, in Vision64Database.ini set EmbeddedHtmlEmail to true:
    [Report]
    EmbeddedHtmlEmail=true

    [Report]
    
    Defines if we want to use embedded HTML emails(no attachments)
    This requires installation of Node.js and puppeteer module.
    
    EmbeddedHtmlEmail=true 
    
    [OpRUleThread]
    
    Section for OPRule thread settings. The Op Rule thread is a background thread that runs periodically updating Op Rules and their results.


  5. For the System environment settings to be implemented, restart the BCM Service or reboot the machine.

  6. In the BCM Client Management application, from the Mail tab > Export Format list, select html.
  7. Select Attach Report to Mail check box.

To enable HTML reports to be displayed in the email body for Linux

  1. Download Node.js from the official Node.js website.
    To install Node.js for the Linux Distributions, download
    Package installation. The detailed instructions on the installation process are available on the Node.js Documentation page. The process of implementing settings for HTML report is described in the Debian master example.

  2. From the terminal, run the following commands:

    install curl if not already installed: sudo apt-get install curl
    sudo curl -fsSL https://deb.nodesource.com/setup_16.x | sudo bash -
    sudo apt-get install -y nodejs npm
    sudo npm install -g puppeteer@18.2.1
  3. To enable attached html email, in Vision64Database.ini set EmbeddedHtmlEmail to true:

    [Report]
    
    EmbeddedHtmlEmail=true
  4. Restart BMC Client Management Service.

  5. Modify convertHtmlReportAsImage.js in ../data/Vision64Database/reports/common/js/ by following further steps:

    1. Add the default path for puppeteer. Line 1 should read:
      const puppeteer = require ('/usr/lib/node_modules/puppeteer')

    2. Add launch parameters to the launch function. Line 4 should read:
      const browser = await puppeteer.launch({
      executablePath: '/path/to/Chrome',
      args: ['--no-sandbox']});

  6. In the BCM Client Management application, from the Mail tab > Export Format list, select html. And then Select Attach Report to Mail check box.

Where to go from here

Previewing a report

Publishing a report

Scheduling the report generation

Related topic

Types of report Open link

Creating a report Open link

Generating a report Open link

Publishing a report Open link

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

Comments