Qualité et livraison — Conventions

Cette page définit des conventions pragmatiques pour standardiser la gestion des rapports .frx :
- réduire les risques de perte de travail,
- faciliter les comparaisons et retours arrière,
- sécuriser la livraison en production.

Note

Ces conventions complètent la méthode décrite dans Ouvrir et enregistrer un .frx (copie de travail, livrable, nommage production).
Elles s’appliquent à chaque rapport modifié, quel que soit le niveau de complexité.

1) Convention de nommage des fichiers (travail vs livrable)

Copie de travail (édition)

Utiliser un nom “humain”, explicite, permettant d’identifier rapidement : le rapport, le client, et la version.

Recommandation (exemple) :
- nomrapport_client_YYYYMMDD_v01.frx
- facture_societeX_20251219_v02.frx

Tip

Conservez un format de date stable YYYYMMDD pour trier naturellement les versions.

Livrable production

En production, certains rapports doivent respecter un nom strict (souvent numérique) pour être appelés correctement.

Règle :
- vous éditez sur une copie de travail explicite,
- vous ne renommez en “nom production” que la version finalisée et validée,
- vous déployez uniquement ce livrable renommé.

Warning

Ne pas “travailler” directement sur un fichier déjà renommé au format production (0.frx, 6.frx, 16.frx, etc.).
Cela rend les retours arrière et comparaisons plus risqués.

2) Versioning minimal (gestion des itérations)

Objectif : pouvoir revenir à une version antérieure sans ambiguïté.

Conventions recommandées :

incrémenter un suffixe v01, v02, v03 à chaque itération significative,
conserver au moins :
la version d’origine (source),
la dernière version validée,
la version livrée en production.

Exemple de cycle

rapport_client_20251219_v01.frx (copie de travail initiale)
rapport_client_20251219_v02.frx (ajustements)
6.frx (livrable final renommé pour production)

3) Copie d’origine (règle non négociable)

Règle d’or :

ne jamais modifier l’unique .frx d’origine,
démarrer chaque session par Enregistrer sous…,
conserver l’original à des fins de comparaison et rollback.

Note

Cette règle limite les risques opérationnels et réduit le temps de diagnostic en cas de retour client.

4) Organisation des dossiers (client / ticket / livraison)

Objectif : retrouver rapidement : le contexte, la dernière version, et le livrable.

Exemple d’organisation pragmatique :

Client/
Ticket_XXXX/
- source/ (original reçu ou export initial)
- work/ (copies de travail versionnées)
- delivery/ (livrable final, renommé si nécessaire)

Tip

Séparer explicitement work/ et delivery/ évite de livrer une mauvaise version par erreur.

5) Conventions de nommage d’objets (optionnel mais utile)

Le nommage d’objets (ex. textes, totals, champs calculés) est recommandé lorsque :
- le rapport contient plusieurs blocs similaires,
- des expressions sont réutilisées ou modifiées régulièrement,
- la maintenance est réalisée par plusieurs personnes.

Conventions simples :

préfixer par type : txt_, lbl_, calc_,
inclure le rôle : txt_client_nom, lbl_total_ht, calc_total_ttc.

Note

Le but n’est pas de tout renommer, mais de rendre les éléments critiques identifiables rapidement lors d’une reprise.

6) Discipline de livraison (rappel)

Avant livraison :

valider le rendu en prévisualisation (Aperçu / Web Preview),
valider le contrôle SPC si applicable,
livrer le fichier au bon nom (production si requis),
archiver la copie de travail versionnée et l’original.

Besoin d’aide ?

Contactez le support SenSaaS :
✉️ support@sensaas.fr
📞 04 90 88 22 76