# Structure Writer

> Transforme la structure d'un module en valeurs d'attributs (le chemin des chapitres, un identifiant de style document et un numéro de tri) pour tous les artefacts à la fois.

Source: https://widgets.doorsnext.com/fr/widgets/structure-writer/

- Discipline: Structure des modules
- Fonctionne dans: Module IBM DOORS Next
- Produits pris en charge: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifie les données
- Keywords: attribut chemin hiérarchique, chemin des chapitres, numéro de section en attribut, identifiant formaté, migration des identifiants DOORS 9, préfixe et suffixe d'identifiant, numéro de séquence, attribut de tri, numérotation automatique, export dans l'ordre du module, IBM DOORS Next
- Version: 1.16 (Publiée le 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Déroulement: 1. Dans Rules, activer les valeurs, choisir les attributs cibles → 2. Ouvrir un module, choisir Whole module ou Selection → 3. Write et confirmer : chemin, ID et numéro → 4. Rapport de modifications dans Excel

## Ce que c'est et pourquoi cela existe
Dans un module DOORS Next, la place d'une exigence (dans quel chapitre elle se trouve, quel numéro elle porte, où elle apparaît dans le document) n'est visible que dans la vue du module. Dès que les artefacts apparaissent dans une vue multi-modules, un export, un filtre, un rapport ou un autre outil, ce contexte disparaît. Les équipes venant de DOORS 9 regrettent aussi leurs identifiants de document habituels comme « SRS-1234 ».

Structure Writer copie la structure dans des attributs, pour qu'elle voyage avec l'artefact. Pour chaque artefact d'un module, il peut écrire le chemin de ses chapitres parents (« 1 Introduction > 1.2 Périmètre »), un identifiant formaté composé d'un préfixe, de l'identifiant de l'artefact et d'un suffixe (« SRS-001234-A ») et un numéro qui croît dans l'ordre du module, pour le tri. Vous choisissez lesquelles des trois valeurs il vous faut et dans quel attribut va chacune.

## Problèmes résolus
- Les exports et les vues multi-modules perdent le chapitre auquel appartient une exigence.
- Hors du module, les exigences ne peuvent pas être triées dans l'ordre du document.
- Les projets migrés ont besoin d'identifiants de style document avec préfixe, mais les saisir à la main est lent et source d'erreurs.
- Les anciens outils de numérotation modifiaient un artefact à la fois et mettaient des minutes pour chaque centaine d'artefacts.
- Après le déplacement ou l'insertion d'un chapitre, les chemins et numéros tenus à la main deviennent faux sans que personne ne le voie.

## Avantages
- **Trois valeurs en une exécution :** chemin hiérarchique, identifiant formaté et numéro de séquence, chacun facultatif et chacun dans son propre attribut.
- **Chemin flexible :** chaque niveau en numéro de section et nom, numéro seul, nom seul, identifiant ou identifiant et nom, avec votre séparateur, avec ou sans l'artefact lui-même.
- **Modules entiers, rapidement :** pas de limite de 200 artefacts ; la structure est lue une fois et les valeurs sont enregistrées par lots.
- **Vérifié d'abord :** pour une sélection, la tuile Write indique combien d'artefacts changent et la confirmation combien de chemins, d'ID et de numéros sont écrits ; les valeurs déjà correctes ne sont jamais réenregistrées.
- **Reste juste :** relancez-le après une restructuration, seules les valeurs modifiées sont mises à jour.
- **Preuve :** un rapport de modifications Excel avec chaque valeur avant et après.

## Comment l'utiliser
1. Dans **Rules**, activez les valeurs nécessaires et choisissez l'attribut cible de chacune : le chemin hiérarchique (format de niveau et séparateur), l'identifiant formaté (préfixe, suffixe, remplissage par des zéros) et le numéro de séquence (début et pas).
2. Si besoin, limitez l'exécution à un type d'artefact, excluez les titres ou ne remplissez que les cibles vides (**Additional settings**).
3. Ouvrez un module, choisissez **Whole module** et cliquez sur **Write** : lisez la confirmation et cliquez sur **Write values**. Les valeurs sont écrites dans tout le module en un seul passage, et seules celles qui changent vraiment sont enregistrées.
4. Ou sélectionnez quelques artefacts du module et choisissez **Selection** : la tuile **Write** indique combien d'entre eux changent ; cliquez sur **Write** et confirmez avec **Write values**. Leurs chemins et numéros proviennent toujours du module entier.
5. Le résultat compte les artefacts écrits, déjà corrects, ignorés et non enregistrés ; **Log** enregistre le rapport de modifications si vous avez besoin d'une trace.

## Bon à savoir
- Travaillez toujours dans un ensemble de modifications : par défaut, les valeurs existantes sont écrasées, car les valeurs suivent la structure. Activez « Only fill empty targets » pour garder les valeurs saisies à la main.
- Les valeurs d'attributs appartiennent à l'artefact, pas à sa place : un artefact utilisé deux fois dans le module reçoit les valeurs de sa première place, et un artefact utilisé aussi dans un autre module reçoit celles du module où le widget a tourné en dernier.
- Les artefacts de premier niveau n'ont pas de chapitre parent : ils ne reçoivent un chemin que si l'artefact lui-même est inclus.
- Le numéro de séquence ne compte que les artefacts écrits, dans leur ordre dans le module.
- Sur de très gros modules, vous pouvez arrêter une exécution, recharger la page et reprendre là où elle s'est arrêtée, avec les mêmes réglages.