標籤連結

功能概述

標籤連結是一個在 Revit 內部開啟的單視窗工具（視窗標題為「標籤連結」）。它會自動連結你當前開啟的專案檔案：你指定一張平面視圖、勾選要處理的元件類型、選定文字標註的樣式與要寫入的參數，工具就會把視圖中每一筆文字標註的內容，自動寫入「距離最近」的目標元件參數裡。

簡單說：圖面上已經畫好的門窗編號、設備型號文字，不用再手動逐筆填進元件參數——按一次「連結」全部搞定。原始的文字標註會保留在圖面上，工具只更新元件參數，之後用這些參數產門窗表、做統計都方便。

30 秒快速開始

1. 在 Revit 中開啟專案檔案，並切換到要處理的平面視圖。
2. 在「BIM-Watson 在地化系統」分頁 →「BIM-Watson 輔助設計工具」面板，點擊「標籤連結」按鈕（首次使用若跳出「登入」視窗，先完成登入）。
3. 「標籤連結」工具視窗出現並自動連結當前檔案（同一時間只開一個視窗；視圖、族群、字型三筆設定先用「使用當前」「挑選」快速帶入）。

工具視窗長什麼樣？（單一視窗、5 個區域）

本工具是單一視窗、沒有分頁。介面依「左 → 右」排列 5 個設定區域，視窗底部有一列結果清單。下表是各區域的用途，建議先熟悉它：

主要功能模組

前置設定

第一步：開啟並連結

1. 在 Revit 中開啟目標專案檔案，並切換到要處理的平面視圖。
2. 在「BIM-Watson 在地化系統」分頁 →「BIM-Watson 輔助設計工具」面板，點擊「標籤連結」按鈕。
3. 「標籤連結」工具視窗出現並自動連結當前檔案（單一執行個體：重複執行指令只聚焦已開啟的視窗，不會疊加第二個）。
4. 若先跳出「登入」視窗，完成登入後再繼續。

關閉 Revit 檔案時，工具視窗會自動關閉。

第二步：選擇處理範圍

1. 「視圖」清單：選定目標視圖（或按「使用當前」帶入目前開啟的視圖）。注意清單預設選中的是第一列（高程最低的平面），務必確認選到你要的視圖。
2. 「族群」清單：勾選目標族型式；或按清單下方的「挑選」到圖面點選元件帶入。挑選時在 Revit 視圖點一個或多個元素，按空白鍵或 Enter 結束，Esc 取消。
3. 「字型」清單：選定文字標註樣式；或按「挑選」點一筆文字標註自動帶入其樣式。
4. 「連結欄位」清單：選定要寫入的參數（清單依勾選的族群自動產生，需等族群勾選後才有內容）。

第三步：執行並觀察結果

1. 檢查五項設定：「視圖」（選對視圖）、「族群」（至少勾一個）、「字型」（選對樣式）、「連結欄位」（非空）、「鍵結距離」（符合圖面密度）。
2. 按「連結」。執行是異步的：按後按鈕變灰，等 Revit 空檔時開始處理，完成後按鈕恢復。
3. 結果看兩處：視窗底部清單逐行列出「元素:ID 家族名稱型式名稱」；日誌回報「已連結N元素」。
4. 跑錯了：一次執行是單一操作，在 Revit 按一次 Ctrl+Z 可整次復原（中間不要做其他操作）。

操作步驟

本工具是單一視窗、沒有分頁。本章依視窗實際的左→右布局分成 5 個區域（另加底部結果清單），每個功能都標明位置（📍 所在清單與按鈕）。介面重複出現的動詞：「使用當前」（帶入目前視圖）、「挑選」（到圖面選取）、「連結」（執行）。

區域 1：「視圖」清單（選定處理目標）

決定工具要掃描哪一張平面視圖；所有後續設定與執行都作用在這張視圖上。

1.1 選定目標視圖

📍 「視圖」清單（最左，欄位標題「視圖」）

一句話：從模型的「樓層平面」與「機械平面」清單中選定要處理的那張；切換選取會同時刷新右側「族群」清單。

1. 查看「視圖」清單：列名格式為「FloorPlan:視圖名」（樓層平面）或「EngineeringPlan:視圖名」（機械平面），依所屬樓層高程由低到高排列；開窗時預設選中第一列。
2. 選取目標視圖的列（確認選到的才是你要處理的視圖）。
3. 確認右側「族群」清單已刷新成該視圖內包含的元件類型。

1.2 使用當前

📍 「視圖」清單 → 按 使用當前（清單下方）

一句話：一鍵把「Revit 目前開啟的視圖」選為處理目標，免得到清單找。

1. 在 Revit 中切換到目標平面視圖。
2. 回到工具視窗按 使用當前，「視圖」清單中對應列即被選中。
3. 若目前視圖不是樓層平面／機械平面，清單沒有對應列、不會有任何變化——請直接在清單選列。

1.3 雙擊切換到該視圖

📍 「視圖」清單 → 雙擊任一列

一句話：把 Revit 的目前視圖切換到該列的視圖，方便到圖面核對文字與元件。

1. 在「視圖」清單雙擊目標列。
2. Revit 目前視圖即切換到該視圖，可直接到圖面檢查標註位置。

區域 2：「族群」清單（選定要鍵結的元件類型）

決定標註文字可以寫入哪些「族型式」；清單列出選定視圖內的所有族實例類型（門、窗、牆、樓板、設備……都在內）。

2.1 勾選族型式

📍 「族群」清單（欄位標題「族群」，最左有複選框）

一句話：勾選一個或多個族型式——執行時只有勾選類型下的元件會參與配對，不勾任何類型就沒有任何元件被處理。

1. 查看「族群」清單：每列是選定視圖中的一個族型式，列名格式為「型式名:家族名」（例如「D-101:門」）。
2. 逐個勾選目標類型；牆、樓板等類型也在清單中，只勾你確定要鍵結的，避免文字被寫進不相干的參數。
3. 每次勾選狀態改變，右側「連結欄位」清單會自動更新（見 2.3）。

2.2 到圖面挑選勾選

📍 「族群」清單 → 按 挑選（清單下方）

一句話：直接在 Revit 圖面點目標元件，對應的族型式就會被勾選，不用在清單裡找名字。

1. 按 挑選，焦點轉到 Revit 視圖。
2. 點選一個或多個目標元件（可混合不同類型，例如同時點門與窗）。
3. 按空白鍵（或 Enter）結束挑選：清單會先清空原來的勾選，再只勾上被點元件對應的族型式。
4. 中途按 Esc 取消則維持原本的勾選狀態不變。

2.3 「連結欄位」清單隨勾選自動產生

📍 「連結欄位」清單（左四，沒有按鈕、內容自動產生）

一句話：自動列出「所有已勾選族型式共同擁有的、可寫入的文字（字串）參數」，按名稱排序並預選第一項；它決定你能選哪些參數寫入。

1. 在「族群」清單勾選族型式。
2. 看「連結欄位」清單：勾選類型共有的字串參數（例如「標記」「說明」）會出現在清單中。
3. 清單為空＝所勾類型之間沒有共用的可寫入字串參數：調整勾選範圍，或先在 Revit 中讓各類型擁有同名文字參數。

區域 3：「字型」清單（選定要認的文字標註）

決定視圖中哪一種「文字標註樣式」是文字來源：執行時只有選定樣式的文字標註會被讀取與配對。

3.1 選定文字標註樣式

📍 「字型」清單（欄位標題「字型」）

一句話：從整個專案的所有文字標註樣式中，選出畫門窗編號／設備型號所用的那一個（預設選中第一項）。

1. 查看「字型」清單：列出專案中所有文字標註樣式（不是單一視圖的），按名稱排序。
2. 選定標註所用的樣式列。
3. 不確定是哪個樣式時，改用下方「挑選」點一筆文字標註帶入（見 3.2）。

3.2 挑選文字標註帶入

📍 「字型」清單 → 按 挑選（清單下方）

一句話：到圖面點一筆現有的文字標註，工具自動選中它的樣式，免得手動認名字。

1. 按 挑選，焦點轉到 Revit 視圖。
2. 點選一筆要作為來源的文字標註（只能點一筆）。
3. 「字型」清單自動選中該標註的樣式；Esc 取消則維持原選取。

區域 4：「連結欄位」與「鍵結距離」（寫入目標與範圍）

決定「寫進哪個參數」與「配對允許的最遠距離」——這兩個設定直接決定執行結果的正確性。

4.1 選定連結欄位

📍 「連結欄位」清單（左四）

一句話：選定標註文字要寫入哪個參數——執行後，被鍵結元件的該參數值會被更新為標註文字。

1. 確認「連結欄位」清單有項目（為空時見 2.3 的說明）。
2. 選定目標參數列（例如「標記」）。
3. 記下：執行後該參數的既有值會被標註文字覆蓋，請選對欄位再執行。

4.2 設定鍵結距離

📍 「鍵結距離」輸入框（最右區域，輸入框右側有「mm」標籤）

一句話：設定標註與元件允許配對的最大距離——只有「水平距離小於此值」的最近元件會被鍵結，距離太遠的標註會被跳過。

1. 查看目前數值：預設 2000，單位 mm，範圍 1 至 9999999，可輸入一位小數。
2. 依圖面密度調整：疏鬆佈局可用 3000–5000；密集佈局縮到 1000 以下，避免把文字配到相鄰元件。
3. 注意距離是「水平（平面 X/Y）距離」：高程差異不計入；視圖中顯示的其他高程元件（若 XY 最近）也可能被配對。

區域 5：「連結」與底部結果清單（執行與驗證）

一切設定完成後按「連結」執行；結果顯示在視窗底部的清單，並輸出到日誌。

5.1 按「連結」執行鍵結

📍 連結 按鈕（最右區域、「鍵結距離」輸入框下方）

一句話：掃描選定視圖中所有「選定樣式」的文字標註，為每筆找出「鍵結距離」內最近的勾選類型元件，把標註內容寫入選定的「連結欄位」參數。

1. 確認五項設定：「視圖」選對、「族群」至少勾一個、「字型」選對、「連結欄位」非空、「鍵結距離」合理。
2. 按 連結。
3. 按鈕變灰：執行為異步（等 Revit 空檔處理），完成後自動恢復；期間請勿重複按。
4. 完成後看底部結果清單（逐行列出）與日誌的「已連結N元素」。
5. 切到 Revit 視圖，選取被鍵結的元件、在屬性中確認參數值已寫入；原始文字標註仍保留在圖面上。

5.2 查看結果清單

📍 結果清單（視窗底部、橫跨整列，無欄位標題）

一句話：每次執行後逐行列出本次成功鍵結的元件，格式「元素:ID 家族名稱型式名稱」；雙擊任一行可到 Revit 選取該元件驗證。

1. 執行完成後查看底部清單：本次結果會清空上一次的內容後重新填入；「已連結0元素」表示本次沒有可配對的標註。
2. 先在「視圖」清單雙擊、把 Revit 切到被處理的視圖（選取動作發生在目前視圖）。
3. 雙擊結果清單的一行：對應元件在 Revit 中被選取（只選取、不縮放），到屬性面板檢查「連結欄位」的參數值。

使用技巧與注意事項

名詞對照表（先花 2 分鐘看這個）

本工具介面文字與 Revit 中文術語混用，下列是最常遇到、也最容易混淆的：

高效作業建議

重要注意事項

進階應用提示

常見疑難排解

快速查詢：遇到什麼狀況用什麼功能

功能索引表（依區域）

常用工作流卡片