Promotion
La page Promotion transfère la configuration d'une instance à une autre — du développement vers la recette, de la recette vers la production — élément par élément, avec les fichiers utilisés par chaque élément. L'export produit un paquet ; l'import montre ce que le paquet modifierait, champ par champ, puis l'écrit après un instantané de version. Les clés propres à une instance — mots de passe, URL, hôtes, licence, nom de l'environnement… — ne voyagent jamais et ne sont jamais écrasées sur la cible.
Accès : Gestion → Promotion.
Vue d'ensemble
Ce qui peut être promu
| Type | Contenu de l'élément | Transféré avec lui |
|---|---|---|
| Document | Un document. | Ses fichiers — XSL de pré-traitement, XSL d'indexation, RTF, XSLT UBL et son complément PDF (.pdf.json), Schematron spécifique — et le modèle PDF qu'il désigne. |
| Modèle PDF | Un modèle PDF. | — |
| Liste | Une liste de référence ou une liste personnalisée. | — |
| Règle de notification | Une règle de notification. | — |
| Rapport quotidien · Reprise auto · Contrôle cycle de vie | Un rapport quotidien, une reprise automatique ou un contrôle du cycle de vie. | — |
| Connecteur | Un connecteur API, SQL, base de données ou FTP, sans ses secrets ni ses cibles. | — |
| Modèle de réglages | E-invoicing, e-reporting, annuaire, dossiers surveillés, contrôles d'intégrité, requêtes de rapports ou file d'impression JDE, sans ses clés d'instance. | — |
| Fichier | Le fichier commun des valeurs UBL par défaut (ubl-defaults.xsl, les valeurs propres à l'exploitant dans la XSL commune). | — |
Les paramètres globaux, l'authentification unique et les noms de colonnes remplacés de la base NomaUBL ne sont jamais promus : ils décrivent l'instance elle-même.
Exporter
- Cocher les éléments dans l'arborescence, regroupés par type avec leur nombre. La case du type sélectionne tous les éléments visibles de ce type ; Filtrer les éléments… restreint l'arborescence.
- Vérifier les dépendances affichées sous chaque élément : les fichiers qu'il utilise et les éléments ajoutés avec lui. Le modèle PDF désigné par un document sélectionné est coché automatiquement et marqué dépendance.
- Exporter le paquet télécharge le ZIP. Le panneau latéral compte les éléments, dépendances et fichiers de la sélection ; Vider la sélection permet de repartir de zéro.
Contenu du paquet
| Entrée | Contenu |
|---|---|
manifest.json | Les éléments avec leur type et leur somme de contrôle, l'instance et la version d'origine, l'auteur et la date. |
items/ | Un fragment JSON par élément. |
files/ | Les fichiers référencés, avec leur chemin relatif à la racine de l'environnement : les variables %APP_HOME% et %ENV% des propriétés restent valables sur la cible. |
Ce qui ne voyage jamais
Mots de passe, secrets, jetons, clés d'API, licence, URL, hôtes, utilisateurs, schéma de base, nom et couleur de l'environnement, ainsi que les jalons des tâches (dernière tâche BIP, dernier parcours, dernière récupération) ne sont jamais exportés. À l'import, la cible conserve ses propres valeurs pour ces clés.
Importer
| Type | Élément | État | Modifications | Détail | Appliqué |
|---|---|---|---|---|---|
| Document | invoices | modifié | 3 | ||
| Modèle PDF | standard | identique | 0 | ||
| Fichier | xsl/invoices.xsl | nouveau | 0 |
Aperçu
Éléments : 0 nouveaux, 1 modifiés, 1 identiques, 0 ignorés
Fichiers : 1 nouveaux, 0 modifiés, 0 identiques, 0 ignorés
Éléments et fichiers modifiés
Remplacer par le paquet ▾
Commentaire pour les instantanés et le journal
✓ Appliquer
- Choisir un paquet de promotion (.zip). La page lit le manifeste — environnement d'origine, version, auteur, date — et calcule l'aperçu sans rien écrire.
- Lire l'aperçu. Chaque élément et chaque fichier reçoit un état : nouveau, modifié, identique ou ignoré. La grille indique le nombre de champs modifiés par élément ; une ligne ouvre la comparaison des champs — clé, changement (défini, ajouté, modifié, supprimé), valeur Cible et valeur Paquet.
- Choisir la règle appliquée aux éléments et fichiers modifiés :
- Remplacer par le paquet — les éléments et fichiers modifiés prennent la version du paquet ;
- Conserver la cible, n'écrire que les nouveaux — seuls les nouveaux éléments et fichiers sont écrits.
- Saisir un commentaire, repris dans les instantanés et le journal.
- Appliquer puis confirmer. Le panneau passe en Résultat, la colonne Appliqué signale ce qui a été écrit, et Choisir un autre paquet réinitialise la page.
Ce qu'écrit Appliquer :
- chaque élément est inséré ou mis à jour par son nom dans son propre fichier de configuration ;
- chaque fichier est écrit après un instantané de version, consultable et restaurable dans les versions de fichiers ;
- les clés d'instance déjà présentes sur la cible conservent leur valeur ;
- l'import forme une seule entrée du journal des versions, avec son auteur et son commentaire.
La grille est la table de données partagée ; sa vue figure dans l'éditeur des vues de liste.
Accès
Accorder Promotion dans le groupe Gestion de la page Rôles. Le droit Réglages est également requis.
Le mode Package des versions de fichiers reste disponible pour les fichiers bruts rattachés à aucun élément.
Conseils & bonnes pratiques
- Promouvoir de l'environnement inférieur vers le supérieur. Modifier en développement, vérifier en recette, puis importer le même paquet en production : le paquet garde la trace de ce qui a été transféré.
- Lire la comparaison avant d'appliquer. Un élément modifié sur une clé inattendue signale souvent une modification faite directement sur la cible.
- Choisir Conserver la cible pour ajouter sans écraser, par exemple pour apporter un nouveau document à une instance dont les documents existants ont été ajustés sur place.
- Rédiger un commentaire explicite. C'est le libellé des instantanés à restaurer si l'import doit être annulé.