Commande NOTIFY
Envoie un message de notification par e-mail.
Syntaxe
NOTIFY USER nom_utilisateur <PASSWORD mdp> MAILBOX nom_chemin ADDRESS destinataire <CC destinataire_cc> <BCC destinataire_cci> <SUBJECT objet> MESSAGE message <ATTACHMENT nom_chemin>
Paramètres
| Nom | Description |
|---|---|
| USER nom_utilisateur |
Adresse électronique de l'expéditeur. |
| PASSWORD mdp optionnel |
Mot de passe du serveur de messagerie. |
| MAILBOX nom_chemin |
Nom du serveur SMTP à utiliser pour envoyer le courrier électronique. Par exemple : MAILBOX "mailserver.exemple.com" |
| ADDRESS destinataire |
Adresse électronique d'un ou plusieurs destinataires. Séparez plusieurs adresses électroniques par des virgules. Saisissez 1020 caractères au maximum. |
| CC destinataire_cc optionnel |
Adresse électronique d'un ou plusieurs destinataires mis en copie carbone. Séparez plusieurs adresses électroniques par des virgules. Saisissez 1020 caractères au maximum. |
| BCC destinataire_cci optionnel |
Adresse électronique d'un ou plusieurs destinataires mis en copie carbone invisible. Séparez plusieurs adresses électroniques par des virgules. |
| SUBJECT objet optionnel |
Ligne d'objet du message électronique. |
| MESSAGE message |
Corps de texte du message électronique. Le message est en texte brut et ne prend pas en charge HTML. Si vous souhaitez insérer un saut de ligne dans votre message, utilisez deux caractères caret : ^^. |
| ATTACHMENT nom_chemin optionnel |
Chemin d'accès et nom de fichier d'une ou de plusieurs pièces jointes. Doit être une chaîne entre guillemets. Indiquez plusieurs pièces jointes en saisissant les fichiers dans une liste de valeurs séparées par des virgules pour nom_chemin : ATTACHMENT "résultat1,résultat2" |
Exemples
Envoi d'un e-mail de rapport d'erreurs
Vous exécutez un script, et vous souhaitez envoyer un e-mail de notification si le script échoue. À l'aide de NOTIFY, vous définissez le message électronique et incluez deux pièces jointes :
- le fichier trace
- un fichier .fil contenant les erreurs enregistrées
NOTIFY USER "support@societe.com" MAILBOX "mail.societe.com" ADDRESS "script_admin@exemple.com" SUBJECT "Rapport d'erreur" MESSAGE "Echec du traitement du script. Détails joints." ATTACHMENT "Erreurs.fil,ACL_Demo.log"
Remarques
Destinataires et pièces jointes
Vous pouvez utiliser la commande NOTIFY pour envoyer des messages de notification à un ou plusieurs destinataires. Les messages peuvent inclure des fichiers de données et des projets Analytics en pièces jointes.
La commande NOTIFY peut être utilisée pour informer les personnes concernées de l'échec inattendu d'un script.
Protocoles et ports
La commande peut être utilisée avec n'importe quel serveur de messagerie qui prend en charge le protocole SMTP (Simple Mail Transfer Protocol), utilisé par Microsoft Exchange et de nombreux serveurs de messagerie. La commande NOTIFY peut également être utilisée avec d'anciennes applications de courrier électronique (Microsoft et autres) qui envoient le courrier électronique localement.
NOTIFY utilise le port 25 ; ce port doit donc être ouvert sur le serveur de messagerie, sinon la commande échoue. Le numéro de port utilisé par la commande n'est pas configurable. Si NOTIFY échoue et renvoie un message d'erreur, contactez votre service informatique pour déterminer si le port 25 est bloqué sur votre réseau.
Gestion des erreurs
Si Analytics n'est pas en mesure de se connecter avec le serveur de messagerie, il réalise cinq tentatives supplémentaires pour se connecter, avec une pause de 10 secondes entre chaque tentative. Si aucune tentative de connexion n'aboutit, la commande NOTIFY est annulée (un message est ajouté à la trace), mais le traitement du script se poursuit.
Vous pouvez utiliser la commande SET pour modifier ce comportement par défaut. Vous pouvez spécifier un nombre différent de tentatives de connexion et une durée différente entre chaque tentative ou bien vous pouvez désactiver des tentatives de connexion supplémentaires. Vous pouvez aussi spécifier l'arrêt du traitement du script par Analytics en cas d'annulation de la commande NOTIFY. Pour plus d'informations, consultez la section Commande SET.
Un destinataire de message électronique incorrect n'est pas considéré comme un échec de la commande NOTIFY et n'entraîne pas l'arrêt d'un script quel que soit le paramètre associé.
