Attribute Composer

Ce que c'est et pourquoi cela existe

De nombreux attributs d'un projet d'exigences n'apportent aucune information nouvelle : ils répètent, sous une forme fixe, ce que l'artefact contient déjà. Un libellé court composé de l'identifiant et de la priorité, un titre qui reprend l'en-tête, une clé portant le type d'artefact, une copie du texte de l'exigence en texte brut pour un rapport ou un export. Aujourd'hui, ces champs sont remplis à la main, artefact par artefact, ou restent vides faute de temps.

Attribute Composer les remplit en une seule exécution. Vous construisez une règle une fois (les parties de la valeur et leur ordre), et le widget écrit le résultat dans l'attribut choisi, pour tous les artefacts d'un module ou seulement pour ceux que vous avez sélectionnés, après vous avoir montré exactement ce que chaque artefact recevrait.

Problèmes résolus

• Des attributs censés suivre une convention de nommage (« ID / Priorité / Nom ») et qui divergent dès qu'ils sont saisis à la main.
• Des champs qui restent vides pour des milliers d'artefacts, parce que les remplir un par un n'est pas réaliste.
• Le texte de l'exigence nécessaire en texte brut dans un attribut séparé, pour des exports, des rapports ou des outils externes.
• Des valeurs saisies deux fois : une modification de l'attribut source n'atteint jamais la copie.
• Aucun moyen de voir, avant l'enregistrement, ce qu'une mise à jour en masse écrirait réellement.

Avantages

• Une règle, un module entier : des parties dans l'ordre que vous choisissez : attributs de tout type, le nom, l'identifiant, le type d'artefact, le texte de l'exigence en texte brut et votre propre texte, comme des séparateurs.
• Aperçu avant toute écriture : chaque artefact avec sa valeur actuelle et sa nouvelle valeur, côte à côte.
• Sûr par défaut : seuls les attributs cibles vides sont remplis, sauf si vous demandez l'écrasement ; un résultat vide n'est jamais écrit et une valeur déjà correcte n'est pas réenregistrée.
• Résultats propres : une partie vide emporte son séparateur, vous n'obtiendrez donc jamais « ID / / Nom ».
• Réutilisable : les règles peuvent être enregistrées sous un nom et rechargées quand le même travail se représente.
• Preuve : un rapport de modifications Excel énumère chaque artefact avec la valeur avant et après.

Comment l'utiliser

1. Ouvrez un module dans DOORS Next. Dans Rule, cliquez sur Change et choisissez le Target attribute : un attribut de texte, un attribut numérique lorsque la valeur est un nombre, un attribut d'énumération lorsque la valeur est l'un de ses libellés, un attribut oui/non ou date, ou le nom de l'artefact.
2. Construisez la valeur sous Parts, in order avec Add attribute et Add text : chaque partie est un attribut, le nom, l'identifiant, le type d'artefact, le texte de l'exigence en texte brut ou votre propre texte, par exemple un séparateur. Déplacez les parties avec les flèches ; la ligne sous les parties montre la règle obtenue.
3. Laissez cochées ou décochez Skip empty parts et Only fill empty targets (décochée, les valeurs existantes sont écrasées), choisissez un Artifact type si un seul type doit changer, puis cliquez sur Done.
4. Sous Write, choisissez Whole module ou Selection (les artefacts sélectionnés dans DOORS Next) et cliquez sur Find. La liste montre la nouvelle valeur de chaque artefact qui changerait ; une ligne ouverte montre l'attribut, sa valeur actuelle et la nouvelle, ainsi que Show in module.
5. Cliquez sur Write, lisez la confirmation et cliquez sur Write N values. À la fin, le bloc de résultat indique combien de valeurs ont été écrites, étaient déjà correctes, ont été ignorées ou ont échoué ; Log télécharge le rapport des modifications Excel, et les artefacts en échec peuvent être relancés depuis le même bloc.
6. Pour sauter la recherche sur tout le module, cliquez sur Write sans cliquer d'abord sur Find : après une confirmation, la règle est appliquée à chaque artefact du module en une seule passe, et les chiffres arrivent à la fin.

Bon à savoir

• Travaillez toujours dans un ensemble de modifications : l'abandonner est la seule façon de retrouver les valeurs précédentes.
• Les énumérations sont écrites avec leurs libellés (plusieurs valeurs séparées par des virgules), les utilisateurs avec leur nom, les dates en année, mois et jour (YYYY-MM-DD).
• Le texte de l'exigence est écrit en texte brut : paragraphes, éléments de liste et lignes de tableau deviennent des lignes, la mise en forme est supprimée.
• Les règles enregistrées sont personnelles : elles restent dans votre navigateur et ne sont ni partagées avec vos collègues ni stockées sur le serveur.
• Une valeur très longue n'est pas écrite ; la limite se modifie dans les paramètres du widget.
• Sur de très grands modules, vous pouvez arrêter une exécution, recharger la page et reprendre là où elle s'est arrêtée, avec la même règle.