Holarch

Requisiti

Documenti

Scrivere, strutturare, numerare, mettere in baseline e pubblicare specifiche come viste aggiornate del modello, con modelli, testo formattato, report e output Word.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Cosa rende qualcosa un documento
    2. Tipi di documento
    3. Numeri
    4. Baseline
  3. Come usarlo
    1. Quando e perché
    2. Creare una specifica dei requisiti da un modello
    3. Scrivere i requisiti
    4. Aggiungere molti requisiti rapidamente
    5. Ristrutturare
    6. Rivedere, mettere in baseline e pubblicare
    7. Esempio pratico: la demo CubeSat EO-1
    8. Suggerimenti e buone pratiche
    9. Errori comuni
    10. Come si collega alle altre funzionalità
  4. L'elenco dei documenti
  5. La pagina del documento
    1. Intestazione della pagina
    2. Barra degli strumenti
    3. Riquadro della struttura
    4. Il corpo del documento
    5. Menu del clic destro
    6. Aggiunta rapida
    7. Ispettore
  6. Aggiungere elementi
    1. Nuovi elementi
    2. Altre classi
    3. Documenti strutturati con Heading
    4. Entità esistenti
  7. Ristrutturare
    1. Aumentare e ridurre il rientro e spostare
    2. Trascinare e rilasciare
    3. Sposta sotto
  8. Numerazione
    1. Rinumerazione automatica
    2. Regole per il numero successivo
    3. Rinumerare
    4. Numerazione del documento (numeri meta)
  9. Modelli
    1. Modelli predefiniti
    2. Salvare un documento come modello
    3. Gestire i modelli
    4. Modelli salvati in questo browser
    5. Applicare un modello a un documento esistente
  10. Editor di testo formattato
    1. Barra degli strumenti
    2. Tabelle
    3. Immagini e file
    4. Testo alternativo
    5. Link e link incorporati
    6. Contenuto dinamico
    7. Strumenti di testo IA
    8. Incollare
    9. Scorciatoie del testo formattato
  11. Trovare nel documento
  12. Trovare e sostituire
  13. Menu Scrivi
    1. Impostare un attributo su questo ramo
    2. Dividere in più elementi
  14. Menu Controlla
    1. Stato di tracciabilità
    2. Trovare gli acronimi
  15. Menu Consegna
    1. Modelli Word
    2. File Word aziendali
  16. Menu Vista
  17. Baseline
    1. Creare una baseline
    2. Visualizzare una baseline
    3. Confrontare le versioni
  18. Report
  19. Output Word
    1. Didascalie, elenchi e riferimenti incrociati
    2. Impostazione del deliverable
    3. Formato della pagina
    4. Conversione del testo formattato
    5. Redline
    6. Stampa / PDF
  20. Commenti
  21. Raccolte
    1. Sezioni generate
    2. Raccolta in Word
  22. Strumenti IA
  23. Scorciatoie da tastiera
  24. Impostazioni memorizzate in questo browser
  25. Messaggi
  26. Limiti
  27. Correlati

Panoramica

Un documento è una specifica, un piano o una procedura le cui sezioni e i cui requisiti sono entità del modello. Usare la pagina del documento per scriverli e ristrutturarli, numerarli, metterli in baseline e pubblicarli in Word, Excel, ReqIF, Markdown e altri formati.

Ogni elemento di un documento è un'entità. Così lo stesso requisito compare anche nel Database, nei diagrammi, nella Matrice di tracciabilità e nel controllo di qualità. Una modifica in uno qualsiasi di questi punti compare nel documento.

Concetti

Cosa rende qualcosa un documento

  • Un documento è un'entità Artifact che soddisfa una di due condizioni:
    • Ha un'etichetta di tipo documento: qualsiasi etichetta il cui nome termina con “Document”.
    • È source of di almeno uno Statement o Heading.
  • I suoi elementi di primo livello sono le entità di cui il documento è source of. Gli elementi più profondi dipendono da essi tramite relazioni decomposed by. La struttura visualizzata è questo albero di scomposizione.
  • Gli elementi sono di solito Statement (sezioni, titoli, note, ipotesi) e Requirement (e loro sottoclassi). Qualsiasi altra classe si aggiunge con Altra classe….
  • Gli Heading (documenti strutturati di LML 2.0) sono sezioni che contengono elementi di qualsiasi classe. Una sottosezione è un Heading sotto un Heading (decomposed by). Qualsiasi altro elemento sotto un Heading è il contenuto della sezione: l'Heading lo contains, l'elemento mantiene il proprio numero ed è elencato prima delle sottosezioni. Vedere Documenti strutturati con Heading.
  • Rimuovere un elemento da un documento non elimina l'entità. Eliminarlo dal Database sì.

Tipi di documento

Il tipo è l'etichetta di tipo documento del documento. Decide quali modelli vengono proposti per primi e se il documento si apre in modalità carta.

TipoModelli predefiniti
Requirements DocumentRequirements Specification; Stakeholder Requirements Specification (StRS); System Requirements Specification (SyRS); Software Requirements Specification (SRS); Interface Requirements Specification (IRS)
Interface Control DocumentInterface Control Document (ICD)
Concept of Operations DocumentConcept of Operations
Needs Analysis DocumentNeeds Analysis
Concept Exploration DocumentConcept Exploration; Trade Study Report
Concept Definition DocumentConcept Definition; Architecture Description
Systems Engineering Management Plan DocumentSystems Engineering Management Plan
Test Plan DocumentTest Plan; Verification and Validation Plan; Test Procedure; Test Report
Independent Verification & Validation Plan DocumentIV&V Plan
Project Management Plan DocumentProject Management Plan; Risk Management Plan; Configuration Management Plan
Integrated Logistics Support Plan DocumentIntegrated Logistics Support Plan
Standard Operating Procedure DocumentStandard Operating Procedure

I modelli degli altri tipi sono elencati in Altri modelli, così qualsiasi modello può avviare qualsiasi documento.

Per aggiungere un tipo di documento, aggiungere alla classe Artifact un'etichetta il cui nome termina con “Document” (vedere Estensioni dello schema). Un documento con l'etichetta Pacchetto di revisione riunisce altri documenti; vedere Raccolte.

Numeri

Ogni elemento ha un numero, come 3.2, mostrato prima del nome. I numeri sono memorizzati nell'entità, quindi lo stesso requisito mostra lo stesso numero ovunque. L'eccezione è la numerazione del documento, che mantiene numeri separati per ogni documento.

Holarch mantiene i numeri in ordine finché Rinumera automaticamente dopo l'aggiunta o lo spostamento di elementi è attivo (impostazione predefinita; la casella si trova in Scrivi ▾ → Rinumera…).

Baseline

Una baseline è un'istantanea di sola lettura del documento. Contiene:

  • Gli elementi del documento, i loro attributi e le loro relazioni, inclusi i collegamenti a entità a un passo fuori dal documento.
  • Le impostazioni del documento.
  • Record di approvazione datati, che non possono essere modificati in seguito.

Le baseline alimentano i report delle modifiche e le tabelle Revision History e Approvals dell'output Word.

Nel servizio ospitato:

  • Ogni record di approvazione riceve l'ora del server e l'account che lo ha salvato, non l'orologio del browser. Il record mostra “(ora del server) · registrato da {name}” e il salvataggio viene scritto nel registro di audit.
  • Solo i proprietari del progetto possono rinominare o eliminare una baseline. Per gli altri, Elimina e il campo del nome sono in grigio con “Solo un proprietario del progetto può rinominare o eliminare una baseline.” Ripristino e reversione funzionano come prima.

Nell'app desktop, i record riportano la data in cui il computer li ha salvati.

Come usarlo

Quando e perché

Usare un documento quando il deliverable è una specifica che qualcuno leggerà, rivedrà e firmerà. Esempi:

  • Una specifica dei requisiti di sistema per la SRR.
  • Un concetto operativo all'inizio dello sviluppo del concetto.
  • Un piano di test prima dell'inizio della verifica.
  • Una procedura per le operazioni.

Scrivere qui i requisiti, poi tracciarli verso funzioni, asset e test altrove nel modello. Il documento risponde a “Cosa dice questa specifica, in quale ordine, e cosa è cambiato da quando è stata approvata?”

Nel flusso dell'ingegneria dei sistemi, i documenti vengono per primi: esigenze degli stakeholder e requisiti di sistema. Alimentano l'analisi funzionale e l'allocazione. Alle revisioni tornano come output approvati e in baseline, con report di tracciabilità.

Creare una specifica dei requisiti da un modello

  1. Nella barra di navigazione, aprire Esigenze e requisiti → Documenti.
  2. Fare clic su + Nuovo documento nell'intestazione della pagina.

    Si apre Nuovo documento.

  3. Inserire il Nome (obbligatorio). Numero e descrizione si possono aggiungere in seguito nell'ispettore.
  4. In Modello, Modelli per mostra i modelli di un tipo di documento, per esempio Requirements Document. Ogni scheda mostra in anteprima le prime sezioni. Sceglierne uno tra:
    • Vuoto: un documento vuoto del tipo mostrato.
    • Una voce di Modelli dell'organizzazione (server Holarch, ospitati o self-hosted), pubblicata dagli amministratori della propria organizzazione. Il modello predefinito dell'organizzazione per il tipo è preselezionato.
    • Una voce di Modelli di progetto, salvata in questo progetto.
    • Una voce di Modelli predefiniti.
    • Un modello di un altro tipo di documento, in Altri modelli.

      Il documento assume il tipo del modello scelto.

  5. Selezionare Includi indicazioni di scrittura per aggiungere una breve guida alla scrittura a ogni sezione di un modello predefinito.
  6. Fare clic su Crea.

    Il documento si apre con le sezioni numerate del modello, per esempio 1 Document Control, 1.1 Revision History, 1.2 Approvals, 2 Introduction … Se sono state incluse le indicazioni di scrittura, eliminarle man mano che si scrive ogni sezione.

Scrivere i requisiti

  1. Fare clic sulla riga di una sezione per selezionarla.
  2. Fare clic su + Figlio, oppure premere ⌥⌘↵ / Ctrl+Alt↵.

    Compare una nuova riga chiamata “Nuovo requisito” con il suo numero, e il nome è pronto per la digitazione.

  3. Digitare il nome e premere Enter.
  4. Fare clic sulla descrizione e scrivere l'enunciato con “shall”.
  5. Premere ⌘↵ / Ctrl↵ o fare clic altrove per salvare la descrizione.
  6. Per aggiungere il requisito successivo allo stesso livello, premere di nuovo ⌘↵ / Ctrl↵.

+ Nuovo … (intestazione della pagina) aggiunge l'elemento alla fine del documento; + Dopo e + Figlio lo aggiungono accanto all'elemento selezionato (lo indica il suggerimento di + Nuovo …). Tutti e tre aggiungono l'ultima classe scelta dai loro menu ▾ (Requirement per impostazione predefinita). Questo browser ricorda la scelta.

Aggiungere molti requisiti rapidamente

Usare Aggiunta rapida in fondo al documento per digitare requisiti uno dopo l'altro.

  1. Nella barra Aggiunta rapida, scegliere la sezione, per esempio Sotto 4 Command and Data Handling.
  2. Digitare il testo del requisito.
  3. Premere Enter.

    Holarch aggiunge il requisito e lo nomina con le parole dopo “shall”. Il cursore resta nel campo per il successivo.

Ristrutturare

Modificare la struttura con i tasti, trascinando o dal menu del clic destro. Con la rinumerazione automatica attiva, i numeri si aggiornano dopo ogni spostamento.

  • Con i tasti: selezionare una riga, poi premere:
    • ⌥⇧→ / Alt+Shift+→ per rientrarla sotto l'elemento soprastante.
    • ⌥⇧← / Alt+Shift+← per ridurne il rientro.
    • ⌥ / Alt+↑ o ⌥ / Alt+↓ per spostarla tra gli elementi dello stesso livello.
    • Tab non si usa per il rientro, quindi passa sempre al campo successivo.
  • Trascinando: trascinare le righe nel riquadro Struttura. Rilasciare sul bordo superiore o inferiore di una riga per mettere l'elemento prima o dopo di essa. Rilasciare al centro per farlo diventare un figlio.
  • Dal menu: fare clic destro sulla riga e scegliere Sposta sotto ▸, poi scegliere il nuovo padre dall'elenco (digitare per filtrarlo). I figli si spostano insieme.

Rivedere, mettere in baseline e pubblicare

  1. Scegliere Controlla ▾ → Controlla qualità e correggere i requisiti deboli (vedere Requisiti).
  2. Scegliere Controlla ▾ → Stato di tracciabilità… e collegare i requisiti non ancora allocati o verificati.
  3. Chiudere gli elementi aperti in Controlla ▾ → Registro TBD/TBR.
  4. Rivedere Controlla ▾ → Collegamenti da rivedere.
  5. Nel cartiglio, fare clic su Versione ▾ e scegliere Salva baseline….
  6. Inserire un nome, per esempio “SRR Baseline”.
  7. Aggiungere una riga di approvazione per approvatore, con nome, ruolo e dichiarazione.
  8. Fare clic su Crea.

    La baseline compare in Versione ▾, e il pulsante la indica come ultima baseline.

  9. Fare clic su Consegna ▾ → Specifica (Word).

    Il file Word viene scaricato con le opzioni del modello Specification, comprese le tabelle Revision History e Approvals compilate dalle baseline.

  10. Aprire il file in Word e accettare la richiesta di aggiornare i campi.

    Il sommario si compila.

Per far rivedere il documento prima della baseline, fare clic su Richiedi revisione accanto al tipo di documento. I revisori del progetto lo trovano in Documenti da rivedere in Il mio lavoro e lo approvano o rifiutano lì o nella striscia sotto il titolo.

Dopo modifiche successive, vedere cosa è cambiato:

  1. Fare clic su Versione ▾ → Confronta versioni….
  2. Scegliere la baseline in Da e Versione corrente in A.

    Il report elenca ogni aggiunta, rimozione e modifica. Fare clic su Modifiche (Excel) per scaricarlo, oppure su Redline (Word) per un file Word con revisioni.

Esempio pratico: la demo CubeSat EO-1

Creare la demo da Gestisci progetti → File di progetto ▾ → Nuovo progetto demo. Poi aprire Esigenze e requisiti → Documenti → EO-1 System Requirements Specification (numero SRS-001).

Leggere la struttura. Sei sezioni contengono i requisiti:

  • 1 Mission Imaging
  • 2 Attitude Determination and Control
  • 3 Electrical Power
  • 4 Command and Data Handling
  • 5 Communications
  • 6 Ground Segment and Operations

Il requisito 1.6 Revisit Time ha due figli, 1.6.1 Ground Track Repeat e 1.6.2 Off-Nadir Imaging. La colonna Punteggio di qualità mostra delle barre. 2.5 Safe Mode Recovery e 6.4 Operator Interface hanno un punteggio basso.

Correggere una formulazione debole:

  1. Premere ⌘F / Ctrl+F e digitare should.

    Il contatore mostra i risultati.

  2. Premere Enter finché 2.5 non è evidenziato.

    Il suo testo è “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”.

  3. Riscriverlo, per esempio “The spacecraft shall resume imaging within 24 hours of a safe mode entry.”

    La colonna del punteggio mostra un tag Non aggiornato finché non si esegue di nuovo il controllo.

Dividere un requisito composto:

  1. Selezionare 6.4 Operator Interface (“…shall be user friendly and/or easy to use.”).
  2. Fare clic destro su di esso e scegliere Dividi in più elementi….
  3. Fare clic su ✦ Proponi una suddivisione.

    Si ottiene un requisito misurabile per riga.

  4. Deselezionare le righe indesiderate, oppure fare clic su Unisci per unire una riga alla successiva, e fare clic su Applica.

Aggiungere rapidamente un requisito:

  1. In Aggiunta rapida, scegliere Sotto 3 Electrical Power.
  2. Digitare “The EPS shall provide a 5 V regulated bus within 3%.” e premere Enter.

    Viene aggiunto come 3.7, con il nome “Provide A 5 V Regulated”.

Vedere cosa è cambiato dalla SRR:

  1. Fare clic su Versione ▾ nel cartiglio e scegliere SRR Baseline.

    Il banner indica “Baseline “SRR Baseline”, sola lettura, salvata il {date}”. Gli approvatori sono J. Rivera, Systems Lead; R. Okafor, Mission Principal Investigator; e L. Brandt, Program Manager.

  2. Fare clic su Confronta con la versione corrente.

Il report elenca:

  • 3.1 Orbit Average Power: descrizione cambiata da 28 W a 30 W, e una nuova motivazione.
  • 2.4 Target Slew: Status Draft → In Review.
  • Il nuovo 4.4 Downlink Encryption, con i suoi due nuovi collegamenti satisfies.
  • Le proprie modifiche di questa sessione.

Pubblicare:

  1. Fare clic su Torna alla versione corrente.
  2. Fare clic su Consegna ▾ → Specifica (Word).

    Il file Word inizia con il titolo e “Requirements Document · No. SRS-001”. Seguono una riga di Revision History per SRR Baseline (“Baseline iniziale”) e le tre approvazioni, poi i requisiti numerati.

Suggerimenti e buone pratiche

  • Scrivere un requisito per riga, con un solo “shall”. Dividi in più elementi… e il controllo di qualità aiutano a mantenere i requisiti singoli.
  • Mantenere le sezioni come Statement e i requisiti come Requirement. Il controllo di qualità valuta solo i Requirement. I report solo sui requisiti (RVTM, VCRM, RTM) saltano gli Statement.
  • Creare una baseline prima di ogni revisione e prima di riscritture importanti. Il ripristino e i report delle modifiche dipendono da essa.
  • Un clic su una riga la seleziona. Per modificare, fare clic sul campo stesso, oppure premere Enter o F2 sulla riga selezionata.
  • Usare Vista ▾ → Carta per leggere il documento come una pagina, senza colonne di attributi. Disattivarla per modificare gli attributi nelle colonne.
  • Tenere d'occhio i punti dello stato di tracciabilità: un requisito è pronto per la revisione quando il suo punto è verde.

Errori comuni

  • L'aggiunta è in grigio. È attivo un filtro o un ordinamento (Vista filtrata: la modifica è disattivata. Cancella il filtro nella barra degli strumenti), oppure si sta visualizzando una baseline. Fare clic sull'avviso, oppure su Torna alla versione corrente.
  • I numeri sono saltati dopo uno spostamento. La rinumerazione automatica riscrive i numeri del gruppo di elementi dello stesso livello. Per mantenere i numeri impostati a mano, deselezionare Rinumera automaticamente dopo l'aggiunta o lo spostamento di elementi in Scrivi ▾ → Rinumera…, oppure bloccare gli elementi i cui numeri non devono cambiare.
  • Un elemento rimosso è ancora nel Database. Rimuovi lo toglie solo dal documento. Per eliminarlo, scegliere Elimina elemento… nel messaggio che segue, fare ⇧ / Shift-clic su Rimuovi, oppure premere ⇧Delete / Shift+Delete.
  • La numerazione con lettere o romana è diventata decimale. La rinumerazione automatica e Rinumera… producono numeri decimali (1, 1.1, 1.1.1). Per mantenere le appendici con lettere, disattivare la rinumerazione automatica e numerarle a mano.

Come si collega alle altre funzionalità

  • Alimentato da:
    • Importazione crea documenti da Word, Excel, CSV, ReqIF, XMI e testo.
    • I modelli creano lo scheletro.
    • I generatori IA aggiungono requisiti.
  • Alimenta:
  • Ovunque altrove: ogni elemento è un'entità. Compare nel Database, nella Vista elemento e in diagrammi come Spider e ad albero.

L'elenco dei documenti

L'elenco dei documenti mostra ogni documento del progetto come scheda, nella stessa galleria della pagina Diagrammi. Si apre con Esigenze e requisiti → Documenti.

Ogni scheda mostra:

  • Una miniatura della struttura del documento.
  • Il nome, il tipo e l'ultima modifica (l'ultima modifica al documento o a un suo elemento).
  • “N elementi · N requisiti”.
  • Qualità media N%, quando i requisiti hanno un punteggio.
  • N TBD/TBR: gli elementi aperti.
ControlloChe cosa fa
Cerca documenti…Mostra le schede il cui nome, numero o descrizione contiene il testo.
OrdinamentoModificati di recente (predefinito), Numero (ordine della struttura), Nome, Classe.
Pillole dei tipiTutti e una pillola per tipo di documento con il suo conteggio.
Mostra altro (N)Mostra altre schede.
Importa (intestazione della pagina)Apre la pagina Importazione (Importazione ed esportazione).
+ Nuovo documento (intestazione della pagina)Apre Nuovo documento.
⋯ su una schedaApri, Apri in ▸ Vista elemento, Duplica… ed Elimina….

Elimina… apre Elimina documento: “Elimina “…”. Le sue N sezioni restano nel progetto come elementi.” Quando alcune sezioni non sono in nessun altro documento, Elimina anche le N sezioni non usate da nessun altro documento elimina anche quelle. Annulla ripristina tutto.

Fare clic su una scheda per aprire il documento.

L'indirizzo documents/<id> apre direttamente un documento. Aggiungere ?baseline=<id> o ?baseline=latest per aprire una baseline, ?find=<text> per avviare una ricerca, oppure ?comments=1 per mostrare i commenti del documento nell'ispettore.

La pagina del documento

La pagina del documento mostra un documento come struttura e tabella, con l'elemento selezionato nell'ispettore.

  • + Nuovo {Class} aggiunge un elemento della classe corrente alla fine del documento. Il suo ▾ apre il menu delle classi:
    • Aggiungi elemento esistente….
    • Inserisci documento… e Inserisci sezione generata… (solo raccolte).
    • Sotto l'intestazione Aggiungi alla fine: ogni classe Statement e Heading (quella corrente ha un ✔), e Altra classe….
  • ✦ IA ▾ (nella barra superiore) contiene gli strumenti IA del documento (vedere Strumenti IA).

Barra degli strumenti

ControlloChe cosa fa
+ DopoAggiunge un elemento dopo quello selezionato, allo stesso livello (⌘↵ / Ctrl↵). Il suo ▾ aggiunge Aggiungi elemento esistente…, Aggiungi figlio (⌥⌘ / Ctrl+Alt↵) e l'elenco delle classi sotto Aggiungere dopo l'elemento selezionato.
+ FiglioAggiunge un figlio dell'elemento selezionato (⌥⌘↵ / Ctrl+Alt↵). Il suo ▾ offre Aggiungi elemento esistente… e l'elenco delle classi sotto Aggiungi un figlio.
⇤ / ⇥Riduce (⌥⇧← / Alt+Shift+←) / aumenta (⌥⇧→ / Alt+Shift+→) il rientro dell'elemento selezionato.
↑ / ↓Sposta l'elemento selezionato in alto o in basso tra gli elementi dello stesso livello (⌥ / Alt+↑ / ⌥ / Alt+↓).
RimuoviToglie subito dal documento gli elementi selezionati e i loro sottoalberi (Delete fa lo stesso). Rimosso dal documento. offre Annulla ed Elimina elemento…. ⇧ / Shift-clic o ⇧Delete / Shift+Delete elimina gli elementi e i loro figli dopo una conferma che indica cosa viene eliminato. Esc o la × dell'ispettore cancella la selezione.
Scrivi ▾Aggiungere, inserire, generare e modificare contenuti (vedere Menu Scrivi).
Controlla ▾Qualità, controlli del modello, stato di tracciabilità, collegamenti da rivedere, TBD/TBR e commenti per questo documento, con i conteggi (vedere Menu Controlla).
Consegna ▾Impostazione del deliverable e della pagina, il modello Word, le versioni e le esportazioni raggruppate per output (vedere Menu Consegna).
Vista ▾Interruttori diretti per questo documento: Carta, Riquadro struttura, Stato di tracciabilità e Colonne (vedere Menu Vista).
Vista filtrata: la modifica è disattivata. Cancella il filtroCompare mentre è attivo un filtro per classe o etichetta o un ordinamento per colonna. Fare clic per cancellarli.
TrovaApre la casella di ricerca (⌘F / Ctrl+F).

I pulsanti di struttura sono disattivati quando:

  • Non è selezionato nulla.
  • L'elemento selezionato è bloccato.
  • È attivo un filtro o un ordinamento.
  • Si sta visualizzando una baseline.

Riquadro della struttura

Il riquadro della struttura a sinistra mostra la gerarchia del documento, con un filtro in alto. Non ci sono schede: le baseline sono in Versione ▾ del cartiglio, e i commenti si aprono nell'ispettore.

  • ‹ nasconde il riquadro, e › sul bordo sinistro lo mostra di nuovo (anche Vista ▾ → Riquadro struttura).
  • Trascinarne il bordo destro per ridimensionarlo (da 180 a 500 px).
  • Selezionare un elemento apre l'ispettore accanto al riquadro; il riquadro resta aperto.
  • Quando il riquadro e il documento insieme misurano meno di 900 px (contando l'ispettore come aperto, così selezionare un elemento non cambia nulla), il riquadro si chiude. Si apre allora come sovrapposizione da ›. Fare clic all'esterno per chiuderlo.

Filtra in alto nel riquadro:

  • Filtra la struttura restringe la struttura agli elementi il cui numero o nome contiene il testo, compresi quelli compressi. I loro padri restano nella struttura, attenuati, come contesto. Non filtra il documento.
  • Chip delle classi, uno per classe presente nel documento con il suo conteggio (mostrati quando il documento ha più di una classe). Fare clic su un chip per mostrare nel documento solo quella classe e le sue sottoclassi; fare di nuovo clic per mostrare tutte le classi. Fare clic destro su un chip per {Class} e sottoclassi, Solo {Class} e Cancella il filtro per classe.
  • Chip delle etichette, uno per etichetta usata nel documento, con i conteggi. Fare clic sui chip per mostrare solo gli elementi con tutte le etichette scelte. Per gli elementi con una qualsiasi di più etichette, usare una query del Database.
  • Con più di sei chip, si raccolgono dietro Filtra per classe o etichetta (n); da chiusi, restano visibili solo i chip attivi. Meno filtri li richiude. Questo browser ricorda la scelta.
  • Cancella filtro compare mentre è attivo un filtro o un ordinamento. Le righe filtrate mantengono il loro rientro. La modifica è disattivata finché è attivo un filtro o un ordinamento.

La struttura:

  • Ogni elemento ha il suo campione di colore, il numero e il nome, 🔒 quando è bloccato, e gli interruttori ▾/▸.
  • Fare clic su una voce per selezionare l'elemento e scorrere fino a esso.
  • Trascinare per riordinare (vedere Trascinare e rilasciare). Le destinazioni di rilascio non valide vengono contrassegnate e rifiutate: un elemento non può andare sotto un proprio figlio, sotto un elemento bloccato o sotto una classe che non può essere decomposed by esso.
  • Le righe della parte di documento visibile sono evidenziate, e la struttura scorre insieme al documento. Resta ferma mentre vi si punta sopra, vi si lavora o se è stata fatta scorrere negli ultimi due secondi.
  • I livelli profondi che non entrano mostrano un tag di livello L{n} invece di un rientro maggiore.

Il corpo del documento

Il corpo inizia con il cartiglio: il tipo e le etichette del documento, il numero di elementi, “numerato per documento” quando è attiva la numerazione del documento, 💬 n commenti aperti (quando ce ne sono; vedere Commenti) e Versione ▾ (vedere Baseline). Versione ▾ indica Versione corrente, Corrente · ultima baseline {name} o Baseline: {name}. Sotto di essi:

  • N. e il titolo: fare clic per modificare il numero e il nome del documento, oppure raggiungerli con Tab e premere Enter o F2.
  • La descrizione del documento: fare clic per modificarla nell'editor di testo formattato, oppure raggiungerla con Tab e premere Enter o F2.
  • La tabella. La colonna Entità contiene ogni elemento: interruttore, numero, nome, badge e descrizione. Le altre colonne sono le colonne di attributi scelte in Vista ▾ → Colonne ▸: Status, Verification Method e Punteggio di qualità finché non vengono cambiate. La vista Carta non ne ha.

Ogni riga mostra:

  • ▾/▸ per comprimere o espandere i figli.
  • Il numero e il nome. Fare clic per modificare, oppure raggiungerne uno con Tab e premere Enter o F2. Enter salva e Esc annulla; lo stato attivo resta sul campo. Le interruzioni di riga incollate diventano spazi.
  • Badge:
    • 🔒: l'elemento è bloccato.
    • ⚡: l'elemento contiene indicazioni. Puntarvi sopra per leggerle.
    • 💬 n: commenti non risolti. Fare clic per aprirli nell'ispettore.
    • ⚠ Rivedi: un requisito a monte è cambiato.
    • Il badge della classe.
    • Il punto dello stato di tracciabilità (solo requisiti; vedere Stato di tracciabilità).
  • La descrizione, modificata nell'editor di testo formattato.
  • Una barra colorata sul bordo sinistro: blu quando l'elemento è invariato dall'ultima baseline, ambra quando è nuovo o modificato.
  • Celle degli attributi:
    • Etichette mostra dei chip con × per rimuovere e + per aggiungere. Il menu elenca le etichette consentite dalla classe, oppure “Nessun'altra etichetta”.
    • Gli attributi di testo si modificano sul posto. Gli altri attributi usano l'editor del loro tipo.
    • Punteggio di qualità mostra una barra colorata: verde dal 67% in su, ambra dal 34% al 66%, rossa sotto. Mostra un tag Non aggiornato con un'icona a orologio quando il testo è cambiato dopo l'ultimo controllo; puntarvi sopra per il motivo.
    • “—” significa che la classe non ha quell'attributo.

Ordinamento e larghezza delle colonne:

  • Fare clic sull'intestazione di una colonna per ordinare in modo crescente, di nuovo per l'ordine decrescente, e una terza volta per disattivare l'ordinamento.
  • L'ordinamento elenca gli elementi in modo piatto, senza gerarchia, e sospende la scrittura.
  • Trascinare il bordo destro di un'intestazione per ridimensionare la colonna. La colonna Entità è larga almeno 300 px, le altre almeno 80 px. Le larghezze vengono mantenute per documento in questo browser.
  • Una riga vuota di separazione divide le sezioni di primo livello.

Selezionare le righe:

  • Fare clic su una riga per selezionarla. Un clic seleziona soltanto; per modificare, fare clic sul campo, oppure premere Enter o F2 sulla riga.
  • Per deselezionare, fare clic sullo spazio vuoto sotto la tabella, premere Esc o fare clic su ✕.
  • ↑ e ↓ spostano la selezione tra le righe.
  • ⌘ / Ctrl-clic (Ctrl-clic su Windows e Linux) aggiunge un elemento alla selezione o lo toglie.
  • ⇧ / Shift-clic seleziona l'intervallo dall'ultimo elemento cliccato a questo, nell'ordine mostrato (con eventuali ordinamenti o filtri). ⌘ / Ctrl+⇧ / Shift-clic aggiunge quell'intervallo alla selezione.
  • ⌘A / Ctrl+A su un elemento con lo stato attivo (non durante la modifica) seleziona ogni elemento mostrato. ⇧ / Shift+↑ e ⇧ / Shift+↓ estendono la selezione dall'elemento con lo stato attivo.
  • Gli stessi gesti funzionano nella Struttura. La barra degli strumenti mostra il conteggio (“21 selezionati”). Un semplice clic, o Esc, torna a un solo elemento.
  • I clic in un campo in modifica mantengono il comportamento del testo: lì ⇧ / Shift-clic estende la selezione del testo.

Menu del clic destro

Fare clic destro su un elemento del documento (il suo numero, nome, badge o lo spazio attorno) o su una voce della Struttura per aprirne il menu nel punto del puntatore. Da tastiera, portare lo stato attivo sulla riga o sulla voce della Struttura e premere Shift+F10 o il tasto Menu; il menu si apre sull'elemento e Esc riporta lì lo stato attivo. Su uno schermo touch, tenere premuto l'elemento. L'elemento diventa la selezione.

Il menu inizia con fino a tre azioni suggerite, scelte in base allo stato dell'elemento, ciascuna con il motivo a destra: per esempio ✦ Aggiungi criteri misurabili… (non soddisfa: Unambiguous), ✦ Genera caso di test… (non verificato), Rivedi collegamento… (a monte cambiato) o Risolvi TBD… (TBD aperto). Se non c'è nulla da correggere, suggerisce ✦ Controlla con l'IA… e ✦ Chiedi all'IA su questo…. ✦ Altra IA ▸ elenca ogni azione IA per l'elemento. Le regole e l'elenco completo sono in Modello e Database. Ogni azione IA mostra il suo risultato per la revisione prima che cambi qualcosa. Quando l'IA è disattivata, la parte IA è una sola riga inattiva che ne indica il motivo.

I comandi dopo il separatore. Un tasto mostrato a destra di un comando fa lo stesso da tastiera (vedere Scorciatoie da tastiera):

ComandoChe cosa fa
Vai aSolo Struttura. Fa scorrere il documento fino all'elemento e vi sposta lo stato attivo (Enter sulla voce della Struttura).
AperturaApre la Vista elemento.
Rinomina…Cambia il nome. F2 su un elemento con lo stato attivo nel documento modifica il nome sul posto.
Aggiungi {class} dopoAggiunge un elemento della classe corrente dopo questo, come fa + Dopo (⌘↵ / Ctrl↵).
Aggiungi {class} figlioAggiunge un elemento della classe corrente sotto questo, come fa + Figlio (⌥⌘↵ / Ctrl+Alt↵).
Aumenta rientro, Riduci rientroCome ⇥ e ⇤ nella barra degli strumenti (⌥⇧→ / Alt+Shift+→ e ⌥⇧← / Alt+Shift+←).
Sposta su, Sposta giùCome ↑ e ↓ nella barra degli strumenti (⌥ / Alt+↑ e ⌥ / Alt+↓).
Stato ▸, Priorità ▸Imposta l'attributo; il valore corrente è spuntato.
Metti in relazione con ▸Elenca per prime le relazioni più usate per la classe, poi Tutte le relazioni ▸ con ogni relazione consentita dalla classe. Sceglierne una apre un selettore per le entità di destinazione.
Mostra nel diagramma ▸Elenca i tipi di diagramma che possono mostrare l'elemento; sceglierne uno lo apre.
Copia linkCopia un link alla Vista elemento dell'elemento.
Copia numeroCopia il numero dell'elemento.
Apri in ▸Vista elemento, Cronologia…, i diagrammi che possono mostrare l'elemento (gerarchia, albero, Spider, Action, Asset, Risk, temporale), Matrice di tracciabilità, Qualità dei requisiti e Analisi funzionale.
Sposta sotto ▸Un elenco filtrabile digitando degli elementi che possono contenere questo, rientrati nell'ordine del documento, e Livello superiore del documento quando ha un padre. I figli si spostano insieme.
Dividi in più elementi…Vedere Dividere in più elementi.
Cambia classe…Apre Cambia classe (lo stesso dialogo del Database; vedere Modello e Database).
Rinumera da qui…Apre Rinumerare per questo elemento, gli elementi successivi dello stesso livello e i loro figli.
Imposta attributo su questo ramo…Vedere Impostare un attributo su questo ramo.
Blocca / SbloccaBlocca l'elemento contro le modifiche, o lo sblocca.
Rimuovi da questo documentoToglie l'elemento e i suoi figli dal documento (Delete). Le entità restano nel progetto; il messaggio offre Annulla ed Elimina elemento….
Elimina elemento…Elimina l'elemento e i suoi figli dopo la conferma (⇧Delete / Shift+Delete).

Ogni comando si può annullare con un solo annullamento. I comandi non applicabili sono inattivi e il loro suggerimento ne indica il motivo:

  • In una baseline, o con accesso in sola visualizzazione, funzionano solo Vai a, Apri, Mostra nel diagramma ▸, Copia link e Copia numero. In una baseline sono inattivi anche i suggerimenti e le azioni ✦ IA.
  • Su un elemento bloccato, Rinomina…, Stato ▸, Priorità ▸, Collega a ▸, gli spostamenti ed Elimina elemento… sono inattivi.
  • Mentre è attivo un filtro o un ordinamento, aggiunta e spostamento sono inattivi (“Cancellare prima il filtro o l'ordinamento”).
  • I comandi che sposterebbero l'elemento oltre l'inizio o la fine del suo livello sono inattivi (per esempio Sposta su sul primo elemento).

Più elementi selezionati. Un clic destro su un elemento della selezione agisce su tutti gli elementi selezionati. Il menu mostra N selezionati e offre le azioni ✦ di gruppo (✦ Controlla con l'IA (n requisiti)…, ✦ Riscrivi (n) ▸, ✦ Genera casi di test (n)…, ✦ Chiedi all'IA su questi (n)…, ✦ Suggerisci tracciamenti (n)…; vedere IA su più elementi selezionati), Imposta stato ▸, Imposta priorità ▸, Aggiungi al documento ▸, Rimuovi n da questo documento ed Elimina n elementi… (dopo la conferma; i figli degli elementi selezionati vanno con essi). I comandi per un solo elemento (Vai a, Apri, Rinomina…, aggiunta, rientro e spostamento) restano elencati ma inattivi, con il motivo “Agisce su un elemento”. Ogni comando è un passaggio di annullamento. Un clic destro su un elemento esterno alla selezione lo rende l'unico elemento selezionato.

La descrizione e qualsiasi campo in modifica mantengono il menu del browser, così lì si può copiare, incollare e controllare l'ortografia. ⌥ / Alt-clic destro mostra il menu del browser ovunque.

Aggiunta rapida

Aggiunta rapida permette di digitare requisiti in fila senza usare la barra degli strumenti. La barra sotto il documento contiene Aggiunta rapida, l'elenco delle sezioni, il campo di testo e Aggiungi. L'elenco delle sezioni offre Fine del documento e Sotto {number name} per ogni sezione di primo livello.

Digitare un requisito e premere Enter o fare clic su Aggiungi. Il nuovo elemento riceve:

  • La classe corrente.
  • Il testo come descrizione.
  • Un nome formato dalle prime parole dopo “shall”, “must”, “will” o “should”: fino a cinque parole, con le iniziali maiuscole.

Il campo accetta fino a 2.000 caratteri. Mentre è attivo un filtro o un ordinamento, il campo indica “Cancellare il filtro o l'ordinamento per aggiungere elementi”.

Ispettore

L'elemento selezionato si apre nell'ispettore a destra, con il pannello completo dell'entità (vedere Modello e Database).

  • In un documento, lì le relazioni decomposed by e decomposes sono di sola lettura, perché le controlla la struttura.
  • La × dell'intestazione (Esc) cancella la selezione. Vista ▾ → Comprimi i figli comprime le sezioni sotto l'elemento selezionato.
  • Gli elementi bloccati si aprono in sola lettura.

Aggiungere elementi

Nuovi elementi

  • + Nuovo {Class} aggiunge alla fine.
  • + Dopo aggiunge dopo l'elemento selezionato.
  • + Figlio aggiunge l'ultimo figlio dell'elemento selezionato, e il padre si espande.
  • Senza selezione, + Dopo e + Figlio aggiungono alla fine.

Un nuovo elemento si chiama “Nuovo {Class}”. Viene selezionato e il suo nome si apre per la modifica.

Altre classi

Altra classe… apre Aggiungi elemento al documento con Classe (qualsiasi classe) e Nome. Usarlo per elementi che non sono Statement, come la descrizione di un Asset o un Test Case in un piano di test.

Documenti strutturati con Heading

Un Heading è una sezione di un documento (l'approccio degli artefatti strutturati di LML 2.0). Usare gli Heading quando una sezione mescola classi, per esempio requisiti, azioni e rischi, o quando lo stesso requisito compare in più documenti.

  1. Scegliere Heading in un menu delle classi (+ Nuovo ▾, + Dopo ▾ o + Figlio ▾). Di un Heading al primo livello il documento è source of; sotto un altro Heading è una sottosezione numerata.
  2. Selezionare l'Heading e usare + Figlio ▾ per aggiungerne il contenuto: un nuovo elemento di qualsiasi classe, oppure Aggiungi elemento esistente…. L'Heading contains l'elemento.
  3. Il contenuto mantiene il proprio numero: aggiunta, spostamento e Rinumera… numerano gli Heading e lasciano invariati i numeri del contenuto, così un requisito come RQ.CLN.1 si legge allo stesso modo in ogni documento. Il contenuto di una sezione è elencato prima delle sottosezioni.

Spostare il contenuto in un altro Heading (trascinamento, Sposta sotto ▸) sposta il suo collegamento contains. I Controlli del modello contano un requisito contenuto in un Heading come collocato in un documento.

Per registrare da dove proviene un requisito, collegarlo all'Artifact di origine con originated by (ispettore → Relazioni; l'Artifact lo elenca sotto originates). Un progetto creato prima degli Heading mantiene il suo schema; Schema → Aggiungi nuovi elementi integrati… aggiunge Heading, contains e originates.

Esempio nella demo CubeSat EO-1: la sezione 7 Applicable Documents della EO-1 System Requirements Specification è un Heading. Il suo contenuto sono i due standard del progetto, che mantengono i numeri STD-1 e STD-2. STD-1 origina il requisito 3.4 Bus Regulation e STD-2 origina 5.2 UHF Command Uplink.

Entità esistenti

Aggiungi elemento esistente… apre un selettore di entità. Il selettore esclude il documento e i suoi elementi attuali. L'entità viene aggiunta con tutta la sua scomposizione. Quando porta con sé dei figli, il messaggio indica “Aggiunto {entity} con N entità figlie”.

Ristrutturare

Aumentare e ridurre il rientro e spostare

  • Aumenta rientro rende l'elemento l'ultimo figlio dell'elemento soprastante dello stesso livello. Il primo elemento di un gruppo non può essere rientrato.
  • Riduci rientro rende l'elemento il successivo allo stesso livello del suo padre.
  • Sposta su/giù scambia l'elemento con quello vicino. Gli elementi bloccati e i vicini bloccati non si spostano.
  • Quando uno spostamento non è possibile, il messaggio indica “L'elemento selezionato non può spostarsi oltre in quella direzione.”

Trascinare e rilasciare

Trascinare nel riquadro Struttura. L'elenco scorre quando si trascina vicino al bordo superiore o inferiore. Il punto di rilascio decide il risultato:

  • 28% superiore di una riga: l'elemento va prima di essa.
  • 28% inferiore di una riga: l'elemento va dopo di essa.
  • Centro di una riga: l'elemento ne diventa figlio.
  • Il nome del documento in alto: l'elemento diventa un elemento di primo livello alla fine.

Sposta sotto

Fare clic destro su un elemento e scegliere Sposta sotto ▸. L'elenco contiene gli elementi che possono accoglierlo come figlio, rientrati nell'ordine del documento, e Livello superiore del documento quando l'elemento ha un padre. Digitare per filtrare l'elenco, poi scegliere il nuovo padre. I figli si spostano insieme; il messaggio indica “Spostato {item}”.

L'elenco esclude il sottoalbero dell'elemento stesso, il suo padre attuale, gli elementi bloccati e i padri non consentiti dallo schema. Quando lo spostamento non riesce, il messaggio indica “L'elemento non può essere spostato lì: il nuovo genitore è al suo interno, o l'elemento è bloccato. Scegliere un altro genitore o sbloccarlo.”

Numerazione

Rinumerazione automatica

Rinumera automaticamente dopo l'aggiunta o lo spostamento di elementi è attivo per impostazione predefinita; si cambia in Scrivi ▾ → Rinumera…. Finché è attivo, queste azioni rinumerano il gruppo dello stesso livello interessato e tutti i discendenti: aggiunta, spostamento, aumento e riduzione del rientro, rimozione e divisione.

  • Gli elementi di primo livello ricevono lo schema di numerazione del documento con un numero progressivo. Parte dal primo numero del documento: 1, a meno che non sia cambiato in Rinumera….
  • I figli ricevono il numero del padre, un punto e un numero progressivo (3, 3.1, 3.1.1).
  • Gli elementi bloccati e le voci del glossario (elementi con l'etichetta Acronym, il cui numero è il termine) mantengono i loro numeri ma occupano comunque una posizione.

Con l'opzione disattivata:

  • Un nuovo elemento riceve il numero successivo a quello dell'elemento precedente. Un primo figlio riceve il numero del padre più .1.
  • I numeri esistenti non cambiano.
  • Spostare un elemento rinumera solo il sottoalbero spostato.
  • Sposta su/giù scambia i due numeri.

Regole per il numero successivo

Per continuare una sequenza, Holarch incrementa l'ultima parte del numero precedente. Mantiene i separatori e un punto, due punti o una parentesi finali.

  • Cifre: 1.9 → 1.10, 2. → 3.
  • Lettere: a → b, z → aa, Z → AA, Appendix A → Appendix B
  • Numeri romani di due o più lettere: IV → V, IX → X. Una sola lettera conta come lettera (I → J).
  • A tutto il resto viene aggiunto .1.

Rinumerare

Scrivi ▾ → Rinumera… rinumera l'intero documento in un solo passaggio. Rinumera da qui… nel menu del clic destro di un elemento rinumera quell'elemento, gli elementi successivi dello stesso livello e tutti i loro figli.

Il dialogo contiene:

  • Schema: {n} è la posizione e {n:3} la completa a tre cifre. SYS-{n:3} produce SYS-001, SYS-002; i loro figli vengono numerati sotto di essi, SYS-001.1, SYS-001.2. Uno schema senza {n} riceve il numero alla fine. Da un elemento, lo schema e il primo numero sono precompilati a partire dal suo numero.
  • Primo numero (solo cifre). Un altro input mostra “Inserire il primo numero in cifre, ad esempio 1.”
  • Una tabella di anteprima con Elemento, Attuale e Nuovo (i numeri modificati sono evidenziati; fino a 400 righe), e un conteggio come “Cambiano 12 numeri su 40.”
  • Rinumera automaticamente dopo l'aggiunta o lo spostamento di elementi (solo intero documento).
  • La nota “Gli elementi bloccati mantengono i propri numeri. Un solo Annulla riporta indietro l'intera rinumerazione.” Anche le voci del glossario mantengono i loro.
  • Rinumera. Il messaggio indica “Numeri del documento aggiornati”.

Un'esecuzione sull'intero documento salva lo schema e il primo numero con il documento. La rinumerazione automatica successiva li usa.

Numerazione del documento (numeri meta)

La numerazione del documento mantiene numeri separati per ogni documento. Usarla quando lo stesso requisito compare in due documenti con numeri diversi.

Attivarla con Consegna ▾ → Impostazione del deliverable… → Numerazione → Numeri del documento (conservati solo in questo documento). Numeri del modello (i numeri propri degli elementi) la disattiva.

  • Quando la si attiva, il numero attuale di ogni elemento viene copiato nel documento.
  • Da quel momento, le modifiche dei numeri cambiano solo questo documento.
  • Il cartiglio mostra “· numerato per documento” finché è attiva.
  • Esportazioni e report usano i numeri del documento.

Modelli

I modelli provengono da quattro posizioni. Nuovo documento e Usa modello li elencano in quest'ordine, prima i modelli di questo tipo di documento:

GruppoDove è conservatoChi può aggiungerlo o modificarlo
Modelli dell'organizzazione: {name}Sui server Holarch (ospitati o self-hosted), per l'organizzazioneAmministratori dell'organizzazione
Modelli di progettoNel file del progetto; li vede ogni membro del progettoI proprietari del progetto (nell'app desktop: chiunque apra il progetto)
Modelli predefinitiIn HolarchNessuno
Salvato in questo browserSolo in questo browser (modelli salvati prima della versione 1.8.0)Importarli in un progetto

Modelli predefiniti

Ogni modello predefinito ha sezioni numerate con tabelle iniziali (per esempio le tabelle Revision History e Approvals). Con Includi indicazioni di scrittura, ogni sezione inizia anche con una breve guida alla scrittura.

Nuovo documento mostra il numero di sezioni di ogni modello, per esempio “39 sezioni” per la Requirements Specification.

I modelli seguono la prassi comune dell'ingegneria dei sistemi per ogni tipo di documento: specifiche dei requisiti degli stakeholder, di sistema, del software e delle interfacce, un documento di controllo delle interfacce, una descrizione dell'architettura, verifica e validazione, piani di test e di rischio, procedure e report di test, studi di trade-off e gestione della configurazione.

Molte sezioni contengono blocchi dinamici che si aggiornano dal modello ogni volta che il documento viene mostrato o esportato:

BloccoPresente in
VCRM, VCRM per livello, RVTM e RTM dei requisiti del documento stessoSpecifiche dei requisiti (sezioni Verification e Traceability)
VCRM e RVTM dell'intero progettoTest Plan, Verification and Validation Plan, Test Procedure, Test Report
Matrice delle interfacce e l'elenco dei conduitInterface Control Document, Architecture Description
Matrice di allocazione (funzioni ai componenti)Concept Definition, Architecture Description
Statement con l'etichetta AcronymOgni sezione Acronyms
Artifact con l'etichetta ReferenceOgni sezione References
Risk; Artifact Trade StudyRisk Management Plan; Trade Study Report

Una matrice che copre “questo documento” punta al nuovo documento. Per il Test Report, aggiungere i risultati di un ciclo di test con Inserisci ▸ Matrice… ▸ Test Report e scegliere la suite e il ciclo di test.

Salvare un documento come modello

Salvare la struttura di un documento come modello per avviare nuovi documenti a partire da essa.

  1. Scegliere Scrivi ▾ → Modelli ▸ Salva come modello….

    Si apre Salva {Type} come modello.

  2. Inserire il Nome del modello.
  3. In Salva in, scegliere:
    • Questo progetto: ogni membro del progetto può usarlo. Solo i proprietari del progetto vedono questa scelta.
    • Organizzazione: {name} (server Holarch, amministratori dell'organizzazione): ogni membro dell'organizzazione può usarlo. Selezionare Renderlo il predefinito dell'organizzazione per {Type} per preselezionarlo in Nuovo documento.
  4. Selezionare Includi file e immagini se il modello deve conservarli.
  5. Fare clic su Salva.

Un modello memorizza classe, nome, numero, descrizione, livello, etichette e valori semplici degli attributi di ogni elemento. I risultati di qualità sono esclusi. Una matrice che copre il documento salvato copre il nuovo documento quando il modello viene applicato.

Se non è possibile salvare nessuno dei due tipi, il dialogo lo indica: chiedere a un proprietario del progetto o a un amministratore dell'organizzazione.

Gestire i modelli

Scrivi ▾ → Modelli ▸ Gestisci modelli… elenca i modelli del progetto. I proprietari possono usare Rinomina e Rimuovi; Annulla ripristina un modello rimosso. I documenti creati da un modello non cambiano.

Gli amministratori dell'organizzazione gestiscono i modelli dell'organizzazione in Impostazioni dell'organizzazione → Modelli di documento: aprire l'organizzazione e usare Modelli di documento per rinominare un modello, attivare o disattivare Predefinito (un predefinito per tipo di documento) o rimuoverlo.

Modelli salvati in questo browser

Prima della versione 1.8.0, i modelli personalizzati venivano salvati nel browser. La prima volta che un proprietario del progetto apre l'elenco dei modelli, Holarch propone di copiarli nel progetto: Importa nel progetto o Non ora. Fino ad allora restano elencati sotto Salvato in questo browser. Gestisci modelli… offre per essi Importa nel progetto e Rimuovi dal browser.

Applicare un modello a un documento esistente

Scrivi ▾ → Modelli ▸ Applica modello… apre Usa modello con Tipo di documento, Modello, Salvare questo documento come modello… e Gestisci modelli….

Applica aggiunge le sezioni del modello, con i loro numeri e il loro annidamento, alla fine del documento. Il messaggio indica “Aggiunte N sezioni.” Annulla le rimuove.

Editor di testo formattato

L'editor di testo formattato modifica le descrizioni con formattazione, tabelle, immagini e contenuto dinamico. Fare clic su una descrizione (o sulla descrizione del documento) per modificarla. Da tastiera, raggiungere la descrizione con Tab e premere Enter o F2; i lettori di schermo la annunciano come campo di testo con il nome del suo elemento (“Descrizione di 1.2 Power Budget”).

L'editor si apre sul posto con una barra degli strumenti, un contatore di parole e caratteri (“parole: N · caratteri: N”) e il suggerimento “⌘↩ salva · Esc annulla · Tab esci”.

  • Per salvare, premere ⌘↵ / Ctrl↵, fare clic su ✓, fare clic fuori dall'editor oppure premere Tab per uscirne.
  • Per annullare, premere Esc. Lo stato attivo torna alla descrizione.
  • Ogni salvataggio si può annullare con un solo annullamento.
  • Tab non crea mai rientri, quindi non può bloccare l'utente nell'editor. Il rientro degli elenchi si cambia con ⌘ / Ctrl+] / ⌘ / Ctrl+[ o con ⇤ / ⇥.

Barra degli strumenti

PulsanteChe cosa fa
+Menu Inserisci: ✦ Scrivi con l'IA…, Immagine…, Testo alternativo… (quando il testo contiene immagini), Tabella…, Blocco di codice, Linea, Link…, Link a documento…, File…, Diagramma…, Valore dinamico…, Conteggio o totale…, Tabella dinamica…, Matrice…, Riferimento incrociato…, Simbolo…, e Aggiorna figure di diagramma quando il testo contiene immagini di diagrammi
✦Strumenti di testo IA (vedi sotto)
¶ ▾Stile di paragrafo: Testo, da Titolo 1 a Titolo 4, Citazione, Blocco di codice
G / C / SGrassetto (⌘B / Ctrl+B), corsivo (⌘I / Ctrl+I), sottolineato (⌘U / Ctrl+U)
⋯Sottolineato (⌘U / Ctrl+U), Barrato, Apice, Pedice, Codice in linea, Evidenziazione, Cancella formattazione (⌘⇧M / Ctrl+Shift+M)
• / 1.Elenco puntato (⌘⇧8 / Ctrl+Shift+8) / elenco numerato (⌘⇧7 / Ctrl+Shift+7)
⇤ / ⇥Riduci rientro (⌘[) / aumenta rientro (⌘])
≡ ▾Allineamento: A sinistra, Al centro, A destra, Giustificato
▦Inserisci tabella… e, all'interno di una tabella, le operazioni sulla tabella
🔗Link (⌘K / Ctrl+K)
ACampioni di Colore del testo e Sfondo (dieci colori ciascuno) e Rimuovi colore
AaCarattere (Arial, Brush Script MT, Comic Sans MS, Garamond, Georgia, Helvetica, Impact, monospace, Times New Roman) e Dimensione (da 10 a 60 px) per la selezione
↶ / ↷Annulla (⌘Z / Ctrl+Z) / ripeti (⇧⌘Z / Ctrl+Shift+Z) all'interno dell'editor
</>Sorgente HTML (⌘/ / Ctrl+/); il sorgente viene ripulito quando si torna indietro
⤢Schermo intero; Esc esce prima dallo schermo intero
✓Salva (⌘↵ / Ctrl↵)

Carattere, dimensione e stili che racchiudono la selezione richiedono una selezione. Senza di essa, il messaggio indica “Selezionare prima del testo.”

Tabelle

Inserisci tabella chiede Righe (predefinito 2), Colonne (predefinito 3) e Riga di intestazione (attiva). Tab e Shift+Tab spostano tra le celle. Tab nell'ultima cella (o Shift+Tab nella prima) esce dall'editor.

All'interno di una tabella, fare clic su ▦ o fare clic destro su una cella per le operazioni sulla tabella:

  • Aggiungi riga sopra, Aggiungi riga sotto, Aggiungi colonna prima, Aggiungi colonna dopo.
  • Aggiungi riga di intestazione, Aggiungi didascalia, Unisci con la cella a destra.
  • Elimina riga, Elimina colonna, Rimuovi riga di intestazione, Rimuovi didascalia, Elimina tabella.

Immagini e file

  • Immagine… inserisce un file immagine come figura. Il dialogo Inserisci immagine chiede Testo alternativo (cosa mostra l'immagine), oppure Decorativa (testo alternativo non necessario) per un'immagine che non aggiunge informazioni.
  • Si può anche incollare un'immagine, o rilasciare un file immagine nell'editor. Queste iniziano senza testo alternativo; il messaggio indica “Immagine aggiunta senza testo alternativo. Aggiungerlo con il menu + (Testo alternativo…).”
  • Incollare l'indirizzo di un'immagine (che termina con .png, .jpg, .jpeg, .gif o .webp) inserisce l'immagine.
  • Le immagini più grandi di 4.000 px sul lato più lungo vengono ridotte per adattarle. L'avviso indica “Immagine ridotta a W × H px (il limite è 4000 px sul lato più lungo).”
  • Un file immagine oltre il limite per file viene ridisegnato a 1.600 px di larghezza come JPEG. Se è ancora troppo grande, il messaggio indica “L'immagine supera il limite di N MB.”
  • File… allega qualsiasi file come link di download, con un'icona per il suo tipo. I file oltre il limite mostrano “Il file supera il limite di N MB.”

Testo alternativo

Il testo alternativo descrive un'immagine per i lettori di schermo e nel controllo di accessibilità di Word.

  • + → Testo alternativo… elenca ogni immagine del testo con il suo testo alternativo e una casella Decorativa. Avvisa quando un'immagine non ha testo alternativo o quando il testo alternativo è un nome di file.
  • Fare doppio clic su un'immagine, oppure fare clic destro su di essa e scegliere Modifica testo alternativo…, per modificare solo quella.
  • Le immagini dei diagrammi (Diagramma…) prendono il testo alternativo dalla didascalia: il tipo di diagramma e il nome dell'entità.
  • L'output Word scrive il testo alternativo nella descrizione di ogni immagine. Un'immagine decorativa viene contrassegnata come decorativa.
  • Link… (Inserisci link) accetta un URL e un Testo. Gli indirizzi senza http:, https:, mailto: o # ricevono https://. I link si aprono in una nuova scheda.
  • Link a documento… (Inserisci link a documento) collega a un altro documento. Accetta un Documento, una Versione (Corrente o Baseline: {name}) e un Testo.
    • Nell'output Word, i documenti collegati in questo modo possono essere aggiunti come appendici.
    • Senza altri documenti, il messaggio indica “Questo progetto non ha altri documenti. Crearne prima uno.”

Contenuto dinamico

Il contenuto dinamico resta allineato al modello ovunque il testo venga mostrato: nel documento, nell'ispettore, nelle esportazioni e nella ricerca.

  • Diagramma… (Inserisci diagramma): scegliere il Tipo di diagramma e l'entità (o una lavagna o un riquadro). Inserisce un'immagine del diagramma, con una didascalia, collegata al diagramma.
    • L'immagine è dinamica. Quando il modello cambia, il documento mostra la nuova immagine dopo un momento, e Word e le altre esportazioni la ridisegnano.
    • Per mantenere l'immagine attuale, fare doppio clic sulla figura nell'editor (Figura di diagramma) e disattivare Aggiorna l'immagine quando il modello cambia. La figura diventa allora un'istantanea.
    • Aggiorna figure di diagramma (in +) ridisegna subito ogni figura dinamica del testo.
    • Quando l'entità del diagramma viene eliminata, la figura mantiene la sua ultima immagine.
  • Valore dinamico…: scegliere un'entità e un Attributo. L'editor mostra il suo “Valore dinamico”. Per cambiare l'attributo, fare doppio clic sul valore dinamico (Modifica valore dinamico).
  • Conteggio o totale… inserisce un numero ricalcolato dal modello, per una sintesi direzionale o una riga di stato come “12 di 40 requisiti sono verificati” (due conteggi). I suoi campi:
    • Query: quali entità contare, per esempio class:Requirement AND Requirement:"Status=Approved". Vedere la sintassi di ricerca.
    • Ambito: Intero progetto, questo documento o un altro documento. Una raccolta come ambito copre tutte le sue parti.
    • Funzione: Conteggio, Somma, Media, Minimo o Massimo. Tutte tranne Conteggio chiedono un Attributo numerico, come l'Amount di un Cost. Senza numeri da totalizzare, il valore è N/A.
    • Il valore attuale. Per cambiare un conteggio in seguito, fare doppio clic su di esso.
  • Matrice… inserisce una RTM, RVTM, VCRM, matrice di allocazione o altra matrice dinamica. Vedere Generazione di documenti.
  • Tabella dinamica… inserisce una tabella di entità da una query. Le righe vengono ricalcolate ogni volta che il testo viene mostrato o esportato. I suoi campi:
    • Query, per esempio class:Requirement AND label:"Functional Requirement". Il valore predefinito è order:modified-. Vedere la sintassi di ricerca.
    • Ambito: Intero progetto, questo documento, oppure un altro documento o una raccolta.
    • Colonne (in ordine): predefinite Numero, Nome. + Aggiungi attributo… aggiunge una colonna di attributo. + Aggiungi colonna di relazione… aggiunge una colonna che elenca le entità correlate, per esempio Verified by.
    • Limite: predefinito 10. Tutte le righe elenca ogni corrispondenza.
    • Un'anteprima fino a 50 righe.
    • Per cambiare una tabella dinamica in seguito, fare doppio clic su di essa.
  • Intervallo del foglio di calcolo… inserisce celle di un foglio di calcolo come tabella, o come grafico di un tipo a scelta (o uno dei grafici del foglio stesso), con una didascalia. Scegliere il foglio di calcolo, il foglio e l'intervallo, e facoltativamente una vista condivisa da seguire. La tabella e il grafico mostrano i valori attuali e si aggiornano quando le celle cambiano; Word e le altre esportazioni usano i valori al momento dell'esportazione. Quando l'intervallo viene eliminato, la tabella mantiene le sue ultime righe ed è contrassegnata come mancante.
  • Riferimento incrociato… (Inserisci riferimento incrociato) rimanda a una parte del documento aperto tramite il suo numero attuale:
    • Sezione o elemento mostra il numero e il nome dell'elemento, per esempio “3.2 Frost Warning”. Altra entità… sceglie un'entità esterna al documento.
    • Figura e Tabella elencano le figure e le tabelle del documento che hanno una didascalia, come “Figura 2” o “Tabella 1”. Sceglierne una che non ha ancora una chiave di riferimento le aggiunge una chiave.
    • Il testo segue la rinumerazione. Nell'output Word, i riferimenti incrociati diventano campi che Word aggiorna con i numeri delle didascalie. Un riferimento incrociato la cui destinazione è stata eliminata mantiene il suo testo ed è contrassegnato.
  • Simbolo… inserisce uno tra: ± ° µ Ω ≈ ≠ ≤ ≥ × ÷ √ ∞ ∑ π Δ, frecce, • … — –, © ® ™ § ¶, € £ ¥ ¢, ½ ¼ ¾ ² ³, ✓ ✗.

Strumenti di testo IA

✦ riscrive la selezione, oppure il paragrafo corrente quando non c'è nulla di selezionato. Senza nulla su cui lavorare, il messaggio indica “Non c'è testo da riscrivere.”

Gli strumenti:

  • Migliora la formulazione, Semplifica, Correggi ortografia e grammatica, Abbrevia, Aggiungi dettaglio, Completa la frase.
  • Riscrivi con un tono…: accademico, assertivo, informale, sicuro, costruttivo, empatico, entusiasmante, scorrevole, formale, cordiale, ispirazionale, professionale.
  • Traduci… e Traduci l'intero testo…: arabo, cinese, inglese, francese, tedesco, greco, italiano, giapponese, coreano, portoghese, russo, spagnolo, svedese, ucraino.
  • Scrivi con l'IA….

L'anteprima mostra Attuale, Suggerito e Modifiche. Scegliere Sostituisci, Riprova o Scarta.

Incollare

Il testo formattato incollato mantiene la sua struttura: titoli, elenchi, tabelle e link. Perde le classi, gli stili in linea (tranne sulle celle di tabella) e il markup di Office. Script, frame e link non sicuri vengono rimossi da tutto il testo formattato.

Scorciatoie del testo formattato

TastiAzione
⌘↵ / Ctrl↵Salva e chiudi
EscAnnulla (o esci dallo schermo intero)
⌘B / Ctrl+B / ⌘I / Ctrl+I / ⌘U / Ctrl+UGrassetto / corsivo / sottolineato
⌘K / Ctrl+KCollegamento
⌘⇧7 / Ctrl+Shift+7 / ⌘⇧8 / Ctrl+Shift+8Elenco numerato / puntato
⌘] / ⌘[Aumenta / riduci rientro
Tab / Shift+TabCella di tabella successiva / precedente; altrove, esce dall'editor (salvando)
⌘⇧M / Ctrl+Shift+MRimuovi formattazione
⌥⌘0 / Ctrl+Alt+0Paragrafo di testo
Da ⌥⌘1 / Ctrl+Alt+1 a ⌥⌘4 / Ctrl+Alt+4Da Titolo 1 a Titolo 4
⌘/ / Ctrl+/Sorgente HTML
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+ZAnnulla / ripeti nell'editor

Trovare nel documento

Fare clic su Trova o premere ⌘F / Ctrl+F per cercare nel documento. La casella di ricerca mostra “n di m”.

La ricerca copre numero, nome e descrizione di ogni elemento, i valori delle colonne mostrate e i messaggi del controllo di qualità. Salta gli elementi nascosti da un filtro.

  • Enter o ▼ passa alla corrispondenza successiva.
  • Shift+Enter o ▲ passa alla corrispondenza precedente.
  • Esc cancella il testo, e × chiude la casella.

Le sezioni compresse si aprono per mostrare una corrispondenza. Le righe corrispondenti sono evidenziate e quella corrente è contrassegnata.

Trovare e sostituire

Scrivi ▾ → Trova e sostituisci… apre Trova e sostituisci. Contiene:

  • Trova e Sostituisci.
  • I campi in cui cercare: Nome, Numero e Descrizione. Numero è disattivato per impostazione predefinita.
  • Maiuscole/minuscole e Solo parole intere.

La riga sotto i campi indica “N entità corrispondono (le entità bloccate vengono saltate).” Sostituisci tutto cambia ogni corrispondenza negli elementi del documento, e un solo annullamento revoca tutto. Il messaggio indica “Aggiornate N entità”, oppure “Nessuna corrispondenza”. Nel testo formattato cambia solo il testo: formattazione, link e notazioni restano intatti.

Menu Scrivi

Scrivi ▾ contiene i comandi che aggiungono e modificano il contenuto. I comandi che aggiungono elementi sono inattivi in una baseline, con accesso in sola visualizzazione e mentre è attivo un filtro o un ordinamento; il suggerimento ne indica il motivo.

ElementoChe cosa fa
Aggiungi elemento ▸Le classi Statement e Altra classe…. Aggiunge l'elemento dopo quello selezionato, o alla fine se non è selezionato nulla. La classe scelta diventa la classe corrente.
Aggiungi elemento esistente…Vedere Entità esistenti.
Inserisci ▸Contenuto dinamico nella descrizione dell'elemento selezionato: Valore dinamico…, Conteggio o totale…, Tabella dinamica…, Matrice…, Immagine del diagramma…, Intervallo del foglio di calcolo… e Riferimento incrociato…. L'editor della descrizione si apre alla fine del testo con il dialogo scelto (vedere Contenuto dinamico). Inattivo finché non è selezionato un elemento non bloccato (“Selezionare prima un elemento non bloccato”). In una raccolta offre anche Documento… e Sezione generata… (vedere Raccolte).
✦ Genera requisiti…Generatore IA, sotto l'elemento selezionato o per l'intero documento. Ogni risultato viene mostrato in anteprima prima di essere aggiunto.
✦ Genera requisiti figli…Con uno Statement o un requisito selezionato: nuovi figli di esso.
✦ Genera rischi…Con un elemento selezionato: rischi per esso.
✦ Genera caso di test…Con un requisito selezionato: un caso di test che lo verifica.
✦ Riassumi…Scrive un elemento di sintesi, mantenuto per primo nel documento, senza numero.
✦ Traduci…Traduce il testo del documento, con un'anteprima.
Trova e sostituisci…Vedere Trovare e sostituire.
Rinumera…Vedere Rinumerare.
Modelli ▸Applica modello… (Applicare un modello), Salva come modello… (Salvare un documento come modello) e Gestisci modelli… (Gestire i modelli).

Impostare un attributo su questo ramo

Fare clic destro su un elemento e scegliere Imposta attributo su questo ramo… per impostare un valore sull'elemento e su tutti i suoi discendenti. Scegliere Aggiungi etichetta, Rimuovi etichetta o un attributo, poi il valore. Il dialogo indica “Si applica a {item} e ai suoi N discendenti. Gli elementi bloccati vengono saltati.” Il messaggio indica “Aggiornate N entità (k bloccate saltate)”.

Dividere in più elementi

Fare clic destro su un elemento e scegliere Dividi in più elementi… per suddividere un requisito composto in requisiti singoli. Il dialogo si intitola Dividi in più elementi: {item}.

  1. Scegliere Dividi alle frasi o Dividi ai paragrafi, e Nuovi elementi come suoi figli o Nuovi elementi dopo di esso.

    La tabella mostra un elemento proposto per parte, con il numero, un Nome e un Testo modificabili.

  2. Oppure fare clic su ✦ Proponi una suddivisione perché l'IA proponga requisiti singoli (fino a 20).
    • Le righe il cui testo contiene un indirizzo web partono non spuntate.
    • Quando l'originale è approvato, in baseline o bloccato, la sostituzione del suo testo è una scelta facoltativa non spuntata.
    • Un confronto mostra la riga 1 rispetto all'originale.
  3. Modificare nomi e testo. Unisci unisce una parte alla successiva.
  4. Togliere la spunta alle parti indesiderate e fare clic su Applica.

La parte 1 (“mantiene”) resta nell'elemento originale. Ogni parte spuntata diventa un nuovo elemento della stessa classe con le stesse etichette. I numeri vengono proposti automaticamente; con la rinumerazione automatica attiva, vengono riassegnati dopo la divisione. Un solo annullamento revoca l'intera divisione; il messaggio indica “Diviso in N elementi”.

Menu Controlla

Controlla ▾ elenca ciò che richiede attenzione in questo documento, con i conteggi a destra:

ElementoChe cosa fa
Controlla qualitàControlla ogni requisito del documento che supera il filtro corrente e apre i risultati. Con un requisito selezionato, la voce è Controlla la qualità di questo requisito. Senza requisiti: “Questo documento non ha Requirement da controllare. Gli Statement non vengono valutati.”
Controlli del modello per questo documento…Apre Controlli del modello per questo documento: i rilievi dei Controlli del modello per il documento e i suoi elementi (regola, elemento, rilievo) e il contenuto dinamico che punta a qualcosa di mancante. Fare clic su un elemento per selezionarlo. Se non ce ne sono: “Nessun rilievo per questo documento.” Apri controlli del modello apre la pagina per l'intero progetto.
Stato di tracciabilità…Mostra “N di M completati” e apre Stato di tracciabilità: i requisiti non ancora allocati o verificati, ciascuno con il suo punto e ciò che manca (satisfied by, verified by). Fare clic su uno per selezionarlo. Aprire la RVTM apre la pagina RVTM. Mostrato quando il documento ha requisiti.
Collegamenti da rivedereApre Collegamenti da rivedere per questo documento.
Registro TBD/TBRApre il registro TBD/TBR per questo documento.
Trova acronimi…Vedere Trovare gli acronimi.
CommentiMostra il numero di commenti aperti e li apre nell'ispettore (vedere Commenti).

Stato di tracciabilità

Un punto dopo i badge di ogni requisito ne mostra lo stato di tracciabilità:

  • Verde: il requisito è satisfied by qualcosa (allocato) e verified by qualcosa.
  • Ambra: manca uno dei due.
  • Rosso: non esiste nessuno dei due collegamenti.

Puntare sul punto per lo stato e ciò che manca, per esempio “Stato di tracciabilità: Parzialmente tracciato. Manca: nessun collegamento verified by (non verificato).” Fare clic su di esso per un menu con gli elementi sotto Satisfied by (allocazione) e Verified by (fare clic su uno per aprirlo), Apri nella RVTM e Collega a ▸. Gli Statement e le altre classi non hanno il punto. In una baseline i punti mostrano i collegamenti della baseline. Disattivare i punti con Vista ▾ → Stato di tracciabilità.

Trovare gli acronimi

Controlla ▾ → Trova acronimi… trova gli acronimi nei numeri, nei nomi e nelle descrizioni del documento e li aggiunge alla sua sezione Glossary, in un unico elenco di revisione.

  • Un acronimo è formato da due o più maiuscole, fino a otto caratteri, e non solo cifre.
  • L'espansione proviene dalla voce già presente nel progetto, oppure dalle parole accanto al termine le cui iniziali lo compongono (“Concept of Operations” → CONOPS).
  • Ogni riga ha Mantieni, il Termine, l'Espansione e le sue Occorrenze (fare clic su “N occorrenze” per vedere ogni punto in cui compare). Una nota contrassegna i termini già “nel Glossario”, con una “voce presente nel progetto”, o con “nessuna espansione trovata”.
  • I termini con un'espansione non ancora nel Glossario partono spuntati. La casella nell'intestazione spunta o toglie la spunta a tutti.
  • Collegare ogni occorrenza nel testo alla relativa voce del glossario (valore dinamico) (attivo) trasforma ogni occorrenza nelle descrizioni in un valore dinamico del numero della voce, collegato alla voce.

Fare clic su Aggiungi al glossario. Ogni termine spuntato diventa uno Statement con l'etichetta Acronym con Number = termine e Name = espansione, sotto la sezione di primo livello Glossary del documento (viene usata una sezione esistente chiamata Glossary o Acronyms; altrimenti ne viene aggiunta una alla fine). Una voce già presente nel progetto viene riutilizzata invece di crearne una seconda. Un solo annullamento revoca tutto. Se non si trova nulla compare “Nessun acronimo in questo documento. Gli acronimi sono parole con due o più lettere maiuscole, come CONOPS.”; se non è spuntato nulla, “Spuntare almeno un termine.” La rinumerazione lascia invariate le voci del glossario.

Menu Consegna

Consegna ▾ imposta il deliverable e lo esporta, raggruppato per output:

ElementoChe cosa fa
Impostazione del deliverable…Numerazione, frontespizio, intestazione corrente e blocco firme (vedere Impostazione del deliverable).
Imposta pagina…Marcatura, copertina e numeri di pagina (vedere Formato pagina).
Modello Word ▸I modelli Word, con un ✔ su quello usato da questo documento, e Modifica modelli Word…. Sceglierne uno lo rende il modello di questo documento.
Versione ▸Salva baseline… e Confronta versioni… (vedere Baseline).
Word: un {template} (Word) per modello WordScarica subito il documento in Word con le opzioni di quel modello; il modello del documento stesso mostra “questo documento”. Da una baseline, l'output è la baseline.
Struttura (Word)…La struttura come titoli, facoltativamente con un sommario.
Redline (Word)…Vedere Redline. Richiede una baseline.
Excel: Matrice di tracciabilità…Una matrice standard come Excel, Word, CSV o pagina web (vedere Generazione di documenti).
Modifiche (Excel)…Modifiche da una baseline a una successiva o alla versione corrente. Richiede una baseline.
Scambio: Requisiti (ReqIF)…, Dati del documento (JSON)…Formati di scambio (vedere Report).
Stampa o PDF…Vedere Stampa / PDF.
Tutte le esportazioni…Ogni esportazione con le sue opzioni (vedere Report).

Modelli Word

Un modello Word è un insieme con nome di opzioni di esportazione Word e della pagina. Dà forma al file Word, non al contenuto (i modelli di documento riempiono il contenuto; vedere Modelli). Ogni documento ne usa uno; il predefinito è Specifica. Sceglierlo in Consegna ▾ → Modello Word ▸.

Modelli predefiniti:

ModelloOpzioni
SpecificaSommario fino al livello 3, didascalie numerate, elenchi delle figure e delle tabelle, cronologia delle revisioni e approvazioni dalle baseline, documenti collegati come appendici. Colonne di attributi quando il documento ne mostra.
Deliverable per capitoloCome Specifica, con didascalie numerate per capitolo (Figura 3-1) e i titoli all'interno delle descrizioni nel sommario.
Copia di revisionePagine orizzontali con le colonne di attributi del documento sotto ogni elemento; sommario fino al livello 2, nessuna tabella iniziale.
SempliceTitolo, titoli e testo: niente sommario, numeri delle didascalie o tabelle iniziali.

Tutti i modelli predefiniti usano pagine Letter.

Modifica modelli Word… apre Modelli Word. I modelli predefiniti hanno Copia; una copia diventa un modello di progetto, conservato nel progetto per ogni membro. Selezionare un modello di progetto per cambiare:

  • Nome, Formato pagina (Letter (8,5 × 11 in) o A4 (210 × 297 mm)) e Orientamento (Verticale o Orizzontale).
  • Sommario (Nessuno, Livello 1, Livelli 1–2, Livelli 1–3, Livelli 1–4, Ogni livello) e Numeri delle didascalie (Figura 1, Tabella 1, Per capitolo: Figura 3-1 o Disattivato).
  • Elenco delle figure ed elenco delle tabelle (quando ci sono didascalie), I titoli all'interno delle descrizioni compaiono nel sommario, Le colonne di attributi mostrate nel documento, sotto ogni elemento, Documenti collegati come appendici e Cronologia delle revisioni e approvazioni dalle baseline.
  • Elimina modello.

Fare clic su Salva (un solo annullamento revoca il salvataggio; il messaggio indica “Modelli Word salvati.”). Un documento il cui modello è stato eliminato torna a Specifica.

File Word aziendali

Un modello di progetto può contenere il file Word della propria organizzazione (.docx o .dotx, fino a 5 MB). L'esportazione usa allora del file:

  • Stili: caratteri, colori, stili dei titoli e del corpo. Gli stili mancanti nel file (didascalie, voci del sommario) vengono aggiunti; la numerazione dei titoli del file viene scartata, perché è Holarch a numerare i titoli.
  • Pagina: formato, orientamento e margini. La scelta del file imposta di conseguenza Formato pagina e Orientamento del modello.
  • Intestazioni e piè di pagina, con i loro loghi e numeri di pagina. A ciascuno viene aggiunta la marcatura del progetto o del documento.
  • Frontespizio: il contenuto del file prima della sua prima interruzione di sezione, oppure l'intero file se non ne ha. Sostituisce il frontespizio di Holarch.

Nel frontespizio e nelle intestazioni e piè di pagina vengono compilati questi segnaposto: {{Title}}, {{Type}}, {{Number}}, {{Version}}, {{Date}}, {{Project}}, {{Organization}}, {{Contract}}, {{CDRL}}, {{Prepared For}}, {{Prepared By}} e {{Baseline}}. Maiuscole e spazi non contano. Il resto del testo tra parentesi graffe resta com'è.

Per aggiungerne uno:

  1. Scegliere Consegna ▾ → Modello Word ▸ → Modifica modelli Word….
  2. Fare clic su Scegli… nella riga File Word aziendale, oppure selezionare un modello di progetto e fare clic su Scegli… sotto File Word aziendale.
  3. Scegliere il file. Fare clic su Salva.

Sostituisci… cambia il file e Rimuovi torna agli stili e al frontespizio di Holarch. Un file che non è un documento Word viene rifiutato con “Il file non è un documento Word (.docx o .dotx).” Il contenuto che rimanda all'esterno del documento viene escluso: immagini collegate, oggetti e controlli incorporati, e i campi INCLUDETEXT, INCLUDEPICTURE, DDE, LINK e IMPORT. Le macro non vengono mai lette.

La pagina del modello imposta anche la larghezza della vista Carta: le pagine Letter sono larghe 816 px, le A4 794 px, di più in orizzontale. In Tutte le esportazioni… → Documento (Word), le opzioni partono dal modello del documento; lì Modello Word le compila da un altro modello, ed è possibile cambiarle per una singola esportazione.

Menu Vista

Vista ▾ contiene interruttori diretti per questo documento:

  • Carta (✔ quando attiva): mostra il documento come pagine, larghe quanto la pagina del modello Word, senza colonne di attributi. I Requirements Document partono con l'opzione disattivata; gli altri tipi con l'opzione attiva.
  • Riquadro struttura: mostra o nasconde il riquadro della struttura.
  • Stato di tracciabilità: mostra o nasconde i punti dello stato di tracciabilità. Attivo per impostazione predefinita.
  • Colonne ▸ (inattivo nella vista Carta): ogni attributo delle classi del documento e i campi dell'elemento (Classe, Numero, Creato il, Modificato il, Etichette), con un ✔ sulle colonne mostrate. Sceglierne una per mostrarla o nasconderla; una nuova colonna va alla fine. Colonne predefinite ripristina Status, Verification Method e Punteggio di qualità.
  • Comprimi tutto, ed Espandi tutto quando qualcosa è compresso.
  • Comprimi i figli: comprime le sezioni sotto l'elemento selezionato (inattivo finché non è selezionato un elemento con sottosezioni).
  • Reimposta vista: cancella compressione, filtri, ordinamento e ricerca. Mostra inoltre il riquadro della struttura alla larghezza predefinita, reimposta le larghezze delle colonne e ripristina le colonne predefinite.
  • Apri in ▸: apre l'elemento selezionato, o il documento quando non è selezionato nulla, in un'altra vista: Vista elemento, Cronologia… (ogni modifica registrata, con un confronto per parole per campo), i diagrammi che possono mostrarlo, Matrice di tracciabilità (il documento come asse delle righe), Qualità dei requisiti (limitata al documento) e Analisi funzionale.
  • Guida.

Fare clic con il tasto destro sull'intestazione di una colonna per Sposta a sinistra, Sposta a destra e Nascondi colonna.

Le colonne vengono ricordate per documento in questo browser. L'ultima scelta è il punto di partenza per i documenti non ancora configurati. Carta e Stato di tracciabilità vengono salvati con il documento. La posizione di scorrimento orizzontale resta invariata quando si seleziona una riga.

Baseline

Versione ▾ nel cartiglio elenca Versione corrente, le baseline di questo documento e, sotto Baseline del progetto, le baseline del progetto (ciascuna con la sua data; un ✔ indica quella mostrata). Termina con Salva baseline… e Confronta versioni…. Consegna ▾ → Versione ▸ contiene gli stessi due comandi.

Creare una baseline

  1. Fare clic su Versione ▾ → Salva baseline… (disattivato mentre è mostrata una baseline: “Tornare prima alla versione corrente”).

    Salva baseline si apre con la nota “La baseline conserva questa versione del documento (i suoi elementi, i loro attributi e le relazioni) per visualizzarla, confrontarla e ripristinarla in seguito. I record di approvazione vengono datati ora e non possono essere modificati in seguito.”

  2. Inserire il Nome (obbligatorio). Il valore predefinito è “{document} Baseline N”.
  3. In Approvazioni, compilare una riga per approvatore: Nome, Ruolo e Dichiarazione. La prima riga è precompilata con il proprio nome. La dichiarazione predefinita è “Approvato per il rilascio.”
  4. Fare clic su + Aggiungi approvatore per altre righe, o su × per rimuoverne una. Le righe senza nome vengono ignorate.
  5. Fare clic su Crea.

    Il messaggio indica “Baseline salvata”.

Visualizzare una baseline

Scegliere una baseline in Versione ▾. Il banner riporta “Baseline “{name}”, sola lettura, salvata il {date}” (con “· baseline del progetto” per una baseline del progetto), con gli approvatori. Offre:

  • Torna alla versione corrente: torna alla copia di lavoro.
  • Modifica (baseline del documento): apre Modifica baseline. Rinominare la baseline, o aggiungere record di approvazione in Aggiungi approvazioni. “I nuovi record vengono datati ora e aggiunti all'elenco. I record esistenti non possono essere modificati.”
  • Confronta con la versione corrente (baseline del documento): apre Confronta versioni a partire da questa baseline.
  • Ripristina baseline: chiede “Sovrascrivere le entità, l'ordine e la struttura di questo documento con la baseline “{name}”? Le entità aggiunte nel frattempo vengono rimosse dal documento (non eliminate). È possibile annullare.”
    • Per una baseline del progetto apre Sostituisci il progetto con la baseline: “Sostituire l'intero progetto con la baseline del progetto “{name}”? È possibile annullare.”
  • Elimina: chiede “Eliminare la baseline “{name}”?”

In una baseline, la modifica, l'aggiunta rapida e gli strumenti di struttura sono disattivati, e la struttura mostra 🔒. Consegna ▾ produce gli output dalla baseline (“Esporta (baseline “{name}”)”).

Il contenuto dinamico in una baseline mostra il modello della baseline, sullo schermo e negli output: valori dinamici, conteggi e totali, tabelle dinamiche, matrici e riferimenti incrociati vengono risolti rispetto all'istantanea, e le figure dei diagrammi conservano le immagini memorizzate con la baseline. Una baseline del documento contiene il documento, i suoi elementi e le entità a una relazione di distanza, quindi un conteggio o una tabella al suo interno copre quelle entità; un valore dinamico di un'entità esterna alla baseline mostra il suo valore attuale.

Confrontare le versioni

Versione ▾ → Confronta versioni… apre Confronta versioni. Confronta Da (una baseline) con A: una baseline successiva o la Versione corrente. Senza baseline mostra “Questo documento non ha baseline. Salvarne prima una.”

Elenca “N modifiche”, con Numero, Nome, Tipo di modifica, Campo e Modifica. Per il testo modificato, Modifica mostra un confronto parola per parola.

Tipi di modifica:

  • Aggiunto e Rimosso.
  • Modificato: il campo è Name, Number, Description, Class, Image o un qualsiasi attributo.
  • Etichetta aggiunta ed Etichetta rimossa.
  • Relazione aggiunta, Relazione rimossa e Attributo della relazione.

Modifiche (Excel) lo scarica con Number, Name, Class, Change Type, Field, Old Value e New Value. Redline (Word) scarica lo stesso confronto come redline di Word (vedere Redline).

Report

Consegna ▾ esporta il documento in Word, PDF, fogli di calcolo e altri formati. Le voci {template} (Word) vengono scaricate subito (vedere Modelli Word); ogni voce Word ha una descrizione di una riga sotto il nome. Elimina documento…, alla fine del menu, elimina il documento, facoltativamente con le sezioni non usate da altri documenti (vedere L'elenco dei documenti), poi torna all'elenco. Struttura (Word)…, Redline (Word)…, Modifiche (Excel)…, Requisiti (ReqIF)…, Dati del documento (JSON)… e Stampa o PDF… aprono la finestra Esporta con quella scelta; Tutte le esportazioni… la apre con l'ultima scelta.

  1. Fare clic su Consegna ▾ → Tutte le esportazioni….

    Si apre Esporta.

  2. Scegliere cosa esportare in Esporta come. Le scelte si chiamano “<contenuto> (<formato>)” e sono raggruppate per output: Word, Excel, CSV, Pagina web, Testo, Scambio e Stampa.
  3. Impostarne le opzioni.
  4. Modificare il Nome del file (fino a 99 caratteri).
  5. Fare clic su Esporta.

Anteprima mostra le prime 60 righe dei report in foglio di calcolo. Per le altre esportazioni mostra “L'anteprima mostra solo le esportazioni in foglio di calcolo. Scegliere un'esportazione Excel.” I report usano i numeri del documento e, in una baseline, il contenuto della baseline.

RapportoOutputOpzioni
Documento (Word)Il documento in Word (vedere Output Word)Modello Word (quello del documento; sceglierne un altro compila da esso le opzioni sottostanti), Aggiungi un sommario, Profondità del sommario da 1 a 6, Numeri delle didascalie (Figura 1, Tabella 1, Per capitolo: Figura 3-1, Tabella 3-1 o Disattivato), Elenco delle figure ed elenco delle tabelle (quando il documento ha didascalie), I titoli all'interno delle descrizioni compaiono nel sommario, Includi le colonne di attributi mostrate nel documento, Aggiungi i documenti collegati come appendici, Compilare le tabelle Cronologia delle revisioni e Approvazioni dalle baseline. I valori predefiniti provengono dal modello; con Specification: sommario fino al livello 3, numeri semplici delle didascalie, elenchi, colonne se mostrate, appendici e tabelle delle baseline attivi, titoli disattivati. Il formato e l'orientamento della pagina sono quelli del modello.
Modifiche (Excel)Ogni elemento, attributo e relazione aggiunto, rimosso o modificato tra due versioniDa (una baseline, la più vecchia selezionata per prima), A (Versione corrente o una baseline); “Questo documento non ha baseline. Salvarne prima una.” se non ce n'è nessuna
Tabella (CSV)Una riga per elementoAttributi (in ordine di colonna) (predefiniti Number, Name, Description e le colonne visualizzate; anche qualsiasi Relazione: {name}, che elenca gli elementi correlati), Ordina per Gerarchico, Numero o Nome
Commenti (Excel)Una riga per commento sul documento e sui suoi elementi, con l'autore del commentoIncludi classe, nome, numero e descrizione, Data, Risolto (tutti attivi)
Dati del documento (JSON)Il documento per la reimportazioneEntità direttamente correlate (disattivato), Commenti (attivo), Baseline (disattivato), Cronologia (disattivato)
Struttura (Word)Solo titoli, numeratiAggiungi un sommario (disattivato)
Documento (Markdown)Il documento come titoli e testo Markdownnessuna
Documento (Stampa o PDF)La finestra di stampa del browser; scegliere lì Salva come PDFnessuna
Redline (Word)Il documento con le revisioni di Word (vedere Redline)Dalla baseline (la più recente), Destinazione (una baseline successiva o Corrente)
Rilievi di qualità (Excel)Nove righe per requisito (una per criterio) con il messaggio e un Sì verde o un No rosso, e un “Punteggio del report” finaleAltri attributi, Includi Created On, Modified On e Global ID
Requisiti (ReqIF)ReqIF XML con la gerarchia e i collegamenti traced to, satisfied by, verified by, satisfies, verifies e traced from all'interno del documentonessuna
RSM (Excel)Requirement → elementi satisfied byAttributi dei requisiti (Number, Name), Attributi delle entità correlate (Class, Number, Name, Description)
RTM (Excel)Requirement → elementi traced tocome RSM
RVM (Excel)Requirement → elementi verified bycome RSM
RVTM (Excel)Requirement → Test Case che lo verificano, con ogni riga del documento inclusaAttributi dei requisiti (Number, Name, Description, Verification Method(s)), Attributi di Test Case (Number, Name, Description, Status)
TVM (Excel)Test Case nel documento → i requisiti che verificanoAttributi di Test Case (Number, Name, Status), Attributi dei requisiti (Number, Name, Description)
VCRM (Excel)Requisiti × metodi di verifica con una XAttributi dei requisiti (Number, Name), Metodi di verifica (tutti)
Matrice di tracciabilità (Excel), (Word), (CSV), (HTML)Una matrice standard del documento o dell'intero progetto (vedere Generazione di documenti)Matrice, Ambito (Questo documento o Intero progetto)

Nei report a matrice:

  • Un requisito senza elementi collegati è ombreggiato in rosso. Nella VCRM, un requisito senza metodo è ombreggiato in rosso.
  • Le celle del requisito vengono unite sulle sue righe correlate.
  • Le due righe di intestazione sono bloccate.

Output Word

Documento (Word) crea un file Word in questo ordine:

  1. Il frontespizio (con Copertina attiva in Imposta pagina, o Frontespizio in Impostazione del deliverable), oppure il titolo e una riga in corsivo con il tipo e “N. {number}”. Da una baseline, la riga aggiunge “Baseline: {name} ({date})”. Un avviso di marcatura (Imposta pagina) compare in un riquadro sotto il titolo.
  2. Cronologia delle revisioni (Versione, Data, Autore, Modifiche): una riga per baseline del documento, dalla più vecchia, fino alla baseline esportata.
    • La prima riga riporta “Baseline iniziale”. Le righe successive riportano “N aggiunti, N rimossi, N modificati” o “Nessuna modifica”.
    • L'autore è chi ha creato la baseline o i suoi approvatori.
  3. Approvazioni (Ruolo, Nome, Dichiarazione, Data), dalla baseline più recente (o esportata). Senza record di approvazione, gli approvatori pianificati in Impostazione del deliverable ricevono un blocco firme: Ruolo, Nome, Firma e Data con righe vuote da firmare.
  4. La descrizione del documento, poi il sommario, l'Elenco delle figure e l'Elenco delle tabelle, e un'interruzione di pagina.
  5. Ogni elemento come titolo Word con il suo numero e nome, poi la sua descrizione. Da Titolo 1 a Titolo 6 seguono la profondità; i livelli più profondi restano a Titolo 6. Una tabella Attributo/Valore elenca le colonne scelte che hanno un valore.
  6. Appendici: ogni documento collegato da un link incorporato inizia su una nuova pagina con “{document} Appendice” e il suo contenuto, un livello più in basso.

Le tabelle generate possono andare in una sezione invece che all'inizio. Questo avviene quando il documento ha una sezione con uno di questi nomi (i modelli integrati li usano):

  • Cronologia delle revisioni: “Revision History” o “Document Revision History”.
  • Approvazioni: “Approvals”, “Approval”, “Sign-off”, “Signoff”, “Signatures” o “Signature”.

Didascalie, elenchi e riferimenti incrociati

  • Le didascalie delle figure (la didascalia di un'immagine, una figura di diagramma) riportano “Figura 1: {caption}” sotto l'immagine. Le didascalie delle tabelle (il titolo di un blocco matrice, la didascalia di una tabella) riportano “Tabella 1: {caption}” sopra la tabella.
  • Per capitolo le numera per sezione di primo livello: “Figura 3-1” è la prima figura della sezione 3. Le tabelle senza didascalia non vengono numerate.
  • I numeri sono campi SEQ di Word, e l'Elenco delle figure e l'Elenco delle tabelle sono campi Word sulle didascalie. Compaiono solo quando il documento ha didascalie di figure o tabelle. Finché Word non aggiorna i campi, gli elenchi mostrano le didascalie senza numeri di pagina.
  • Ogni titolo, didascalia di figura e didascalia di tabella ha un segnalibro. Un riferimento incrociato in una descrizione diventa un campo REF di Word verso il segnalibro, quindi mostra il titolo corrente (“3.2 Frost Warning”) o l'etichetta (“Figura 2-1”) dopo che Word ha aggiornato i campi. Un riferimento incrociato a un elemento che non è nel documento esportato mantiene il suo testo.
  • I titoli all'interno delle descrizioni compaiono nel sommario trasforma i titoli di una descrizione in veri titoli Word un livello sotto l'elemento. Se disattivato, restano paragrafi in grassetto.

Impostazione del deliverable

Consegna ▾ → Impostazione del deliverable… contiene i dati che un deliverable contrattuale di solito mostra. Applica li salva; ⌘Z / Ctrl+Z li annulla in un solo passaggio.

CampoDove compare
NumerazioneNumeri del modello (i numeri propri degli elementi) (predefinito) o Numeri del documento (conservati solo in questo documento) (vedere Numerazione del documento).
FrontespizioAttiva il frontespizio (lo stesso interruttore di Copertina in Imposta pagina).
Versione, Redatto daFrontespizio e intestazione corrente (gli stessi campi di Imposta pagina).
Organizzazione, Redatto per, Numero di contratto, Voce CDRL, Numero DIDFrontespizio. La voce CDRL compare anche nel piè di pagina corrente.
LogoIn cima al frontespizio. PNG, JPEG o GIF, fino a 400 KB.
Avviso del frontespizioUn riquadro in fondo al frontespizio, per esempio una dichiarazione di distribuzione. Vuoto: l'avviso di marcatura di Imposta pagina.
Intestazione e piè di pagina correntiAttivi per impostazione predefinita. L'intestazione mostra “{number}, Versione {version}” e il titolo; il piè di pagina mostra la data, “Pagina X di Y” e “CDRL {item}”. Richiede un numero di documento o una versione.
Approvatori pianificatiRuolo e nome per approvatore. Ricevono righe per la firma finché una baseline non registra le approvazioni.

Il numero del documento è il campo N. accanto al titolo del documento.

Formato della pagina

  • La pagina del modello Word: US Letter o A4, verticale o orizzontale, con margini superiore e inferiore di 1 pollice e margini laterali di 0,875 pollici.
  • Calibri 11 pt.
  • Veri stili di titolo, così il riquadro di spostamento e il sommario di Word funzionano.
  • Le righe di intestazione delle tabelle sono ombreggiate e ripetute su ogni pagina.
  • I banner di pagina (marcature) si ripetono nell'intestazione e nel piè di pagina di ogni pagina, frontespizio incluso.
  • Con un frontespizio, il file ha tre sezioni: il frontespizio (solo banner, senza intestazione corrente e senza numero di pagina), le parti preliminari (cronologia delle revisioni, approvazioni, descrizione, sommario ed elenchi, numerate i, ii, iii) e il corpo (numerato da 1; “Pagina X di Y” conta il corpo).
  • Word chiede di aggiornare i campi quando apre il file. Fino ad allora, il sommario mostra “Fare clic con il tasto destro e scegliere Aggiorna campo per creare il sommario.”

Conversione del testo formattato

  • Conservati: grassetto, corsivo, sottolineato, barrato, apice, pedice, codice in linea (Consolas), evidenziazione, colore del testo e link web.
  • I titoli all'interno delle descrizioni diventano paragrafi in grassetto, o titoli Word con l'opzione sopra.
  • Gli elenchi diventano paragrafi rientrati con “•” o “1.”.
  • I blocchi di codice diventano righe a spaziatura fissa ombreggiate. Le citazioni diventano corsivo rientrato.
  • Le tabelle mantengono le colonne unite e l'ombreggiatura delle intestazioni.
  • Le immagini PNG, JPEG e GIF vengono incorporate, larghe fino a circa 6,5 pollici, con il loro testo alternativo come descrizione dell'immagine. Le immagini SVG e WebP vengono escluse dai file Word.

Redline

Consegna ▾ → Redline (Word)… scrive il documento con le revisioni di Word. Scegliere la Dalla baseline e la Destinazione (una baseline successiva o Corrente). Redline (Word) in Confronta versioni fa lo stesso per le due versioni mostrate lì.

  • Il file inizia con una tabella Riepilogo delle modifiche: ogni modifica del report delle modifiche, inclusi attributi, etichette e relazioni.
  • Poi il documento alla versione di destinazione: un elemento aggiunto è un inserimento revisionato; un elemento rimosso è un'eliminazione revisionata, posta dopo l'elemento che lo precedeva; un nome o una descrizione modificati mostrano le parole eliminate e inserite.
  • Accettare o rifiutare le modifiche nella scheda Revisione di Word. Le descrizioni modificate compaiono come testo semplice; quelle invariate mantengono la loro formattazione.
  • Le modifiche sono attribuite a chi ha creato la baseline di destinazione, o al proprio nome per Corrente.

Stampa o PDF… stampa la pagina del documento con il browser. I banner vengono stampati in cima e in fondo a ogni pagina. Con un'intestazione corrente (Impostazione del deliverable), “{number}, Versione {version}” e il titolo si ripetono in cima a ogni pagina, e la data e la voce CDRL in fondo. In una raccolta ogni parte inizia su una nuova pagina. I numeri di pagina, il sommario e i numeri delle didascalie sono solo nell'output Word.

Commenti

Commentare un elemento nel suo pannello dell'entità nell'ispettore (la parte Discussione). Controlla ▾ → Commenti, o 💬 n commenti aperti nel cartiglio, mostra i commenti nell'ispettore:

  • Ogni commento sul documento e sui suoi elementi, raggruppato per elemento, con “(N aperti)”. Le risposte sono rientrate sotto il commento a cui rispondono. Fare clic sul nome di un elemento per selezionarlo.
  • Mostra risolti include i commenti risolti.
  • Ogni discussione ha Risolvi/Riapri sul primo commento, e ogni commento ha × (elimina).
  • Per commentare il documento stesso, digitare in Commenta questo documento… e fare clic su Aggiungi commento.
  • × in alto chiude i commenti; selezionando un elemento si mostra invece il suo pannello dell'entità.
  • Una riga con commenti non risolti mostra 💬 n; fare clic per aprire la discussione dell'elemento.
  • Risolvere, riaprire ed eliminare i commenti in entrambi i punti.
  • Commenti (Excel) in Tutte le esportazioni… li raccoglie.

Vedere Commenti e revisioni.

Raccolte

Una raccolta assembla altri documenti. Quelle nuove create nella pagina Revisioni o con Crea pacchetto di revisione hanno l'etichetta Pacchetto di revisione; i pacchetti creati in precedenza hanno l'etichetta Raccolta e funzionano allo stesso modo. Vedere Revisioni.

Inserisci documento… aggiunge un documento. Si trova in Scrivi ▾ → Inserisci ▸ e nel menu + Nuovo ▾.

  • Elenca i documenti non ancora inclusi.
  • Il documento inserito compare come elemento di primo livello, con il proprio contenuto sotto di esso. Il messaggio riporta “Inserito {document}”.
  • Senza altri documenti, compare “Nessun altro documento da inserire.”

Sezioni generate

Inserisci sezione generata… (in Scrivi ▾ → Inserisci ▸ e nel menu + Nuovo ▾) aggiunge una parte il cui contenuto viene ricostruito dal modello ogni volta che la raccolta viene mostrata o esportata.

ContenutoChe cosa contiene la parte
Matrice o Test Report…Inserisci apre Inserisci matrice; scegliere lì la matrice (o un Test Report) e il suo ambito. L'ambito Raccolta (tutte le parti) copre ogni parte. Lasciare vuoto Nome della sezione per usare il nome della matrice.
Elenco degli acronimiUna tabella degli Statement con l'etichetta Acronym (Number, Name), ordinata per numero.
Tabella di queryUna tabella delle entità che corrispondono a Query, con le Colonne elencate (nomi di attributi, separati da virgole).

La parte viene numerata dopo l'ultima parte, così i documenti delle parti mantengono i loro numeri. ⌘Z / Ctrl+Z la rimuove in un solo passaggio. Senza nome compare “Inserire un nome per la sezione.”; una tabella di query senza query o senza colonne mostra “Inserire una query e almeno una colonna.”

Raccolta in Word

L'esportazione Word di una raccolta esporta ogni elemento di primo livello come parte:

  • Il titolo della parte riporta “Parte A: {document}” (Titolo 1), con una riga per il tipo di documento, il numero e la baseline fissata.
  • I numeri di sezione all'interno di una parte ricevono la lettera della parte: “A.1 Scope”, “B.1 Scope”. Nessun numero di sezione si ripete.
  • Ogni parte dopo la prima inizia su una nuova pagina.
  • Con le didascalie Per capitolo, le figure della Parte B riportano “Figura B-1”.

Impostazione del deliverable… in una raccolta aggiunge Parti della raccolta:

ImpostazioneScelte
Etichette delle partiParte A, Parte B, … (predefinito), Volume 1, Volume 2, …, Appendice A, Appendice B, … o Nessuna etichetta di parte
Numeri di sezionePer parte, con la lettera o il numero della parte (A.1, B.1) (predefinito), Continua tra le parti (1, 2, 3) o Ogni documento mantiene i propri numeri
Iniziare ogni parte su una nuova paginaAttivo per impostazione predefinita
Frontespizio per ogni parteIl titolo della parte e la sua riga su una pagina a sé
Esportare ogni parte daCorrente, o una delle baseline del documento della parte. Una parte fissata mostra 📌 e il nome della baseline nella sua riga, ed esporta il contenuto di quella baseline.

Strumenti IA

✦ IA ▾ nella barra superiore elenca gli strumenti di IA per la selezione e il documento. Ogni risultato dell'IA viene prima mostrato in anteprima, e un solo annullamento revoca tutto. In una baseline gli strumenti sono disattivati. Vedere IA.

  • Per un Requirement o uno Statement selezionato: Riscrivi in modo chiaro…, Aggiungi criteri misurabili… (requisiti), Semplifica…, Suddividi requisito composto…, Bozza della motivazione…, Suggerisci nome…, Controlla con l'IA (questo requisito)…, Genera requisiti figli… e Genera caso di test… (requisiti).
  • Per qualsiasi elemento selezionato: Genera rischi….
  • Per il documento: Genera requisiti…, Riepiloga documento…, Traduci documento… e Controlla con l'IA (N requisiti)….

Scorciatoie da tastiera

TastiAzione
⌘F / Ctrl+FTrovare nel documento
Enter / Shift+EnterCorrispondenza successiva / precedente (nella casella di ricerca)
⌘↵ / Ctrl↵Aggiungere un elemento dopo quello selezionato
⌥⌘↵ / Ctrl+Alt↵Aggiungere un figlio dell'elemento selezionato
⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+←Aumentare / ridurre il rientro dell'elemento selezionato
⌥ / Alt+↑ / ⌥ / Alt+↓Spostare l'elemento selezionato in su / in giù
↑ / ↓Selezionare la riga precedente / successiva; lo stato attivo si sposta con essa
TabCampo successivo: la riga selezionata, poi il suo numero, nome e descrizione
Enter / F2Su una riga, modificarne il nome; su un numero, nome o descrizione, modificarlo
Delete o BackspaceRimuovere gli elementi selezionati dal documento (Annulla nel messaggio)
⇧Delete / Shift+DeleteEliminare gli elementi selezionati e i loro figli, dopo una conferma
EscDeselezionare; nella casella di ricerca, cancellare la ricerca
Enter / EscSalvare / annullare la modifica di un numero o di un nome (lo stato attivo resta sul campo)
↑ ↓ Home End nella strutturaSpostarsi tra gli elementi della struttura
→ / ← nella strutturaEspandere / comprimere un elemento, o andare al suo primo figlio / al suo padre
Enter / Space nella strutturaAprire l'elemento nel documento (lo stato attivo passa alla sua riga) / selezionarlo
⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+ZAnnullare / ripetere (fuori da un editor)

Su Windows e Linux usare Ctrl per ⌘ / Ctrl e Alt per ⌥ / Alt. Le scorciatoie di riga funzionano quando nessun campo ha lo stato attivo. ⌘↵ / Ctrl↵ e ⌥⌘↵ / Ctrl+Alt↵ funzionano anche durante la modifica di un numero o di un nome. Vedere Scorciatoie da tastiera e i tasti del testo formattato sopra.

Impostazioni memorizzate in questo browser

Conservati in questo browser:

  • Se il riquadro della struttura è nascosto, e la sua larghezza.
  • Le colonne e le larghezze delle colonne per documento.
  • L'ordinamento dell'elenco.
  • La classe corrente per i nuovi elementi.
  • L'ultimo tipo di report.
  • I modelli salvati prima della versione 1.8.0, finché non vengono importati in un progetto.

Salvati con il documento e condivisi con tutti i membri del progetto: Carta, Stato di tracciabilità, il modello Word, la numerazione del documento, lo schema di numerazione e il primo numero, e la rinumerazione automatica. I modelli Word del progetto vengono salvati con il progetto.

Messaggi

MessaggioSignificato e soluzione
Nessun documento / “Creare un documento con + Nuovo documento, o importare Word, Excel, CSV o ReqIF con Importa.”Il progetto non ha ancora documenti.
“Nessun documento corrisponde. Cancellare la ricerca o scegliere Tutti.”Cancellare Cerca documenti… o fare clic su Tutti.
Documento non trovatoL'indirizzo punta a un documento eliminato. Usare Torna ai documenti.
Questo documento è vuoto / “Aggiungere un requisito con “+ Nuovo requisito”, o compilare il documento da un modello con Scrivi → Applica modello….”Aggiungere elementi o applicare un modello.
“Nessun elemento corrisponde al filtro. Cancellare il filtro per vedere tutti gli elementi.”Modificare o cancellare i chip di classe ed etichetta.
Vista filtrata: la modifica è disattivata. Cancella il filtro / “Cancellare il filtro o l'ordinamento per aggiungere entità”La creazione è sospesa; fare clic sull'avviso per cancellare.
“Digitare prima il testo.”L'aggiunta rapida è stata inviata vuota.
“L'entità selezionata non può spostarsi oltre in quella direzione.”L'elemento è il primo o l'ultimo, bloccato, o accanto a un elemento bloccato.
“Un'entità non può andare sotto il proprio figlio. Scegliere un altro padre.”Scegliere una destinazione fuori dal sottoalbero dell'elemento.
Non aggiornato (colonna Quality Score)Il testo è cambiato dopo l'ultimo controllo di qualità. Eseguirlo di nuovo.
“Impossibile caricare i modelli di documento.”Il catalogo dei modelli non è stato caricato; ricaricare la pagina.
“L'anteprima mostra solo le esportazioni in foglio di calcolo. Scegliere un'esportazione Excel.”L'anteprima funziona solo per i report Excel.
“Questo documento non ha baseline. Salvarne prima una.”Creare una baseline prima di eseguire i report delle modifiche.
“Esportazione non riuscita: … Controllare il modello Word, poi esportare di nuovo.”Un'esportazione Word con un clic non è riuscita; controllare il modello in Modifica modelli Word….
“L'immagine supera il limite di N MB.” / “Il file supera il limite di N MB.”Il file è più grande del limite per file del server.

Limiti

Limite: i nomi modificati in una riga del documento sono limitati a 200 caratteri, e i numeri a 139. L'aggiunta rapida accetta 2.000 caratteri.

Limite: le immagini vengono ridotte a 4.000 px sul lato più lungo. I file allegati e le immagini sono limitati dal limite per file del server (10 MB con il piano Free, 25 MB con Individual, 100 MB con Team) e dalla quota di archiviazione del progetto.

Limite: l'output Word incorpora solo immagini PNG, JPEG e GIF. I livelli di titolo oltre il 6 vengono mostrati come Titolo 6.

Limite: i modelli dell'organizzazione esistono sui server Holarch (ospitati o self-hosted), non nell'app desktop; l'app desktop conserva i modelli di progetto nel file del progetto. Un'organizzazione contiene fino a 200 modelli di fino a 3.000 sezioni ciascuno. I modelli salvati in un progetto non vengono proposti negli altri progetti: salvare il modello nell'organizzazione, o salvarlo di nuovo nell'altro progetto.