Controllo e revisioni
File Word e PDF come Artifact
Aggiungere documenti Word e PDF a un progetto come Artifact, rivederne e commentarne le pagine, conservare ogni versione e liberare spazio rimuovendo i file delle versioni precedenti.
In questa pagina
- Concetti
- Come usarlo
- Quando e perché
- Aggiungere file Word o PDF
- Caricare una nuova versione
- Revisionare e commentare
- Commenti sulle versioni successive
- Commenti e revisioni rilevate da Word
- Confrontare due versioni
- Esempio pratico: una revisione di progetto sulla demo CubeSat EO-1
- Suggerimenti e buone pratiche
- Errori comuni
- Come si collega
- La sezione File
- Rimuovere i file delle versioni precedenti
- File in corso di aggiunta
- Senza conversione
- Messaggi
- Limiti
- Correlati
Un documento Word o un PDF può risiedere nel progetto come Artifact. I revisori lo leggono in Holarch, ne commentano le pagine e lo approvano come qualsiasi altro elemento. Ogni nuovo caricamento dello stesso documento diventa una nuova versione, e le versioni precedenti restano leggibili.
Sul servizio ospitato, i file Word vengono trasformati in PDF quando li si aggiunge, e i PDF vengono compressi. Il PDF è ciò che tutti leggono, scaricano e commentano.
Concetti
- Artifact con file: un Artifact che contiene un file. La sua pagina ha in alto una sezione File con il visualizzatore, le versioni e gli strumenti per il file.
- Versione: un caricamento del documento. Ogni versione conserva il suo PDF, chi l'ha caricata, la data e una nota facoltativa. Per impostazione predefinita viene mostrata la versione più recente.
- Conversione: la trasformazione di un file Word in PDF e la compressione dei PDF. Viene convertito un file alla volta per tutti; i file di account diversi si alternano, così un grosso lotto non blocca gli altri.
- Commento fissato: un commento che appartiene a un punto di una versione: parole selezionate, un punto, un riquadro o un'intera pagina (oppure, nella vista Word, un paragrafo). La Discussione mostra dove si trova, per esempio “sulla versione 2, pagina 3”.
Come usarlo
Quando e perché
Usare un Artifact con file quando un deliverable è scritto al di fuori di Holarch: un pacchetto di revisione di progetto, il documento di controllo delle interfacce di un fornitore, un rapporto di test. Tenerlo nel progetto lo colloca accanto ai requisiti e agli elementi che copre. I revisori commentano in un unico posto, e le baseline registrano quale versione è stata approvata.
Aggiungere file Word o PDF
- Aprire il Database di un progetto LML.
- Fare clic su + Nuovo elemento, poi su Artifact da un file Word o PDF… sotto il campo Nome. Quando il Database mostra solo gli Artifact, il pulsante è + Nuovo Artifact e il pulsante del dialogo indica Da un file Word o PDF…. Il dialogo si chiude e si apre la selezione dei file.
Lo stesso pulsante si trova nel dialogo Nuovo elemento ovunque si apra, per esempio ⌘K / Ctrl+K → Nuovo elemento…. Si possono anche trascinare file .docx e .pdf sulla tabella del Database, oppure premere ⌘K / Ctrl+K ed eseguire Artifact da file… in qualsiasi pagina del progetto.
- Scegliere uno o più file.
Sopra la tabella compare File in corso di aggiunta, con lo stato di ogni file: “In attesa (2 prima)”, Conversione…, Compressione… o Memorizzazione….
- Attendere, o continuare a lavorare. È possibile chiudere la scheda.
Quando un file è pronto, Holarch lo comunica: “Design Review.docx è pronto come Artifact.” Se non è aperta alcuna scheda di Holarch dell'utente, il messaggio arriva via email.
Ogni file diventa un Artifact, chiamato come il file senza l'estensione. L'avviso indica la dimensione memorizzata, per esempio “Memorizzato come 2.1 MB, compresso da 15 MB.”
Caricare una nuova versione
- Aprire l'Artifact.
- Nella sezione File, fare clic su Carica nuova versione… e scegliere il file.
- Facoltativamente inserire una Nota per la nuova versione, per esempio “Commenti della revisione di progetto recepiti”, e fare clic su Carica come nuova versione.
Nella pagina compare “Nuova versione Design Review.docx: Conversione…” finché non è pronta.
Quando si aggiunge un file il cui nome corrisponde a un Artifact già creato da un file con quel nome, File già nel progetto chiede cosa fare:
- Carica come nuova versione (predefinito): il file diventa la versione successiva di quell'Artifact.
- Conserva entrambi: un Artifact separato, il cui nome riceve “ (2)”.
- Annulla: non viene aggiunto nulla.
Revisionare e commentare
- Aprire l'Artifact. Pagine mostra il PDF nel visualizzatore di documenti: una barra degli strumenti, le pagine e un pannello Commenti accanto.
- Spostarsi nel documento con la barra degli strumenti: Pagina 3 di 12 (digitare un numero di pagina e premere Enter), i pulsanti pagina precedente e successiva, Miniature, lo zoom (Adatta alla larghezza, Pagina intera o una dimensione fissa) e Trova (⌘F / Ctrl+F). Tasti: ← e → girano le pagine, Home ed End vanno alla prima e all'ultima pagina, + e − regolano lo zoom.
- Commentare in uno di quattro modi:
- Seleziona testo: selezionare parole sulla pagina (è anche possibile copiarle), poi fare clic su Commenta la selezione. Le parole vengono evidenziate.
- Punto: fare clic sul punto della pagina a cui appartiene il commento.
- Riquadro: trascinare un riquadro attorno a un'area, per esempio una figura o una tabella.
- Commenta la pagina: un commento sulla pagina mostrata, nel suo insieme.
Digitare il commento nel pannello e fare clic su Aggiungi commento (⌘Enter / Ctrl+Enter). Digitare @ e un nome per menzionare qualcuno.
- Il pannello Commenti elenca le discussioni in ordine di pagina, numerate come i loro indicatori sulla pagina. Fare clic su una discussione per andare al suo punto; fare clic su un indicatore o un'evidenziazione per aprirne la discussione. Rispondi, Risolvi e Riapri funzionano come nella Discussione; Mostra risolti mostra le discussioni risolte.
- Per avere più spazio, fare clic su Vista revisione (la versione sull'intera finestra) o Sgancia (una finestra separata, per esempio su un secondo schermo). Entrambe restano aggiornate mentre le persone commentano.
Ogni commento appartiene alla versione su cui è stato fatto, e anche la Discussione lo mostra, per esempio “sulla versione 2, pagina 3”. Commentare non modifica mai il file: un PDF firmato mantiene la sua firma.
Commenti sulle versioni successive
Quando viene aggiunta una nuova versione, le discussioni aperte si spostano su di essa, così una revisione prosegue tra le versioni:
- Holarch trova le parole di ogni discussione nella nuova versione, anche quando si sono spostate su un'altra pagina o il testo circostante è stato reimpaginato. La discussione compare lì con l'etichetta Dalla versione 1 (la versione su cui è stata fatta).
- Quando le parole sono state modificate, la discussione viene anche contrassegnata Testo modificato dopo e mostra cosa diceva la versione precedente, per esempio “La versione 1 diceva: “reject 40 W””.
- Quando le parole non ci sono più, la discussione viene elencata in Versioni precedenti alla fine del pannello Commenti, con le parole citate e Mostra sulla versione 1 (l'ultima versione che le contiene).
- Un Punto o un Riquadro segue la riga di testo più vicina. Su una pagina senza testo (un disegno o una scansione) resta dov'era quando la pagina appare uguale nella nuova versione; altrimenti va in Versioni precedenti.
- Le discussioni risolte restano sulle versioni su cui si trovavano. Riaprirne una per farla spostare sulle versioni più recenti.
- Fatto su (sopra le discussioni, quando ci sono discussioni di più di una versione) mostra solo le discussioni fatte su una versione, o tutte.
- Le discussioni provenienti da Word seguono le stesse regole.
Questo avviene quando viene aggiunta la nuova versione. I progetti con commenti precedenti a questa funzionalità ricevono lo stesso trattamento la prima volta che viene mostrata una versione più recente. Nella Discussione, un commento di una versione precedente indica dove si trova ora, per esempio “Sulla versione 1, pagina 2, “radiator” · portato alla versione 3” o “· non nella versione 3”.
I commenti conservano le parole citate, quindi restano leggibili dopo la rimozione del file di una vecchia versione. Un commento modificato conserva il testo precedente: Testo precedente sotto il commento elenca ogni formulazione precedente con chi l'ha scritta e quando.
Una baseline registra la versione del file e le sue discussioni come erano in quel momento. Fare clic sul nome della baseline in Nelle baseline per vederle.
Commenti e revisioni rilevate da Word
Sul servizio ospitato, il markup di revisione proprio di un file Word viene incluso quando lo si aggiunge:
- I suoi commenti diventano discussioni sul PDF, sulle parole su cui sono stati fatti, con le loro risposte. Ciascuno mantiene l'autore e la data di Word ed è contrassegnato Da Word. Un commento che Word ha segnato come completato arriva risolto.
- Le sue revisioni rilevate vengono elencate come suggerimenti: “Inserimento suggerito: …” o “Eliminazione suggerita: …”, a nome della persona che le ha fatte.
- Il PDF mostra i commenti a margine e le revisioni rilevate come redline.
L'avviso dopo il caricamento indica cosa è stato incluso, per esempio “3 commenti e 2 revisioni rilevate sono stati importati da Word.” Le discussioni importate appartengono a chi carica, che può risolverle o eliminarle. Le persone che osservano l'elemento non ricevono notifiche per ogni commento importato.
Confrontare due versioni
- Aprire l'Artifact. Nella sezione File, fare clic su Confronta versioni… (mostrato quando l'Artifact ha due o più versioni).
- Scegliere la versione Meno recente e quella Più recente. Per impostazione predefinita la versione mostrata viene confrontata con quella precedente.
Le due versioni compaiono affiancate, pagina per pagina:
- Le parole Inserito sono verdi sulla versione più recente.
- Le parole Eliminato sono rosse sulla versione meno recente.
- Le frasi e i paragrafi Spostato sono viola in entrambe le posizioni. Un blocco spostato e anche modificato mostra pure le modifiche alle parole. L'elenco delle modifiche indica entrambe le pagine, per esempio “Pagina 2 → pagina 5”.
- Le pagine senza testo (disegni, scansioni) vengono confrontate come immagini. Una pagina modificata viene contornata; sulla pagina più recente, Differenze mostra in rosso dove solo la versione meno recente ha inchiostro e in verde dove ce l'ha solo quella più recente.
- Selezionare una modifica nell'elenco, o fare clic su Precedente e Successiva (F7 e Shift+F7), per mostrarla su entrambi i lati. Scorrimento sincronizzato mantiene lo stesso testo affiancato durante lo scorrimento.
Il testo viene confrontato sull'intero documento, quindi il testo spostato su un'altra pagina, o reimpaginato su altre righe, viene comunque abbinato. Un file Word conservato senza conversione viene confrontato come testo, senza pagine. I documenti lunghi mostrano una barra di avanzamento durante la lettura.
Lo stesso confronto evidenzia le modifiche al testo altrove: la revisione delle richieste di modifica, la Cronologia degli elementi, le modifiche dei documenti e le differenze delle librerie mostrano le frasi spostate come spostate, con un collegamento Spostato in / Spostato da tra le due posizioni.
Esempio pratico: una revisione di progetto sulla demo CubeSat EO-1
- Nella demo CubeSat EO-1, aprire il Database, fare clic su + Nuovo elemento e aggiungere “EO-1 CDR Package.docx” con Artifact da un file Word o PDF….
- Quando è pronto, aprire EO-1 CDR Package e metterlo in relazione con i requisiti che copre.
- I revisori lo aprono e usano Commenta la pagina… per la pagina 12: “Thermal margin table is missing the eclipse case.”
- Dopo le correzioni, caricare di nuovo “EO-1 CDR Package.docx” e scegliere Carica come nuova versione, con la nota “CDR comments addressed”.
- Creare una baseline. La pagina dell'Artifact mostra Nelle baseline con il nome della baseline per la versione 2.
Suggerimenti e buone pratiche
- Caricare ogni nuova versione con lo stesso nome di file. Un solo Artifact contiene allora l'intera cronologia.
- Caricare un PDF invece di un file Word quando il layout deve corrispondere esattamente a Word: la conversione può spostare le interruzioni di riga.
- I PDF firmati, i moduli PDF, i file PDF/A e i PDF cifrati vengono conservati esattamente come caricati. Comprimerli romperebbe la firma, il modulo o la conformità.
Errori comuni
- È comparso un secondo Artifact: è stato scelto Conserva entrambi. Eliminarlo, poi caricare di nuovo il file e scegliere Carica come nuova versione.
- Un file Word di oltre 100 MB è stato rifiutato: in Word, scegliere File → Salva con nome → PDF, poi caricare il PDF.
Come si collega
- Commenti e revisioni: i commenti fissati sono commenti normali; risposte, menzioni e approvazioni funzionano come per qualsiasi elemento. Vedere Commenti e revisioni.
- Baseline: una baseline registra la versione che aveva ogni Artifact con file. Vedere Richieste di modifica.
- Archiviazione: il PDF di ogni versione conta per lo spazio del progetto e dell'utente. Vedere Allegati, archiviazione e limiti.
La sezione File
| Controllo | Che cosa fa |
|---|---|
| Versione | Mostra una versione: “Versione 3 (ultima) · data · autore del caricamento”. Le versioni il cui file è stato rimosso indicano “file rimosso”. |
| Scarica (PDF) | Salva il PDF della versione mostrata. Un file Word mostrato senza conversione offre Scarica (.docx). |
| Ripristina come più recente | Rende di nuovo più recente la versione mostrata, come nuova versione. Non viene sovrascritto nulla. Solo editor, non sull'ultima versione. |
| Carica nuova versione… | Aggiunge la versione successiva. Solo editor. |
| Confronta versioni… | Due versioni affiancate con il testo inserito, eliminato e spostato evidenziato. Vedere “Confrontare due versioni”. |
| Rimuovi i file delle versioni precedenti… | Elimina i file delle vecchie versioni scelte. Vedere sotto. |
| Pagine / Visualizzatore PDF | Il visualizzatore di documenti (pagine, Trova, commenti); oppure il visualizzatore PDF del browser (stampa). |
| Vista revisione / Sgancia | Il visualizzatore di documenti sull'intera finestra, o in una finestra separata. |
| Commenta la pagina… / Fissa un commento | Nella vista Word (un file Word conservato senza conversione): un commento su una pagina in base al suo numero, o sul paragrafo su cui si fa clic. Fare clic su Smetti di fissare per terminare. I PDF usano gli strumenti propri del visualizzatore (vedere Revisionare e commentare). |
Sotto gli strumenti, i dati della versione: Caricato (chi e quando), File caricato (il suo nome originale), Nota, Memorizzato (la dimensione e il risparmio), e Nelle baseline (fare clic sul nome di una baseline per vedere le discussioni che ha registrato).
Rimuovere i file delle versioni precedenti
I PDF delle vecchie versioni occupano spazio. Rimuovere quelli che non servono a nessuno:
- Sull'Artifact, fare clic su Rimuovi i file delle versioni precedenti….
- Selezionare le versioni.
Compare “Rimuove definitivamente i file della versione 2. La versione resta nella cronologia.”
- Fare clic su Rimuovi file.
Compare “Rimossi i file di 1 versione (liberati 12.4 MB).”
- Chi può rimuovere: il titolare dell'account su un piano personale (il proprietario del progetto), un amministratore dell'organizzazione sul piano Team. Un amministratore dell'organizzazione non necessita dell'accesso in modifica al progetto; la rimozione riporta il nome dell'amministratore.
- L'ultima versione non può essere rimossa in questo modo. Per rimuoverla, eliminare l'Artifact.
- La versione resta nell'elenco, contrassegnata “File rimosso da nome il data”. I suoi commenti restano nella Discussione come testo.
- La rimozione viene registrata nel log di audit, con le versioni e lo spazio liberato.
File in corso di aggiunta
Il Database mostra File in corso di aggiunta mentre i caricamenti sono in corso.
- Caricamento…: il file è in fase di invio. Annulla lo interrompe, e non viene aggiunto nulla.
- In attesa (n prima) o In attesa (prossimo): il file attende il suo turno. Annulla lo rimuove dalla coda.
- Conversione…, Compressione…, Memorizzazione…: il file è in elaborazione.
- Un file che non è stato possibile aggiungere resta nell'elenco con il suo messaggio finché non si fa clic su Ignora.
Se il server si riavvia durante una conversione, il file torna in coda e viene ritentato una volta.
Senza conversione
Quando il server non ha un convertitore, i file vengono memorizzati come caricati:
- I PDF vengono memorizzati senza compressione.
- I file Word vengono mostrati in sola lettura nel browser: “Mostrato in sola lettura nel browser (nessuna conversione PDF su questo server). Il layout può differire da Word.” Fissa un commento fissa allora i commenti ai paragrafi.
Messaggi
| Messaggio | Che cosa fare |
|---|---|
| “file è di 140 MB. I file Word oltre 100 MB non possono essere convertiti. In Word, scegliere File → Salva con nome → PDF, poi caricare il PDF.” | Salvare il documento come PDF in Word e caricare il PDF. |
| “Impossibile convertire file: il file è protetto da password. Rimuovere la password e caricarlo di nuovo.” | Aprire il file in Word, rimuovere la password di apertura, salvare e caricare di nuovo. |
| “Impossibile convertire file: il file è danneggiato o non è un documento Word.” | Aprire e salvare il file in Word, o caricare un PDF. |
| “Impossibile convertire file: ha richiesto più di 5 minuti (molto grande o complesso). Dividerlo o salvarlo come PDF e caricare il PDF.” | Dividere il documento, o salvarlo come PDF in Word e caricare il PDF. |
| “Impossibile convertire file: richiede più memoria di quella disponibile nel convertitore (molte immagini grandi). Ridurre le immagini o caricare un PDF.” | Comprimere le immagini in Word (Formato immagine → Comprimi immagini), o caricare un PDF. |
| “Impossibile memorizzare file: il file è danneggiato o non è un PDF.” | Salvare di nuovo il PDF dal programma che lo ha creato. |
| “Solo i documenti Word (.docx) e i PDF diventano Artifact. Non aggiunti: file.” | Salvare prima gli altri formati come .docx o PDF. |
| Un messaggio sul limite per file | Il file supera il limite per file del piano. Per un file Word viene anche consigliato di salvarlo come PDF. |
Quando un file non può essere aggiunto, non viene conservato nulla: nessun Artifact, nessuna versione, e il caricamento viene eliminato.
Limiti
| Piano | Per file |
|---|---|
| Free / Accademico | 10 MB |
| Individual | 25 MB |
| Team | 100 MB |
- I file Word oltre 100 MB non possono essere convertiti con nessun piano.
- Il limite per file si applica al file caricato. Il PDF memorizzato conta per lo spazio del progetto e dell'utente.
- Gli Artifact Word e PDF sono disponibili nei progetti LML.