Aller au contenu

Service SQL IBM i (AS/400) · Fonction scalaire

SYSTOOLS.SEND_EMAIL

Envoyer un courriel depuis SQL

Envoie un courriel avec objet, corps et pièce jointe depuis une requête SQL, avec destinataires en copie et copie cachée.

À quoi ça sert

Cette fonction scalaire envoie un message à TO_EMAIL avec un objet (SUBJECT) et un corps (BODY). Elle accepte une pièce jointe de l'IFS (ATTACHMENT), des destinataires en copie (CC_EMAIL) et en copie cachée (BCC_EMAIL), ainsi qu'un type de corps (BODY_TYPE, *PLAIN par défaut).

On l'utilise pour diffuser un rapport en fin de traitement, par exemple avec un fichier produit par SYSTOOLS.GENERATE_SPREADSHEET ou SYSTOOLS.GENERATE_PDF, ou pour alerter un responsable depuis un traitement planifié.

Résultat réel sur un IBM i 7.5

Pas de démonstration : la fonction envoie un courriel.

L'exemple d'IBM

Envoyer un courriel à un utilisateur avec un fichier en pièce jointe.

-- Description: Send an email to a user with an attachment. 
   VALUES SYSTOOLS.SEND_EMAIL(TO_EMAIL   => 'someuser@gmail.com',  
                            SUBJECT    => 'Status for last week',  
                            BODY       => 'Attached is the status information for last week.',  
                            ATTACHMENT => '/home/myuser/status.log');

Bon à savoir

L'envoi suppose que la messagerie sortante du système soit configurée et qu'un serveur de courrier soit joignable ; sinon l'appel échoue.

Paramètres

ParamètreTypePar défautSignification
TO_EMAIL VARCHAR(5000) obligatoire Adresse électronique du destinataire
SUBJECT VARCHAR(255) obligatoire Objet du message
BODY VARCHAR(5000) obligatoire Corps du message
ATTACHMENT DOUBLE-BYTE CHAR LARGE OBJECT NULL Pièce jointe
CC_EMAIL VARCHAR(5000) NULL Destinataires en copie
BCC_EMAIL VARCHAR(5000) NULL Destinataires en copie cachée
BODY_TYPE VARCHAR(6) '*PLAIN' Type du corps du message