你永遠不會 new 出來的 NotesDOM 節點：唯讀的 DTD 角落

NotesDOM 實作了完整的 W3C 節點模型，這代表有四種節點型別存在於多數 XML 開發者從不碰的 DTD 角落：DocumentType、Entity、EntityReference、Notation。一份簡短地圖 —— 它們是什麼、哪一個你真的能建立（EntityReference）、哪些是已解析 DTD 的唯讀反映、以及為什麼在 2026 年你多數時候可以直接走過它們，外加那個「知道它們存在能省下一個下午」的情境。

NotesDOM 你略過的那些節點 —— 直到一次 round-trip 把註解吃掉

你用 NotesDOMParser 建好了處理 element 與 text 節點的流程。然後來了一份帶註解、CDATA 區塊、processing instruction 的 XML，你改一個值、序列化回去 —— 註解和 PI 不見了，CDATA 變成被跳脫的純文字。一篇 NotesDOM 節點家族長尾的實測報告：NodeList 那個 1-based 的 GetItem（不是 W3C 的 0-based item()）、用來批次插入的 DocumentFragment，以及你得自己建立、才留得住的 CDATA／註解／processing instruction 節點。

Domino Web View 翻頁的真相：Start 不是流水號，是階層座標

「我以為 Start=31 就是第 31 列，然後我錯了。」一篇 classic view ?OpenView Start 參數的除錯實測報告：純數字跳到第 N 個最上層分類、像 1.1.1.1.6 的點號值是階層座標、末段會 clamp 但中段不會、而你沒辦法用一個 URL 跳到絕對最後一頁。外加三個實用應用 —— 分類內序號、@DocNumber("")（含必須單獨使用的地雷）、以及用 ReadViewEntries 做麵包屑。

你的 Domino view 表頭為什麼永遠歪一格：passthrough HTML 黑魔法考古

接手一個老 classic-web Domino view，你常會發現直欄標題整體往右偏一格 —— 而且沒人知道為什麼。一篇實測報告，挖出藏在二十年前 view 設計裡的 passthrough HTML 把戲：直欄值與標題裡的方括號 HTML、間隔欄、每列 checkbox，以及真正的元兇 —— 一個故意不閉合的 <input 標籤吞掉 </td><td> 欄界線、把兩個直欄合併成一格，讓它之後的每個表頭都往右偏。

DQL 跳「Domino Query 執行時錯誤」怎麼辦：三層診斷階梯

一個 DQL 查詢失敗，你看到「Domino Query 執行時錯誤:」後面接一大串文字。一篇讀懂這個訊息的實測報告：你在 Err 裡找到的 4854 對診斷毫無用處（每個 DQL 失敗都回它），答案永遠在「詳細原因」那一行。涵蓋四段訊息結構、三層階梯（catalog / view 沒建 / partial TIMEDATE）、讓查詢時好時壞的 design catalog 半殘、以及「0 筆且無錯誤」的排查清單。

DQL view 日期直欄查詢：型別與時區怎麼無聲吃掉你的結果（三個成因）

「直欄轉成日期反而有些抓得到有些沒抓到，蠻怪的。」一篇實測報告：一個 DQL view 直欄日期查詢結果不一致，拆開來發現有三個獨立成因。DQL 從不自動轉型（所以直欄的輸出型別要跟查詢詞相符）、底層欄位存了文字與日期混型、而 @dt 不帶時區位移就是 UTC——它會在不改變總筆數的情況下弄壞邊界文件。兩個解法皆實測 6/6 全中。

NotesXSLTransformer：用 LotusScript 以 XSLT 轉換 XML 與 DXL

NotesXSLTransformer 把 XSLT stylesheet 套到 XML 或 DXL 上、寫出轉換結果 — 是 Domino XML 工具組裡繼 DOM 與 SAX parser 之後的最後一塊。本文說明 session.CreateXSLTransformer 與它的三種來源、stylesheet 必須是 stream 的規則、把 DXL export → 轉換 → import 串起來而不落暫存檔的 pipelining 模型、以及那個透過 Log 屬性與 On Error（而非事件）運作的錯誤處理。

NotesJSONNavigator：LotusScript 原生 JSON 解析，不必再做字串手術

在 Domino 10.0.1 之前，用 LotusScript 解析 JSON 意味著 Evaluate 花招或手刻的字串手術。NotesJSONNavigator 用一個真正的 parser 取代了那些：session.CreateJSONNavigator 給你一棵可用 GetElementByName、GetNthElement、JSON Pointer 路徑導覽的型別化樹。本文說明 navigator、element/object/array 類別、型別常數，以及命名上的意外（是 GetFirstElement 不是 GetFirstItem；AppendElement 是 value 在前 name 在後）。

用程式管理全文索引：CreateFTIndex、UpdateFTIndex，與本機 vs 伺服器的分界

FTSearch 要快、要能用萬用字元與相關性排序，就需要全文索引 — 而 NotesDatabase 能用 LotusScript 建立、更新、移除索引。陷阱是一個幾乎沒人料到的分界：CreateFTIndex / UpdateFTIndex / RemoveFTIndex 只對本機資料庫有效，而 FTIndexFrequency 只對伺服器有效，伺服器索引其實是由 Updall 工作管理的（updall -X 是重建、不是建立）。本文說明 options bitmask、create 與 update 的差別、以及那個分界。