Steuerung & Prüfungen
Word- und PDF-Dateien als Artifacts
Fügen Sie einem Projekt Word-Dokumente und PDFs als Artifacts hinzu, prüfen und kommentieren Sie ihre Seiten, behalten Sie jede Version und geben Sie Speicher frei, indem Sie die Dateien alter Versionen entfernen.
Auf dieser Seite
- Konzepte
- So setzen Sie es ein
- Wann und warum
- Word- oder PDF-Dateien hinzufügen
- Eine neue Version hochladen
- Prüfen und kommentieren
- Kommentare an späteren Versionen
- Kommentare und nachverfolgte Änderungen aus Word
- Zwei Versionen vergleichen
- Durchgearbeitetes Beispiel: ein Design-Review im Demo CubeSat EO-1
- Tipps und bewährte Vorgehensweisen
- Häufige Fehler
- Zusammenhänge
- Der Abschnitt Datei
- Dateien älterer Versionen entfernen
- Dateien werden hinzugefügt
- Ohne Konvertierung
- Meldungen
- Grenzen
- Verwandte Themen
Ein Word-Dokument oder ein PDF kann als Artifact in Ihrem Projekt liegen. Prüfer lesen es in Holarch, kommentieren seine Seiten und genehmigen es wie jedes andere Element. Jeder neue Upload desselben Dokuments wird zu einer neuen Version, und frühere Versionen bleiben lesbar.
Beim gehosteten Dienst werden Word-Dateien beim Hinzufügen in PDF umgewandelt, und PDFs werden komprimiert. Das PDF ist das, was alle lesen, herunterladen und kommentieren.
Konzepte
- Datei-Artifact: ein Artifact, das eine Datei enthält. Seine Seite hat oben einen Abschnitt Datei mit dem Viewer, den Versionen und den Dateiwerkzeugen.
- Version: ein Upload des Dokuments. Jede Version behält ihr PDF, wer es hochgeladen hat, das Datum und eine optionale Notiz. Die neueste Version wird standardmäßig angezeigt.
- Konvertierung: das Umwandeln einer Word-Datei in PDF und das Komprimieren von PDFs. Es wird für alle jeweils eine Datei konvertiert; Dateien verschiedener Konten wechseln sich ab, sodass ein großer Stapel andere nicht aufhält.
- Angehefteter Kommentar: ein Kommentar, der zu einer Stelle einer Version gehört: ausgewählte Wörter, ein Punkt, ein Rahmen oder eine ganze Seite (oder in der Word-Ansicht ein Absatz). Die Diskussion zeigt, wo er sitzt, zum Beispiel "on version 2, page 3".
So setzen Sie es ein
Wann und warum
Verwenden Sie ein Datei-Artifact, wenn ein Liefergegenstand außerhalb von Holarch geschrieben wird: ein Design-Review-Paket, ein Schnittstellen-Kontrolldokument eines Lieferanten, ein Testbericht. Liegt es im Projekt, steht es neben den Anforderungen und Elementen, die es abdeckt. Prüfer kommentieren an einer Stelle, und Baselines erfassen, welche Version genehmigt wurde.
Word- oder PDF-Dateien hinzufügen
- Öffnen Sie die Datenbank eines LML-Projekts.
- Klicken Sie auf + Neues Element und dann unter dem Feld Name auf Artifact aus einer Word- oder PDF-Datei…. Wenn die Datenbank nur Artifacts zeigt, heißt die Schaltfläche + Neues Artifact, und die Schaltfläche des Dialogs lautet Aus einer Word- oder PDF-Datei…. Der Dialog schließt sich, und die Dateiauswahl öffnet sich.
Dieselbe Schaltfläche steht im Dialog Neues Element überall dort, wo er sich öffnet, zum Beispiel ⌘K / Ctrl+K → Neues Element…. Sie können auch .docx- und .pdf-Dateien auf die Datenbanktabelle ziehen oder auf jeder Seite des Projekts ⌘K / Ctrl+K drücken und Artifact aus Datei… ausführen.
- Wählen Sie eine oder mehrere Dateien.
Über der Tabelle sehen Sie Dateien werden hinzugefügt mit dem Status jeder Datei: "Waiting (2 ahead)", Wird konvertiert…, Wird komprimiert… oder Wird gespeichert….
- Warten Sie oder arbeiten Sie weiter. Sie können den Tab schließen.
Ist eine Datei fertig, meldet Holarch: "Design Review.docx is ready as an Artifact." Ist kein Holarch-Tab von Ihnen geöffnet, kommt die Meldung per E-Mail.
Jede Datei wird zu einem Artifact, benannt nach der Datei ohne ihre Endung. Der Hinweis nennt die gespeicherte Größe, zum Beispiel "Stored as 2.1 MB, compressed from 15 MB."
Eine neue Version hochladen
- Öffnen Sie das Artifact.
- Klicken Sie im Abschnitt Datei auf Neue Version hochladen… und wählen Sie die Datei.
- Geben Sie optional eine Notiz zur neuen Version ein, zum Beispiel "Comments from the design review addressed", und klicken Sie auf Als neue Version hochladen.
Bis sie fertig ist, sehen Sie auf der Seite "New version Design Review.docx: Converting…".
Fügen Sie eine Datei hinzu, deren Name einem Artifact entspricht, das bereits aus einer Datei dieses Namens erstellt wurde, fragt Datei bereits im Projekt, was geschehen soll:
- Als neue Version hochladen (Standard): Die Datei wird zur nächsten Version dieses Artifacts.
- Beide behalten: ein separates Artifact, dessen Name " (2)" erhält.
- Abbrechen: Nichts wird hinzugefügt.
Prüfen und kommentieren
- Öffnen Sie das Artifact. Seiten zeigt das PDF im Dokument-Viewer: eine Symbolleiste, die Seiten und daneben einen Bereich Kommentare.
- Bewegen Sie sich mit der Symbolleiste durch das Dokument: Seite 3 von 12 (geben Sie eine Seitenzahl ein und drücken Sie Enter), die Schaltflächen für vorherige und nächste Seite, Miniaturen, Zoom (Seitenbreite, Ganze Seite oder eine feste Größe) und Suchen (⌘F / Ctrl+F). Tasten: ← und → blättern, Home und End gehen zur ersten und letzten Seite, + und − zoomen.
- Kommentieren Sie auf eine von vier Arten:
- Text auswählen: Wählen Sie Wörter auf der Seite aus (Sie können sie auch kopieren) und klicken Sie dann auf Auswahl kommentieren. Die Wörter werden hervorgehoben.
- Punkt: Klicken Sie auf die Stelle der Seite, zu der der Kommentar gehört.
- Rahmen: Ziehen Sie einen Rahmen um einen Bereich, zum Beispiel eine Abbildung oder eine Tabelle.
- Seite kommentieren: ein Kommentar zur gezeigten Seite als Ganzes.
Geben Sie den Kommentar im Bereich ein und klicken Sie auf Kommentar hinzufügen (⌘Enter / Ctrl+Enter). Geben Sie @ und einen Namen ein, um jemanden zu erwähnen.
- Der Bereich Kommentare listet die Threads in Seitenreihenfolge auf, nummeriert wie ihre Markierungen auf der Seite. Klicken Sie auf einen Thread, um zu seiner Stelle zu gehen; klicken Sie auf eine Markierung oder Hervorhebung, um ihren Thread zu öffnen. Antworten, Erledigen und Wieder öffnen funktionieren wie in der Diskussion; Erledigte anzeigen zeigt erledigte Threads.
- Für mehr Platz klicken Sie auf Überprüfungsansicht (die Version über das ganze Fenster) oder In eigenem Fenster (ein separates Fenster, zum Beispiel auf einem zweiten Bildschirm). Beide bleiben aktuell, während Personen kommentieren.
Jeder Kommentar gehört zu der Version, an der er verfasst wurde, und die Diskussion zeigt ihn ebenfalls, zum Beispiel "on version 2, page 3". Das Kommentieren ändert die Datei nie: Ein signiertes PDF behält seine Signatur.
Kommentare an späteren Versionen
Wird eine neue Version hinzugefügt, wandern offene Threads mit, sodass ein Review über Versionen hinweg weitergeht:
- Holarch findet die Wörter jedes Threads in der neuen Version, auch wenn sie auf eine andere Seite gewandert sind oder der Text um sie herum neu umbrochen wurde. Der Thread wird dort mit Aus Version 1 (der Version, an der er verfasst wurde) gezeigt.
- Wurden die Wörter bearbeitet, wird der Thread außerdem mit Text seitdem geändert markiert und zeigt, was die frühere Version sagte, zum Beispiel "Version 1 said: “reject 40 W”".
- Sind die Wörter verschwunden, wird der Thread am Ende des Bereichs Kommentare unter Frühere Versionen aufgelistet, mit seinen zitierten Wörtern und In Version 1 anzeigen (der letzten Version, die sie enthält).
- Ein Punkt oder Rahmen folgt der nächstgelegenen Textzeile. Auf einer Seite ohne Text (einer Zeichnung oder einem Scan) bleibt er, wo er war, wenn die Seite in der neuen Version gleich aussieht; andernfalls kommt er unter Frühere Versionen.
- Erledigte Threads bleiben an den Versionen, an denen sie waren. Öffnen Sie einen wieder, damit er zu den neueren Versionen wandert.
- Verfasst zu (über den Threads, sobald es Threads aus mehr als einer Version gibt) zeigt nur die Threads, die an einer Version verfasst wurden, oder alle.
- Threads aus Word folgen denselben Regeln.
Das geschieht, wenn die neue Version hinzugefügt wird. Projekte mit Kommentaren aus der Zeit vor dieser Funktion werden genauso behandelt, wenn zum ersten Mal eine neuere Version gezeigt wird. In der Diskussion gibt ein Kommentar aus einer älteren Version an, wo er jetzt ist, zum Beispiel "On version 1, page 2, “radiator” · carried to version 3" oder "· not in version 3".
Kommentare behalten ihre zitierten Wörter, sodass sie noch lesbar sind, nachdem die Datei einer alten Version entfernt wurde. Ein bearbeiteter Kommentar behält seinen früheren Text: Früherer Text unter dem Kommentar listet jede frühere Formulierung mit Verfasser und Zeitpunkt auf.
Eine Baseline erfasst die Dateiversion und ihre Kommentar-Threads so, wie sie damals waren. Klicken Sie unter In Baselines auf den Namen der Baseline, um sie zu sehen.
Kommentare und nachverfolgte Änderungen aus Word
Beim gehosteten Dienst kommt das eigene Review-Markup einer Word-Datei beim Hinzufügen mit:
- Ihre Kommentare werden zu Kommentar-Threads auf dem PDF, an den Wörtern, an denen sie verfasst wurden, mit ihren Antworten. Jeder behält Autor und Datum aus Word und ist mit Aus Word markiert. Ein Kommentar, den Word als erledigt markiert hat, kommt erledigt an.
- Ihre nachverfolgten Änderungen werden als Vorschläge aufgelistet: "Suggested insertion: …" oder "Suggested deletion: …", von der Person, die sie vorgenommen hat.
- Das PDF zeigt die Kommentare am Rand und die nachverfolgten Änderungen als Redline.
Der Hinweis nach dem Upload gibt an, was mitgekommen ist, zum Beispiel "3 comments and 2 tracked changes came over from Word." Die importierten Threads gehören Ihnen, sodass Sie sie erledigen oder löschen können. Personen, die das Element beobachten, werden nicht über jeden importierten Kommentar benachrichtigt.
Zwei Versionen vergleichen
- Öffnen Sie das Artifact. Klicken Sie im Abschnitt Datei auf Versionen vergleichen… (angezeigt, wenn das Artifact zwei oder mehr Versionen hat).
- Wählen Sie die Version Älter und Neuer. Standardmäßig wird die gezeigte Version mit der vorherigen verglichen.
Die beiden Versionen erscheinen nebeneinander, Seite für Seite:
- Eingefügt: Eingefügte Wörter sind auf der neueren Version grün.
- Gelöscht: Gelöschte Wörter sind auf der älteren Version rot.
- Verschoben: Verschobene Sätze und Absätze sind an beiden Stellen violett. Ein verschobener Block, der auch bearbeitet wurde, zeigt auch seine Wortänderungen. Die Änderungsliste nennt beide Seiten, zum Beispiel "Page 2 → page 5".
- Seiten ohne Text (Zeichnungen, Scans) werden als Bilder verglichen. Eine geänderte ist umrandet; auf der neueren Seite zeigt Unterschiede rot, wo nur die ältere Version Tinte hat, und grün, wo nur die neuere.
- Wählen Sie eine Änderung in der Liste aus oder klicken Sie auf Zurück und Weiter (F7 und Shift+F7), um sie auf beiden Seiten zu zeigen. Synchron scrollen hält beim Scrollen denselben Text nebeneinander.
Der Text wird über das ganze Dokument verglichen, sodass Text, der auf eine andere Seite gewandert ist oder auf andere Zeilen umbrochen wurde, trotzdem zugeordnet wird. Eine ohne Konvertierung behaltene Word-Datei wird als Text verglichen, ohne Seiten. Lange Dokumente zeigen beim Lesen einen Fortschrittsbalken.
Derselbe Vergleich markiert Textänderungen auch anderswo: Die Prüfung von Änderungsanträgen, der Verlauf von Elementen, Dokumentänderungen und Bibliotheksunterschiede zeigen verschobene Sätze als verschoben, mit einem Link Verschoben nach / Verschoben von zwischen den beiden Stellen.
Durchgearbeitetes Beispiel: ein Design-Review im Demo CubeSat EO-1
- Öffnen Sie im Demo CubeSat EO-1 die Datenbank, klicken Sie auf + Neues Element und fügen Sie "EO-1 CDR Package.docx" mit Artifact aus einer Word- oder PDF-Datei… hinzu.
- Wenn es fertig ist, öffnen Sie EO-1 CDR Package und setzen Sie es mit den Anforderungen in Beziehung, die es abdeckt.
- Prüfer öffnen es und verwenden Seite kommentieren… für Seite 12: "Thermal margin table is missing the eclipse case."
- Laden Sie nach den Korrekturen "EO-1 CDR Package.docx" erneut hoch und wählen Sie Als neue Version hochladen, mit der Notiz "CDR comments addressed".
- Erstellen Sie eine Baseline. Die Artifact-Seite zeigt In Baselines mit dem Namen der Baseline für Version 2.
Tipps und bewährte Vorgehensweisen
- Laden Sie jede neue Version unter demselben Dateinamen hoch. Ein Artifact enthält dann den ganzen Verlauf.
- Laden Sie statt einer Word-Datei ein PDF hoch, wenn das Layout genau mit Word übereinstimmen muss: Die Konvertierung kann Zeilenumbrüche verschieben.
- Signierte PDFs, PDF-Formulare, PDF/A-Dateien und verschlüsselte PDFs werden genau so behalten, wie sie hochgeladen wurden. Sie zu komprimieren würde die Signatur, das Formular oder die Konformität zerstören.
Häufige Fehler
- Ein zweites Artifact ist erschienen: Sie haben Beide behalten gewählt. Löschen Sie es, laden Sie die Datei erneut hoch und wählen Sie Als neue Version hochladen.
- Eine Word-Datei über 100 MB wurde abgelehnt: Wählen Sie in Word Datei → Speichern unter → PDF und laden Sie dann das PDF hoch.
Zusammenhänge
- Kommentare und Reviews: Angeheftete Kommentare sind gewöhnliche Kommentare; Antworten, Erwähnungen und Genehmigungen funktionieren wie bei jedem Element. Siehe Kommentare und Reviews.
- Baselines: Eine Baseline erfasst die Version, die jedes Datei-Artifact hatte. Siehe Änderungsanträge.
- Speicher: Das PDF jeder Version zählt zum Speicher des Projekts und zu Ihrem Speicher. Siehe Anhänge, Speicher und Grenzen.
Der Abschnitt Datei
| Steuerelement | Was sie tut |
|---|---|
| Version | Zeigt eine Version: "Version 3 (latest) · Datum · Hochladender". Versionen, deren Datei entfernt wurde, zeigen "file removed". |
| Herunterladen (PDF) | Speichert das PDF der gezeigten Version. Eine ohne Konvertierung gezeigte Word-Datei bietet Herunterladen (.docx). |
| Als neueste wiederherstellen | Macht die gezeigte Version wieder zur neuesten, als neue Version. Nichts wird überschrieben. Nur Bearbeiter, nicht bei der neuesten Version. |
| Neue Version hochladen… | Fügt die nächste Version hinzu. Nur Bearbeiter. |
| Versionen vergleichen… | Zwei Versionen nebeneinander mit markiertem eingefügtem, gelöschtem und verschobenem Text. Siehe „Zwei Versionen vergleichen“. |
| Dateien älterer Versionen entfernen… | Löscht die Dateien gewählter alter Versionen. Siehe unten. |
| Seiten / PDF-Viewer | Der Dokument-Viewer (Seiten, Suchen, Kommentare) oder der eigene PDF-Viewer des Browsers (Drucken). |
| Überprüfungsansicht / In eigenem Fenster | Der Dokument-Viewer über das ganze Fenster oder in einem separaten Fenster. |
| Seite kommentieren… / Kommentar anheften | In der Word-Ansicht (eine ohne Konvertierung behaltene Word-Datei): ein Kommentar zu einer Seite nach ihrer Nummer oder zu dem Absatz, auf den Sie klicken. Klicken Sie auf Anheften beenden, um aufzuhören. PDFs verwenden die eigenen Werkzeuge des Viewers (siehe Prüfen und kommentieren). |
Unter den Werkzeugen die Angaben zur Version: Hochgeladen (wer und wann), Hochgeladene Datei (ihr ursprünglicher Name), Notiz, Gespeichert (die Größe und die Einsparung) und In Baselines (klicken Sie auf den Namen einer Baseline, um die von ihr erfassten Kommentar-Threads zu sehen).
Dateien älterer Versionen entfernen
Die PDFs alter Versionen belegen Speicher. Entfernen Sie die, die niemand braucht:
- Klicken Sie am Artifact auf Dateien älterer Versionen entfernen….
- Wählen Sie die Versionen aus.
Sie sehen "Removes the files of version 2 permanently. The version stays in the history."
- Klicken Sie auf Dateien entfernen.
Sie sehen "Removed the files of 1 version (12.4 MB freed)."
- Wer entfernen darf: der Kontoinhaber bei einem persönlichen Tarif (der Projekteigentümer), ein Organisationsadministrator beim Tarif Team. Ein Organisationsadministrator braucht keinen Bearbeitungszugriff auf das Projekt; die Entfernung trägt den Namen des Administrators.
- Die neueste Version kann so nicht entfernt werden. Um sie zu entfernen, löschen Sie das Artifact.
- Die Version bleibt in der Liste, markiert mit "File removed by Name on Datum". Ihre Kommentare bleiben als Text in der Diskussion.
- Die Entfernung wird im Audit-Protokoll erfasst, mit den Versionen und dem freigegebenen Speicher.
Dateien werden hinzugefügt
Die Datenbank zeigt Dateien werden hinzugefügt, während Ihre Uploads unterwegs sind.
- Wird hochgeladen…: Die Datei wird gesendet. Abbrechen stoppt sie, und nichts wird hinzugefügt.
- Wartet (n davor) oder Wartet (als Nächstes): Die Datei wartet, bis sie an der Reihe ist. Abbrechen entfernt sie aus der Warteschlange.
- Wird konvertiert…, Wird komprimiert…, Wird gespeichert…: Die Datei wird verarbeitet.
- Eine Datei, die nicht hinzugefügt werden konnte, bleibt mit ihrer Meldung in der Liste, bis Sie auf Verwerfen klicken.
Startet der Server während einer Konvertierung neu, kommt die Datei zurück in die Warteschlange und wird noch einmal versucht.
Ohne Konvertierung
Hat der Server keinen Konverter, werden Dateien so gespeichert, wie sie hochgeladen wurden:
- PDFs werden ohne Komprimierung gespeichert.
- Word-Dateien werden schreibgeschützt im Browser gezeigt: "Shown read-only in the browser (no PDF conversion on this server). Layout may differ from Word." Kommentar anheften heftet Kommentare dann an Absätze.
Meldungen
| Nachricht | Was zu tun ist |
|---|---|
| "Datei is 140 MB. Word files over 100 MB can't be converted. In Word, choose File → Save As → PDF, then upload the PDF." | Speichern Sie das Dokument in Word als PDF und laden Sie das PDF hoch. |
| "Couldn't convert Datei: the file is password-protected. Remove the password and upload it again." | Öffnen Sie die Datei in Word, entfernen Sie das Kennwort zum Öffnen, speichern Sie und laden Sie sie erneut hoch. |
| "Couldn't convert Datei: the file is damaged or not a Word document." | Öffnen und speichern Sie die Datei in Word, oder laden Sie ein PDF hoch. |
| "Couldn't convert Datei: it took longer than 5 minutes (very large or complex). Split it or save it as PDF and upload the PDF." | Teilen Sie das Dokument auf, oder speichern Sie es in Word als PDF und laden Sie das PDF hoch. |
| "Couldn't convert Datei: it needs more memory than the converter has (many large images). Reduce the images or upload a PDF." | Komprimieren Sie die Bilder in Word (Bildformat → Bilder komprimieren), oder laden Sie ein PDF hoch. |
| "Couldn't store Datei: the file is damaged or not a PDF." | Speichern Sie das PDF erneut aus dem Programm, das es erstellt hat. |
| "Only Word documents (.docx) and PDFs become Artifacts. Not added: Dateien." | Speichern Sie andere Formate zuerst als .docx oder PDF. |
| Eine Meldung zur Grenze je Datei | Die Datei überschreitet die Grenze je Datei Ihres Tarifs. Bei einer Word-Datei kommt der Rat hinzu, sie als PDF zu speichern. |
Kann eine Datei nicht hinzugefügt werden, wird nichts behalten: kein Artifact, keine Version, und der Upload wird gelöscht.
Grenzen
| Plan | Je Datei |
|---|---|
| Free / Academic | 10 MB |
| Individual | 25 MB |
| Team | 100 MB |
- Word-Dateien über 100 MB können bei keinem Tarif konvertiert werden.
- Die Grenze je Datei gilt für die Datei, die Sie hochladen. Das gespeicherte PDF zählt zum Speicher des Projekts und zu Ihrem Speicher.
- Word- und PDF-Artifacts sind in LML-Projekten verfügbar.