Versions

Chaque environnement conserve un historique restaurable des configurations publiées. Cette page couvre le modèle brouillon/version active, l'enregistrement et la publication d'une version, la comparaison de deux instantanés (y compris votre brouillon non publié), la restauration, et la promotion d'une version entre environnements.

Le modèle brouillon / version active

Chaque environnement gère deux choses en parallèle : un brouillon de travail (à quoi ressemblent actuellement vos connexions, fonctions, boutons de ruban et volet Office dans le tableau de bord) et une version active (un instantané enregistré réellement servi à Excel).

Modifier, c'est toujours modifier un brouillon. Ajouter une fonction, changer une connexion, ajuster le volet Office — rien de tout cela ne crée de version, et rien de tout cela n'atteint Excel de lui-même.
Une version n'est créée que délibérément — via Enregistrer la version ou via Promouvoir. Il n'y a pas de version « modification » automatique ; c'est pourquoi une fonction tout juste construite ne renvoie toujours rien tant que vous ne l'avez pas publiée.
La version active est un pointeur, pas une copie du brouillon. L'environnement pointe vers une version enregistrée ; l'agent sert exactement l'instantané de cette version. Un environnement sans version active ne sert encore rien — son agent affiche zéro fonction.

Pourquoi une fonction toute neuve renvoie une cellule vide

Si vous venez de construire une fonction et que la cellule n'affiche rien (ou que la configuration de l'agent semble vide), vous n'avez presque certainement pas publié. Rendez-vous sur la page Versions de l'environnement et Enregistrer la version avec « Activer cette version » coché — c'est la seule action qui pousse votre brouillon vers l'agent.

Enregistrer une version

Depuis la page Versions de l'environnement, Enregistrer la version capture le brouillon de travail actuel sous un nom que vous choisissez. Sa fenêtre modale comporte un interrupteur :

Activer cette version (activé par défaut) — publie l'instantané immédiatement ; l'agent commence à le servir.
Désactivé — enregistre un point de contrôle sans changer ce qui est actuellement actif. Utile pour capturer une étape en cours de modification sans encore la livrer.

Activer une version (Make live)

Toute version enregistrée dans l'historique peut être réactivée d'un clic — une action Activer qui déplace simplement le pointeur de version active vers celle-ci. Elle ne touche pas à votre brouillon de travail et ne crée pas de nouvelle version ; c'est un simple interrupteur de publication/retour en arrière. Utilisez-la pour revenir à une version connue comme fiable après une mauvaise publication, ou pour repromouvoir une version plus ancienne sans relancer Promouvoir.

Comparer

L'action Comparer (ou cocher deux lignes dans l'historique) ouvre une comparaison en pleine page entre deux versions quelconques. Les deux sélecteurs sont :

De — n'importe quelle version enregistrée.
À — n'importe quelle version enregistrée, ou une option spéciale État actuel (avec le badge Brouillon) qui récupère votre brouillon de travail brut et non versionné directement depuis les tables actives de l'environnement.

Comparer une version enregistrée à l'État actuel est la façon de voir exactement ce que la publication changerait avant de la faire — la même vérification qui alimente la bannière « changements non publiés » de la page Versions. Pour comparer avec la version active de l'environnement en particulier (et non le brouillon), choisissez-la dans la liste des versions — la ligne que l'historique marque comme Active.

L'état actuel n'est pas la même chose que la version active

Même quand rien ne semble différent, « État actuel » est toujours votre brouillon de travail relu à l'instant — ce n'est délibérément pas une copie mise en cache de l'instantané de la version active. Comparer avec lui est le seul moyen de voir les modifications non publiées ; comparer deux versions enregistrées ne montre jamais que des différences entre publications.

La comparaison classe chaque élément modifié comme ajouté, supprimé ou modifié, et pour les éléments modifiés indique exactement quels champs ont changé — y compris un indicateur pour les changements qui ne touchent que les champs de valeur d'une connexion (hôte, URL, référence de secret) plutôt que sa structure.

Restaurer

Restaurer est l'alternative plus ancienne et plus radicale à Activer une version : elle écrase le brouillon de travail de l'environnement avec le contenu d'une version enregistrée et enregistre une entrée restore. Les lignes de version du tableau de bord utilisent Activer pour les retours en arrière au quotidien (pas d'écrasement, pas d'avertissement destructeur) ; Restaurer reste disponible comme action de dernier recours lorsque vous voulez spécifiquement que le brouillon lui-même soit remplacé.

Promouvoir entre environnements

Promouvoir apporte la structure d'un environnement source dans un environnement en aval et la publie en une seule étape — c'est ainsi que les changements structurels (une nouvelle fonction, une connexion dont la forme a changé) atteignent QA, Staging ou Production. Cela :

Copie la structure depuis l'environnement source (Development).
Ne touche jamais aux propres valeurs de la cible — ses identifiants, son hôte d'agent et ses réglages de cache restent exactement tels que configurés pour cet environnement.
Enregistre une entrée promote dans l'historique de versions de la cible, avec un titre du type « Promu depuis Development » et les badges de différence correspondants.

Lire l'historique

L'historique des versions liste chaque version de la plus récente à la plus ancienne, chaque ligne affichant :

Une icône de genre — Enregistrée (un Enregistrer la version manuel), Promotion ou Restauration.
Le titre de la version (le nom que vous avez choisi, ou un intitulé dérivé du genre).
Un badge bleu Active et une mise en évidence sur la version actuellement servie.
L'environnement d'origine, qui a fait la modification, et quand.
Des badges de différence résumant ce qui a changé par rapport à la version précédente.

Sur chaque ligne, vous pouvez Activer, Comparer (avec une autre ligne) ou Supprimer (suppression douce ; la version active ne peut pas être supprimée). Une bannière ambrée en haut de la page vous indique quand le brouillon de travail a des changements non publiés en attente d'un Enregistrer la version.

Les versions apparaissent aussi dans les journaux

Les événements Enregistrer / Promouvoir / Activer apparaissent dans la console Journaux sous un filtre « Changements de configuration », limité à l'environnement que vous consultez — pratique quand vous voulez une piste d'audit chronologique aux côtés des analyses d'utilisation plutôt que la page Versions dédiée. Voir Journaux et exports.

Environnements

Ce qu'est un environnement, le renommage et le cache de résultats.

Dépannage

« Ma formule est vide » et d'autres correctifs, à commencer par le piège brouillon/version active ci-dessous.