QuickMail 2.0
© Copyright 2003-2006 Astase
www.astase.com
Avant tout, merci de lire et
d'accepter la licence d'utilisation du produit en cliquant ici afin d'utiliser QuickMail.
Présentation
QuickMail est une application
permettant d'envoyer des mails en ligne de commande.
Vous pourrez ainsi envoyer des messages via des programmes, ou des
fichiers Batch.
Par défaut, QuickMail procède ainsi :
- Analyse de la ligne de commande et préparation de
l'envoi
- Envoi de(s) mail(s)
- Réussi ? Si oui, QuickMail quitte.
- Si non, QuickMail recommence un nombre déterminé
de fois avant d'arrêter (3 par défaut).
Pour plus d'efficacité, placez QuickMail dans un répertoire dans le PATH (par exemple dans le répertoire de Windows), vous pourrez ainsi l'appeler sans préciser à chaque fois un chemin d'accès.
Le programme affiche tous les messages en anglais pour une universalité de compréhension. Si vous voyez des fautes, n'hésitez pas à nous contacter pour les corriger !
Les paramètres sont de la forme
suivante :
-Paramètre:"Valeur"
La valeur du paramètre doit être
encadrée de guillemets. Les paramètres sont séparés entre eux par des
espaces :
-h:"smtp.logic.com" -t:"Moi@moi.com" -f:"o@nw.org" -s:"Salut !" -b:"Test..."
Les liste des paramètres que l'application accepte est inscrite ci-dessous. A chaque paramètre est associé un "Paramètre court" (en une ou deux lettres), permettant de réduire la longueur de la ligne de commande, mais jouant le même rôle que les paramètres longs. Par exemple, les deux lignes ci-dessous sont identiques :
-AttachedFile:"C:\Test.exe"
-af:"C:\test.exe"
QuickMail ne différencie pas les minuscules des majuscules dans les
paramètres de la ligne de commande.
Sous les versions personnelles de Windows, la longueur de la ligne de
commande est limitée. Si votre ligne de commande est trop longue,
placez là dans la première ligne d'un fichier texte, et utilisez le
seul paramètre :
-z:"<adresse_du_fichier_ligne_de_commande>"
La première ligne du fichier passé en paramètre sera traité comme une
ligne de commande du logiciel.
En cas d'erreurs, QuickMail n'affiche aucun message afin de ne pas bloquer un processus d'envoi pouvant être automatique. Par contre, il s'arrête et renvoie un code d'erreur que vous pouvez récupérer ultérieurement dans vos programmes (voir liste des codes d'erreur ci-dessous).
Enfin, vous ne pouvez pas utiliser le
caractère ' " ' (guillemet) pour un autre usage que la délimitation des
paramètres dans la ligne de commande. Si vous souhaitez en insérer sans
perturber la ligne de commande, utilisez la séquence de caractères
\*\\, qui sera remplacée à l'exécution par '"'.
De même, il est possible d'insérer des retours à la ligne en utilisant
la séquence suivante : \n\\
Ces équivalences ne sont pas
remplacées dans le fichier où QuickMail doit importer le texte du mail
(si le paramètre "BodyFile" est spécifié), puisque celles-ci n'étant
pas dans la ligne de commande, sont autorisées.
Paramètres QuickMail
Paramètres obligatoires
-Host : Serveur SMTP assurant
l'envoi du mail
Ex : -Host:"smtp.free.fr"
Equivalent court : -h
-From : Adresse E-Mail de
l'expéditeur
Ex : -From:"moi@aol.com"
Equivalent court : -f
-To : Adresse E-Mail du destinataire. Si il y en a plusieurs,
ils doivent être séparés par des virgules.
Ex : -To:"jdl@aol.com"
Equivalent court : -t
Paramètres facultatifs
Concernant le message lui-même
-Subject : Sujet du mail.
Ex : -Subject:"Ton nouveau chat"
Equivalent court : -s
-Body : Corps du mail. Les
caractères "\n\\" seront remplacés par des sauts de ligne à l'exécution.
Ex : -Body:"Bonjour,\n\\\n\\Nous avons bien reçu votre demande, nous la
traitons dès que possible.\n\\\n\\Jean DUPOND."
Equivalent court : -b
-BodyFile : Uniquement si BODY
n'est pas précisé. Importe le corps du mail depuis un fichier texte.
Ex : -BodyFile:"c:\lettres\lettre_generique.txt"
Si le fichier n'est pas trouvé, l'envoi continue, sauf si le
commutateur "-fqf" est trouvé sur la ligne de commande.
Equivalent court : -bf
-CC : Adresses email séparées
par des virgules, où seront envoyé le message en "Carbon Copy".
Ex : -CC:"yan@caramail.com,xmickael@aol.com"
Equivalent court : -cc
-BCC : Adresses email séparées
par des virgules, où seront envoyé le message en "Blind Carbon Copy"
(cci).
Ex : -BCC:"yan@caramail.com,xmickael@aol.com"
Equivalent court : b-cc
-ReplyTo: Si ce paramètres est
spécifié, il permet de sélectionner comme adresse de retour une autre
que celle de la personne ayant envoyé l'e-mail.
Ex : -ReplyTo:"norepy@moi.com"
Equivalent court : -r
-MailAgent: Identifie le
logiciel ayant envoyé le mail.
Ex : -MailAgent:"Microsoft Outlook Express 6.0"
Equivalent court : -ma
-Port: Permet de changer le port
du serveur SMTP utilisé (par défaut, 25)
Ex : -pt:2025
Equivalent court : -pt
-Charset: Identifie le jeu de
caractères du message.
Ex : -Charset:"iso-8859-1"
Equivalent court : -cs
-ContentType: Identifie le type
du contenu de l'e-mail.
Ex : -ContentType:"text/plain"
Equivalent court : -ct
-ContentDisposition: Identifie
le paramètre spécial "Content-Disposition" du mail.
Equivalent court : -cd
-ContentTransfertEncoding:
Identifie le paramètre spécial "Content Transfert Encoding" du mail.
Equivalent court : -ce
-HeloName: Identifie le
paramètre qui sera envoyé lorsque le serveur SMTP demandera la
présentation de l'utilisateur (HELO)
Ex : -HeloName:"82.63.110.4"
Equivalent court : -hn
-Organization: Identifie l'organisation ayant envoyé le message
Ex : -Organization:"My Compagny Inc."
Equivalent court : -o
-Priority: Change la priorité
"Normale" du message par une des propriétés suivantes :
0 : La plus lente, 1 : lente, 2 : normale, 3 : rapide, 4 : urgente.
Ex : -Priority:"4"
Equivalent court : -p
-AttachedFile: Permet de
spécifier le fichier à joindre à l'e-mail. Plus la pièce jointe pèse
lourd, plus l'envoi du message s'en trouve ralenti.
Ex : -AttachedFile:"C:\patch.exe"
Si le fichier n'est pas trouvé, l'envoi continue, sauf si le
commutateur "-fqf" est trouvé sur la ligne de commande.
Equivalent court : -af
-FromFile: Lis la ligne de
commande à partir d'un fichier texte. La PREMIERE ligne du fichier doit
contenir les arguments, et seule celle-ci est traitée.
Si des variables d'environnement Batch sont dans le fichier texte,
celles-ci sont développées.
Ex : -FromFile:"C:\Args.txt"
Equivalent court : -z
-TimeOut: Spécifie le délai
maximum en millisecondes au delà duquel la connexion sera abandonnée si
aucune réponse n'a été reçue du serveur. Si ce paramètre est ignoré,
les valeurs par défaut sont utilisées.
Ex : -tt:"5000"
Equivalent court : -tt
-RCount: Spécifie le nombre
d'essais d'envois que doit effectuer QuickMail avant d'abandonner ce
dernier si le mail ne peut-être transmis.
Par défaut, ce paramètre vaut 3.
Ex : -rc:"10"
Equivalent court : -rc
-Noretry: Abandonne
automatiquement l'envoi si le mail ne peut être transmis lors du
premier essai.
Ce paramètre revient à utiliser : -rc:"1".
Equivalent court : -nr
-BodyTempFile: Spécifie que le
fichier body (si -bf est utilisé) est temporaire et qu'il doit être
détruit après envoi.
Le fichier est détruit UNIQUEMENT si le mail est envoyé avec succès.
Equivalent court : -btf
-AttachedTempFile: Spécifie que
le fichier attaché (si -af est utilisé) est temporaire et qu'il doit
être détruit après envoi.
Le fichier est détruit UNIQUEMENT si le mail est envoyé avec succès.
Equivalent court : -atf
-Waittoclose: Attends que
l'utilisateur presse une touche au lieu de fermer automatiquement la
fenêtre.
Equivalent court : -w
-Ret: Affiche le code de retour de QMail avant de s'arrêter.
-fqf: (Force quit if not found)
: Arrête QMail si les fichiers attachés (-af) ou de body (-bf) n'ont pu
être trouvés.
-> Serveur SMTP et
authentification
Certains serveurs SMTP requièrent que l'utilisateur s'identifie avant
d'envoyer un mail par le biais d'un couple nom d'utilisateur / mot de
passe.
Si vous êtes dans ce cas, vous devez d'abord :
++ Activer le mode LOGIN :
- login (ou -lg)
++ Spécifier un nom d'utilisateur et un mot de passe via :
- user (-usr)
- password (-pw)
Par exemple vous devrez rajouter à votre ligne de commandes les caractères suivants si vous vous authentifiez sous le nom Maurice avec comme mot de passe "Test" :
... -lg -usr:"Maurice" -pw:"Test"
-> Variables QMail
Les variables QuickMail sont des
chaînes spécifiques qui seront remplacées par des valeurs particulières.
Celles ci sont traitées soit dans la ligne de commande, soit dans le
fichier BODY attaché (-bf).
Pour l'instant cette version implémente les variables suivantes :
Variable |
Valeur |
%QDATE% | Date sous la forme
dd/mm/yyyy Ex : 21/12/2003 |
%QDATE2% | Date sous la forme dd/mm/yy Ex : 21/12/03 |
%QDATE3% | Date longue sous la
forme nom_jour date mois année Ex: Lundi 12 Décembre 2003 |
%QHOUR% | Heure sous la forme
hh:mm Ex : 13:30 |
%QHOUR2% | Heure sous la forme
hh:mm:ss Ex : 13:30:28 |
%QHOUR3% | Heure avec formatage
américain AM/PM Ex : 7:03 PM |
%QDATETIME% | Date et heure
entière sous forme dd/mm/yy - hh:mm Ex : 21/12/2003 - 13:30 |
%QCNAME% | Nom du poste de
travail utilisé pour l'envoi du mail Ex : WEBLAF01 |
%QIP% | IP du poste de
travail utilisé pour l'envoi du mail Ex : 87.124.52.12 |
%QUNAME% | Nom de l'utilisateur
ayant envoyé le mail Ex : ARA |
Pour que celles-ci soient prises en compte, vous devez utiliser les commandes suivantes :
Développement des variables dans la ligne de commande
Commutateur : -expandcmd (ou -e)Développement des variables dans le fichier bodyfile (si -bf est utilisé)
Commutateur : -expandbf (ou -ef)
Attention, les variables doivent être
orthographiées de la même manière que ci-dessus, et en majuscules.
Si vous souhaitez que nous implémentions d'autres variables, n'hésitez
pas à nous contacter en suivant le lien de bas de page.
-> Exemple de lignes de commande
Qmail -f:"moi@free.fr" -h:"smtp.free.fr" -t:"custommer@ebsoft.com" -bf:"C:\Textes\CommandeRecue.txt"
-s:"A propos de votre commande"
Qmail -z:"C:\Mails\DefaultArgs.txt"
Qmail -f:"moi@free.fr" -h:"smtp.free.fr" -t:"admin@lh.net" -b:"Backup terminé à %QDATE%" -e
-> Exemple d'utilisation pour
l'envoi de fichier log
monprog.exe /args
>>C:\log.txt
qmail -f:"me@bar.com" -h:"smtp.bar.com"
-t:"me@foo.com" -bf:"C:\log.txt" -s:"Resultats envoyés par
MONPROG" -btf
-> Affichage de fichiers HTML
Si vous voulez afficher des fichiers au format HTML, n'oubliez pas de
mettre le paramètre "content-type" à "text/html", de la manière
suivante :
... -ct:"text/html"
Codes de retour
Code de retour d'information :
-0 : Aucun problème rencontré. L'application s'est terminée une fois
le(s) mail(s) envoyé(s).
Codes de retour d'erreur :
-1 : Certains fichiers n'ont pu être trouvés (et le commutateur
"-fqf" est présent en ligne de commande).
-2 : Certains paramètres envoyés à l'applications sont mal formés,
invalides ou incompatibles, ou la préparation de l'email a échouée.
-3 : Aucun paramètre n'a été renvoyé à l'application.
-4 : L'email n'a pu être envoyé car QMail n'a pu se connecter au
serveur SMTP
-5 : L'email n'a pu être envoyé - erreur au moment de l'envoi du message
-6 : Impossible d'envoyer l'email car le nombre d'envoi est limité à 10
par jour. Enregistrez-vous !
Support technique
Si vous rencontrez des problèmes,
postez vos erreurs sur Astase en cliquant
ici.
Enfin, n'hésitez pas à nous soumettre vos suggestions pour
l'amélioration de ce produit en cliquant
ici.
Pour créer vos Batch et envoyer des mails de façon simple et efficace, nous vous conseillons d'utiliser PowerBatch disponible sur http://www.astase.com/products/powerbatch.
Astase QuickMail
©2003 A.REBOISSON / Astase
www.astase.com