Importa i requisiti
Puoi caricare rapidamente e facilmente i dati dei requisiti esistenti in Requirements & Systems Portal utilizzando il Import Wizard disponibile nel Requirements Module. Sfruttando l’estrazione basata sull’AI, puoi importare requisiti da file PDF, Word, Excel e CSV non strutturati, riducendo il tempo e l’impegno necessari per trasferire manualmente i dati dei requisiti e aiutandoti a acquisirli in modo più accurato ed efficiente.
Accesso all’Importer
È possibile accedere all’Importer dal Requirements Module (
) facendo clic sul pulsante 
in alto a sinistra della pagina e selezionando Create Requirement dal menu visualizzato. In alternativa, quando la specifica attualmente visualizzata non contiene requisiti, è possibile accedere all’importer facendo clic sul pulsante Import nella pagina.
Caricamento di un file
Si aprirà la finestra Import Requirements. In questa fase, puoi caricare un file di un tipo supportato (*.pdf, *.docx, *.xlsx o *.csv). Per farlo, trascina il file nell’area corrispondente della finestra oppure fai clic sul controllo select from your computer per sfogliare e selezionare il file dal disco rigido.
I file nei formati *.pdf e *.docx possono essere importati solo tramite l’importer AI, che è abilitato per impostazione predefinita. Se necessario, può essere disabilitato da un amministratore del Workspace utilizzando l’opzione External Provider nella pagina Settings – ValiAssistant (accessibile facendo clic sull’icona 
in basso a sinistra, selezionando Settings dal menu visualizzato e quindi selezionando ValiAssistant dall’elenco nel riquadro a sinistra) – 
.
Quando l’opzione External Provider è disabilitata, solo i file nei formati *.xlsx e *.csv possono essere importati utilizzando l’importer classico. In questo caso, nella parte superiore della finestra Import Requirements verrà mostrato un messaggio corrispondente (
).
Una volta che il file è stato caricato correttamente, la sua voce verrà mostrata nella finestra. Puoi rimuoverla dalla finestra facendo clic sull’icona 
.
Per un file *.xlsx o *.csv caricato, puoi scegliere di continuare utilizzando l’importer classico abilitando l’opzione Classic Import (Non-AI) in basso a sinistra della finestra.
Revisione dei dati estratti
Una volta caricato il file richiesto, fai clic sul pulsante 
per procedere. I dati estratti verranno presentati come una tabella di requisiti suggeriti da esaminare.
Per impostazione predefinita, i requisiti suggeriti verranno importati nella specifica visualizzata quando è stato aperto l’Importer. Puoi selezionare la specifica desiderata dal menu a discesa nella parte superiore della finestra oppure creare una nuova specifica selezionando la voce + Add specification dal menu a discesa e definendo il nome della nuova specifica mediante il campo nome specifica visualizzato (
).
Abilita l’opzione Update requirements per sovrascrivere eventuali requisiti esistenti nella specifica di destinazione mediante sostituzione dei dati (i dati del file sostituiscono i dati nella specifica).
Abilita l’opzione Parametrize values per controllare i requisiti suggeriti alla ricerca di possibili parametri quantificabili e convertirli in Valis.
Quando si utilizza l’importer classico, sono disponibili anche le seguenti opzioni:
-
Starting row – puoi selezionare da quale riga del file importato i dati devono iniziare a essere raccolti per essere inseriti in Requirements & Systems Portal.
-
Sheet – nel caso di un file con più fogli, puoi selezionare il foglio da cui importare.
Puoi selezionare i requisiti che desideri importare abilitando le caselle di controllo a sinistra delle righe corrispondenti.
Mappatura dei dati
Puoi definire in che modo i dati del file caricato corrisponderanno a campi specifici in Requirements & Systems Portal. Se il file contiene intestazioni identiche ai campi predefiniti di Requirements & Systems Portal, questi campi verranno mappati automaticamente. Tuttavia, se necessario, puoi sovrascrivere o regolare questa mappatura automatica. Fai clic sull’intestazione di una colonna e seleziona il campo desiderato dal menu a discesa.
In alternativa, puoi mappare i dati della colonna in una nuova colonna personalizzata digitandone il nome richiesto nel campo Search/Add custom nel menu a discesa e quindi selezionando <custom_column_name> (Create new) dal menu a discesa.
Puoi anche selezionare None dal menu a discesa per non mappare i dati del file in alcuna colonna (ovvero, questi dati non verranno importati).
Devono essere selezionate almeno le colonne Identifier e Text. In caso contrario, verrà visualizzato un messaggio di avviso finché questa condizione non sarà soddisfatta (
).
I seguenti campi possono essere importati nei requisiti utilizzando l’Importer:
-
Identifier
-
Text
-
Title
-
Rationale
-
Children
-
Parents
-
Section
-
Percorso alla sezione
-
Applicable Block
-
Compliance Comment
-
Type
-
State
-
Compliance
-
V&V Status
-
V&V Methods
-
Applicability
-
Owner
-
Tags
-
Colonne personalizzate
Report di esecuzione
Una volta rivisti i dati da importare e configurate le opzioni come richiesto, fai clic sul pulsante 
per procedere. Al termine dell’importazione verrà visualizzata una finestra di conferma.
Se l’importer rileva problemi nei requisiti importati, ciò verrà indicato nella finestra (
). Fai clic sul link per scaricare un report che descrive in dettaglio le cause dei problemi rilevati. I casi possibili sono:
-
Un tentativo di importare un requisito con relazioni verso identificatori che non esistono nel progetto né tra gli altri requisiti del file importato.
-
Un tentativo di importare un requisito con relazioni verso un identificatore di requisito che appartiene a più di un requisito, sia nel progetto sia tra gli altri requisiti del file importato.
-
Un tentativo di importare un requisito con una dichiarazione di compliance che non è attualmente definita in Requirements & Systems Portal.
-
Un tentativo di importare un requisito con un type che non è attualmente definito in Requirements & Systems Portal.
-
Un tentativo di importare un requisito con uno state che non è attualmente definito in Requirements & Systems Portal.
-
Un tentativo di importare un requisito con un tag che non è attualmente definito in Requirements & Systems Portal.
-
Un tentativo di importare un requisito con una condizione di applicability che non è attualmente definita in Requirements & Systems Portal.
-
Un tentativo di importare un requisito con un method che non è attualmente definito in Requirements & Systems Portal.
-
Un tentativo di importare un requisito con un applicable block che non è attualmente definito in Requirements & Systems Portal.
-
Un tentativo di importare un owner che non è attualmente definito in Requirements & Systems Portal.
-
Un tentativo di importare più di un owner, state o type che non è attualmente definito in Requirements & Systems Portal.
Fai clic sul pulsante 
per tornare alla fase di caricamento file dell’importer oppure fai clic su 
per uscire dall’importer.
Versione precedente dell’Importer
Quando non hai accesso alla versione più recente dell’Importer descritta sopra, viene utilizzata la sua versione precedente. Fai riferimento alla sezione comprimibile qui sotto per saperne di più.
Previous Iteration of the Importer
Importer AI assistito per i requisiti (versione precedente)
La requirements engineering spesso inizia con la redazione dei requisiti degli stakeholder in documenti come PDF e fogli di calcolo Excel, in cui i dati non sono ben strutturati. L’estrazione manuale dei dati dei requisiti da questi documenti non strutturati può richiedere molto lavoro ed essere soggetta a errori e, per accelerare il processo di acquisizione dei requisiti in Requirements & Systems Portal, puoi sfruttare le funzionalità AI per importare requisiti da file PDF, Excel, Word e CSV non strutturati.
Accesso all’Importer (versione precedente)
L’AI Assisted Importer è abilitato per impostazione predefinita. Se necessario, può essere disabilitato da un amministratore del Workspace utilizzando l’opzione External Provider nella pagina Settings – ValiAssistant (accessibile facendo clic sull’icona in basso a sinistra, selezionando Settings dal menu visualizzato e quindi selezionando ValiAssistant dall’elenco nel riquadro a sinistra) – .
Quando l’opzione External Provider è disabilitata, è possibile accedere e utilizzare solo il legacy importer. Per saperne di più sul legacy importer, fai riferimento alla sezione Legacy Importer qui sotto.
È possibile accedere all’AI Assisted Importer dal Requirements Module () facendo clic sul pulsante in alto a sinistra della pagina e selezionando Create Requirement dal menu visualizzato. In alternativa, quando la specifica attualmente visualizzata non contiene requisiti, è possibile accedere all’importer facendo clic sul pulsante Import nella pagina.
Flusso di importazione (versione precedente)
Una volta aperto l’importer, viene presentata la finestra Document Import. Per continuare con l’AI Assisted Importer, fai clic sul pulsante .
Nella fase successiva, puoi caricare un file di un tipo supportato (*.pdf, *.docx, *.xlsx o *.csv). Per farlo, trascina il file nell’area corrispondente della finestra oppure fai clic sul controllo select from your computer per sfogliare e selezionare il file dal disco rigido.
Una volta che il file è stato caricato correttamente, la sua voce verrà mostrata nella finestra. Puoi rimuoverla dalla finestra facendo clic sull’icona . In alternativa, trascina un altro file nella finestra per sostituire il file esistente.
Fai clic sul pulsante per procedere. L’importer elaborerà il file caricato. Una volta terminato il processo, i dati estratti verranno presentati come una tabella di requisiti suggeriti. Puoi selezionare i requisiti che desideri importare abilitando le caselle di controllo a sinistra delle righe corrispondenti.
Fai clic sul pulsante per procedere. Una volta terminata l’importazione, verrà visualizzata una finestra di conferma.
Se l’importer rileva problemi nei requisiti importati, ciò verrà indicato nella finestra (
). Fai clic sul link per scaricare un report che descrive in dettaglio le cause dei problemi rilevati.
Fai clic sul pulsante per tornare alla fase di caricamento file dell’importer oppure fai clic su per uscire dall’importer.
Legacy Importer (versione precedente)
Quando accedi all’Importer (scopri di più), puoi scegliere di continuare con lo strumento di importazione legacy per caricare dati di requisiti strutturati. Inoltre, il legacy importer è disponibile solo quando l’opzione External Provider è disabilitata nelle impostazioni di Requirements & Systems Portal da parte di un amministratore.
Il processo ti guida attraverso tre fasi principali: Specification, Upload e Review. Al completamento dell’importazione di una specifica, viene presentato un riepilogo insieme alla possibilità di eseguire azioni aggiuntive come la Valificazione o l’importazione di altri file. Queste fasi e azioni sono descritte nelle sezioni seguenti.
Specification (versione precedente)
In questa fase del Import Wizard, puoi definire la specifica di importazione di destinazione:
-
Usa l’area Select a specification sul lato sinistro della finestra Import Requirements per selezionare una specifica esistente e, facoltativamente, la relativa sezione.
-
Usa l’area Create a specification sul lato destro della finestra Import Requirements per creare una nuova specifica (e anche definire l’abbreviazione e il blocco a cui allocarla) senza uscire dall’import wizard.
Fai clic sull’area desiderata per utilizzare il metodo preferito.
Upload (versione precedente)
In questa fase del Import Wizard, puoi caricare un file di un tipo supportato. Per farlo, trascina il file sul lato destro della finestra Import Requirements oppure fai clic sul controllo Drop file per sfogliare e selezionare il file dal disco rigido. Una volta che il file è stato caricato correttamente, nella finestra verrà mostrata una notifica.
Review (versione precedente)
In questa fase del Import Wizard, puoi rivedere i risultati dell’importazione dei dati dal file caricato, configurare le opzioni del file e mappare i dati del file ai campi del requisito.
L’area Destination della finestra Import Requirements fornisce un’indicazione visiva di dove verranno importati i dati (in termini di specifica o sezione).
L’area File options offre le seguenti opzioni:
-
Update requirements – quando abilitata, eventuali requisiti esistenti nella specifica di destinazione verranno sovrascritti mediante sostituzione dei dati (i dati del file sostituiscono i dati nella specifica).
-
Use header row – puoi decidere se usare la riga di intestazione del file caricato oppure una riga di intestazione di riferimento generale fornita da Requirements & Systems Portal (cioè intestazioni di colonna come A, B, C, ecc.).
-
Sheet – nel caso di un file con più fogli, puoi selezionare da quale foglio importare.
-
Starting row – puoi selezionare da quale riga del file importato i dati devono iniziare a essere raccolti per essere inseriti in Requirements & Systems Portal.
Nella tabella in fondo alla finestra Import Requirements, puoi visualizzare un'anteprima del file caricato e mappare le sue colonne ai campi di Requirements & Systems Portal. Ciò ti consente di definire in che modo i dati del file corrisponderanno a campi specifici in Requirements & Systems Portal selezionando il campo appropriato nel menu a discesa Map To per ciascuna colonna. Se il file contiene intestazioni identiche ai campi predefiniti in Requirements & Systems Portal, questi campi verranno mappati automaticamente. Tuttavia, se necessario, puoi ignorare o modificare questa mappatura automatica.
-
Deve essere selezionata almeno la colonna Identifier. In caso contrario, verrà visualizzato un messaggio di avviso finché tale condizione non sarà soddisfatta (
).
-
I seguenti campi sono sensibili alle maiuscole/minuscole:
-
Type
-
State
-
Compliance
-
Tags
Ad esempio, se il tag
TBDesiste già in Requirements & Systems Portal e viene importato il tagtbd, verrà creato un nuovo tagtbde importato con il requisito. -
Report di esecuzione (iterazione precedente)
Una volta terminato il processo di importazione, se l'importazione è completata correttamente, vengono visualizzati un messaggio di successo e le modifiche apportate. Se l'importazione fallisce, verrà visualizzato un messaggio di errore. Un esempio di importazione riuscita è mostrato di seguito.
Se sono presenti soft error, verranno anch'essi visualizzati (
). I possibili soft error sono:
-
La relazione non può essere stabilita → l'Identifier del Parent o dei Children non esiste nel progetto
-
La relazione non può essere stabilita → l'Identifier del Parent o dei Children è duplicato nel progetto
-
La dichiarazione di compliance del requisito non esiste nel progetto
-
Il tipo di requisito non esiste nel progetto
-
Lo stato del requisito non esiste nel progetto
-
Il tag non esiste nel progetto
-
La condizione di applicabilità non esiste
Indipendentemente dal fatto che l'importazione abbia successo o meno, puoi reimportare oppure eseguire una nuova importazione facendo clic su Import new file (successo) o Try again (errore), tornando così alla fase 1 (Specification).
Localizzato tramite A