# Module Fill

> Crea l'intera struttura di un modulo vuoto a partire da un semplice elenco di ID di artefatti e livelli, in un solo passaggio.

Source: https://widgets.doorsnext.com/it/widgets/module-fill/

- Area: Struttura dei moduli
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: popolare un modulo, costruire la struttura del modulo, elenco di ID degli artefatti, migrazione, modulo da CSV, inserire artefatti, gerarchia del modulo
- Versione: 2.17 (Rilasciata 2026-10-06)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)

## Che cos'è e perché esiste
Dopo una migrazione da un altro strumento, una riorganizzazione di progetto o quando un documento deve essere composto da requisiti esistenti, gli artefatti esistono già in DOORS Next, ma il modulo che dovrebbe contenerli è vuoto. Inserire a mano centinaia di artefatti in un modulo, nell'ordine giusto e al livello giusto, è lento e soggetto a errori.

Module Fill è stato creato proprio per questo passaggio. Fornite la struttura come un semplice elenco di coppie, ad esempio `[231,1][3513,1.1][67452,1.1.1]`, che può essere preparato in Excel o esportato dallo strumento di origine, e il widget costruisce il modulo.

## Problemi che risolve
- Moduli vuoti da riempire con centinaia di artefatti esistenti in un ordine e una gerarchia precisi.
- Migrazioni in cui la struttura del documento è nota nello strumento di origine ma deve essere ricostruita in DOORS Next.
- Trascinamento manuale con un alto rischio di ordine o livelli errati.
- Moduli costruiti solo in parte dopo un lavoro manuale interrotto.

## Vantaggi
- **Minuti invece di giorni** per strutture documentali di grandi dimensioni.
- **Verificato prima dell'esecuzione:** l'elenco viene convalidato mentre scrivete, ogni ID viene cercato e il modulo pianificato viene mostrato in una tabella.
- **Tutto o niente:** la struttura viene creata con un'unica modifica, quindi il modulo non resta mai riempito a metà.
- **Ripetibile:** lo stesso elenco può essere riutilizzato, ad esempio prima in un progetto di test.
- **Intestazioni riconosciute automaticamente** in base al tipo di artefatto.

## Come si usa
1. Aprite un modulo **vuoto**.
2. Incollate l'elenco delle coppie `[ID,level]` nell'ordine del modulo. I livelli si scrivono come 1, 1.1, 1.1.1 e così via. Errori e avvisi compaiono mentre scrivete.
3. Fate clic su **Find artifacts (N)**. Il widget trova ogni artefatto ed elenca gli eventuali ID che non esistono nella configurazione corrente.
4. Controllate la struttura pianificata nella tabella.
5. Fate clic su **Fill module (N)** e confermate. Al termine, ricaricate il modulo per vedere il risultato.

## Da sapere
- Module Fill funziona solo su moduli vuoti, quindi non mescola mai una nuova struttura con contenuti esistenti.
- Gli artefatti devono già esistere nel progetto e nella configurazione in cui lavorate.
- Quali tipi di artefatto vengono aggiunti come intestazioni è definito da un'impostazione (per impostazione predefinita *Heading*).
