ELO Base

Le module ELO Base est le cœur d'ELONIQ. Il établit la connexion sécurisée au serveur d'index ELO et fournit à tous les autres modules (ELO Importer, ELO Exporter, ELO Mail Importer, etc.) l'infrastructure nécessaire pour accéder au DMS ELO.

Fonctions principales

• Gestion des connexions — Authentification, pool de sessions et reconnexion automatique à une ou plusieurs archives ELO.
• Cache — Les masques, utilisateurs, aspects et données serveur sont stockés localement dans SQLite et rafraîchis en arrière-plan.
• Opérations documentaires — Upload, téléchargement, recherche, déplacement, copie, liaison et gestion des permissions.
• Moteur de workflow — Démarrer, surveiller et traiter automatiquement les workflows via des déclencheurs de chaîne.
• Notifications — Notifications multi-canaux (email, Discord, Teams, Slack, Telegram) pour les tâches workflow.

Architecture

┌────────────────────────────────────────────────────────┐
│                    Modules ELONIQ                      │
│  ┌──────────┐  ┌──────────┐  ┌───────────────────┐    │
│  │Importer  │  │Exporter  │  │Mail Importer      │    │
│  └─────┬────┘  └─────┬────┘  └─────────┬─────────┘    │
│        │             │                 │               │
│  ┌─────▼─────────────▼─────────────────▼───────────┐  │
│  │              Module ELO Base                     │  │
│  │  ┌──────────┐ ┌─────────┐ ┌──────────────────┐  │  │
│  │  │ Sessions │ │ Cache   │ │ Circuit Breaker  │  │  │
│  │  └──────────┘ └─────────┘ └──────────────────┘  │  │
│  │  ┌──────────┐ ┌─────────┐ ┌──────────────────┐  │  │
│  │  │ IX API   │ │ Outils  │ │ Notifications    │  │  │
│  │  └────┬─────┘ └─────────┘ └──────────────────┘  │  │
│  └───────┼─────────────────────────────────────────┘  │
└──────────┼────────────────────────────────────────────┘
           │
     ┌─────▼─────┐
     │ Serveur   │
     │ ELO IX    │
     └───────────┘

• Support multi-archives — Connexion simultanée à plusieurs archives ELO. Chaque archive est gérée indépendamment avec son propre cache et sa propre session.
• Cache intelligent — Les masques, utilisateurs, aspects et données serveur sont mis en cache dans SQLite. Le démarrage à froid utilise la base de données, tandis que le cache est automatiquement rafraîchi en arrière-plan.
• Circuit Breaker — Détection automatique des pannes ELO. En cas d'échecs répétés, la connexion est temporairement suspendue pour éviter la surcharge. Récupération automatique après 30 secondes.
• Gestion des sessions — Connexions HTTP persistantes avec renouvellement automatique. Les sessions sont réutilisées et renouvelées de manière transparente à l'expiration.
• Opérations documentaires — Upload, téléchargement, recherche, déplacement, copie et liaison de documents via une API unifiée.
• Gestion des workflows — Démarrer des workflows, interroger les nœuds, transférer des tâches et surveiller le statut des workflows.
• Notifications multi-canaux — Envoyer des notifications de tâches workflow aux utilisateurs par email, Discord, Microsoft Teams, Slack ou Telegram. Notifications instantanées ou résumés horaires/quotidiens.
• Gestion des permissions (ACL) — Définir, étendre ou restreindre les droits d'accès sur les documents et dossiers. Trois modes de fusion : Remplacer, Étendre (OR), Réduire (AND NOT).
• Métadonnées Gen1 et Gen2 — Prise en charge des champs d'index classiques (Gen1) et des aspects modernes (Gen2). Détection et mise en cache automatiques des deux générations.
• Surveillance de la santé — Surveillance continue de la qualité de connexion avec un statut détaillé par archive.
• Déclencheurs Chain de workflow — Déclenchement automatique de chaînes d'automatisation basé sur les nœuds de workflow. Idéal pour la classification de documents et l'intégration DATEV.
• Classification automatique de documents — Classification basée sur le ML via des nœuds de workflow spéciaux avec enrichissement DATEV SmartDB pour les documents financiers.
• Outils de dossiers — Créer des dossiers, construire des arborescences et déplacer ou copier des objets entre dossiers.
• Interface web utilisateur — Tableau de bord, recherche avancée, navigateur d'archives, boîte de réception workflow, upload et boîte de réception partagée pour les utilisateurs finaux.

Après la configuration, les fonctions suivantes sont disponibles :

1. Vérifier la connexion — Ouvrez la page de statut du module. Vous y verrez l'état de la connexion, l'état du circuit breaker et les informations de cache pour chaque archive configurée.
2. Gérer le cache — Via la page de statut, vous pouvez rafraîchir manuellement le cache. C'est utile après des modifications de masques dans ELO, pour qu'ELONIQ reprenne immédiatement les nouvelles définitions.
3. Vérifier les masques et champs — Le cache affiche tous les masques chargés, les champs d'index (Gen1) et les aspects (Gen2). Utilisez ceci pour vérifier que les masques souhaités sont disponibles.
4. Utilisateurs et groupes — Le cache utilisateurs affiche tous les utilisateurs et groupes ELO. Ceux-ci sont utilisés par les autres modules pour les attributions de permissions.
5. Boîte de réception workflow — Lorsque le cache workflow est activé, les tâches workflow actives sont interrogées régulièrement et affichées dans l'interface web utilisateur.
6. Configurer les notifications — Activez les canaux souhaités dans le ConfigStore et configurez les modèles email/messagerie selon vos besoins.
7. Gérer les documents — Via l'interface web utilisateur, les documents peuvent être recherchés, uploadés, téléchargés et parcourus dans l'archive.
8. Intégration avec les autres modules — ELO Base est automatiquement utilisé par ELO Importer, ELO Exporter et ELO Mail Importer. Assurez-vous que la configuration auth correspond au authName des autres modules.

• Utiliser un utilisateur ELO dédié — Créez un compte de service dédié pour ELONIQ (ex. svc_eloniq). N'utilisez jamais de comptes personnels, car un changement de mot de passe interromprait toute l'intégration.
• Permissions minimales — N'accordez au compte de service que les droits réellement nécessaires. Pour les scénarios d'import uniquement, les droits d'écriture sur les dossiers cibles suffisent.
• Activer TLS — Utilisez HTTPS pour l'URL IX (https://elo-server:9090/ix-Archive/ix) pour chiffrer les identifiants et les données documentaires en transit.
• Ajuster les intervalles de cache — Dans les environnements avec des changements fréquents de masques : raccourcir l'intervalle de rafraîchissement (ex. 360 minutes). Dans les environnements stables : conserver la valeur par défaut (720 minutes).
• Surveiller les health checks — Vérifiez régulièrement la page de statut. Le circuit breaker indique quand la connexion ELO est instable. Réagissez aux états OPEN répétés.
• Utiliser le multi-archive judicieusement — Utilisez des configurations auth séparées pour la production et les tests. Nommez-les clairement (ex. prod, staging, test).
• Tester les notifications — Configurez d'abord un seul canal (ex. email) et testez avec un workflow simple avant d'activer d'autres canaux.
• Attention à la limite de masques — Avec un très grand nombre de masques (> 500), la mise en cache peut devenir lente. Définissez masklimit à une valeur raisonnable pour ne charger que les masques pertinents.
• Mises à jour régulières — Maintenez ELONIQ à jour pour bénéficier des améliorations du wrapper API ELO et du système de cache.

1. Serveur ELO unique

auth:
  - name: production
    ixurl: http://elo-server:9090/ix-Archive/ix
    username: svc_eloniq
    password: secret123

2. Archives ELO multiples (multi-tenant)

auth:
  - name: production
    ixurl: https://elo-prod.entreprise.fr/ix-Archive/ix
    username: svc_eloniq
    password: prod_pw
  - name: test
    ixurl: http://elo-test.entreprise.fr:9090/ix-TestArchive/ix
    username: svc_eloniq_test
    password: test_pw

3. Cache optimisé pour les grandes archives

masklimit: 200
cache_refresh_interval_minutes: 360
cache_max_age_minutes: 720
connection_check_interval_minutes: 2

Ne charger que les 200 masques les plus importants, rafraîchir le cache toutes les 6 heures et vérifier la connexion toutes les 2 minutes.

4. Notifications workflow par email et Teams

# Dans le ConfigStore :
notifications.enabled: true
notifications.channels.email_enabled: true
notifications.channels.teams_enabled: true
workflow_refresh_interval: 30
workflow_cache_enabled: true

Les tâches workflow sont interrogées toutes les 30 secondes et les utilisateurs sont notifiés par email et Teams.

5. Environnement de production avec TLS

auth:
  - name: production
    ixurl: https://elo.entreprise.fr/ix-Archive/ix
    username: svc_eloniq
    password: mot_de_passe_securise
connection_check_interval_minutes: 1
cache_refresh_interval_minutes: 720

6. Déclencheur Chain de workflow (classification automatique)

workflow_chain_triggers:
  - id: datev_classify
    enabled: true
    description: Classifier automatiquement les factures DATEV
    authName: production
    templateId: 42
    nodeName: Classification
    chainId: datev_classifier

Lorsqu'un document atteint le nœud de workflow « Classification », la chain datev_classifier est automatiquement déclenchée.