Corpus de démonstration
Le corpus de démonstration remplit une instance de démonstration avec des données fictives mais réalistes, pour présenter ou tester chaque page de NomaUBL sans fichier client : factures et avoirs émis de toute nature, factures fournisseurs, cycles de vie avec statuts de plateforme, enveloppes d'e-reporting et notifications. Tout passe par les vraies chaînes de traitement — génération UBL, validation, archivage, journal des traitements — mais rien n'est envoyé à une plateforme. La même graine produit le même corpus, et une réinitialisation retire tout ce que la démonstration a créé.
Le corpus ne peut être créé que sur une instance marquée Demo instance = Y. Ne jamais régler cette option sur une instance client.
Vue d'ensemble
Prérequis
| Réglage | Emplacement | Valeur |
|---|---|---|
| Demo instance | Paramètres › Global › Directories | Y |
| Update DB | Paramètres › Global › Processing | Y — les chaînes spool et PDF et le journal des traitements doivent écrire en base. |
Les feuilles de style de l'environnement doivent être installées (elles le sont après une installation standard).
Contenu du corpus
| Document | Source | Contenu |
|---|---|---|
demo_ubl | Fichiers UBL | Factures et avoirs émis couvrant les types de facture (380, 381, 384, 389, 261, 262), EN 16931 et le profil étendu français, les types de transaction (B2B, B2G, B2C, B2BINT, hors champ), toutes les catégories de TVA, remises et charges de document et de ligne, acomptes, bénéficiaires, représentants fiscaux, livraisons, moyens de paiement, pièces jointes et références. Paramétré avec la post-transformation UBL vers CII. |
demo_jde | Spools XML de type JDE | Plusieurs factures par fichier, par la chaîne XML ; le mapping, produit à partir du modèle livré, montre des chemins imbriqués, une constante, un total de TVA additionné, un champ trouvé n'importe où dans le bloc et un saut de ligne. |
demo_pdf | PDF texte | Relus par la conversion PDF vers XML : deux blocs d'adresse, des lignes étiquetées, un tableau et des champs par expression régulière pour la clé du document. |
demo_received | Factures fournisseurs UBL | Factures reçues de six fournisseurs français fictifs, conduites selon le parcours acheteur : mise à disposition, prise en charge, approuvée, en litige, refusée, payée. |
Autour d'eux :
- Sociétés et clients — cinq sociétés émettrices et trente acheteurs, fictifs, avec des identifiants valides (SIREN, numéro de TVA, IBAN).
- Cycles de vie — les factures destinées à la plateforme suivent des parcours datés réalistes : envoyée, en attente, déposée, non transmise, refusée, rejetée, en litige, suspendue, approuvée, payée, avec des échecs d'envoi et d'import et des renvois ; certaines sont marquées comme vues. Rien n'atteint une vraie plateforme.
- Anomalies — toutes les factures passent les contrôles français, sauf quelques-unes volontairement invalides pour illustrer les erreurs de validation.
- E-reporting — des enveloppes pour chaque mois terminé, produites par le vrai traitement d'e-reporting, puis conduites jusqu'à déposée, échec d'import ou rejetée.
- Notifications — une règle de notification limitée au portail pour les refus, rejets et échecs.
Depuis les paramètres
Quand Demo instance vaut Y, l'onglet Directories des paramètres globaux affiche un bloc Demo corpus :
| Champ | Défaut | Description |
|---|---|---|
| Invoices | 300 | Nombre de factures produites. |
| Months | 6 | Période couverte, qui se termine au mois en cours. |
| Seed | 2026 | Même graine, même corpus. |
| Sources | ubl,jde,pdf,recv | Parmi ubl, jde, pdf, recv (factures reçues). |
Fill the demo corpus et Reset the demo corpus s'exécutent en tâche de fond avec la fenêtre de progression habituelle. La réinitialisation demande confirmation et retire toutes les factures, enveloppes, lignes de notification, fichiers et documents créés par la démonstration sur l'instance. Enregistrer les paramètres avant de remplir le corpus.
Ce bloc reste en anglais dans l'application.
En ligne de commande
java -jar nomaubl.jar -demo /opt/nomaubl/demo/config/config.json [--seed N] [--invoices 300] [--companies 5] [--customers 30] [--from aaaa-MM] [--months 6] [--sources ubl,jde,pdf,recv] [--out <dossier>] [--reset] [--no-process] [--no-lifecycle]
| Option | Effet |
|---|---|
--seed, --invoices, --months, --sources | Comme dans le bloc des paramètres. |
--companies / --customers | Nombre de sociétés émettrices (5) et d'acheteurs (30). |
--from <aaaa-MM> | Premier mois de la période, à la place de Months compté depuis aujourd'hui. |
--out <dossier> | Dossier des fichiers produits. |
--no-process | Produit les fichiers sans les traiter. |
--no-lifecycle | Traite les factures sans conduire leur cycle de vie. |
--reset | Retire tout ce que la démonstration a créé. |
Voir Ligne de commande.
Conseils & bonnes pratiques
- Réserver un environnement de démonstration, à côté de la recette et de la production, installé comme les autres ; ne régler Demo instance que sur lui.
- Fixer la graine pour une formation ou une démonstration enregistrée : les mêmes factures reviennent après une réinitialisation.
- Réinitialiser avant de remplir de nouveau. Un remplissage s'ajoute à l'existant ; une réinitialisation repart d'une base propre.
- S'appuyer sur le corpus pour essayer un réglage — un jeu de règles, une post-transformation, une règle de notification — sur des centaines de factures variées avant de toucher une instance client.