Holarch

控制與審查

以 Word 和 PDF 檔案作為 Artifact

將 Word 文件和 PDF 以 Artifact 形式加入專案、審查其頁面並留言、保留每個版本,並移除舊版本的檔案以釋放儲存空間。

使用方式 →

本頁內容
  1. 概念
  2. 使用方式
    1. 使用時機與原因
    2. 新增 Word 或 PDF 檔案
    3. 上傳新版本
    4. 審查與留言
    5. 較新版本上的留言
    6. 來自 Word 的留言和追蹤修訂
    7. 比較兩個版本
    8. 實作範例:CubeSat EO-1 示範專案的設計審查
    9. 提示與良好做法
    10. 常見錯誤
    11. 與其他功能的關聯
  3. 檔案區段
  4. 移除舊版本的檔案
  5. 正在新增的檔案
  6. 不轉換
  7. 訊息
  8. 限制
  9. 相關內容

Word 文件或 PDF 可以作為 Artifact 存放在您的專案中。審查者在 Holarch 中閱讀它、在其頁面上留言,並像其他任何項目一樣核准它。同一文件的每次新上傳都會成為新版本,較早的版本仍可閱讀。

在託管服務上,Word 檔案在加入時會轉換為 PDF,PDF 則會被壓縮。所有人閱讀、下載和留言的都是此 PDF。

概念

  • 檔案 Artifact:保存檔案的 Artifact。其頁面頂端有檔案區段,包含檢視器、版本和檔案工具。
  • 版本:文件的一次上傳。每個版本都會保留其 PDF、上傳者、日期和選用的附註。預設顯示最新版本。
  • 轉換:將 Word 檔案轉換為 PDF 並壓縮 PDF。所有人的檔案一次轉換一個;不同帳戶的檔案輪流處理,因此一大批檔案不會耽誤其他人。
  • 釘選留言:屬於某個版本特定位置的留言:選取的字詞、一個點、一個方框或整頁(或在 Word 檢視中為一個段落)。討論會顯示它的位置,例如「在版本 2,第 3 頁」。

使用方式

使用時機與原因

當交付項目是在 Holarch 之外撰寫時,請使用檔案 Artifact:設計審查套件、供應商的介面控制文件、測試報告。將它保存在專案中,可讓它緊鄰它所涵蓋的需求和項目。審查者在同一處留言,基準線會記錄哪個版本獲得核准。

新增 Word 或 PDF 檔案

  1. 開啟 LML 專案的資料庫。
  2. 按一下+ 新增項目,然後按一下名稱欄位下方的從 Word 或 PDF 檔案建立 Artifact…。當資料庫只顯示 Artifact 時,按鈕為+ 新增 Artifact,對話方塊中的按鈕則顯示從 Word 或 PDF 檔案…。對話方塊會關閉,並開啟檔案選擇器。

    在任何開啟「新增項目」對話方塊的地方都有相同的按鈕,例如 ⌘K / Ctrl+K → 新增項目…。您也可以將 .docx 與 .pdf 檔案拖曳到資料庫表格上,或在專案的任何頁面上按 ⌘K / Ctrl+K 並執行從檔案建立 Artifact…。

  3. 選擇一個或多個檔案。

    表格上方會顯示正在新增的檔案,以及每個檔案的狀態:「等候中(前面還有 2 個)」、正在轉換…、正在壓縮…或正在儲存…。

  4. 請等候,或繼續工作。您可以關閉分頁。

    檔案完成時,Holarch 會通知您:「Design Review.docx 已可作為 Artifact 使用。」如果您沒有開啟任何 Holarch 分頁,訊息會透過電子郵件寄送。

每個檔案會成為一個 Artifact,以不含副檔名的檔案名稱命名。通知會說明儲存的大小,例如「儲存為 2.1 MB,由 15 MB 壓縮而來。」

上傳新版本

  1. 開啟該 Artifact。
  2. 在檔案區段中,按一下上傳新版本…並選擇檔案。
  3. 可以選擇輸入新版本的附註,例如「Comments from the design review addressed」,然後按一下作為新版本上傳。

    在完成之前,頁面上會顯示「新版本 Design Review.docx:正在轉換…」。

當您加入的檔案名稱與已由同名檔案建立的 Artifact 相符時,檔案已在專案中會詢問要如何處理:

  • 作為新版本上傳(預設):檔案會成為該 Artifact 的下一個版本。
  • 兩者都保留:另建一個 Artifact,其名稱會加上「 (2)」。
  • 取消:不加入任何內容。

審查與留言

  1. 開啟該 Artifact。頁面會在文件檢視器中顯示 PDF:工具列、頁面,以及旁邊的留言面板。
  2. 以工具列瀏覽文件:第 3 頁,共 12 頁(輸入頁碼並按 Enter)、上一頁和下一頁按鈕、縮圖、縮放(符合寬度、符合頁面或固定大小)以及尋找(⌘F / Ctrl+F)。按鍵:← 和 → 翻頁,Home 和 End 前往第一頁和最後一頁,+ 和 − 縮放。
  3. 可用以下四種方式之一留言:
    • 選取文字:選取頁面上的字詞(也可以複製它們),然後按一下對選取範圍留言。這些字詞會被醒目提示。
    • 位置點:按一下頁面上留言所屬的位置。
    • 方框:在某個區域周圍拖曳出方框,例如圖形或表格。
    • 對頁面留言:針對所顯示頁面整體的留言。

      在面板中輸入留言,然後按一下新增留言(⌘Enter / Ctrl+Enter)。輸入 @ 和姓名即可提及某人。

  4. 留言面板會依頁面順序列出討論串,編號與頁面上的標記相同。按一下討論串即可前往其位置;按一下標記或醒目提示即可開啟其討論串。回覆、解決和重新開啟的運作方式與討論中相同;顯示已解決會顯示已解決的討論串。
  5. 若需要更多空間,請按一下校閱檢視(版本佔滿整個視窗)或彈出(獨立的視窗,例如在第二個螢幕上)。兩者都會在有人留言時保持最新。

每則留言都屬於其所在的版本,討論中也會顯示,例如「在版本 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 項追蹤修訂。」匯入的討論串歸您所有,因此您可以解決或刪除它們。關注該項目的人不會就每則匯入的留言收到通知。

比較兩個版本

  1. 開啟該 Artifact。在檔案區段中,按一下比較版本…(Artifact 有兩個以上版本時顯示)。
  2. 選擇較舊和較新的版本。預設會將顯示的版本與其前一個版本比較。

    兩個版本會逐頁並排顯示:

    • 已插入的字詞在較新版本上以綠色顯示。
    • 已刪除的字詞在較舊版本上以紅色顯示。
    • 已移動的句子和段落在兩處都以紫色顯示。移動後又被編輯的區塊也會顯示其字詞變更。變更清單會列出兩個頁面,例如「第 2 頁 → 第 5 頁」。
    • 沒有文字的頁面(繪圖、掃描)會以圖片方式比較。有變更的頁面會加上外框;在較新的頁面上,差異會以紅色顯示只有較舊版本有墨跡之處,以綠色顯示只有較新版本有墨跡之處。
  3. 在清單中選取一項變更,或按一下上一個和下一個(F7 和 Shift+F7),即可在兩側顯示它。同步捲動會在您捲動時讓相同的文字並排。

文字會在整份文件中比較,因此移到另一頁或重新排列到其他行的文字仍會被比對。不轉換而保留的 Word 檔案會以文字方式比較,不分頁。較長的文件在讀取時會顯示進度列。

相同的比較也會在其他地方標示文字變更:變更請求審查、項目歷程記錄、文件變更和庫差異會將移動的句子顯示為已移動,並在兩處之間以移至 / 移自連結相連。

實作範例:CubeSat EO-1 示範專案的設計審查

  1. 在 CubeSat EO-1 示範專案中,開啟資料庫,按一下+ 新增項目,並以從 Word 或 PDF 檔案建立 Artifact…加入「EO-1 CDR Package.docx」。
  2. 完成後,開啟EO-1 CDR Package並將它關聯到它所涵蓋的需求。
  3. 審查者開啟它,並在第 12 頁使用對頁面留言…:「Thermal margin table is missing the eclipse case.」
  4. 修正後,再次上傳「EO-1 CDR Package.docx」並選擇作為新版本上傳,附註為「CDR comments addressed」。
  5. 建立基準線。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 會占用儲存空間。請移除沒有人需要的版本:

  1. 在該 Artifact 上,按一下移除舊版本的檔案…。
  2. 選取版本。

    您會看到「永久移除版本 2 的檔案。該版本會保留在歷程中。」

  3. 按一下移除檔案。

    您會看到「已移除 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
Individual25 MB
Team100 MB
  • 在任何方案中,超過 100 MB 的 Word 檔案都無法轉換。
  • 單一檔案上限適用於您上傳的檔案。儲存的 PDF 會計入專案和您的儲存空間。
  • Word 和 PDF Artifact 可用於 LML 專案。