Fonctionnement général

Le module permet de définir le modèle d’export à réaliser automatiquement, de définir la périodicité et les destinataires de l’email qui sera envoyé. Il se base sur la fonction d’export, native de Dolibarr. Le module créera automatiquement les exports paramétrés, selon la périodicité enregistrée, et enverra cet export par email aux destinataires spécifiés, selon le modèle d’email enregistré.

Le module permet de gérer la fréquence d’envoi des exports et donc d’utiliser la même requête chaque mois, chaque jour, ….
Exemple, pour une périodicité mensuelle, tout envoi au mois de mars, prendra les données du mois écoulé, à savoir février. Pour une périodicité journalière, les données seront celles du dernier jour écoulé (soit la veille), pour une périodicité hebdomadaire, les données de la dernière semaine écoulée, ….

Prérequis

Le module export de Dolibarr doit être activé.
– Si vous souhaitez utiliser les fonctions automatiques, le module « Travaux planifiés » de Dolibarr doit être activé (Rendez-vous dans Menu Configuration > Modules). Les différents paramétrages afférents doivent être opérationnels (Tâche cron sur le serveur).
Tâche cron créée par le module : autoexport
– L’envoi d’emails doit être configuré dans votre Dolibarr.
– Ce module nécessite la saisie de requête SQL. Vous pourrez utiliser celles présentes dans Dolibarr mais quelques connaissances SQL sont recommandées.

Création d’un export automatisé

Pour créer un export, vous devrez vous rendre en administration du module. Pour cela, vous devrez vous rendre dans la configuration du module (Menu Configuration > Modules > Exports automatisés > utiliser le pictogramme)

Choisissez le bouton « Nouveau » sur la page de listing affichée.

Vous devrez ensuite indiquer les différents éléments nécessaires pour la création de votre nouvel export automatisé.

Ref
Indiquez ici la référence souhaitée pour votre export automatisé.

Libellé
Indiquez ici le nom de votre export automatisé.

Requête SQL
Indiquez ici la requête SQL de l’export souhaité. Plus d’indications plus loin dans la documentation.

Fréquence
Choisissez la fréquence de génération et d’envoi de l’export en indiquant un chiffre et en choisissant la périodicité dans la liste déroulante (exemple : 1 mois)

Nb max de génération
Indiquez ici le nombre de fois où vous souhaitez générer et envoyer l’export automatiquement.

Envoi auto par email
Indiquez oui pour que l’export soit automatiquement envoyé par email.

Sujet de l’email
Saisissez ici l’objet souhaité pour l’email qui sera automatiquement envoyé.

Expéditeur
Indiquez ici l’adresse email à utiliser pour envoyer les exports générés. Attention : cette adresse email doit être enregistrée et configurée dans Dolibarr.

Texte de l’email
Indiquez ici le contenu du mail souhaité.

Destinataire(s)
Saisissez ici les adresses emails des destinataires souhaités de l’email qui sera envoyé automatiquement. Vous devrez séparer les différentes adresses email avec une virgule.

Destinataire(s) Bcc
Saisissez ici les adresses emails des destinataires souhaités de l’email qui sera envoyé automatiquement. Ces destinataires seront en copie cachée. Vous devrez séparer les différentes adresses email avec une virgule.

Requête SQL

Créer une requête SQL
Vous devez indiquer la requête de votre choix dans le champ dédié.
Vous pouvez utiliser les requêtes disponibles dans le module export de Dolibarr, à la fin de la création d’un export. Cela peut vous aider si vous n’avez pas les connaissances SQL nécessaires.

Pour cela, il vous suffit de créer l’export souhaité via le module dédié de Dolibarr et de copier/coller la requête SQL générée, accessible lors de l’étape 5.

Gestion dates exports dans la requête
Le module permet de gérer la fréquence d’envoi des exports et donc d’utiliser la même requête chaque mois, chaque jour, ….
Exemple, pour une périodicité mensuelle, tout envoi au mois de mars, prendra les données du mois écoulé, à savoir février. Pour une périodicité journalière, les données seront celles du dernier jour écoulé (soit la veille), pour une périodicité hebdomadaire, les données de la dernière semaine écoulée, ….

Les données de la requête SQL concernant la date de début et la date de fin sont des variables de substitution.
Vous devrez donc ajouter à la fin de votre requête, dans le WHERE les éléments suivants :
AND XXX> ‘_date_debut_export_’ and XXX < ‘_date_fin_export_’

XXX étant ici la date à prendre en compte (date de création facture, date de validation devis, …)

Consulter, modifier, cloner, supprimer un export

Pour voir le détail d’un export, le modifier, le cloner et/ou le supprimer, vous devrez vous rendre sur sa fiche. Pour cela, cliquez sur sa référence, dans la liste des exports. Vous pourrez ensuite utiliser les boutons dédiés en bas de la fiche (modifier, cloner, supprimer).

Droits utilisateurs

Aucun droit utilisateur particulier. Le paramétrage de ce module se fait en admin, donc par définition, seuls les utilisateurs disposant de ce rôle pourront y accéder.

Découvrir nos autres modules..