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. La page compte trois vues : Export (préparer un paquet, ou promouvoir la sélection directement vers une autre instance), Import (appliquer un paquet) et Historique.
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. | — |
| Formulaire de saisie | Un formulaire de saisie de l'éditeur de facture. | — (les droits des rôles restent propres à chaque environnement) |
| Liste | Une liste de référence ou une liste personnalisée. | — |
| Règle de notification | Une règle de notification. | — |
| Analyse de l'Explorateur · Tableau de bord de l'Explorateur | Une analyse ou un tableau de bord enregistré de l'Explorateur. | Un tableau de bord emporte les analyses de ses tuiles. |
| 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), et chaque fichier utilisé par un document — transformation, XSL, RTF, feuille UBL, Schematron client, mise en page PDF — listé par son chemin avec Used by … les documents qui l'utilisent. Un fichier peut être promu seul, par exemple une feuille partagée par plusieurs documents. | — |
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.
Promouvoir vers une autre instance
Quand les deux instances peuvent communiquer, la sélection de la vue Export est envoyée directement à une instance cible, sans manipuler de fichier ZIP. Le paquet est constitué comme pour un export, transmis à l'aperçu de la cible, puis à son import.
- Cocher les éléments dans la vue Export (avec leurs dépendances).
- Sous Promouvoir vers une instance, en bas du panneau latéral de l'export, choisir l'Instance cible (la dernière utilisée est mémorisée) puis cliquer sur Promouvoir….
- La fenêtre Promouvoir vers … affiche l'aperçu de la cible — nouveaux, modifiés, identiques, ignorés, avec les écarts par champ. Rien n'est encore écrit : Promouvoir vérifie d'abord la sélection sur l'instance cible et montre ce qui y changerait ; rien n'est écrit avant votre confirmation.
- Dans la même fenêtre, choisir la règle des Éléments et fichiers modifiés — Remplacer par le paquet ou Conserver la cible, n'écrire que les nouveaux — et un commentaire, puis cliquer sur Promouvoir n élément(s) et n fichier(s). La cible prend un instantané de version avant chaque écriture, et ses clés d'instance conservent leur valeur. La fenêtre indique ensuite Promue vers … : n élément(s) et n fichier(s) écrits.
L'export ZIP reste disponible pour les instances qui ne peuvent pas communiquer.
Instances cibles
Les cibles se définissent une fois dans Paramètres → Promotion targets (domaine Platform) ; tant qu'aucune n'existe, l'en-tête des Paramètres propose Add promotion targets. Chaque cible comporte :
| Champ | Description |
|---|---|
| Name | Affiché dans la liste des cibles de la page Promotion. |
| URL | Racine de l'instance cible, avec son préfixe de chemin s'il y en a un (par exemple https://test.example/nomaubl). |
| Username / Password | Compte sur la cible, qui doit y disposer de la fonctionnalité Accès aux paramètres ; vide quand la cible fonctionne sans authentification. Le mot de passe est enregistré encodé et décodé sur le serveur uniquement pour l'appel. |
Le compte n'est jamais transmis au navigateur et ne voyage jamais dans un paquet. Cet éditeur reste en anglais dans l'application.
Historique
La vue Historique liste chaque paquet exporté, import appliqué et promotion appliquée sur l'instance, du plus récent au plus ancien :
| Colonne | Description |
|---|---|
| Quand | Date et heure. |
| Sens | Export, Import ou Promue. |
| Contrepartie | La cible d'une promotion, la source d'un import. |
| Auteur | Qui l'a lancée. |
| Politique | replace ou keep. |
| Éléments / Fichiers | Nombres. |
| Commentaire | Le commentaire saisi. |
Une ligne ouvre l'entrée avec son plan complet et ses écarts. Une instance source garde ses promotions, une cible ses imports. Chaque entrée est un fichier JSON du dossier promotions de l'environnement.
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é.