shuotao 批次套用 ViewTemplate 到多個 view
Prerequisites
- Revit 已開啟目標專案
- 目標 ViewTemplate 已存在於專案中（不會自動建立）
- MCP Server 已連線：
ToolSearch select:mcp__revit-mcp__get_view_templates,mcp__revit-mcp__batch_apply_view_template,mcp__revit-mcp__get_sheet_viewport_details,mcp__revit-mcp__get_viewport_map
概念
ViewTemplate 控制 view 的視覺樣式（DetailLevel、HiddenCategories、Filters、Scale、CropBox 設定等）。把多個 view 套到同一個 template，可確保整套圖紙視覺一致。
batch_apply_view_template 用 additive union 方式選 view — 多種選擇器可同時使用，結果取聯集並去重：
| 選擇器 | 用途 |
|---|---|
sheetIds / sheetNumbers |
套用到圖紙上所有 viewport 對應的 view（最常用） |
viewIds |
精確指定 view ElementId 清單 |
viewNames |
精確匹配 view 名稱清單 |
viewNameContains |
名稱子字串匹配（最方便但需注意誤配） |
可選 viewTypeFilter（如 ["FloorPlan", "Section"]）做最後過濾。
Workflow
步驟 1：確認目標 ViewTemplate
呼叫 get_view_templates 列出專案所有 template，跟使用者對齊：
- 確認目標 template 名稱（大小寫/中英文需完全一致）
- 確認 template 的 ViewType — 套到不相容的 view type 時 Revit 可能無聲忽略部分設定
- 記下 template ElementId（更穩定，不受改名影響）
若使用者直接給名稱，可不先列。
batch_apply_view_template找不到時會回列出所有可用 template 供 discovery。
步驟 2：盤點目標 view 範圍
跟使用者確認選 view 的方式：
情境 A：以圖紙為單位（最常見）
「把 A101–A105 這五張圖紙裡所有 view 都套上『建築平面圖』template」
- 直接用
sheetNumbers: ["A101", "A102", "A103", "A104", "A105"] - 或先
get_all_sheets撈出來確認
情境 B：以 view 名稱模式
「所有『(開審)』後綴的 view 都套上 XX template」
- 用
viewNameContains: "(開審)" - 加
viewTypeFilter: ["FloorPlan"]避免誤配 Section/Schedule
情境 C：精確指定
- 使用者給 view ID 或名稱清單，用
viewIds或viewNames
步驟 3：強制 dryRun 預覽（重要 SOP）
先用 dryRun: true 跑一次，確認會被影響的 view 清單：
batch_apply_view_template({
"viewTemplateName": "建築平面圖",
"sheetNumbers": ["A101", "A102", "A103", "A104", "A105"],
"viewTypeFilter": ["FloorPlan"],
"dryRun": true
})
dryRun 回傳檢查重點：
ModifiedCount— 數量是否符合預期（與圖紙上的 view 數對得上嗎？）Modified[].PreviousTemplate— 從哪個 template 換過來？有沒有意外（例如其實已經是對的 template）Modified[].ViewType— 是否包含不該被改的類型（用viewTypeFilter排除）Skipped[]— 哪些被跳過（已使用相同 template是正常的）Failed[]— 是否有錯誤
步驟 4：跟使用者確認後正式執行
把 dryRun 拿掉再跑一次（其他參數一樣）：
batch_apply_view_template({
"viewTemplateName": "建築平面圖",
"sheetNumbers": ["A101", "A102", "A103", "A104", "A105"],
"viewTypeFilter": ["FloorPlan"]
})
步驟 5：視覺驗證
- 在 Revit 開任一張處理過的 sheet
- 點選 view → Properties 面板查看
View Template欄位是否為目標 template - 確認視覺效果（HiddenCategories / Filters / Scale 等）符合預期
常見陷阱
1. ViewTemplate 找不到（錯字／繁簡體／空白差異）
工具回傳會列出所有可用 template。仔細比對名稱（含中英文/全半形/前後空白）。建議用 viewTemplateId 替代 name 避免改名後失效。
2. View 已經是對的 template（被當成跳過）
預設 skipIfSameTemplate: true，已套用相同 template 的 view 會記到 Skipped[]（Reason: 已使用相同 template）。這是設計如此，不是錯誤。
3. View 是 template 本身
工具會跳過 IsTemplate == true 的 view（不能把 template 套到 template 上）。
4. ViewType 不相容
Schedule、Legend、DraftingView 等可以接收 ViewTemplate，但 template 內針對 ViewType 不適用的設定（如 DraftingView 沒有 DetailLevel）會被忽略。建議用 viewTypeFilter 限定到目標類型。
5. 圖紙上的 view 不只主圖
sheetNumbers 會抓該 sheet 上所有 viewport 對應的 view，包含 callout、detail view 等。若只想處理主平面圖，加 viewTypeFilter: ["FloorPlan"]。
6. Additive 選擇器疊加
若同時給 sheetNumbers + viewNames，結果是聯集（不是交集）。要交集效果請拆兩次呼叫：先 dryRun 看 sheet 上有哪些 view，再用 viewNames 精確指定。
7. CropBox 會跟著 template 改變
ViewTemplate 若控制了 CropBox（CropBoxActive / CropBoxVisible / 甚至 CropBox 邊界），套用後 view 的裁剪範圍會被覆蓋。若 view 之前有手動調整的 CropBox，會被 template 蓋掉。先 dryRun 看 PreviousTemplate，若是 <None> 表示這個 view 之前沒 template，套用後改變最大。
8. Phase / Phase Filter 不會跟著改
ViewTemplate 在 Revit 預設不控制 Phase / Phase Filter（兩個欄位通常設成 <not controlled>）。若需要連 Phase 也統一，要另外用 modify_element_parameter 處理。
與其他 Skill 的搭配
跨專案複製後統一樣式
copy-sheets-cross-project (跨專案複製 sheets + views)
↓
batch-apply-view-template (本 skill：把新 view 套上目標檔的 template)
↓
align-views-on-sheets (套 ScopeBox + 對齊 viewport 位置)
補齊新建樓層平面圖
floor-plan-from-template (依範本建新 view，已自帶範本的 ViewTemplate)
↓
（通常不需要本 skill，因為建立時已套）
但若要改成不同 template → 用本 skill
Reference
- C# 實作：
MCP/Core/Commands/CommandExecutor.ViewCreation.cs（BatchApplyViewTemplate方法） - Tool schema：
MCP-Server/src/tools/view-creation-tools.ts - 相關 skill：
align-views-on-sheets— 套完 template 後對齊範圍與位置floor-plan-from-template— 建立新 view 時帶入 templatecopy-sheets-cross-project— 跨專案複製，常接本 skill 後處理