Data Factory > Send Email
Cible
Envoyer des email au format brut ou au format html
Exemple d'usage dans un job
- Envoyer un rapport mail à chaque utilisateur concerné
1. Export Items Exporter les produits en statut new
2. XSLT Grouper les produits par utilisateur
3. Split XML Découper en un fichier par utilisateur
4. XSLT Générer le fichier HTML pour l’email
5. Send Email Envoyer les Emails1
2
3
4
5
2
3
4
5
Les Entrées / Sorties
json
{
"name": "notification-send-email",
"taskReferenceName": "b",
"description": "The business description of the task",
"type": "SUB_WORKFLOW",
"optional": false,
"inputParameters": {
"mode": "FILE",
"file": "file://assets/test.html"
}
}1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Les entrées
| Propriété | Description |
|---|---|
| mode | Obligatoire - Enum - FILE, FILESFILE c’est l’entrée file qui est utiliséeFILES on applique la transformation à chacun des fichiers présents dans filesDans les deux cas le fichier attendu est un HTML contenant des balises meta custom voir plus bas. |
| file | Obligatoire si mode = FILE - File Le fichier à traiter. |
| files | Obligatoire si mode = FILES - Array of File Les fichiers à traiter. |
Les sorties
| Propriété | Description |
|---|---|
| allEmailsSent | Enum - YES, NOSi tous les mails envoyés : YES sinon NO |
Détails sur les documents présents dans les entrées file et files
html
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="pl-mail-to" content="john.doe@product-live.com;jane.doe@product-live.com" />
<meta name="pl-mail-cc" content="martin.dupont@product-live.com;martine.dupont@product-live.com" />
<meta name="pl-mail-bcc" content="joseph.durand@product-live.com;josephine.durand@product-live.com" />
<meta name="pl-mail-subject" content="Nouveau produits" />
<meta name="pl-mail-attachments" content="images.zip=https://app.product-live.com/data-factory/1_documents/download/d05a74cf11788d8f3ae9bf0e0e028dde66f0c83005c5e0d1211b0069945c0c11;pdf.zip=https://app.product-live.com/data-factory/1/download/fb26911d77fe9a9dc44b111eef5b5db7ca2019c8038445662f29b20c54cb6f29" />
<title>Document</title>
<style>
body {
font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
}
b {
color: red;
}
</style>
</head>
<body>
<p>Hello <b>mail!</b></p>
<p>
Attachments can also be <a href="https://app.product-live.com/data-factory/d05a74cf11788d8f3ae9bf0e0e028dde66f0c83005c5e0d1211b0069945c0c11">linked</a>
<br>
In this case, if it's a Product-Live link it will be downloaded only if the user is connected.
</p>
</body>
</html>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
| XPath | Description | Occurrence |
|---|---|---|
| meta[@name='pl-mail-to']/content | Les emails des destinataires séparés par des points-virgules | 1 |
| meta[@name='pl-mail-cc']/content | Les emails des destinataires en copie séparés par des points-virgules | 0..1 |
| meta[@name='pl-mail-bcc']/content | Les emails des destinataires en copie cachée séparés par des points-virgules | 0..1 |
| meta[@name='pl-mail-subject']/content | Le sujet du mail | 1 |
| meta[@name='pl-mail-attachments']/content | Les pièces jointes séparées par point-virgule Format: {file-name.extension}={file-url}. Les urls ne peuvent être que des url Product-Live (des images associées à des items ou des documents générés par Data Factory). | 0..1 |
Détails sur le rapport d'exécution de l'import
Notes générales
- L'objectif est de proposer un message le plus clair possible pour que celui-ci puisse être rapidement interprété par l'utilisateur.
- Le format du rapport proposé est similaire à celui proposé sur les tâches du mapping (import et exécution) et l'import d'items.
Structure du rapport
xml
<Report task="notification-send-email" date="2022-01-01T00:00:00.000Z" action-id="<l'identifiant unique de l'execution du job>">
<Input name="file">(l'url du fichier en entrée)</Input>
<Input name="mode">(le mode passé en paramètre de la tâche)</Input>
<Log type="warning">
<Metadata name="xpath"></Metadata>
<Metadata name="maxNumberOfAttachments"></Metadata>
<Metadata name="numberOfAttachmentsProvided"></Metadata>
<Metadata name="code">MAX_ATTACHMENTS_REACHED</Metadata>
<Message>The maximum number of attachements has been reached</Message>
</Log>
</Report>1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
| XPath | Description | Occurrence |
|---|---|---|
| /Report@task | La clé de la tâche, ici notification-send-email | 1 |
| /Report/Input | Permet de mentionner les inputs de la tache | 1..* |
| /Report/Log | Une ligne du rapport | 0..* |
| /Report/ Log @type | Peut-être error, warning ou info | 1 |
| /Report/ Log / Metadata-Collection | Permet de grouper un ensemble de Metadata | 0..* |
| /Report/ Log / Metadata-Collection@name | Le nom du groupe de metadata | 1 |
| /Report/ Log / Metadata | Représente une métadonnée, elle-même définie par un nom et une valeur | 0..* |
| /Report/ Log / Metadata@name | Le nom de la metadata | 1 |
| /Report/ Log /Message | Le message associé à cette ligne dans le rapport | 1 |
| Code | Message | Metadata | Type | Remarques |
|---|---|---|---|---|
| MAX_ATTACHMENTS_REACHED | The maximum number of attachements has been reached | xpath, maxNumberOfAttachments, numberOfAttachmentsProvided | error | Le mail en question est ignoré. |
| MAX_SIZE_REACHED | The maximum size of an email (attachments and content) has been reached | xpath, emailMaxSizeInMo: La taille de l'ensemble des pièces jointes au mail courant, en Mo, emailSizeInMo | error | Le mail en question est ignoré. |
| MAX_RECIPIENTS_REACHED | The maximum number of recipient has been reached (to, cc and bcc) | xpath | error | Le mail en question est ignoré. La limite du nombre de destinataires concerne l'ensemble des destinataires (to, cc et bcc). |
Limitations fonctionnelles et recommandations
| Element | Description | Limite | Recommendation |
|---|---|---|---|
| Nombre de pièces jointes | 10 | 1 | |
| Taille totale d'un email (en mo) | 10 | 1 | |
| Nombre de destinataires maximal par email | 100 | 10 |