Paramétrer la fonction CatchMail
Plusieurs étapes de paramétrage sont nécessaires et obligatoires.

Veuillez vous référer à la documentation de votre service de messagerie.

Si une catégorie n'est pas saisie dans le titre du mail, un événement de type MAIL sera automatiquement créé.
Il faut donc s'assurer qu'une catégorie d’événement MAIL a été paramétrée dans Akuiteo depuis Outils > Paramétrage > Paramétrage général > Transverse > Catégories d’événements.

Depuis Tiers > Gestion des utilisateurs, créez un utilisateur collaborateur dédié au CatchMail avec les DMF permettant d'effectuer les actions demandées dans le cadre du CatchMail.
Exemple
Je souhaite utiliser le CatchMail pour créer un document lié à une commande client. L'utilisateur CatchMail doit posséder les DMF :
- 100108 BUREAUTIQUE ECRIRE CREER DOCUMENT ;
- 020304 VENTES COMMANDES RECHERCHER.
Cependant, il n'a pas besoin de posséder le DMF 110501 AUTRES SERVICES CATCHMAIL UTILISATEUR CATCHMAIL.
Référence
Pour plus d'informations, voir Ajouter un utilisateur.

1 | Depuis la Console d'administration, allez dans Configuration > Catch Mail pour renseigner les informations de configuration : |
Paramètres | Fonctions |
---|---|
Section Configuration Catch Mail | |
Utiliser le Catch Mail | À cocher pour activer la fonction |
Utilisateur Akuiteo |
Saisir le nom de l’utilisateur CatchMail paramétré dans l'Application Desktop. Ex : CATCH |
Mot de passe Akuiteo | Saisir le mot de passe de cet utilisateur. |
Délai de démarrage (par défaut 20s) |
Saisir un délai à prendre en compte entre le démarrage du serveur et celui du service Catch mail. En seconde. Ex : 20 |
Intervalle d'analyse des mails (par défaut 60s) |
Saisir l’intervalle d’attente entre chaque vérification d’un nouvel email. En seconde. Ex : 60 |
Utiliser une authentification OAUTH (Exchange 365 seulement) |
Activez ou désactivez l'authentification OAUTH pour la connexion à Exchange. Cette case doit être cochée si Exchange 365 est utilisé par Akuiteo dans votre organisation. Dans les autres cas, cette case doit être décochée. |
Client ID |
Ce champ doit être renseigné si Utiliser une authentification OAUTH (Exchange 365 seulement) est coché. Renseignez l'identifiant du client pour l'authentification OAUTH. |
Client Secret |
Ce champ doit être renseigné si Utiliser une authentification OAUTH (Exchange 365 seulement) est coché. Renseignez le secret du client pour l'authentification OAUTH. |
Tenant ID |
Ce champ doit être renseigné si Utiliser une authentification OAUTH (Exchange 365 seulement) est coché. Renseignez l'identifiant de locataire fourni par Microsoft pour l'authentification OAUTH. |
Section Configuration de la messagerie | |
Nom de la configuration |
Donner un nom à votre configuration (Optionnel). Ex : ConfigCatchMail |
Mail du compte |
Saisir l'adresse mail du compte pour utiliser le Catch Mail. Ex : catchmail@akuiteo.com |
Type de compte de messagerie |
Sélectionner votre type de messagerie. Ex : EXCHANGE ou POP3 |
Adresse du serveur Mail |
Si Exchange : Indiquer l’adresse du Web Service Exchange. Ex : https://serveraddress/EWS/exchange.asmx Si POP3 : Indiquer l’adresse du serveur POP3. Ex : mail.serveraddress.net |
Port du serveur Mail |
Si Exchange : Indiquez le port du serveur de mail. Ex : 443 (si sécurisé) Si POP3 : Indiquez le port sur serveur POP3. Ex : 110 pour POP, 995 pour POP SSL |
Est sécurisé | À cocher si le serveur de messagerie utilise le port sécurisé. |
Utilisateur |
Indiquer l’adresse mail du compte Catch mail. Ex : catchmail@akuiteo.com |
Mot de passe | Saisir le mot de passe de ce compte. |
Inbox | Indiquer le répertoire dans lequel sont sauvegardés les e-mails dans votre messagerie. |
Tester la connexion à l'interface Catch mail à partir des valeurs enregistrées | Cliquer sur le lien pour vérifier la bonne configuration. |
2 | Sauvegardez puis relancez le serveur Tomcat. |

Le parseur CatchMail permet d'analyser les chaînes de caractères contenues dans l'objet du mail selon un ordre pré-défini afin d'établir les correspondances entre l'objet du mail et les éléments Akuiteo.
Il est donc important de le paramétrer correctement pour faire fonctionner le Catch Mail de manière optimale.
Note
Il faut au minimum une ligne pour que le parseur fonctionne.
1 | Depuis Akuiteo Client Riche, allez dans Outils > Paramétrage > Paramétrage général > Paramètres spécifiques > Paramétrage Catchmail. |
2 | Cliquez sur |
3 | Renseignez les informations de paramétrage suivantes : |
Colonne | Description |
---|---|
Numéro d'ordre | Ordre suivant lequel le parseur analyse la chaîne de caractère après # ou @. |
Type pièce | Tiers ou pièces de gestion recherchés. |
Associer tiers lié | Action à réaliser par le Catch Mail : si une pièce de gestion ou un tiers est retrouvé, le lien avec le tiers est ajouté. |
Associer affaire liée | Action à réaliser par le Catch Mail : si une pièce de gestion ou un tiers est retrouvé, le lien vers l’affaire est ajouté. |
Recherche avec libellé | Par défaut, la recherche se fait sur le code (ou n° de pièce). Si cette case est cochée, la recherche se fait sur le code puis sur le libellé si le code n’est pas trouvé (nom d'appel ou intitulé de la pièce). |
Exemple
Supposons que vous voulez :
- créer un événement à partir du code ou du nom de la facture client et lier les tiers et les affaires associés dans l'événement.
OU
- créer un événement à partir du code du client et lier l'affaire associée dans l'événement.
Vous devez alors paramétrer l'écran comme suit :
Résultats :
- si le parseur trouve la facture client selon le code ou le titre, comme paramétré en ligne 1, alors l'événement sera créé avec les tiers et les affaires liés.
- si le parseur ne trouve pas la facture client correspondant à la chaîne de caractère, comme paramétré en ligne 1, l'événement ne sera pas créé et la recherche se basera sur la ligne suivante.
- si le parseur trouve le client selon son code uniquement, comme paramétré en ligne 2, alors l'événement sera créé avec les affaires liées.
- si le parseur ne trouve pas le client selon son code, comme paramétré en ligne 2, alors un mail d'erreur sera envoyé indiquant que l'événement ne peut pas être créé.