ELONIQ / Manuel ELONIQ
Deutsch English Français
Aperçu / Exportation / ELO Exporter

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 :

  1. Recherche — Identifier les documents par ID, chemin ELO ou FindSearch
  2. Export — Exporter vers le système de fichiers et/ou envoyer via webhook
  3. Post-traitement — Mettre à jour les champs ObjKey, transférer les workflows
  4. 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 webhookstatus (compact) ou full (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 webhookstatus pour info compacte ou full pour 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éfinir EXPORT_STATUS=Exporté.
  • Webhook pour les intégrations — Utilisez le canal webhook en mode full pour envoyer les métadonnées ELO aux systèmes tiers.
  • MetadataOnly pour les scénarios webhook — Activez MetadataOnly avec 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
ModeCas d'utilisation
Fichier + WebhookExport sur disque ET notification externe
Fichier uniquementExport classique sans notification
Webhook uniquementMetadataOnly=true + Webhook