Ajouter un champ -- Statut envoi d'email
Suivi envoi d'email
Ce cas d'usage ajoute à la commande client un champ qui indique si l'e-mail de la commande a été envoyé à votre contact.
Explication du Cas :
L'objectif est de savoir si le document a bien été envoyé à votre contact quand vous allez sur un document comme une commande client ou une facture de vente.
Lors de la création d'une commande client :
- Vous cochez la case Email envoyé automatiquement.
- Vous validez la commande client.
- Dokos envoie l'e-mail au contact.
- Dokos passe le champ Email Statut à la valeur Envoyé.

Étape 1
Pour débuter il faut ajouter des nouveaux champs à votre document. Nous allons ajouter une nouvelle section pour la séparer des autres sections et ajouter deux champs qui seront :
- Email envoyé automatiquement : Avec une case à cocher.
- Email Statut : une liste avec les valeurs « Pas envoyé » et « Envoyé ». Une notification met la valeur « Envoyé » automatiquement.
Étape 2
Par la suite, pour automatiser l'action de l'envoi de l'email et du changement de la valeur pour le champ Email Statut, nous allons créer une notification.

1. Ajouter des champs personnalisés
Nous allons ajouter deux champs qui seront utilisés :
- Une nouvelle section
- Email envoyé automatiquement : Oui ou non
- Email Statut : Pas envoyé ou Envoyé
1.1 Ajouter un premier champ : Email envoyé automatiquement
Tout d'abord, il faut ajouter sur le type de document Commande client / Facture de vente le champ Email envoyé automatiquement.
Nous allons voir ce cas pour le type de document : Commande client
- Allez sur la liste Commande client
- Cliquez sur les 3 petits points ⋯ en haut.
- Faites Personnaliser

Vous allez arriver sur le document Personnaliser un formulaire pour le document Commande client, dans l'onglet Formulaire (générateur de formulaire visuel)
- Repérez la colonne où ajouter le champ, puis cliquez sur Ajouter un champ en bas de cette colonne

- Choisissez le type Case à cocher, puis renseignez les propriétés du champ dans le panneau de droite :
- Indiquez dans Étiquette : Email envoyé automatiquement
- Nom : laissez vide. Dokos le crée à l'enregistrement à partir de l'étiquette, avec le préfixe
custom_:custom_email_envoyé_automatiquement.
- Faites glisser le champ où vous souhaitez le faire apparaître dans le document, par exemple dans la nouvelle section.

1.2 Ajouter un second champ : Email Statut
Tout d'abord, il faut ajouter un nouveau champ qui permettra de savoir si l'email a bien été envoyé avec les options (Pas envoyé, Envoyé).
- Dans la nouvelle section, cliquez sur Ajouter un champ et choisissez le type Sélectionner
- Renseignez les propriétés du champ dans le panneau de droite :
- Indiquez dans Étiquette : Email Statut
- Nom : laissez vide. Dokos crée
custom_email_statut. - Indiquez dans Options : Pas envoyé, Envoyé en sautant des lignes pour chaque option.
- Toujours dans le panneau de droite, cochez la case Autoriser les modifications après validation. Le champ de recherche Chercher des propriétés... permet de la trouver rapidement.

- Faites glisser ce champ où vous souhaitez le faire apparaître dans le document, par exemple sous le champ Email envoyé automatiquement.
- Cliquez sur Mettre à jour.
Voici les champs que vous obtenez à la fin.
2. Créer une notification et modification d'un champ automatiquement
Il faut créer une nouvelle notification qui sera exécutée dès que le champ Email envoyé automatiquement est coché sur votre commande/facture
Pour ce faire, il faut :
- Allez dans le document Notification
- Ajoutez une notification
- Indiquez un nom d'usage
- Dans la section Canal d'envoi, sélectionnez le canal E-mail

2.1 Section Événement déclencheur
- Type de document: Sélectionnez Commande client
- Envoyer une alerte lors de l'événement : Valider
2.2 Condition
Dans la même section Événement déclencheur :
- Type de condition : Python
- Condition : indiquez
doc.custom_email_envoyé_automatiquement. Ce nom est celui du champ Email envoyé automatiquement. Vérifiez-le dans Personnaliser un formulaire. La notification s'exécute à la validation du document, si la case est cochée.

La capture montre un nom de champ sans le préfixe custom_. Utilisez le nom affiché dans votre formulaire.
2.3 Section Modifier une propriété après la notification
Cette section repliable apparaît en bas du formulaire une fois le Type de document et l'événement renseignés.
- Modifier une propriété après la notification : Sélectionnez le champ Email Statut
- Valeur à définir : Indiquez Envoyé

2.4 Section Destinataires
- Ajoutez une nouvelle ligne
- Destinataire par champ de document : sélectionnez contact_email

2.5 Section Message
- Objet : Il s'agit de l'objet de l'email qui sera envoyé au client
- Indiquez le contenu de l'email qui sera envoyé au client.
2.6 Paramètres des pièces jointes
- Joindre une impression de document : Cochez cette case pour que votre document soit envoyé en pièce jointe dans l'email.
Enregistrez la notification.