View source for Emailing reports

__NOTOC__
ReportComplete can E-Mail reports to parents by logging into your school email SMTP server.  Although this feature is '''experimental''' and E-Mail itself has some inherent security risks (see [[E-mail security]]), it has been used by many schools during the recent COVID-19 pandemic without any reported issues.

'''Sending e-mails using ReportComplete is done entirely at your own risk.'''

<gallery widths=550px heights=300px perrow=1>
email_documents1.png|1. Click the 'Admin' toolbar icon, then select 'E-Mail Documents (experimental)'.
email_documents2.png|2. Fill in the form with your server details, you may need to consult your ICT technician for some of the settings.
</gallery>

==== Settings: ====

'''Server:''' Your SMTP (outgoing) server address.

'''Encryption:''' The type (if any) of encryption, the '''Port''' will be set automatically.

'''Username:''' The username you use to log in to the SMTP server.

'''Password:''' The password you use to log in to the SMTP server (not saved for security reasons).

'''From:''' Your normal E-Mail address.

'''Subject:''' The E-Mail subject text (can contain special [[Control codes]]).

'''Body:''' The E-Mail text body (can contain special [[Control codes]]).


Once you have filled in the form, click 'Test'.  This will send a test E-Mail to check your settings have been entered correctly.  Settings (apart from the password) are automatically saved when you exit the window.

==== Sending: ====
You should see a list of any previously selected pupils in a list, you can toggle between selected and 'all listed' pupils.  Any pupils coloured red will be skipped as they do not have an E-Mail address associated with them.  Click 'Start' to start the sending process.  Sending E-Mails can take a considerable amount of time (especially if 'Higher quality' is ticked), each report must be generated, converted to images, compressed, then sent.  The report is converted to images to ensure its properly formatted and viewable on virtually any type of device.

==== Secured SMTP servers: ====
Some E-Mail SMTP servers need to have special settings or a custom password to allow third-party programs to access them.  In this case, you would need to contact your E-Mail provider or (if you have access) alter the server options yourself to allow ReportComplete.  For example, here is how you create a custom password for Gmail:

<gallery widths=550px heights=300px perrow=1>
google_email1.png|1. Go to [https://myaccount.google.com/security myaccount.google.com/security], you may need to enter your Google account E-Mail address and password.
google_email2.png|2. Click the '>' symbol on 'App passwords'.
google_email3.png|3. Select 'Mail' as the type of App.
google_email4.png|4. Select 'Windows Computer' as the type of device.
google_email5.png|5. Click 'Generate' to create a special password for ReportComplete.
google_email6.png|6. Copy the password, you will need to save it somewhere as ReportComplete will not remember it (for security reasons).
google_email7.png|7. Paste the password into ReportComplete, set ''''smtp.gmail.com'''' as the E-Mail server, select '''SSL/TLS''' (the port will change to '''465'''), type in your google E-Mail address in the 'username' and 'from' fields.  Click 'Test' to make sure everything is working as it should.</gallery>

==== Office365 Email ====
The SMTP AUTH protocol is used by ReportComplete for email submission (typically on TCP port 587), unfortunately, this may be blocked on your Office365 account as they normally use 'Modern Auth'.  Fortunately, there is a setting for each mailbox to override this.


The per-mailbox setting to enable (or disable) SMTP AUTH is available in the Microsoft 365 admin center:
# Open the Microsoft 365 admin center and go to Users > Active users.
# Select the user, and in the flyout that appears, click Mail.
# In the Email apps section, click Manage email apps.
# Verify the Authenticated SMTP setting: unchecked = disabled, checked = enabled.
# When you're finished, click Save changes.


To verify that you've enabled or disabled SMTP AUTH for a specific mailbox, do the following steps:
# Go to Users > Active users.
# Select the user.
# Click Mail.
# Click Manage email apps.
# Verify the value of Authenticated SMTP (checked = enabled, unchecked = disabled).