# Attribute Composer

> Compila un attributo con un valore che costruisci a partire dai dati dell'artefatto stesso, per un intero modulo, mostrando ogni nuovo valore prima di salvare qualsiasi cosa.

Source: https://widgets.doorsnext.com/it/widgets/attribute-composer/

- Disciplina: Qualità dei contenuti
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: compilare attributo automaticamente, combinare attributi, concatenare valori di attributi, copiare il testo del requisito in un attributo, aggiornamento massivo degli attributi, convenzione di denominazione, etichetta dagli attributi
- Versione: 1.15 (Rilasciata 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Scegliere l'attributo di destinazione e le parti → 2. Trova gli artefatti e compone i nuovi valori → 3. Controllare valori attuali e nuovi (Se serve: Modificare la regola e cercare di nuovo) → 4. Scrivere i valori dopo la conferma → 5. Report delle modifiche in Excel

## Che cos'è e perché esiste
Molti attributi di un progetto di requisiti non contengono informazioni nuove: ripetono, in una forma fissa, ciò che l'artefatto già possiede. Un'etichetta breve formata da identificatore e priorità, un titolo che ripete l'intestazione, una chiave che porta il tipo di artefatto, una copia del testo del requisito in testo semplice per un report o un'esportazione. Oggi questi campi si compilano a mano, artefatto per artefatto, oppure restano vuoti perché nessuno ha il tempo di farlo.

Attribute Composer li compila in un'unica esecuzione. Costruisci una regola una sola volta (le parti del valore e il loro ordine) e il widget scrive il risultato nell'attributo scelto, per tutti gli artefatti di un modulo o solo per quelli selezionati, dopo averti mostrato esattamente che cosa riceverebbe ogni artefatto.

## Problemi che risolve
- Attributi che devono seguire una convenzione di denominazione («ID / Priorità / Nome») e che divergono quando vengono digitati a mano.
- Campi che restano vuoti per migliaia di artefatti perché compilarli uno a uno non è realistico.
- Il testo del requisito richiesto come testo semplice in un attributo separato, per esportazioni, report o strumenti esterni.
- Valori digitati due volte: una modifica nell'attributo di origine non raggiunge mai la copia.
- Nessun modo di vedere, prima di salvare, che cosa scriverebbe davvero un aggiornamento massivo.

## Vantaggi
- **Una regola, un intero modulo:** parti nell'ordine che scegli: attributi di qualsiasi tipo, il nome, l'identificatore, il tipo di artefatto, il testo del requisito come testo semplice e il tuo testo, ad esempio i separatori.
- **Anteprima prima di scrivere qualsiasi cosa:** ogni artefatto con il valore attuale e quello nuovo, uno accanto all'altro.
- **Sicuro per impostazione predefinita:** vengono compilati solo gli attributi di destinazione vuoti, a meno che non richieda la sovrascrittura; un risultato vuoto non viene mai scritto e un valore già corretto non viene salvato di nuovo.
- **Risultati puliti:** una parte vuota porta con sé il proprio separatore, quindi non otterrai mai «ID /  / Nome».
- **Riutilizzabile:** le regole possono essere salvate con un nome e ricaricate quando lo stesso lavoro si ripresenta.
- **Prova documentale:** un report delle modifiche in Excel elenca ogni artefatto con il valore prima e dopo.

## Come si usa
1. Apri un modulo in DOORS Next. In **Rule**, fai clic su **Change** e scegli il **Target attribute**: un attributo di testo, un attributo numerico quando il valore è un numero, un attributo di enumerazione quando il valore è una delle sue etichette, un attributo sì/no o data, oppure il nome dell'artefatto.
2. Costruisci il valore in **Parts, in order** con **Add attribute** e **Add text**: ogni parte è un attributo, il nome, l'identificatore, il tipo di artefatto, il testo del requisito come testo semplice o il tuo testo, ad esempio un separatore. Sposta le parti con le frecce; la riga sotto le parti mostra la regola risultante.
3. Lascia attive o disattiva **Skip empty parts** e **Only fill empty targets** (disattivata, i valori esistenti vengono sovrascritti), scegli un **Artifact type** se deve cambiare un solo tipo e fai clic su **Done**.
4. In **Write**, scegli **Whole module** o **Selection** (gli artefatti selezionati in DOORS Next) e fai clic su **Find**. L'elenco mostra il nuovo valore di ogni artefatto che cambierebbe; aprendo una riga vedi l'attributo, il valore attuale e quello nuovo, e **Show in module**.
5. Fai clic su **Write**, leggi la conferma e fai clic su **Write N values**. Al termine, il blocco dei risultati mostra quanti valori sono stati scritti, erano già corretti, sono stati saltati o non sono riusciti; **Log** scarica il report delle modifiche in Excel e gli artefatti non riusciti si possono ritentare dallo stesso blocco.
6. Per saltare la ricerca sull'intero modulo, fai clic su **Write** senza fare prima clic su **Find**: dopo una conferma la regola viene applicata a ogni artefatto del modulo in un solo passaggio e i numeri arrivano alla fine.

## Buono a sapersi
- Lavora sempre in un change set: scartarlo è l'unico modo per recuperare i valori precedenti.
- Le enumerazioni vengono scritte con le loro etichette (più valori separati da virgole), gli utenti con il loro nome, le date come anno, mese e giorno (YYYY-MM-DD).
- Il testo del requisito viene scritto come testo semplice: paragrafi, voci di elenco e righe di tabella diventano righe e la formattazione viene eliminata.
- Le regole salvate sono personali: restano nel tuo browser e non vengono condivise con i colleghi né memorizzate sul server.
- Un valore molto lungo non viene scritto; il limite si può modificare nelle impostazioni del widget.
- Su moduli molto grandi puoi interrompere un'esecuzione, ricaricare la pagina e riprendere da dove si era fermata, con la stessa regola.