ELO Exporter
Export de documents et métadonnées
L'ELO Exporter est un module polyvalent pour l'export automatisé de documents et métadonnées depuis ELO. Il prend en charge l'export vers le système de fichiers et/ou le transfert de métadonnées par webhook.
Aperçu
L'ELO Exporter automatise l'export de documents depuis ELO. Le flux typique est :
- Recherche — Identifier les documents par ID, chemin ELO ou FindSearch
- Export — Exporter vers le système de fichiers et/ou envoyer via webhook
- Post-traitement — Mettre à jour les champs ObjKey, transférer les workflows
- Journalisation — Chaque opération est enregistrée
L'export fichier et le webhook peuvent être utilisés indépendamment ou simultanément. Avec MetadataOnly, un export webhook pur sans écriture sur disque est possible.
Fonctionnalités
- Recherche flexible — Trouver des documents par ID, chemin ELO ou FindSearch
- Export fichier — Exporter documents et/ou métadonnées vers le système de fichiers
- Intégration webhook — Envoyer les résultats d'export via HTTP webhook
- Deux modes webhook —
status(compact) oufull(métadonnées complètes) - MetadataOnly — Export de métadonnées uniquement, sans téléchargement
- Post-traitement — Mise à jour automatique des champs ObjKey après export
- Transfert de workflow — Avancer automatiquement les workflows ELO
- Export par lots — Export en masse via FindSearch
- XRechnung / ZUGFeRD — Génération de factures électroniques (EN 16931)
- Planification — Expressions cron, durées Go ou horaires fixes
- Mécanisme de réessai — Réessai automatique avec backoff exponentiel
- Journalisation — Chaque export est enregistré avec statut, durée et détails
Utilisation
1. Créer une tâche d'export
Naviguez vers Configuration → Tâches d'export → Ajouter.
2. Configurer la source
- ID d'objet — Export direct d'un objet ELO connu
- Chemin ELO — Export par chemin ARCPATH: ou SORD:
- FindSearch — Recherche dynamique par masque et filtres ObjKey
3. Définir la cible
- Système de fichiers — Chemin absolu vers le dossier cible
- Webhook — Sélectionner un canal système et le mode de contenu
- Les deux combinables — Fichier sur disque ET webhook simultanément
4. Post-traitement
- Mise à jour ObjKey — Après export, définir p.ex.
EXPORT_STATUS=Exporté - Contenu webhook —
statuspour info compacte oufullpour métadonnées complètes - Transfert de workflow — Avancer le workflow ELO automatiquement
5. Planification
- Continu — Expression cron ou durée Go
- Planifié — Horaires fixes
Bonnes pratiques
- Dossiers cibles dédiés — Utilisez un dossier séparé pour chaque tâche d'export.
- Exporter les métadonnées — Activez les métadonnées JSON ou .niqcd pour la traçabilité.
- Planifier les gros lots — Exécutez les exports volumineux en heures creuses (ex.
0 2 * * *). - Utiliser le post-traitement — Définissez un champ ObjKey comme
EXPORT_STATUS=Exportéaprès l'export pour éviter les doublons. - Combiner FindSearch + Post-traitement — Rechercher
EXPORT_STATUS=Nouveau, exporter, puis définirEXPORT_STATUS=Exporté. - Webhook pour les intégrations — Utilisez le canal webhook en mode
fullpour envoyer les métadonnées ELO aux systèmes tiers. - MetadataOnly pour les scénarios webhook — Activez
MetadataOnlyavec le webhook pour un export sans écriture sur le système de fichiers. - Configuration de réessai — Activez le mécanisme de réessai avec backoff exponentiel pour les connexions instables.
Exemples
Exemple 1 : Export quotidien de factures avec mise à jour du statut
Tâche : "Factures-Daily" SourceMode: findsearch FindInfo: MaskName=Facture, ObjKeys: EXPORT_STATUS=Nouveau TargetFolder: C:\Export\Factures PostProcessing: UpdateObjKeys: EXPORT_STATUS → Exporté SendMessage: ContentMode=status, OnSuccess=true Interval: 0 8 * * 1-5
Exemple 2 : Webhook uniquement (sans export fichier)
Tâche : "ERP-Sync" MetadataOnly: true PostProcessing: SendMessage: ContentMode=full, OnSuccess=true Interval: */15 * * * *
Exemple 3 : Payload webhook en mode "full"
{
"export": { "job_name": "ERP-Sync", "status": "success" },
"document": { "obj_id": 12345, "filename": "Facture_2024-001.pdf", ... },
"index_fields": { "NR_FACTURE": "2024-001", "FOURNISSEUR": "..." },
"map_fields": { "CONDITIONS_PAIEMENT": "30 jours net" },
"custom_data": { "mandant": "001" }
}Modes d'export
| Mode | Cas d'utilisation |
|---|---|
| Fichier + Webhook | Export sur disque ET notification externe |
| Fichier uniquement | Export classique sans notification |
| Webhook uniquement | MetadataOnly=true + Webhook |