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 : -Cha
rset:"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