P3DSync 說明文件

P3DSync 處理的是 Plant3D 資產（管線、閥件、設備及其 UDA 屬性）—— 而非一般的 AutoCAD 圖塊參考。若您需要擷取或寫回的是一般圖塊參考及其屬性，請改用 BlockSync。P3DSync 有兩種模式，可透過標題列上的切換鈕切換：Plant3D → Excel（擷取）與 Excel → Plant3D（寫回）。擷取模式是單一畫面，內含 Assets/Layers/Viewports 分頁組；寫回模式則是一連串較短的步驟 —— 選取活頁簿與資料夾、檢視差異、寫回，最後另有一個結果畫面。這兩種模式都需要專案的 Plant3D Project Database（ProcessPower.dcf），才能讀取或寫入資產的 Tag、幾何與圖層以外的內容，因為自訂（UDA）屬性存放於該資料庫中，而非圖面實體上。

快速上手

截圖來自較新版本 —— 與您安裝的版本相比，視覺細節可能略有差異。

Plant3D → Excel (extract)

加入檔案並掃描

加入圖面，P3DSync 會自動掃描資產類別、圖層與視埠。

• Add Files… 用於選取個別 .dwg 檔案；Add Folder… 會掃描整個資料夾中的 .dwg 檔案 —— 是否同時掃描子資料夾取決於 "Include subfolders when opening a DWG folder"（Settings → AutoCAD，預設關閉）。
• 新增、移除或清空檔案都會自動重新掃描整批檔案，並顯示即時的逐檔進度條。
• 檔案清單顯示名稱、路徑，以及以顏色標示的 Status/Details 欄位；掃描失敗的檔案會標示其錯誤並略過，不會影響批次中其他檔案的正常掃描。
• 清單下方的狀態列會回報整批已掃描檔案的合計結果："{n} asset classes, {n} layers, {n} viewports across {n} file(s)."

指向 Plant3D Project Database

設定一次 ProcessPower.dcf，讓 Include attributes 能實際讀取 UDA 數值。

• P3DSync 會自動偵測 DWG 資料夾旁或其上一層的 ProcessPower.dcf —— 若專案資料庫位於其他位置，可使用 Browse… 覆寫此設定。
• 若未設定專案資料庫，擷取作業仍可正常取得 Tag、幾何與圖層 —— 只是無法取得自訂（UDA）屬性，因為這些屬性存放於專案資料庫中，而非圖面實體本身。

選擇資產類別、圖層與視埠

確切選擇要匯出哪些類別 —— 以及每張圖面的哪些部分。

• Assets 分頁列出每個已掃描的類別，附有其參考數量、有多少檔案包含此類別、是否具有屬性，以及（若有）內嵌預覽縮圖 —— Details… 可在正式決定匯出前查看該類別的完整內容。
• 可依名稱搜尋，或使用 Select All / Select None / Invert 來管理包含數十種類別的專案核取清單。
• 切換至 Layers 或 Viewports 分頁可進一步縮小匯出範圍 —— 僅會擷取位於（或透過）已勾選圖層或視埠可見的資產；不勾選任何項目則會如常擷取全部內容。
• Save Profile… 會將目前的類別（或圖層）選取內容以名稱儲存，供日後重複使用；Load Profile 則會重新套用該選取內容。Free 版將此上限設為 1 份已儲存設定檔 —— 既有設定檔可隨時被覆寫。

擷取選項與執行匯出

選擇要包含的內容，然後產生活頁簿。

• Include attributes 會從 Plant3D 專案資料庫擷取每個資產的自訂（UDA）屬性，連同其 Tag 一併擷取 —— 需先設定專案資料庫（見上方說明）。
• Include geometry 會加入位置/旋轉角度欄位；Include layer info 會加入圖層欄位；Space scope 可將擷取範圍限制為 model space、paper space 或兩者皆包含。
• Parallel processing 會在效能足夠的電腦上同時掃描並擷取多個檔案 —— 速度較快，但會使用較多記憶體。
• Extract to Excel… 會將一個附時間戳記的 P3DSync_Export_{date}_{time}.xlsx 寫入畫面上顯示的輸出資料夾（預設為您的 DWG 共同所在的資料夾），每個資產類別各佔一個工作表，另附一個 _P3DSync 中繼資料工作表（P3DSync/AutoCAD 版本、來源檔名與 SHA-1 雜湊值、已選取的類別/圖層名稱）。

Excel → Plant3D (write back)

將已編輯的活頁簿比對回圖面

選取 Excel Workbook 以及要與之比對的 DWG 資料夾。

• Choose Excel Workbook… 用於選取已編輯的匯出檔；"Same folder as Excel file"（預設開啟）會將 DWG 資料夾設為活頁簿本身所在的資料夾，純粹依精確檔名比對，因此移動活頁簿位置不會造成混淆。
• P3DSync 會自動偵測 Plant3D Project Database 與 DWG 旁的備份資料夾 —— Browse… 可覆寫其中任一設定。
• 在資料夾中找不到對應 DWG 的列，會顯示於附有數量標記的 Unmatched 分頁中，而不會靜默失敗或阻擋批次中其他項目的處理。

檢視差異預覽

在寫入任何內容前，逐檔、逐屬性確切查看將發生的變更。

• Diff preview 分頁會列出每個已比對的檔案，附有變更數量與被阻擋數量。選取檔案即可查看完整表格：File、Handle、Class、Attribute、Current、New，每列並標示 WillChange / NoChange / CannotWrite 及其原因。
• Show unchanged rows 預設關閉，讓大型批次不會將真正需要注意的少數變更淹沒其中。
• Export Preview… 會將差異表格本身儲存為獨立的活頁簿，方便在寫入前將確切的計畫變更交由他人簽核。

寫回並驗證

寫入已勾選的檔案，然後確認每項變更是否確實生效。

• 勾選確切要納入的檔案，然後點擊 Write Back。確認對話框會明確說明即將異動多少個檔案、多少項屬性變更。
• 「Automatic backup before writing」（預設開啟）會在修改每個檔案之前將其原樣複製到備份資料夾——專案資料庫（ProcessPower.dcf）也會在每次執行的首次寫入前備份一次。任一備份失敗時，該檔案不會寫入任何內容。
• 寫入完成後，P3DSync 會直接從圖面與專案資料庫中重新讀取每個已變更的 Tag 與屬性，以驗證是否符合預期 —— 任何不一致都會在結果報告中明確指出，而不是逕自假設寫入成功。
• 結果報告中的 Rollback All 可一鍵從寫入前的備份還原該次執行修改過的所有檔案以及專案資料庫。寫回畫面的 Restore Backup… 可以從先前任意一次執行的備份還原，而不僅限於目前執行。每個圖面的資料庫修改只會在該圖面儲存成功後才認可，因此失敗的檔案不會讓資料庫處於只改了一半的狀態。