Primary Text Manager

Ce que c'est et pourquoi il existe

Le texte de nombreux artefacts doit souvent changer de la même façon : une marque d'état comme « DRAFT: » au début, une note comme « (TBC) » à la fin, la même phrase type partout, ou plus de texte du tout parce qu'il a été déplacé dans des attributs ou de nouveaux artefacts après une importation.

DOORS Next ne le permet qu'artefact par artefact dans l'éditeur de texte enrichi. Primary Text Manager le fait pour un module entier ou une sélection en une seule exécution et ne modifie que le texte principal : les artefacts gardent leurs ID, attributs, liens et leur place dans le module.

Problèmes résolus

• Modifier un par un le texte de centaines d'artefacts pour ajouter la même marque, note ou phrase.
• Texte de modèle ou de remplacement (« TBD », texte copié d'une ancienne spécification) qui reste dans un nouveau module.
• Texte en double après une importation qui a copié le contenu dans des attributs ou d'autres artefacts.
• Aucune trace de ce qu'a fait une modification de texte en masse, ni de moyen simple de revenir en arrière.

Avantages

• Quatre modifications dans un widget : vider le texte, ajouter un préfixe, ajouter un suffixe ou le remplacer par votre propre texte.
• Seul le texte change. Nom, attributs, liens et structure du module restent exactement comme ils étaient.
• Un clic pour tout un module : vous confirmez une fois, chaque artefact qui a besoin de la modification la reçoit, les autres sont ignorés.
• Jamais deux fois : un préfixe ou un suffixe déjà présent n'est pas ajouté à nouveau, et les titres sont protégés par défaut.
• Des modules entiers en une seule exécution, sans la limite de 200 artefacts des sélections, et un rapport Excel avec chaque texte avant et après.

Utilisation

1. Dans Settings, cliquez sur Change, choisissez sous What to do Empty, Add prefix, Add suffix ou Replace text, saisissez le texte et cliquez sur Done.
2. Ouvrez un module. Sous Apply, gardez Whole module et cliquez sur la tuile d'action, par exemple Add prefix. Lisez la confirmation, qui indique ce qui sera écrit, et confirmez avec le bouton rouge.
3. Le widget modifie tout le module en une seule passe. L'exécution affiche sa progression et vous pouvez arrêter à tout moment ; à la fin, le bloc de résultat indique combien d'artefacts ont été traités, modifiés, n'avaient besoin d'aucune modification ou ont échoué, et Log télécharge le rapport de modifications.
4. Pour ne modifier que certains artefacts, sélectionnez-les dans DOORS Next et choisissez Selection : la ligne sous la tuile indique combien seront modifiés et lesquels restent tels quels. Cliquez sur la tuile et confirmez.

Bon à savoir

• Exécutez Primary Text Manager dans un ensemble de modifications, pour pouvoir l'abandonner si le résultat ne convient pas.
• Un préfixe ou un suffixe est ajouté exactement comme saisi, espaces compris, et prend la mise en forme du premier ou du dernier paragraphe. Les artefacts sans texte ne reçoivent ni préfixe ni suffixe.
• Pour ajouter de nouveau un préfixe ou un suffixe déjà présent, ou l'ajouter aussi aux textes vides, cochez Change even if no change is needed dans Settings.
• Les images et autres fichiers ne sont jamais modifiés. Décochez Leave headings as they are dans Settings uniquement si les titres doivent aussi changer.