管理とレビュー
Artifact としての Word ファイルと PDF ファイル
Word ドキュメントと PDF を Artifact としてプロジェクトに追加し、そのページをレビューしてコメントし、すべてのバージョンを保持し、古いバージョンのファイルを除去してストレージを空けます。
このページの内容
Word 文書や PDF は、Artifactとしてプロジェクトに置くことができます。レビュー担当者は Holarch でそれを読み、ページにコメントを付け、他の項目と同じように承認します。同じドキュメントを新たにアップロードするたびに新しいバージョンになり、以前のバージョンも引き続き読めます。
ホスト型サービスでは、Word ファイルは追加時に PDF に変換され、PDF は圧縮されます。全員が読み、ダウンロードし、コメントを付けるのはこの PDF です。
概念
- ファイル Artifact:ファイルを保持する Artifact。そのページの上部には、ビューア、バージョン、ファイルツールのあるファイルセクションがあります。
- バージョン:ドキュメントの 1 回のアップロード。各バージョンには、PDF、アップロードした人、日付、任意のメモが保持されます。既定では最新のバージョンが表示されます。
- 変換:Word ファイルを PDF にし、PDF を圧縮すること。変換は全員で 1 度に 1 ファイルずつ行われます。異なるアカウントのファイルは順番に処理されるため、1 つの大量のバッチが他のユーザーを待たせることはありません。
- ピン留めされたコメント:1 つのバージョンの特定の場所(選択した語句、点、枠、ページ全体、または Word 表示では段落)に属するコメント。ディスカッションには、その位置が「on version 2, page 3」のように表示されます。
使い方
使う場面と理由
成果物が Holarch の外で作成される場合は、ファイル Artifact を使用します:設計審査パッケージ、サプライヤーのインターフェース管理文書、テストレポートなどです。プロジェクト内に置くと、それが対象とする要求や項目の隣に並びます。レビュー担当者は 1 か所でコメントし、ベースラインにはどのバージョンが承認されたかが記録されます。
Word または PDF ファイルを追加する
- LML プロジェクトのデータベースを開きます。
- + 新しい項目をクリックし、名前フィールドの下にあるWord または PDF ファイルから Artifact を作成…をクリックします。データベースに Artifact だけが表示されている場合、ボタンは+ 新しい Artifactになり、ダイアログのボタンはWord または PDF ファイルから…になります。ダイアログが閉じ、ファイル選択画面が開きます。
同じボタンは、新しい項目ダイアログが開くすべての場所にあります(たとえば ⌘K / Ctrl+K → 新しい項目…)。.docx ファイルや .pdf ファイルをデータベースの表にドラッグするか、プロジェクトの任意のページで ⌘K / Ctrl+K を押してファイルから Artifact を作成…を実行することもできます。
- 1 つ以上のファイルを選びます。
表の上に追加中のファイルが表示され、各ファイルの状態が「Waiting (2 ahead)」、変換しています…、圧縮しています…、保存しています…のように示されます。
- 待つか、作業を続けます。タブを閉じてもかまいません。
ファイルの処理が終わると、Holarch が「Design Review.docx is ready as an Artifact.」と知らせます。Holarch のタブを開いていない場合は、メールでメッセージが届きます。
各ファイルは 1 つの Artifact になり、拡張子を除いたファイル名が付きます。通知には保存されたサイズが、たとえば「Stored as 2.1 MB, compressed from 15 MB.」のように示されます。
新しいバージョンをアップロードする
- Artifact を開きます。
- ファイルセクションで新しいバージョンをアップロード…をクリックし、ファイルを選びます。
- 必要に応じて新しいバージョンのメモ(たとえば「Comments from the design review addressed」)を入力し、新しいバージョンとしてアップロードをクリックします。
準備ができるまで、ページに「New version Design Review.docx: Converting…」と表示されます。
同じ名前のファイルから作成された Artifact がすでにあり、その名前と一致するファイルを追加すると、ファイルはすでにプロジェクトにありますでどうするかを尋ねられます:
- 新しいバージョンとしてアップロード(既定):ファイルはその Artifact の次のバージョンになります。
- 両方残す:別の Artifact になり、名前に「 (2)」が付きます。
- キャンセル:何も追加されません。
レビューとコメント
- Artifact を開きます。ページには、ドキュメントビューアで PDF が表示されます:ツールバー、ページ、その横のコメントパネルです。
- ツールバーでドキュメント内を移動します:Page 3 of 12(ページ番号を入力して Enter を押します)、前のページと次のページのボタン、サムネイル、ズーム(幅に合わせる、ページ全体、または固定のサイズ)、検索(⌘F / Ctrl+F)。キー:← と → でページをめくり、Home と End で最初と最後のページに移動し、+ と − でズームします。
- コメントの方法は次の 4 つです:
- テキストを選択:ページ上の語句を選択し(コピーすることもできます)、選択範囲にコメントをクリックします。語句がハイライトされます。
- 点:コメントを付けるページ上の場所をクリックします。
- 枠:図や表などの領域を囲むように枠をドラッグします。
- ページにコメント:表示しているページ全体へのコメントです。
パネルにコメントを入力し、コメントを追加(⌘Enter / Ctrl+Enter)をクリックします。誰かをメンションするには、@ と名前を入力します。
- コメントパネルには、スレッドがページ順に、ページ上のマーカーと同じ番号で一覧表示されます。スレッドをクリックするとその場所に移動し、マーカーまたはハイライトをクリックするとそのスレッドが開きます。返信、解決、再開はディスカッションと同じように動作します。解決済みを表示は解決済みのスレッドを表示します。
- 広く表示するには、レビュー表示(バージョンをウィンドウ全体に表示)またはポップアウト(別のウィンドウ。たとえば 2 台目の画面用)をクリックします。どちらも、ユーザーがコメントするたびに最新の状態に更新されます。
各コメントは作成されたバージョンに属し、ディスカッションにも「on version 2, page 3」のように表示されます。コメントしてもファイルは変わりません:署名付きの PDF は署名を保持します。
後のバージョンでのコメント
新しいバージョンが追加されると、未解決のスレッドはそのバージョンに移動するため、レビューはバージョンをまたいで続きます:
- Holarch は、新しいバージョン内で各スレッドの語句を見つけます。語句が別のページに移動した場合や、周囲のテキストが再配置された場合も同様です。スレッドはそこにFrom version 1(作成されたバージョン)というラベル付きで表示されます。
- 語句が編集された場合、スレッドには以降にテキスト変更のマークも付き、以前のバージョンの内容が、たとえば「Version 1 said: “reject 40 W”」のように表示されます。
- 語句がなくなった場合、スレッドはコメントパネルの末尾のEarlier versionsの下に、引用された語句とShow on Version 1(その語句がある最後のバージョン)とともに一覧表示されます。
- 点または枠は、最も近いテキスト行に従います。テキストのないページ(図面やスキャン)では、新しいバージョンでもページの見た目が同じであれば元の位置に留まり、そうでなければ Earlier versions の下に移ります。
- 解決済みのスレッドは元のバージョンに留まります。新しいバージョンに移動させるには、スレッドを再開します。
- 作成バージョン(複数のバージョンのスレッドがあると、スレッドの上に表示されます)は、1 つのバージョンで作成されたスレッドだけ、またはすべてのスレッドを表示します。
- Word からのスレッドも同じルールに従います。
これは新しいバージョンが追加されたときに行われます。この機能より前のコメントがあるプロジェクトでは、新しいバージョンが初めて表示されたときに同じ処理が行われます。ディスカッションでは、古いバージョンのコメントに現在の位置が、たとえば「On version 1, page 2, “radiator” · carried to version 3」や「· not in version 3」のように示されます。
コメントは引用された語句を保持するため、古いバージョンのファイルが除去された後も読むことができます。編集されたコメントは以前のテキストを保持します:コメントの下のEarlier textには、以前の各文面が、書いた人と日時とともに一覧表示されます。
ベースラインには、その時点のファイルのバージョンとそのコメントスレッドが記録されます。それらを見るには、ベースライン内の下のベースライン名をクリックします。
Word からのコメントと変更履歴
ホスト型サービスでは、Word ファイルを追加すると、そのファイル自身のレビューマークアップも取り込まれます:
- コメントは、PDF 上の、コメントが付けられた語句に、返信とともにコメントスレッドとして取り込まれます。それぞれ Word での作成者と日付を保持し、Word からのマークが付きます。Word で完了とされたコメントは解決済みとして取り込まれます。
- 変更履歴は、変更を行った人による提案として「Suggested insertion: …」または「Suggested deletion: …」のように一覧表示されます。
- PDF では、コメントは余白に、変更履歴は赤字の見え消しで表示されます。
アップロード後の通知には、取り込まれた内容が、たとえば「3 comments and 2 tracked changes came over from Word.」のように示されます。取り込まれたスレッドはあなたが所有するため、解決したり削除したりできます。項目をウォッチしているユーザーには、取り込まれたコメントごとの通知は届きません。
2 つのバージョンを比較する
- Artifact を開きます。ファイルセクションで版を比較…をクリックします(Artifact に 2 つ以上のバージョンがあると表示されます)。
- 旧と新のバージョンを選びます。既定では、表示しているバージョンがその前のバージョンと比較されます。
2 つのバージョンがページごとに並べて表示されます:
- 挿入された語句は、新しいバージョン上で緑色になります。
- 削除された語句は、古いバージョン上で赤色になります。
- 移動した文や段落は、両方の位置で紫色になります。移動して編集もされたブロックには、語句の変更も表示されます。変更リストには、両方のページが「Page 2 → page 5」のように示されます。
- テキストのないページ(図面、スキャン)は画像として比較されます。変更されたページは枠で囲まれます。新しいページでは、相違点が、古いバージョンにだけ描画がある箇所を赤色、新しいバージョンにだけある箇所を緑色で示します。
- リストで変更を選択するか、前へと次へ(F7 と Shift+F7)をクリックすると、その変更が両側に表示されます。スクロールを同期は、スクロール中も同じテキストを並べて表示します。
テキストはドキュメント全体で比較されるため、別のページに移動したテキストや別の行に再配置されたテキストも対応付けられます。変換せずに保持された Word ファイルは、ページなしでテキストとして比較されます。長いドキュメントでは、読み取り中に進行状況バーが表示されます。
他の場所でも同じ比較でテキストの変更に印が付きます:変更要求のレビュー、項目の履歴、ドキュメントの変更、ライブラリの相違点では、移動した文が移動として示され、2 つの位置の間に移動先 / 移動元のリンクが付きます。
作業例:CubeSat EO-1 デモでの設計審査
- CubeSat EO-1 デモでデータベースを開き、+ 新しい項目をクリックして、Word または PDF ファイルから Artifact を作成…で「EO-1 CDR Package.docx」を追加します。
- 準備ができたらEO-1 CDR Packageを開き、それが対象とする要求と関係付けます。
- レビュー担当者はそれを開き、12 ページにページにコメント…を使います:「Thermal margin table is missing the eclipse case.」
- 修正後、「EO-1 CDR Package.docx」を再びアップロードし、メモ「CDR comments addressed」を付けて新しいバージョンとしてアップロードを選びます。
- ベースラインを作成します。Artifact のページには、バージョン 2 についてベースライン内とベースラインの名前が表示されます。
ヒントとよい進め方
- 新しいバージョンはそれぞれ同じファイル名でアップロードします。そうすると 1 つの Artifact に履歴全体が保持されます。
- レイアウトが Word と完全に一致する必要がある場合は、Word ファイルの代わりに PDF をアップロードします:変換によって改行位置が変わることがあります。
- 署名付き PDF、PDF フォーム、PDF/A ファイル、暗号化された PDF は、アップロードしたとおりに保持されます。圧縮すると、署名、フォーム、または準拠性が壊れるためです。
よくある間違い
- 2 つ目の Artifact が表示された:両方残すを選んだためです。それを削除し、ファイルを再びアップロードして新しいバージョンとしてアップロードを選びます。
- 100 MB を超える Word ファイルが拒否された:Word で ファイル → 名前を付けて保存 → PDF を選び、PDF をアップロードします。
他の機能とのつながり
- コメントとレビュー:ピン留めされたコメントは通常のコメントです。返信、メンション、承認は他の項目と同じように機能します。コメントとレビューを参照してください。
- ベースライン:ベースラインには、各ファイル Artifact のその時点のバージョンが記録されます。変更要求を参照してください。
- ストレージ:すべてのバージョンの PDF が、プロジェクトとあなたのストレージに数えられます。添付ファイル、ストレージ、上限を参照してください。
ファイルセクション
| コントロール | 機能 |
|---|---|
| バージョン | バージョンを表示します:「Version 3 (latest) · 日付 · アップロードした人」。ファイルが除去されたバージョンには「file removed」と表示されます。 |
| ダウンロード(PDF) | 表示しているバージョンの PDF を保存します。変換せずに表示されている Word ファイルではダウンロード(.docx)になります。 |
| 最新として復元 | 表示しているバージョンを、新しいバージョンとして再び最新にします。何も上書きされません。編集者のみ。最新のバージョンでは使えません。 |
| 新しいバージョンをアップロード… | 次のバージョンを追加します。編集者のみ。 |
| 版を比較… | 2 つのバージョンを並べ、挿入、削除、移動されたテキストに印を付けます。「2 つのバージョンを比較する」を参照してください。 |
| 古いバージョンのファイルを削除… | 選んだ古いバージョンのファイルを削除します。下記を参照してください。 |
| ページ / PDF ビューア | ドキュメントビューア(ページ、検索、コメント)、またはブラウザー自身の PDF ビューア(印刷)。 |
| レビュー表示 / ポップアウト | ドキュメントビューアをウィンドウ全体に、または別のウィンドウに表示します。 |
| ページにコメント… / コメントをピン留め | Word 表示(変換せずに保持された Word ファイル)で:番号で指定したページへのコメント、またはクリックした段落へのコメント。終了するにはピン留めを終了をクリックします。PDF ではビューア自身のツールを使用します(「レビューとコメント」を参照)。 |
ツールの下には、バージョンの情報が表示されます:アップロード(誰がいつ)、アップロードしたファイル(元の名前)、メモ、保存済み(サイズと削減量)、ベースライン内(ベースライン名をクリックすると、記録されたコメントスレッドが表示されます)。
古いバージョンのファイルを除去する
古いバージョンの PDF はストレージを使います。誰も必要としないものは除去します:
- Artifact で古いバージョンのファイルを削除…をクリックします。
- バージョンを選択します。
「Removes the files of version 2 permanently. The version stays in the history.」と表示されます。
- ファイルを削除をクリックします。
「Removed the files of 1 version (12.4 MB freed).」と表示されます。
- 除去できる人:個人プランではアカウントの所有者(プロジェクトのオーナー)、Team プランでは組織の管理者。組織の管理者にはプロジェクトの編集権限は不要で、除去には管理者の名前が記録されます。
- 最新のバージョンはこの方法では除去できません。除去するには Artifact を削除します。
- バージョンは一覧に残り、「File removed by 名前 on 日付」と示されます。そのコメントはテキストとしてディスカッションに残ります。
- 除去は、対象のバージョンと空いた容量とともに監査ログに記録されます。
追加中のファイル
アップロード中は、データベースに追加中のファイルが表示されます。
- アップロードしています…:ファイルを送信しています。キャンセルで停止し、何も追加されません。
- Waiting (n ahead)または待機中(次):ファイルは順番を待っています。キャンセルでキューから除去されます。
- 変換しています…、圧縮しています…、保存しています…:ファイルを処理しています。
- 追加できなかったファイルは、閉じるをクリックするまで、メッセージとともに一覧に残ります。
変換中にサーバーが再起動した場合、ファイルはキューに戻され、もう一度処理が試みられます。
変換なしの場合
サーバーに変換機能がない場合、ファイルはアップロードしたとおりに保存されます:
- PDF は圧縮せずに保存されます。
- Word ファイルはブラウザーで読み取り専用で表示されます:「Shown read-only in the browser (no PDF conversion on this server). Layout may differ from Word.」この場合、コメントをピン留めはコメントを段落にピン留めします。
メッセージ
| メッセージ | すること |
|---|---|
| 「file is 140 MB. Word files over 100 MB can't be converted. In Word, choose File → Save As → PDF, then upload the PDF.」 | Word でドキュメントを PDF として保存し、PDF をアップロードします。 |
| 「Couldn't convert file: the file is password-protected. Remove the password and upload it again.」 | Word でファイルを開き、読み取りパスワードを解除して保存し、再びアップロードします。 |
| 「Couldn't convert file: the file is damaged or not a Word document.」 | Word でファイルを開いて保存するか、PDF をアップロードします。 |
| 「Couldn't convert file: it took longer than 5 minutes (very large or complex). Split it or save it as PDF and upload the PDF.」 | ドキュメントを分割するか、Word で PDF として保存して PDF をアップロードします。 |
| 「Couldn't convert file: it needs more memory than the converter has (many large images). Reduce the images or upload a PDF.」 | Word で画像を圧縮する(図の形式 → 図の圧縮)か、PDF をアップロードします。 |
| 「Couldn't store file: the file is damaged or not a PDF.」 | PDF を作成したプログラムから PDF を保存し直します。 |
| 「Only Word documents (.docx) and PDFs become Artifacts. Not added: files.」 | その他の形式は、先に .docx または PDF として保存します。 |
| ファイルごとの上限のメッセージ | ファイルがプランのファイルごとの上限を超えています。Word ファイルの場合は、PDF として保存するよう案内も表示されます。 |
ファイルを追加できない場合は何も保持されません:Artifact もバージョンも作成されず、アップロードは削除されます。
制限事項
| プラン | ファイルごと |
|---|---|
| Free / Academic | 10 MB |
| Individual | 25 MB |
| Team | 100 MB |
- 100 MB を超える Word ファイルは、どのプランでも変換できません。
- ファイルごとの上限は、アップロードするファイルに適用されます。保存された PDF は、プロジェクトとあなたのストレージに数えられます。
- Word と PDF の Artifact は LML プロジェクトで利用できます。