控制與審查
以 Word 和 PDF 檔案作為 Artifact
將 Word 文件和 PDF 以 Artifact 形式加入專案、審查其頁面並留言、保留每個版本,並移除舊版本的檔案以釋放儲存空間。
本頁內容
Word 文件或 PDF 可以作為 Artifact 存放在您的專案中。審查者在 Holarch 中閱讀它、在其頁面上留言,並像其他任何項目一樣核准它。同一文件的每次新上傳都會成為新版本,較早的版本仍可閱讀。
在託管服務上,Word 檔案在加入時會轉換為 PDF,PDF 則會被壓縮。所有人閱讀、下載和留言的都是此 PDF。
概念
- 檔案 Artifact:保存檔案的 Artifact。其頁面頂端有檔案區段,包含檢視器、版本和檔案工具。
- 版本:文件的一次上傳。每個版本都會保留其 PDF、上傳者、日期和選用的附註。預設顯示最新版本。
- 轉換:將 Word 檔案轉換為 PDF 並壓縮 PDF。所有人的檔案一次轉換一個;不同帳戶的檔案輪流處理,因此一大批檔案不會耽誤其他人。
- 釘選留言:屬於某個版本特定位置的留言:選取的字詞、一個點、一個方框或整頁(或在 Word 檢視中為一個段落)。討論會顯示它的位置,例如「在版本 2,第 3 頁」。
使用方式
使用時機與原因
當交付項目是在 Holarch 之外撰寫時,請使用檔案 Artifact:設計審查套件、供應商的介面控制文件、測試報告。將它保存在專案中,可讓它緊鄰它所涵蓋的需求和項目。審查者在同一處留言,基準線會記錄哪個版本獲得核准。
新增 Word 或 PDF 檔案
- 開啟 LML 專案的資料庫。
- 按一下+ 新增項目,然後按一下名稱欄位下方的從 Word 或 PDF 檔案建立 Artifact…。當資料庫只顯示 Artifact 時,按鈕為+ 新增 Artifact,對話方塊中的按鈕則顯示從 Word 或 PDF 檔案…。對話方塊會關閉,並開啟檔案選擇器。
在任何開啟「新增項目」對話方塊的地方都有相同的按鈕,例如 ⌘K / Ctrl+K → 新增項目…。您也可以將 .docx 與 .pdf 檔案拖曳到資料庫表格上,或在專案的任何頁面上按 ⌘K / Ctrl+K 並執行從檔案建立 Artifact…。
- 選擇一個或多個檔案。
表格上方會顯示正在新增的檔案,以及每個檔案的狀態:「等候中(前面還有 2 個)」、正在轉換…、正在壓縮…或正在儲存…。
- 請等候,或繼續工作。您可以關閉分頁。
檔案完成時,Holarch 會通知您:「Design Review.docx 已可作為 Artifact 使用。」如果您沒有開啟任何 Holarch 分頁,訊息會透過電子郵件寄送。
每個檔案會成為一個 Artifact,以不含副檔名的檔案名稱命名。通知會說明儲存的大小,例如「儲存為 2.1 MB,由 15 MB 壓縮而來。」
上傳新版本
- 開啟該 Artifact。
- 在檔案區段中,按一下上傳新版本…並選擇檔案。
- 可以選擇輸入新版本的附註,例如「Comments from the design review addressed」,然後按一下作為新版本上傳。
在完成之前,頁面上會顯示「新版本 Design Review.docx:正在轉換…」。
當您加入的檔案名稱與已由同名檔案建立的 Artifact 相符時,檔案已在專案中會詢問要如何處理:
- 作為新版本上傳(預設):檔案會成為該 Artifact 的下一個版本。
- 兩者都保留:另建一個 Artifact,其名稱會加上「 (2)」。
- 取消:不加入任何內容。
審查與留言
- 開啟該 Artifact。頁面會在文件檢視器中顯示 PDF:工具列、頁面,以及旁邊的留言面板。
- 以工具列瀏覽文件:第 3 頁,共 12 頁(輸入頁碼並按 Enter)、上一頁和下一頁按鈕、縮圖、縮放(符合寬度、符合頁面或固定大小)以及尋找(⌘F / Ctrl+F)。按鍵:← 和 → 翻頁,Home 和 End 前往第一頁和最後一頁,+ 和 − 縮放。
- 可用以下四種方式之一留言:
- 選取文字:選取頁面上的字詞(也可以複製它們),然後按一下對選取範圍留言。這些字詞會被醒目提示。
- 位置點:按一下頁面上留言所屬的位置。
- 方框:在某個區域周圍拖曳出方框,例如圖形或表格。
- 對頁面留言:針對所顯示頁面整體的留言。
在面板中輸入留言,然後按一下新增留言(⌘Enter / Ctrl+Enter)。輸入 @ 和姓名即可提及某人。
- 留言面板會依頁面順序列出討論串,編號與頁面上的標記相同。按一下討論串即可前往其位置;按一下標記或醒目提示即可開啟其討論串。回覆、解決和重新開啟的運作方式與討論中相同;顯示已解決會顯示已解決的討論串。
- 若需要更多空間,請按一下校閱檢視(版本佔滿整個視窗)或彈出(獨立的視窗,例如在第二個螢幕上)。兩者都會在有人留言時保持最新。
每則留言都屬於其所在的版本,討論中也會顯示,例如「在版本 2,第 3 頁」。留言永遠不會變更檔案:已簽署的 PDF 會保留其簽章。
較新版本上的留言
新增新版本時,未解決的討論串會移到新版本,讓審查可以跨版本繼續:
- Holarch 會在新版本中找出每個討論串的字詞,即使它們移到了另一頁或周圍文字重新排列也一樣。討論串會顯示在該處,並標示來自版本 1(其建立時的版本)。
- 當字詞已被編輯時,討論串也會標示文字此後已變更,並顯示較早版本的內容,例如「版本 1 原文:“reject 40 W”」。
- 當字詞已不存在時,討論串會列在留言面板末端的較早版本下,附上其引用的字詞和在版本 1 中顯示(仍包含這些字詞的最後一個版本)。
- 位置點或方框會跟隨最近的一行文字。在沒有文字的頁面上(繪圖或掃描),當該頁在新版本中看起來相同時,它會保持在原位;否則會移到較早版本下。
- 已解決的討論串會保留在其原本所在的版本。重新開啟一個討論串,即可讓它移到較新的版本。
- 新增於(在討論串上方,當有來自多個版本的討論串時顯示)只顯示在某一版本上建立的討論串,或全部顯示。
- 來自 Word 的討論串遵循相同的規則。
這會在新增新版本時發生。在此功能推出前就有留言的專案,在第一次顯示較新版本時會得到相同的處理。在討論中,來自較舊版本的留言會說明它目前的位置,例如「在版本 1,第 2 頁,“radiator” · 已帶到版本 3」或「· 不在版本 3 中」。
留言會保留其引用的字詞,因此即使舊版本的檔案被移除後仍可閱讀。編輯過的留言會保留其較早的文字:留言下方的較早文字會列出每個較早的措辭,以及撰寫者和時間。
基準線會記錄當時的檔案版本及其留言討論串。按一下在基準線中下的基準線名稱即可查看。
來自 Word 的留言和追蹤修訂
在託管服務上,Word 檔案本身的審閱標記會在您加入它時一併帶入:
- 其註解會成為 PDF 上、位於其原本字詞處的留言討論串,並包含回覆。每則都保留來自 Word 的作者和日期,並標示來自 Word。Word 中標示為完成的註解會以已解決狀態帶入。
- 其追蹤修訂會列為建議:「建議插入:…」或「建議刪除:…」,由做出修訂的人提出。
- PDF 會在邊界顯示註解,並以紅線顯示追蹤修訂。
上傳後的通知會說明帶入了哪些內容,例如「已從 Word 帶入 3 則註解和 2 項追蹤修訂。」匯入的討論串歸您所有,因此您可以解決或刪除它們。關注該項目的人不會就每則匯入的留言收到通知。
比較兩個版本
- 開啟該 Artifact。在檔案區段中,按一下比較版本…(Artifact 有兩個以上版本時顯示)。
- 選擇較舊和較新的版本。預設會將顯示的版本與其前一個版本比較。
兩個版本會逐頁並排顯示:
- 已插入的字詞在較新版本上以綠色顯示。
- 已刪除的字詞在較舊版本上以紅色顯示。
- 已移動的句子和段落在兩處都以紫色顯示。移動後又被編輯的區塊也會顯示其字詞變更。變更清單會列出兩個頁面,例如「第 2 頁 → 第 5 頁」。
- 沒有文字的頁面(繪圖、掃描)會以圖片方式比較。有變更的頁面會加上外框;在較新的頁面上,差異會以紅色顯示只有較舊版本有墨跡之處,以綠色顯示只有較新版本有墨跡之處。
- 在清單中選取一項變更,或按一下上一個和下一個(F7 和 Shift+F7),即可在兩側顯示它。同步捲動會在您捲動時讓相同的文字並排。
文字會在整份文件中比較,因此移到另一頁或重新排列到其他行的文字仍會被比對。不轉換而保留的 Word 檔案會以文字方式比較,不分頁。較長的文件在讀取時會顯示進度列。
相同的比較也會在其他地方標示文字變更:變更請求審查、項目歷程記錄、文件變更和庫差異會將移動的句子顯示為已移動,並在兩處之間以移至 / 移自連結相連。
實作範例: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 的基準線名稱。
提示與良好做法
- 以相同的檔案名稱上傳每個新版本。如此一個 Artifact 就會保存完整的歷程。
- 當版面必須與 Word 完全一致時,請上傳 PDF 而非 Word 檔案:轉換可能會移動換行位置。
- 已簽署的 PDF、PDF 表單、PDF/A 檔案和加密的 PDF 會完全按上傳時的樣子保留。壓縮它們會破壞簽章、表單或符合性。
常見錯誤
- 出現了第二個 Artifact:您選擇了兩者都保留。請刪除它,然後再次上傳檔案並選擇作為新版本上傳。
- 超過 100 MB 的 Word 檔案被拒絕:在 Word 中選擇「檔案 → 另存新檔 → PDF」,然後上傳該 PDF。
與其他功能的關聯
- 留言和審查:釘選留言是一般的留言;回覆、提及和核准的運作方式與任何項目相同。請參閱留言與審查。
- 基準線:基準線會記錄每個檔案 Artifact 當時的版本。請參閱變更請求。
- 儲存空間:每個版本的 PDF 都會計入專案和您的儲存空間。請參閱附件、儲存空間與限制。
檔案區段
| 控制項 | 功能 |
|---|---|
| 版本 | 顯示一個版本:「版本 3(最新)· date · uploader」。檔案已移除的版本會顯示「檔案已移除」。 |
| 下載(PDF) | 儲存所顯示版本的 PDF。不轉換而顯示的 Word 檔案提供下載(.docx)。 |
| 還原為最新 | 將所顯示的版本再次設為最新版本,作為一個新版本。不會覆寫任何內容。僅限編輯者,不適用於最新版本。 |
| 上傳新版本… | 新增下一個版本。僅限編輯者。 |
| 比較版本… | 兩個版本並排,並標示插入、刪除和移動的文字。請參閱「比較兩個版本」。 |
| 移除舊版本的檔案… | 刪除所選舊版本的檔案。請見下文。 |
| 頁面 / PDF 檢視器 | 文件檢視器(頁面、尋找、留言);或瀏覽器自己的 PDF 檢視器(列印)。 |
| 校閱檢視 / 彈出 | 文件檢視器佔滿整個視窗,或在獨立的視窗中。 |
| 對頁面留言… / 釘選留言 | 在 Word 檢視中(不轉換而保留的 Word 檔案):依頁碼對某頁留言,或對您按一下的段落留言。按一下停止釘選即可結束。PDF 使用檢視器自己的工具(請參閱「審查與留言」)。 |
工具下方是該版本的資訊:上傳者(誰以及何時)、已上傳的檔案(其原始名稱)、附註、已儲存(大小和節省的空間),以及在基準線中(按一下基準線名稱即可查看它所記錄的留言討論串)。
移除舊版本的檔案
舊版本的 PDF 會占用儲存空間。請移除沒有人需要的版本:
- 在該 Artifact 上,按一下移除舊版本的檔案…。
- 選取版本。
您會看到「永久移除版本 2 的檔案。該版本會保留在歷程中。」
- 按一下移除檔案。
您會看到「已移除 1 個版本的檔案(釋放了 12.4 MB)。」
- 可以移除的人:個人方案的帳戶持有人(專案擁有者)、Team 方案的組織管理員。組織管理員不需要專案的編輯權限;移除會帶有管理員的姓名。
- 最新版本無法以此方式移除。若要移除,請刪除該 Artifact。
- 該版本會保留在清單中,並標示「檔案已由 name 於 date 移除」。其留言會以文字形式保留在討論中。
- 移除會記錄在稽核記錄中,附上版本和釋放的空間。
正在新增的檔案
您的上傳進行中時,資料庫會顯示正在新增的檔案。
- 正在上傳…:正在傳送檔案。取消會停止上傳,且不會加入任何內容。
- 等待中(前面還有 n 個)或等待中(下一個):檔案正在等候輪到它。取消會將它從佇列中移除。
- 正在轉換…、正在壓縮…、正在儲存…:正在處理檔案。
- 無法加入的檔案會連同其訊息保留在清單中,直到您按一下關閉。
如果伺服器在轉換期間重新啟動,檔案會回到佇列中並再嘗試一次。
不轉換
當伺服器沒有轉換器時,檔案會按上傳時的樣子儲存:
- PDF 會在不壓縮的情況下儲存。
- Word 檔案會在瀏覽器中以唯讀方式顯示:「在瀏覽器中以唯讀方式顯示(此伺服器不支援 PDF 轉換)。版面可能與 Word 不同。」此時釘選留言會將留言釘選到段落。
訊息
| 訊息 | 處理方式 |
|---|---|
| 「file 為 140 MB。超過 100 MB 的 Word 檔案無法轉換。請在 Word 中選擇「檔案 → 另存新檔 → PDF」,然後上傳該 PDF。」 | 在 Word 中將文件另存為 PDF,然後上傳該 PDF。 |
| 「無法轉換 file:檔案受密碼保護。請移除密碼後再次上傳。」 | 在 Word 中開啟檔案,移除開啟密碼,儲存後再次上傳。 |
| 「無法轉換 file:檔案已損毀或不是 Word 文件。」 | 在 Word 中開啟並儲存檔案,或上傳 PDF。 |
| 「無法轉換 file:處理時間超過 5 分鐘(非常大或非常複雜)。請將它拆分,或另存為 PDF 後上傳該 PDF。」 | 拆分文件,或在 Word 中將它另存為 PDF 後上傳該 PDF。 |
| 「無法轉換 file:它需要的記憶體超過轉換器所擁有的(大量大型圖片)。請縮減圖片或上傳 PDF。」 | 在 Word 中壓縮圖片(圖片格式 → 壓縮圖片),或上傳 PDF。 |
| 「無法儲存 file:檔案已損毀或不是 PDF。」 | 從建立該 PDF 的程式重新儲存 PDF。 |
| 「只有 Word 文件(.docx)和 PDF 可以成為 Artifact。未加入:files。」 | 請先將其他格式另存為 .docx 或 PDF。 |
| 單一檔案上限訊息 | 檔案超過您方案的單一檔案上限。Word 檔案還會收到另存為 PDF 的建議。 |
無法加入檔案時,不會保留任何內容:沒有 Artifact、沒有版本,上傳的檔案也會被刪除。
限制
| 方案 | 每個檔案 |
|---|---|
| Free / 學術 | 10 MB |
| Individual | 25 MB |
| Team | 100 MB |
- 在任何方案中,超過 100 MB 的 Word 檔案都無法轉換。
- 單一檔案上限適用於您上傳的檔案。儲存的 PDF 會計入專案和您的儲存空間。
- Word 和 PDF Artifact 可用於 LML 專案。