Connexions, Import et Export
0 personnes ont aimé cet article
Intégrations : Imports, Exports et Connexions Externes
Pour que la solution s'intègre vraiment à votre écosystème, elle doit pouvoir recevoir des documents et des données depuis d'autres systèmes (courriels, dépôts FTP, fichiers CSV, bases de données) et envoyer des informations vers ces mêmes systèmes lors des transitions de flux. Ce guide couvre tous les mécanismes d'intégration génériques — par opposition aux modules ERP spécifiques qui font l'objet de v3_modules_integrations_erp.md.
Vous y trouverez la configuration des programmes d'exportation (courriel, fichier texte, XML, FTP, répertoire, base de données, API), des services d'importation (CSV, courrier entrant, lecture de répertoire), du service de courrier sortant pour les notifications, et de l'infrastructure réseau (lecteurs réseau, connexions externes ODBC).
Dans ce guide
- Vue d'ensemble du modèle d'intégration
- Exportation par courriel
- Exportation par fichier texte (CSV / TXT)
- Exportation par XML
- Exportation par FTP
- Exportation vers un répertoire
- Exportation vers une base de données
- Exportation vers une API (Connecteur universel)
- Service d'import CSV
- Service de courrier entrant
- Service de lecture de répertoire
- Service de courrier sortant (notifications)
- Lecteurs réseau
- Connexions externes (ODBC)
Vue d'ensemble du modèle d'intégration {#modèle}
L'intégration Viridem fonctionne selon trois grandes mécaniques :
| Mécanique | Description | Quand l'utiliser |
|---|---|---|
| Services d'importation | Tâches de fond qui scrutent en continu une source externe (boîte de courriel, dossier réseau) et créent automatiquement des documents Viridem | Pour faire entrer des documents en flux continu |
| Programmes d'exportation | Programmes attachés à une transition de flux. Lorsqu'un document franchit la transition, le programme s'exécute et envoie des données vers une cible | Pour pousser des données vers d'autres systèmes à un moment précis du processus |
| Infrastructure | Composants partagés (lecteurs réseau, connexions ODBC, service de courriel sortant) utilisés par les services et programmes | Configuration préalable aux services et programmes qui en dépendent |
Tous ces éléments se configurent dans Configuration > Système, principalement dans les sections Système (services, lecteurs réseau, connexions externes) et Modules (programmes du Module de base Viridem).
Information : Pour attacher un programme à une transition de flux, consultez v3_flux_de_travail.md. La configuration du programme et son attachement à un flux sont deux opérations distinctes.
Exportation par courriel {#exp-courriel}
Le programme d'exportation par courriel envoie automatiquement le document (et tous les documents du même groupe de gabarits) par courriel lors d'une transition de flux. Le message est personnalisable et peut s'adresser à un ou plusieurs destinataires — utilisateurs Viridem ou non.
Accédez via Configuration > Système > Modules > Module de base Viridem > onglet Exportation par courriel.
Ajouter un programme d'exportation par courriel
- Cliquez sur Ajouter. Une fenêtre contextuelle s'ouvre.
- Saisissez un nom significatif pour le programme et cliquez sur Ajouter.
- Configurez les paramètres détaillés :
| Paramètre | Description |
|---|---|
| Destinataires | Saisissez une ou plusieurs adresses séparées par des points-virgules, ou liez à des champs globaux |
| CC / CCI | Destinataires en copie, optionnel |
| Sujet | Texte du sujet — peut contenir des variables (voir Ajouter des variables) |
| Corps du message | Texte personnalisé du courriel. Cliquez sur Ajouter des variables pour insérer des champs Viridem dans le message |
| Pièces jointes | Document courant inclus par défaut. Vous pouvez inclure les documents du groupe |
- Pour utiliser une variable, cliquez sur Ajouter des variables, copiez la clé correspondante et collez-la dans le texte à l'endroit voulu (ex.
{{Numéro de facture}}). - Cliquez sur Enregistrer.
Modifier un programme d'exportation par courriel
- Cliquez sur le crayon de la ligne du programme dans la grille.
- Ajustez les destinataires, le sujet, le corps du message ou les pièces jointes.
- Cliquez sur Enregistrer.
Supprimer un programme d'exportation par courriel
- Sélectionnez le programme dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Avant de supprimer, vérifiez les transitions qui utilisent ce programme via le bouton de visualisation des dépendances.
Exportation par fichier texte (CSV / TXT) {#exp-texte}
Le programme d'exportation par fichier texte exporte l'information des documents vers un fichier CSV ou TXT, dont la structure est entièrement configurable.
Accédez via Configuration > Système > Modules > Module de base Viridem > onglet Exportation par fichier texte.
Ajouter un programme d'exportation par fichier texte CSV
- Cliquez sur Ajouter. Une fenêtre s'ouvre.
- Saisissez un nom significatif et cliquez sur Ajouter.
- Configurez :
| Paramètre | Description |
|---|---|
| Préfixe du nom de fichier | Texte fixe ajouté au début de chaque fichier généré (ex. FAC_) |
| Extension réseau | Chemin du répertoire de dépôt. Viridem doit avoir les accès en lecture et écriture |
| Type de connexion au répertoire | Local (dossier sur le serveur Viridem) ou Lecteur réseau (lecteur préconfiguré) |
| Lecteur réseau | Si le type est Lecteur réseau, sélectionnez-le dans la liste |
| Sous-répertoire | Chemin dans le lecteur |
| Séparateur | Caractère séparateur des colonnes (virgule, point-virgule, tabulation) |
| Mapping des colonnes | Pour chaque colonne du fichier, sélectionnez le champ global Viridem à exporter |
- Cliquez sur Enregistrer.
Ajouter un programme d'exportation par fichier texte TXT
La procédure est identique au CSV, mais avec un type TXT plutôt que CSV. Utilisez ce type pour les formats à largeur fixe ou les structures propriétaires qui ne suivent pas la convention CSV.
Modifier un programme d'exportation par fichier texte
- Cliquez sur le crayon de la ligne du programme dans la grille.
- Ajustez le préfixe, le chemin de dépôt, le séparateur ou le mapping des colonnes.
- Cliquez sur Enregistrer.
Supprimer un programme d'exportation par fichier texte
- Sélectionnez le programme dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Les fichiers déjà exportés ne sont pas modifiés.
Exportation par XML {#exp-xml}
Le programme d'exportation par XML génère un fichier XML structuré contenant des informations fixes ou dynamiques du document. La structure du fichier est configurable selon les besoins du système destinataire.
Accédez via Configuration > Système > Modules > Module de base Viridem > onglet Exportation par XML.
Ajouter un programme d'exportation par XML
- Cliquez sur Ajouter, saisissez un nom, cliquez à nouveau sur Ajouter pour valider.
- Configurez :
| Paramètre | Description |
|---|---|
| Structure XML | Template XML avec variables référant aux champs Viridem |
| Chemin de dépôt | Répertoire où le fichier sera déposé (Local ou Lecteur réseau) |
| Nom de fichier | Préfixe + variables dynamiques |
| Encodage | UTF-8, ISO-8859-1, etc. selon les exigences du destinataire |
- Cliquez sur Enregistrer.
Le programme s'exécute lors d'une transition — voir v3_flux_de_travail.md pour l'attachement.
Modifier un programme d'exportation par XML
- Cliquez sur le crayon de la ligne du programme.
- Ajustez la structure XML, le chemin de dépôt, le nom de fichier ou l'encodage.
- Cliquez sur Enregistrer.
Supprimer un programme d'exportation par XML
- Sélectionnez le programme dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Les fichiers déjà exportés ne sont pas modifiés.
Exportation par FTP {#exp-ftp}
Le programme d'exportation par FTP téléverse automatiquement les documents (convertis en HXML) vers un serveur FTP/SFTP de l'entreprise.
Accédez via Configuration > Système > Modules > Module de base Viridem > onglet Exportation par FTP.
Ajouter une configuration d'exportation par FTP
- Cliquez sur Ajouter dans la fenêtre de configuration.
- Renseignez :
| Paramètre | Description |
|---|---|
| Serveur FTP | Nom DNS ou adresse IP du serveur |
| Port | Port (généralement 21 pour FTP, 22 pour SFTP) |
| Nom d'utilisateur | Compte FTP |
| Mot de passe | Mot de passe du compte (champ confirmé) |
| Mot de passe vide | Cochez si la connexion est anonyme |
- Cliquez sur Enregistrer.
Astuce : Pour SFTP avec un port non-standard, configurez plutôt un lecteur réseau SFTP (voir section Lecteurs réseau) qui permet l'indication d'un port personnalisé, puis utilisez l'exportation vers un répertoire.
Modifier la configuration FTP
- Cliquez sur la ligne de la configuration FTP dans la grille.
- Ajustez les paramètres de connexion (serveur, port, identifiants).
- Cliquez sur Enregistrer.
Supprimer la configuration FTP
- Cliquez sur la poubelle de la ligne.
- Confirmez la suppression. Les transitions qui dépendent de ce serveur FTP cesseront d'envoyer les documents — vérifiez les dépendances avant.
Exportation vers un répertoire {#exp-répertoire}
Le programme d'exportation vers un répertoire copie les documents vers un dossier réseau ou local. Aucun document n'est supprimé ni déplacé de Viridem — c'est une copie pure.
Cas d'usage typiques :
- Donner accès à une copie de la facture fournisseur depuis le logiciel comptable
- Maintenir une plateforme de partage de fichiers pour une équipe externe à Viridem
Accédez via Configuration > Système > Modules > Module de base Viridem > onglet Exportation vers un répertoire.
Ajouter un programme d'exportation vers un répertoire
- Cliquez sur Ajouter, saisissez un nom, validez.
- Configurez :
| Paramètre | Description |
|---|---|
| Type de connexion | Local ou Lecteur réseau |
| Répertoire / Sous-répertoire | Chemin du dossier de dépôt |
| Nom du fichier | Le document peut être renommé selon les valeurs de jusqu'à trois champs globaux combinés (ex. Facture_<Fournisseur>_<NumFacture>_<Date>.pdf) |
- Cliquez sur Enregistrer.
Modifier un programme d'exportation vers un répertoire
- Cliquez sur le crayon de la ligne du programme.
- Ajustez le répertoire, le nom de fichier ou la connexion.
- Cliquez sur Enregistrer.
Supprimer un programme d'exportation vers un répertoire
- Sélectionnez le programme dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Les fichiers déjà copiés dans le répertoire restent en place.
Exportation vers une base de données {#exp-bd}
Le programme d'exportation vers une base de données insère ou met à jour des enregistrements directement dans une base externe.
Accédez via Configuration > Système > Modules > Module de base Viridem > onglet Exportation vers une base de données.
Ajouter un programme d'exportation vers une base de données
- Cliquez sur Ajouter, saisissez un nom, validez.
- Configurez :
| Paramètre | Description |
|---|---|
| Connexion externe | Sélectionnez la connexion ODBC configurée (voir section Connexions externes) |
| Table cible | Nom de la table dans laquelle insérer |
| Mapping des colonnes | Pour chaque colonne de la table, indiquez la valeur source (champ Viridem ou valeur fixe) |
| Type d'opération | Insertion, Mise à jour, ou Upsert (insertion ou mise à jour selon existence) |
- Cliquez sur Tester pour valider la connexion, puis sur Enregistrer.
Avertissement : L'écriture directe en base de données externe est puissante mais risquée. Validez chaque programme sur un environnement de test. Loginnove n'est pas responsable des corruptions de données qui pourraient résulter de programmes mal configurés.
Modifier un programme d'exportation vers une base de données
- Cliquez sur le crayon de la ligne du programme.
- Ajustez la connexion, la table cible, le mapping ou le type d'opération.
- Cliquez sur Tester puis Enregistrer.
Supprimer un programme d'exportation vers une base de données
- Sélectionnez le programme dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Les enregistrements déjà insérés dans la base externe ne sont pas affectés.
Exportation vers une API (Connecteur universel) {#exp-api}
Le programme d'exportation vers une API envoie les données vers une API REST externe (XML ou JSON). Disponible via le Module Connecteur universel — voir aussi v3_modules_integrations_erp.md.
Accédez via Configuration > Système > Modules > Module Connecteur universel.
Ajouter un programme d'exportation vers une API
- Cliquez sur Ajouter, saisissez un nom, validez.
- Configurez :
| Paramètre | Description |
|---|---|
| URL | Adresse complète de l'endpoint API |
| Méthode | GET (récupérer), POST (créer), PUT (mettre à jour), DELETE (supprimer) |
| Authentification | Type d'authentification et identifiants (Basic, Bearer, OAuth2, etc.) |
| En-têtes HTTP | Headers supplémentaires (Content-Type, Accept, etc.) |
| Corps de la requête | Template du payload avec variables Viridem |
| Format | XML ou JSON |
- Cliquez sur Tester puis Enregistrer.
Information : Le protocole SOAP n'est pas pris en charge par le Connecteur universel. Pour SOAP, contactez un intégrateur Viridem pour un développement sur mesure.
Modifier un programme d'exportation vers une API
- Cliquez sur le crayon de la ligne du programme.
- Ajustez l'URL, la méthode, l'authentification, les en-têtes ou le corps de la requête.
- Cliquez sur Tester puis Enregistrer.
Supprimer un programme d'exportation vers une API
- Sélectionnez le programme dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Les transitions qui dépendent de ce programme cesseront d'appeler l'API — vérifiez les dépendances avant.
Service d'import CSV {#imp-csv}
Le service d'import CSV scrute un dossier en continu et crée automatiquement des documents Viridem à partir des fichiers CSV qui y sont déposés. Utile pour automatiser l'ingestion de données venant d'un système tiers qui produit régulièrement des extracts.
Accédez via Configuration > Système > Système > Service d'import CSV.
Ajouter un service d'import CSV
- Cliquez sur Ajouter. Une fenêtre s'ouvre.
- Saisissez le nom du programme et cliquez sur Confirmer.
- Configurez :
| Paramètre | Description |
|---|---|
| Type de connexion | Local (dossier sur le serveur Viridem) ou Lecteur réseau |
| Sous-répertoire | Chemin dans lequel le service va lire |
| Lecteur réseau | Si type Lecteur réseau, sélectionnez-le |
| Gabarit cible | Gabarit avec lequel les nouveaux documents seront créés |
| Mapping des colonnes | Pour chaque colonne du CSV, indiquez le champ Viridem cible |
| Fréquence de lecture | À quelle cadence le service scrute le dossier |
| Action après traitement | Supprimer le fichier source, le déplacer dans un sous-dossier Traités, etc. |
- Cliquez sur Enregistrer.
Modifier un service d'import CSV
- Cliquez sur la ligne du service dans la grille.
- Ajustez le répertoire, le gabarit, le mapping ou la fréquence.
- Cliquez sur Enregistrer.
Supprimer un service d'import CSV
- Sélectionnez le service dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Le scrutation s'arrête immédiatement — les fichiers déjà dans le dossier ne seront plus traités automatiquement.
Service de courrier entrant {#imp-courriel}
Le service de courrier entrant permet de configurer une ou plusieurs boîtes courriel que Viridem scrute pour récupérer automatiquement les documents reçus par courriel. Les protocoles supportés sont :
- POP3
- IMAP
- Exchange
- Office 365
- Gmail
Astuce : Si vous configurez un courriel Office 365, utilisez fortement le protocole Office 365 plutôt qu'IMAP — il est plus stable et bénéficie des fonctionnalités natives Microsoft (OAuth2, dossiers, etc.).
Accédez via Configuration > Système > Système > Service de courrier entrant.
Ajouter un service de courrier entrant
- Cliquez sur Ajouter. Une fenêtre s'ouvre.
- Remplissez les champs selon la configuration demandée :
| Paramètre | Description |
|---|---|
| Nom | Nom significatif (ex. « Facturation Acomba », « Notes de frais ») |
| Protocole/API | POP3, IMAP, Exchange, Office 365, ou Gmail. Les autres champs s'adaptent selon ce choix |
| Serveur | Serveur de messagerie (sauf pour Office 365 où l'authentification est OAuth2) |
| Port | Port du serveur (993 IMAPS, 995 POPS, 587 SMTP, etc.) |
| Identifiants | Compte courriel et mot de passe, ou OAuth2 pour Office 365 |
| Dossier surveillé | Boîte de réception, ou un dossier spécifique |
| Action après traitement | Marquer comme lu, déplacer vers un dossier, supprimer |
| Filtres | Critères pour ne traiter qu'une partie des courriels (expéditeur, sujet, etc.) |
- Cliquez sur Enregistrer.
Avertissement : Seul un utilisateur ayant les droits d'accès appropriés peut configurer le service de courrier entrant — l'accès à une boîte mail est sensible.
Modifier un service de courrier entrant
- Cliquez sur la ligne du service dans la grille.
- Ajustez le protocole, les identifiants, le dossier surveillé ou les filtres.
- Cliquez sur Enregistrer.
Supprimer un service de courrier entrant
- Sélectionnez le service dans la grille.
- Cliquez sur la poubelle.
- Confirmez. Le scrutation de la boîte cesse immédiatement.
Service de lecture de répertoire {#imp-répertoire}
Le service de lecture de répertoire scrute un dossier réseau en continu et crée automatiquement des documents Viridem à partir des fichiers qui y sont déposés (PDF, images). Très utilisé pour les flux venant d'un scanner réseau ou d'une numérisation de masse.
Accédez via Configuration > Système > Système > Service lecteur de répertoire.
Ajouter un service de lecture de répertoire
- Cliquez sur Ajouter au-dessus de la grille.
- Saisissez un nom significatif pour le service.
- Configurez :
| Paramètre | Description |
|---|---|
| Type de connexion | Local ou Lecteur réseau |
| Répertoire | Si type Local, chemin du dossier sur le serveur |
| Lecteur réseau / Sous-répertoire | Si type Lecteur réseau, sélectionnez le lecteur et indiquez le chemin |
| Fréquence de lecture | Cadence de scrutation |
| Action après lecture | Déplacer le fichier vers un sous-dossier Traités, le supprimer, ou le laisser en place |
| Gabarit par défaut | Optionnel — sinon Viridem tente l'autodétection sur chaque fichier |
- Cliquez sur Enregistrer.
Modifier un service de lecture de répertoire
- Cliquez sur la ligne du service dans la grille.
- Ajustez le répertoire, la fréquence, l'action après lecture ou le gabarit par défaut.
- Cliquez sur Enregistrer.
Supprimer un service de lecture de répertoire
- Sélectionnez le service dans la grille.
- Cliquez sur la poubelle.
- Confirmez. La scrutation cesse — les fichiers restant dans le dossier ne seront plus importés automatiquement.
Service de courrier sortant (notifications) {#courrier-sortant}
Le service de courrier sortant sert à envoyer les notifications de Viridem — un document a été assigné à vous, une approbation est requise, une délégation a été créée, etc. La configuration est facultative mais hautement recommandée pour les déploiements de plus d'un ou deux utilisateurs.
Information : Vérifiez les détails techniques avec un membre de l'équipe TI. Les paramètres dépendent du serveur de messagerie de votre entreprise et des protocoles supportés.
Accédez via Configuration > Système > Système > Service de courrier sortant.
Configurer le service
- Sélectionnez le protocole :
- SMTP — Standard supporté par la majorité des serveurs de courriel
- Compte Microsoft — Pour les organisations sur Office 365 / Microsoft 365 (OAuth2)
- Remplissez les champs selon le protocole choisi :
Pour SMTP
| Paramètre | Description |
|---|---|
| Serveur SMTP | Adresse du serveur (ex. smtp.office365.com, smtp.gmail.com) |
| Port | Port SMTP (587 STARTTLS, 465 SSL) |
| SSL/TLS | Cochez selon les exigences du serveur |
| Authentification | Nom d'utilisateur et mot de passe du compte d'envoi |
| Adresse d'expédition | Adresse From: des notifications (ex. noreply@entreprise.com) |
Pour Compte Microsoft
| Paramètre | Description |
|---|---|
| Tenant ID | Identifiant du tenant Azure AD |
| Application ID | Identifiant de l'application enregistrée dans Azure |
| Secret client | Secret généré dans Azure |
| Adresse d'expédition | Boîte mail Microsoft 365 à utiliser |
- Cliquez sur Tester puis sur Enregistrer.
Lecteurs réseau {#lecteurs-réseau}
Les lecteurs réseau sont des chemins préconfigurés (montages de partages SMB, FTP, SFTP) qui sont ensuite réutilisés par les services et programmes d'import/export. Vous pouvez configurer plusieurs lecteurs par base de données.
Accédez via Configuration > Système > Système > Lecteurs réseau.
Ajouter un lecteur réseau
- Cliquez sur Ajouter au-dessus de la grille.
- Configurez :
| Paramètre | Description |
|---|---|
| Nom | Nom significatif (ex. « Scanner RH », « Dépôt factures fournisseurs ») |
| Type de connexion | SMB (Windows), FTP, SFTP, etc. Les champs s'adaptent selon ce choix |
| Chemin réseau | Chemin UNC pour SMB (\\serveur\partage), URL pour FTP/SFTP |
| Port | Port personnalisé si nécessaire (utile pour SFTP) |
| Identifiants | Compte d'accès au partage |
| Options SSL/TLS | Pour SFTP, FTPS |
- Cliquez sur Tester pour valider la connexion.
- Cliquez sur Ajouter pour enregistrer.
Modifier un lecteur réseau
- Cliquez sur la ligne du lecteur dans la grille.
- Ajustez le chemin, le port, les identifiants ou les options SSL/TLS.
- Cliquez sur Tester pour valider, puis sur Enregistrer.
Supprimer un lecteur réseau
- Sélectionnez le lecteur dans la grille.
- Cliquez sur la poubelle.
- Confirmez.
Avertissement : Avant de supprimer, vérifiez qu'aucun service ne dépend de ce lecteur (services d'import, programmes d'exportation vers un répertoire, etc.) — sinon ces services échoueront silencieusement.
Connexions externes (ODBC) {#connexions-externes}
Les connexions externes ODBC permettent à Viridem de communiquer avec des bases de données externes pour passer des requêtes SQL. Elles sont essentielles pour :
- Le Module d'extraction de données (v3_modules_traitement_documents.md)
- Les listes de données externes (v3_parametres_fiscaux_et_listes.md)
- L'exportation vers une base de données (voir section ci-dessus)
Bases de données prises en charge
| SGBD | Version |
|---|---|
| MSSQL | 2012 et plus |
| MySQL | Toutes versions modernes |
| PostgreSQL Unicode | Toutes versions modernes |
| PostgreSQL ANSI | Toutes versions modernes |
| Progress | Sous licence payante |
Accédez via Configuration > Système > Système > Connexions externes.
Ajouter une connexion externe
- Cliquez sur Ajouter au-dessus de la grille.
- Une fenêtre s'ouvre avec les paramètres de base. Configurez :
| Paramètre | Description |
|---|---|
| Nom | Nom significatif (ex. « Base ERP production », « Base CRM ») |
| Pilote ODBC | Sélectionnez dans la liste. Seuls les pilotes installés sur le serveur Viridem sont disponibles |
| Serveur / Hôte | Adresse du serveur de base de données |
| Port | Port d'écoute |
| Base de données | Nom de la base à interroger |
| Identifiants | Nom d'utilisateur et mot de passe d'un compte avec les droits SELECT minimum |
- Vous pouvez ajouter des champs personnalisés si la connexion demande des attributs spécifiques. Cliquez sur Ajouter un champ pour chaque ligne supplémentaire. Cochez la case Cacher la valeur pour masquer la saisie (mot de passe, clé API).
- Cliquez sur Tester pour valider la connexion.
- Cliquez sur Enregistrer.
Modifier une connexion externe
- Cliquez sur la ligne de la connexion dans la grille.
- Ajustez le pilote ODBC, le serveur, le port, la base de données ou les identifiants.
- Cliquez sur Tester pour valider, puis sur Enregistrer.
Supprimer une connexion externe
- Sélectionnez la connexion dans la grille.
- Cliquez sur la poubelle.
- Confirmez.
Avertissement : Avant suppression, vérifiez les listes de données externes, programmes d'extraction et programmes d'exportation vers une base de données qui en dépendent — leur fonctionnement sera interrompu.
Astuce : Donnez à votre compte ODBC les droits SELECT minimum nécessaires plutôt qu'un compte administrateur. C'est une bonne pratique de sécurité qui limite les dégâts en cas de fuite des identifiants.