EDOF 2
Convertisseur EDOF — Guide d’utilisation
Introduction
Ce guide vous accompagne pas à pas dans l’utilisation du Convertisseur EDOF, un outil conçu pour simplifier la création de vos fichiers XML LHÉO destinés à la plateforme EDOF (Échange de Données sur l’Offre de Formation). Vous y trouverez l’objectif de l’outil, ses bénéfices, les étapes d’utilisation, les validations automatiques, ainsi qu’une FAQ et des bonnes pratiques.
Ce document suit le format Markdown Crisp et remplace les émojis par des encadrés normalisés pour plus de clarté. |
À quoi sert cet outil ?
Le Convertisseur EDOF transforme vos données de formation (offres/produits et sessions) stockées dans des fichiers Excel en un fichier XML conforme au format LHÉO, prêt à être importé dans EDOF.
Utilisez cet outil pour automatiser la génération de votre catalogue LHÉO à partir d’Excel, en toute fiabilité. |
Pourquoi l’utiliser ?
- Gain de temps : plus besoin de créer manuellement vos fichiers XML.
- Fiabilité : validations automatiques et détection d’anomalies.
- Simplicité : interface guidée en 3 étapes.
- Conformité : respect automatique du schéma LHÉO exigé par EDOF.
- Contrôle : vérification et journal des anomalies avant export.
Comment ça marche ? (Étapes)
1) Renseigner les informations d’organisme
- Saisissez le SIRET de votre organisme de formation.
- Le SIRET sert à identifier vos offres et à nommer le fichier XML généré.
- Validez.
Le SIRET est mémorisé localement pour vos prochains exports. |
2) Importer les fichiers Excel
Vous devez fournir deux fichiers Excel distincts :
Fichier Produits (Offres de formation)
Contient vos offres : Référence produit (ex. PRO-001), Nom, Objectifs, Public visé, Prix, Durée, Certifications, etc.
Fichier Sessions (Dates et lieux)
Contient vos sessions : Référence session (ex. SES-001), Produit associé, Dates début/fin, Lieu, Modalités(présentiel/distanciel), Prix, etc.
Les deux fichiers sont obligatoires pour générer un catalogue complet. |
3) Générer le fichier XML
- Choisissez la portée d’export :
- Catalogue complet (recommandé) : toutes les offres et leurs sessions.
- Offres uniquement : met à jour les offres sans sessions.
- Actions/Sessions uniquement : met à jour les sessions avec leurs offres parentes.
- Activez des options (facultatif) :
- Détection stricte des doublons.
- Autres validations avancées.
- Cliquez sur « Générer le fichier XML ».
Le convertisseur va :
- Vérifier la validité de vos données.
- Normaliser les formats (dates, téléphones, codes postaux…).
- Créer le fichier XML conforme LHÉO.
- Présenter un résumé détaillé des éléments exportés.
Filtrage automatique des données
Pour garantir un export de qualité, des filtres automatiques sont appliqués avant génération.
Règles pour les Produits (Offres)
Un produit est exporté uniquement si :
- Colonne Export EDOF = VRAI (ou
TRUE,1,OUI) - Colonne Actif = VRAI (ou
TRUE,1,OUI)
Cela vous permet de préparer un catalogue complet dans Excel, mais de n’exporter que les offres prêtes pour EDOF. |
Règles pour les Sessions
Une session est exportée uniquement si :
- Colonne Export EDOF = VRAI (ou
TRUE,1,OUI) - Statut principal session =
prévisionnelouconfirmé
Sessions automatiquement exclues :
- en cours
- terminé
- archivé
- annulé
Badges de comptage (après import)
- X offres : nombre de produits prêts à l’export (après filtrage).
- X sessions : nombre de sessions prêtes à l’export (après filtrage).
Validations / Vérifications automatiques
Formats validés et normalisés
- Téléphones : normalisation au format français (ex.
01 23 45 67 89). - Emails : contrôle de la validité syntaxique.
- SIRET : contrôle des 14 chiffres.
- Dates : conversion automatique au format AAAAMMJJ.
- Codes postaux : vérification code postal / ville via API publique.
Détection d’anomalies
- Doublons : sessions identiques (même lieu, prix, durée, modalités).
- Données manquantes : champs obligatoires vides.
- Incohérences : prix négatifs, dates invalides, etc.
Journal ou historique
Journal des anomalies (rapport détaillé)
Pour chaque anomalie détectée, le journal indique :
- Type d’erreur,
- Numéro de ligne concerné,
- Sévérité : erreur bloquante ou avertissement,
- Suggestion de correction.
Téléchargement et historique d’exports
- Téléchargez le XML via « Télécharger le XML ».
- Nom de fichier :
<<VOTRE_SIRET>>_catalogue.xml
- Nom de fichier :
- Les 10 derniers exports sont conservés et re-téléchargeables sans régénération.
Structure attendue des colonnes (rappel)
Produits (Offres)
- Référence obligatoire (format
PRO-...) - Nom du produit obligatoire
- Objectif obligatoire
- Public visé obligatoire
- Export EDOF (optionnel :
VRAI/FAUX) - Actif (optionnel :
VRAI/FAUX) - Prix, Durée, Certifications…
Sessions
- Référence obligatoire (format
SES-...) - Produit obligatoire (référence de produit existant)
- Date de début et Date de fin obligatoires
- Prix TTC obligatoire
- Statut principal session (recommandé)
- Export EDOF (optionnel :
VRAI/FAUX) - Lieu, Modalités…
Le convertisseur détecte automatiquement les colonnes, mais certains noms sont attendus pour une reconnaissance optimale. |
Questions fréquentes (FAQ)
Mes fichiers Excel doivent-ils avoir un format particulier ?
Oui. Respectez les noms de colonnes listés ci-dessus. Le convertisseur fait une détection automatique, mais la conformité des libellés améliore la qualité d’import.
Que faire en cas d’erreurs ?
- Ouvrez le journal des anomalies.
- Corrigez les lignes mentionnées dans vos fichiers Excel.
- Réimportez les fichiers corrigés (glisser-déposer).
- Régénérez le XML.
Le convertisseur modifie-t-il mes fichiers Excel ?
Non. Les fichiers Excel ne sont jamais modifiés : ils sont lus pour produire le XML.
Mes données sont-elles sécurisées ?
Oui, les données restent sur votre ordinateur. Aucune donnée n’est transmise, sauf pour :
- la validation code postal / ville (API publique gouvernementale),
- la normalisation de certaines données invalides (via OpenAI, en dernier recours uniquement).
Conseils et bonnes pratiques
Avant d’importer |
|---|
Vérifiez les noms de colonnes. |
Utilisez des références produits commençant par |
Utilisez des références sessions commençant par |
Assurez-vous que chaque session pointe vers un produit existant. |
Pour un export de qualité |
Renseignez tous les champs obligatoires. |
Adoptez des formats cohérents (dates, prix, téléphones). |
Vérifiez le couple code postal / ville. |
Servez-vous de Export EDOF et Actif pour piloter l’export. |
Après la génération |
Lisez le résumé et contrôlez les compteurs. |
Consultez le journal des anomalies et corrigez si nécessaire. |
Prévisualisez le XML avant téléchargement. |
Conservez une copie de vos Excel sources. |
Annexes (exemples)
Exemples de valeurs acceptées
- Export EDOF :
VRAI,TRUE,1,OUI - Statut principal session :
prévisionnel,confirmé - Téléphone (FR) :
0X XX XX XX XX - Date (sortie LHÉO) :
AAAAMMJJ(ex.20251201)
Exemple de nom de fichier exporté
12345678901234_catalogue.xml
En synthèse : préparez proprement vos fichiers Excel, importez-les, choisissez la portée d’export, laissez le convertisseur valider et normaliser, puis téléchargez votre XML conforme LHÉO. |
Mis à jour le : 10/11/2025
Merci !
