Courriel

Rôle

Crée des courriels à partir des données du tableau ou un courriel récapitulatif pour l’ensemble du jeu de données. Prend en charge les destinataires, CC, CCI, le texte mis en forme, le tableau d’entrée et les pièces jointes.

Entrées et sorties

Une destination avec in et des sorties facultatives success/failure. L’envoi a lieu pendant l’écriture de la destination active.

Paramètres

Le paramètre	Réglages et valeurs	Options et limites
`role`	Rôle du bloc : une source lit les données ; une destination écrit le résultat.	Par défaut : `target`
`connection_id`	La connexion enregistrée par laquelle le bloc accède au système.	Par défaut : `empty` Jusqu’à 64 caractères
`to`	Adresses des destinataires principaux ou modèle utilisant un champ de ligne.	Par défaut : `empty` Jusqu’à 4 000 caractères
`cc`	Adresses en copie (CC).	Par défaut : `empty` Jusqu’à 4 000 caractères
`bcc`	Adresses en copie cachée (CCI).	Par défaut : `empty` Jusqu’à 4 000 caractères
`to_people`	Utilisateurs et rôles UBC Data Bridge pour les destinataires principaux.
`cc_people`	Utilisateurs et rôles pour les copies.
`bcc_people`	Utilisateurs et rôles pour les copies cachées.
`subject`	Objet du courriel sur une seule ligne ; accepte les balises.	Par défaut : `empty` Jusqu’à 998 caractères
`body`	Corps du courriel, avec mise en forme et insertion du tableau.	Par défaut : `empty` Jusqu’à 100 000 caractères
`format`	text ou html ; un nouveau bloc de l’éditeur utilise du texte mis en forme.	Options : `text`, `html` Par défaut : `text`
`attachments`	Pièces jointes du Gestionnaire de fichiers, d’un dossier ou du champ « Fichier joint » des paramètres d’exécution.	Nombre : 0–20
`time_zone`	Fuseau horaire pour les substitutions de date et d’heure système.	Par défaut : `Europe/Kyiv` Jusqu’à 64 caractères

Modèles et nombre de messages

La substitution {{Назва поля}} utilise la valeur de la ligne actuelle. Balises système : {{$date}}, {{$time}}, {{$datetime}}, {{$flow}}, {{$rows}}, {{$row}}, {{$table}}.

Si un modèle de destinataire, d’objet ou de corps contient un champ de ligne ou {{$row}}, un message distinct est créé pour chaque ligne. Sinon, un seul message est créé pour toutes les données d’entrée.
{{$table}} est disponible uniquement dans le corps du message. Il inclut jusqu’à 1 000 lignes et une indication du reste.
Tous les champs utilisés dans les balises doivent exister dans l’entrée ; TEMPLATE_FIELD_MISSING est détecté pendant la préparation.
Les dates et heures utilisent le time_zone indiqué. Les valeurs des données sont échappées pour les messages mis en forme.

Configuration étape par étape

Créez et testez une connexion SMTP. Ajoutez un bloc qui l’utilise.
Définissez les destinataires par adresses, balise de champ ou utilisateurs/rôles.
Rédigez l’objet et le corps ; insérez les balises depuis la liste des champs disponibles.
Vérifiez l’indication précisant s’il y aura un courriel pour tout le jeu de données ou un par ligne.
Ajoutez les pièces jointes et le fuseau horaire. Vérifiez la préparation dans une simulation avant l’envoi.

Règles et diagnostics

Les adresses des utilisateurs et membres de rôles sont lues dans leurs profils actuels pendant l’exécution.
L’objet ne peut pas contenir de sauts de ligne ; les noms de balises sont validés.
Jusqu’à 20 sources de pièces jointes ; une même source ne peut pas être ajoutée deux fois. Une pièce jointe issue d’un paramètre est absente si l’utilisateur n’a pas ajouté de fichier.
Un dossier du Gestionnaire de fichiers ajoute les fichiers qu’il contient au moment de l’exécution.
La livraison externe peut avoir un résultat partiel ou incertain. Avant de relancer après une erreur, vérifiez le journal pour éviter les courriels en double.
Une entrée active vide ne crée aucun message : EMPTY_STAGE. Jusqu’à 10 000 messages sont autorisés par bloc et par exécution ; au-delà, filtrez ou répartissez les données.
La perte de la réponse pendant un envoi externe est traitée comme un résultat incertain : le système ne renvoie pas automatiquement ce message.
Séparez les adresses par des virgules, points-virgules ou sauts de ligne. Il faut au moins un destinataire et un objet non vide ; jusqu’à 500 destinataires au total par courriel. Les doublons entre « À », « CC » et « CCI » sont supprimés.
Un dossier joint ajoute jusqu’à 100 fichiers. La taille totale du courriel, pièces jointes comprises, est limitée par le paramètre de la connexion SMTP.

Exemple de configuration

Pour un tableau CustomerEmail, CustomerName, Amount, définissez to={{CustomerEmail}}, subject=Votre rapport, body=Bonjour, {{CustomerName}}. Montant : {{Amount}}. Cela crée un courriel par ligne. Pour un récapitulatif unique, utilisez une adresse fixe et le corps « {{$rows}} lignes traitées. {{$table}} ».