Appliquer les Valeurs pré-remplies à l'échelle du projet sur le Webclient
Mettez à jour une valeur pré-remplie à l'échelle du projet sur le Webclient en choisissant une valeur existante et en la validant via l'étape de confirmation avec aperçu de la portée. Le changement réécrit chaque Documentation existante du projet et fixe la nouvelle valeur par défaut pour chaque nouvelle Documentation.
La fonctionnalité Valeurs pré-remplies de Sparkify vous permet de définir une seule fois les valeurs par défaut des champs de documentation et de les voir se remplir automatiquement partout où elles s'appliquent. Appliquer est l'action que vous atteignez sur la couche projet du Webclient lorsque la valeur que vous voulez définir comme standard du projet existe déjà comme valeur sur certain(s) champ(s) à l'intérieur de n'importe quel Modèle de documentation choisi dans les Valeurs pré-remplies. Vous choisissez les champs, vous choisissez la valeur, et une seule confirmation réécrit cette valeur dans chaque Documentation existante du projet.
Ce qui rend la couche projet différente, c'est ce qui se passe quand vous confirmez. La nouvelle valeur réécrit le champ dans chaque Documentation existante du projet créée à partir de ce modèle — et devient la valeur par défaut pour chaque nouvelle Documentation créée à partir de ce modèle par la suite. L'effet est bidirectionnel : en arrière sur ce qui existe déjà, en avant sur ce qui reste à venir.
Qui peut l'utiliser
Appliquer à l'échelle du projet sur le Webclient est disponible pour les Propriétaires et les Gestionnaires. Les Utilisateurs peuvent ouvrir le menu déroulant de la couche projet (puisqu'ils sont autorisés à exécuter Modifier), mais l'option Appliquer les valeurs pré-remplies ne sera pas disponible pour eux. La restriction d'Appliquer correspond au rayon d'impact : une seule confirmation réécrit les valeurs de champ dans chaque Documentation existante du projet, donc Appliquer reste au niveau Propriétaire / Gestionnaire. Si vous avez besoin qu'une valeur pré-remplie au niveau projet soit appliquée et que vous n'êtes ni Propriétaire ni Gestionnaire, demandez à l'un d'eux de l'exécuter.
Où apparaît Appliquer
Appliquer est spécifique à la couche projet du Webclient. Les deux points d'entrée vers les pré-remplissages de la couche projet — l'icône d'éclair dans la barre supérieure et le bouton Valeurs pré-remplies sur la carte d'info du projet — ouvrent le même menu déroulant à deux options : Appliquer les valeurs pré-remplies et Modifier les valeurs pré-remplies. La couche Workspace n'expose pas du tout Appliquer — il n'y a pas d'équivalent au niveau Workspace de la réécriture à l'échelle du projet. Modifier au niveau Workspace fixe uniquement la valeur par défaut à l'échelle du Workspace pour les nouvelles Documentations à venir.
Pour les parcours des points d'entrée et les captures d'écran, voir l'article parent : Valeurs pré-remplies.
Ce que fait Appliquer
Appliquer vous permet de choisir un ou plusieurs champs, puis de sélectionner une valeur existante à définir comme pré-remplissage au niveau projet pour ces champs. Utilisez-le lorsque la valeur que vous voulez existe déjà comme valeur sur certain(s) champ(s) à l'intérieur de n'importe quel Modèle de documentation choisi dans les Valeurs pré-remplies, et que vous voulez l'adopter comme nouveau standard du projet. Vous ne tapez rien de nouveau ; vous choisissez parmi des valeurs existantes. Une fois votre choix fait, le flux aboutit à l'étape de confirmation d'Appliquer (décrite ci-dessous).
L'étape de confirmation d'Appliquer
Avant qu'aucun changement ne soit validé, le flux affiche une étape de confirmation avec un aperçu de la portée. L'aperçu détaille exactement ce que la confirmation va faire :
- Combien de champs seront appliqués.
- Combien de Documentations existantes seront réécrites — chaque Documentation déjà présente dans le projet créée avec le même Modèle de documentation adopte désormais la nouvelle valeur pour ces champs.
Vous confirmez ensuite ou annulez. Rien n'est écrit tant que vous n'avez pas confirmé — il n'y a pas d'écrasement silencieux.
Appliquer ou Modifier ?
Appliquer et Modifier sont désormais deux flux séparés aux effets différents :
- Modifier enregistre une nouvelle valeur comme pré-remplissage au niveau projet. Après confirmation, vous obtenez un message de confirmation « Valeur pré-remplie mise à jour » — et c'est tout. Les nouvelles Documentations créées à partir du modèle par la suite démarrent avec la nouvelle valeur, mais les Documentations existantes du projet ne sont pas touchées.
- Appliquer est ce qui réécrit la valeur dans chaque Documentation existante du projet qui utilise le modèle choisi. Un Propriétaire ou Gestionnaire ouvre le flux d'Appliquer, choisit le Modèle de documentation, choisit les champs et les valeurs, et confirme — à ce moment-là, la réécriture à l'échelle du projet a lieu.
Modifier n'enchaîne plus avec Appliquer. Modifier la valeur pré-remplie et l'appliquer aux Documentations existantes sont désormais deux étapes indépendantes. Si vous avez seulement besoin de changer la valeur par défaut pour la suite, Modifier suffit ; pour réécrire également les Documentations existantes, exécutez Appliquer comme étape séparée.
Utilisez-la avec prudence
La propagation à l'échelle du projet rend Appliquer puissant : une seule confirmation réécrit le même champ dans chaque Documentation existante du projet qui utilise ce modèle, et devient la valeur par défaut pour chaque nouvelle. Il n'y a pas de bouton d'annulation. Une fois que vous confirmez, le changement est écrit dans chaque Documentation affectée, et la seule façon de revenir en arrière est de lancer à nouveau Appliquer avec la valeur précédente — ce qui signifie que vous (ou quelqu'un de votre équipe) devez vraiment vous souvenir de quelle était la valeur précédente. Si personne ne s'en souvient, l'état antérieur est perdu.
C'est pourquoi l'étape de confirmation avec aperçu de la portée est le seul moment qui compte. Avant qu'aucune écriture n'ait lieu, l'aperçu vous montre combien de champs sont sur le point d'être appliqués et combien de Documentations existantes seront réécrites avec les nouvelles valeurs. Lisez-le attentivement — c'est le moment d'attraper un mauvais champ ou une faute de frappe, pas après.