Email basic reports

Before you can email Power Operation basic reports, configure the SMTP server and email list(s). See Configure email settings to send basic reports for details.

There are 3 ways to email basic reports:

  1. The Report Viewer email button
  2. Visit a Specific URL
  3. Use Cicode via ReportMailer

Report Viewer email button

Use this method to send a customized one-time email to an individual or group of email addresses.

  1. Run the report as normal.
  2. In the Report Viewer, click (Email) .
  3. Enter the requested information in the pop-up dialog.
  4. Click Send.

Visit a Specific URL

NOTE: Each visit to a URL causes the email to be sent. Be sure that you have the correct report and email list before you visit this URL/send the email. Also, you should secure this URL using the web.config file. For information on modifying/using the web.config file, see http://support.microsoft.com, and search on kb 815179.

To send a basic report to an existing email list, visit the following URL:

http://<ServerName>/Reporting/Report/<ReportName>/<ConfigurationName>/Email/<EmailList>

where:

  • <ServerName> = the name or IP of the reporting server
  • <ReportName> = the name of the report you wish to view
  • <ConfigurationName> = the name of the saved configuration to use
  • <EmailList> = the name of the email list you wish to use

You must use a saved configuration (see Create and view basic reports for instructions). You cannot change report parameters from this URL.

No progress bar or update will display, as these interfere with some scheduling clients.

Use Cicode via ReportMailer

You can use a utility called ReportMailer to email basic reports. This command line utility is located in the PLS_Include project. It can be called by Cicode. You can create a button on the graphics page and have it call the Cicode function or use a scheduled process to trigger an email.

Before you can use ReportMailer, you need to create or edit the file called ReportMailer.ini file that is in your project (not in PLS_Include). The ReportMailer.ini file must include the text listed in the following table:

Text Field

Required Setting

Description

LoginUsername

demo

Username for logging in to reporting system for emailing reports

LoginPassword

demo

User's password, will be encrypted on the first run

IsEncrypted

False

Flag that indicates if the password is encrypted. If you change the password, edit the field (replacing the unreadable encrypted entry, if one exists). Then change this value to False. The new password will be encrypted at the next startup cycle, and this field will be updated to True.

ScadaBinPath

C:\Program Files (x86)\Schneider Electric\Power Operation\v2024\bin

The bin path of Power Operation

LogOnUrl

http://SCADASERVER/
Reporting/LogOn.aspx

The URL of the logon page(this is an example; use your own server name)

ReportServerName

SCADASERVER

The name or IP address of the server running the reporting application

LogLevel

All

The level of logging you want in the report mailer application. This log is saved to a ReportMailerLog.txt file in the running project's directory. Possible settings are ALL, DEBUG, ERROR, WARN.

 

After this file is configured, run the ReportMailer.exe with the following syntax:

ReportMailer.exe <ReportName> <ConfigurationName> <EmailList> <ScadaProjectPath>

where:

  • <ReportName> = the name of the report you wish to view
  • <ConfigurationName> = the name of the saved configuration to use
  • <EmailList> = the name of the email list you wish to use
  • <ScadaProjectPath> = the full path to your SCADA project

This command line application may be called from Cicode using the following example:

FUNCTION
PLS_EmailReport()
ErrSet(1);
STRING FilePath = ParameterGet("CtEdit","User","") + "\PLS_Include\
ReportMailer.exe " + "MultiDeviceReport SampleConfiguration SampleList " +
"^"C:\ProgramData\Schneider Electric\Power Operation\User\PLS_Example^"";
Exec(FilePath);
END

NOTES:

  • The SCADA project path must be enclosed in escaped quotes ("^").
  • This is an asynchronous (non-blocking) call. While the EXEC() method will return immediately, it may take a few moments to run and email the report. See the web.config timeout value (see option 2 previously) for more information.
  • You can also call the ReportMailer application directly from a command line. In this case, you can add the term "blocking" to the command line (as a fifth parameter). This causes ReportMailer to act in a synchronous state (block the call) and to return any error messages to the console. Never use the "blocking" parameter by Cicode, as it could prevent EXEC() from returning in a timely fashion.

Scheduling basic reports

You can schedule the emailing of basic reports by executing the previous Cicode as an action from a timed event. For more information, see Configuring Events in the Plant SCADA help file ( ..\Program Files (x86)\Schneider Electric\Power Operation\v2024\bin\Help\SCADA Help).

You can also use the Windows Task Scheduler to send these reports. Refer to Microsoft's documentation on Using the Task Scheduler (Microsoft Docs).