Cette commande est disponible pour les utilisateurs d’Office 365. L’authentification OAuth (protocole OAuth2) est utilisée pour se connecter au protocole SMTP et envoyer des emails.
Afin de s’authentifier, il faut fournir notamment les éléments suivants :
- Microsoft Entra ID (tenant ID) : paramètre Tenant
- ID client de l'application : paramètre ClientIdVal
- Valeur secrète de l'application : paramètre ClientSecretVal
Bien entendu, ces informations n’apparaitront pas dans la trace Launcher.
Pour plus d’infos, voici un lien sur la documentation Microsoft.
Syntaxe
|
CHGVAR |
VAR(&CMD) VALUE('GRAPHSEND') |
|
CHGVAR |
VAR(&PARM1) VALUE(' ;UserId="compte SMTP
qui enverra l’email" ;ClientSecretVal="client secret" ;Tenant="tenant" ;Subject="sujet" [;Text="Texte de l’email"] [;Html="chemin du fichier HTML, corps du mail"] [;Attach="liste pièces jointes"] [;EmailCc="Destinataires CC"] [;EmailBcc="Destinataires BCC"] [;Priority=0|1|2] [;Importance=0|1|2] |
|
CALL |
PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT) |
Paramètres
|
Paramètres |
|
|
Parm1 ou Parm2 |
Server : Nom du serveur
SMTP. Généralement : outlook.office365.com. UserId
: Compte
SMTP utilisé pour l’authentification OAuth et pour l’envoi de
l’email (FROM). Password : Mot de passe de UserId.
EmailTo : Liste des destinataires TO. Chaque adresse email est séparée par un point-virgule.
ClientIdVal : Client ID. Utile pour l’authentification.
ClientSecretVal : Client Secret. Utile pour l’authentification.
Tenant : Tenant. Utile pour l’authentification.
Subject : Sujet de l’email.
Text : Texte brut de l’email.
Html : Au lieu d’utiliser le paramètre Text, on peut spécifier ici le chemin complet d’un fichier HTML qui correspondra au corps de l’email. Attach : Liste des pièces jointes. Il faut spécifier le chemin complet pour chaque pièce jointe. Chaque chemin sera séparé par un point-virgule.
EmailCc : Liste des destinataires CC. Chaque adresse email est séparée par un point-virgule.
EmailBcc : Liste des destinataires BCC. Chaque adresse email est séparée par un point-virgule.
Priority : Priorité de l’email. 0 =
non urgent
Importance : Importance de l’email. 0 =
basse
|
Exemple
L’exemple suivant envoie un email avec un fichier HTML en corps de mail, avec des pièces jointes.
LNCCMD CMD(GRAPHSEND) +
PARM1('Server="outlook.office365.com";UserId+
="test@aura.com";Password="aura"+
;emailTo="contact@aura.com;+
tech@aura.com";clientIdVal="ddfgthyp-4444-5555-a+
fgt-asdftp74569b";clientSecretVal="TeV7U~rG+
5555.Y1hPmL9-HG7sC_OPMgbls8156zT";Tenant="4+
745etg9-sese-55e0-5479-5639874df156";Subjec+
t="Test GRAPH";Html="C:\A\ista4.HTML";+
Attach="C:\A\res.pdf;C:\A\F84.pdf;C:\A\image001.jp+
g;c:\A\image002.png"') +
PARM2('Priority=2;Importance=2')