Find and Replace

Ce que c'est et pourquoi il existe

Un nom de produit change, un terme est renommé, un espace réservé comme « TBD » reçoit enfin sa valeur, ou une ancienne unité doit disparaître. Dans une spécification de centaines d'exigences, le même texte doit changer dans de nombreux artefacts à la fois.

DOORS Next ne permet de modifier qu'un artefact à la fois. Find and Replace parcourt un module entier ou une sélection, montre chaque endroit où se trouve le texte et ce qu'il deviendra, et le remplace partout après une seule confirmation. Seul le texte visible change : mise en forme, liens, images et tableaux restent tels quels.

Problèmes résolus

• Ouvrir des centaines d'artefacts un par un pour changer le même mot ou la même expression.
• Des endroits oubliés : un ancien terme qui reste dans quelques exigences que personne n'a trouvées.
• Des modifications en masse qui cassent la mise en forme ou les liens parce que le texte stocké a été modifié à l'aveugle.
• Aucune trace de ce qu'une modification en masse a fait, et aucun retour arrière simple.

Avantages

• Voir avant de changer : chaque artefact contenant le texte et, pour chaque endroit, l'ancien texte barré et le nouveau après.
• Correspondances exactes : Match case et Whole words only, pour que « pump » ne change ni « pumps » ni « Pump » si vous ne le voulez pas.
• La mise en forme reste : gras, listes, liens et images sont conservés ; seul le texte recherché change.
• Les noms aussi : si vous le souhaitez, recherche aussi dans les noms des artefacts en plus du texte principal.
• Des modules entiers en une exécution, sans la limite de 200 artefacts des sélections, et un rapport de modifications Excel avec chaque texte avant et après.

Utilisation

1. Dans Settings (cliquez sur Change s'il est replié), saisissez le texte dans Find what et le nouveau texte dans Replace with (laissez-le vide pour supprimer le texte). Choisissez Match case, Whole words only et où chercher : Primary text, Name ou les deux. Done replie Settings sur une ligne.
2. Ouvrez un module, choisissez Whole module sous Replace et cliquez sur Find. Le résultat indique combien d'artefacts contiennent le texte et combien de fois ; ouvrez une ligne pour voir chaque endroit avec l'ancien texte barré et le nouveau texte à la suite.
3. Cliquez sur Replace, lisez la confirmation et cliquez sur Replace in N artifacts. Une carte de progression montre l'exécution, et vous pouvez cliquer sur Stop à tout moment. Cliquez sur Log dans le résultat pour télécharger le rapport de modifications.
4. Pour ne modifier que certains artefacts, sélectionnez-les dans DOORS Next et choisissez Selection · N : le widget les parcourt aussitôt. Cliquez sur Replace et confirmez.

Bon à savoir

• Lancez Find and Replace dans un change set, pour pouvoir l'abandonner si le résultat ne convient pas.
• Le texte est recherché exactement tel que saisi, espaces compris ; il n'y a pas de caractères génériques. Une espace trouve aussi une espace insécable.
• Un texte coupé par la mise en forme (une partie d'un mot en gras) n'est pas remplacé ; la recherche compte ces endroits pour que vous les corrigiez à la main.
• Les images et autres fichiers gardent leur contenu ; seul leur nom change si Name est choisi.
• Sur tout le module, Replace fonctionne aussi sans recherche préalable : chaque artefact est lu et le texte est remplacé là où il se trouve ; les chiffres sont connus à la fin.
• Sur les très grands modules, le navigateur peut ralentir. Arrêtez l'exécution avec Stop, rechargez la page et rouvrez le module : Continue from … reprend là où elle s'est arrêtée, avec les mêmes paramètres.