auto-multiple-choice-mailing — mail PDF annotated completed answer sheets to students
auto-multiple-choice
mailing [--xmlargs args.xml
] --project
project-dir
--students-list
students-list.csv
[--list-encoding encoding
] --email-column
col
--sender
sender-email
--subject
subject
--text
email-body
[--text-content-type
content-type
] [--debug file.log
] [transport
arguments
...]
The command auto-multiple-choice mailing sends by email the PDF annotated completed answer sheets to the students. Email addresses are taken from the students list file.
--project
project-dir
Gives the project directory.
--students-list
students-list.csv
sets the students list file name.
--list-encoding
encoding
selects an encoding for file
students-list.csv
(default is
utf-8).
--email-column
col
sets the name of the column containing the email addresses of the students in the students list file.
--sender
sender-email
sets the sender email.
--cc
cc-email-address
sets the carbon copy email address.
--bcc
bcc-email-address
sets the blind carbon copy email address.
--subject
subject
sets the subject of the emails to send.
--text
email-body
sets the body text of the emails to send.
--text-content-type
content-type
sets the content-type of email text.
content-type
may be
text/plain
or
text/html
.
--attach
filename
adds file filename
as an
attachment to all emails sent. Use this option several times to
attach multiple files.
--transport
transport
sets the transport to use.
transport
may be
sendmail
or
SMTP
.
--debug
file.log
gives a file to fill with debugging information.
--delay
time
sets a delay of time
seconds
between each sending.
Depending on the value used for argument
transport
, the following arguments can be
added:
--sendmail-path
path
sets the path to the sendmail command
(defaults to /usr/sbin/sendmail
).
--smtp-host
host
sets the SMTP hostname (defaults to
smtp
).
--smtp-port
port
sets the port to use (default value is 25).
--smtp-ssl
mode
sets the security mode for the SMTP connection. The
option mode
can be
ssl
, starttls
, or 0
(unsecured).
--smtp-user
user
sets the username for authenticated SMTP.
--smtp-passwd-file
file
gives the path of a file containing the password (as the first line of the file) for authenticated SMTP.
To avoid encoding problems, one can place some arguments in a
XML file and use the --xmlargs
argument as the first
command argument. Here is an example of such a file:file.xml
<?xml version="1.0" encoding="UTF-8"?> <arguments> <arg>--sender</arg><arg>Bienvenüe <paamc@passoire.fr></arg> <arg>--text</arg><arg>Voilà votre copie corrigée</arg> <arg>--subject</arg><arg>QCM</arg> </arguments>