HCL Domino 日報 — 每日技術精選
HCL Domino 中英雙語日報,每日精選生態系最新動態與技術深度文章。
最新文章
- XPages 用 DXL:方法名是 createDxlExporter(不是 DXL),匯入看 DocumentImportOption
你要在 XPages 把一份文件、或整個 view 丟給外部系統當 XML,或反過來把一段 XML 餵進來變成 Notes 文件。DXL(Domino XML)就是 Domino 原生的 XML 格式,而 session 兩個方向都內建了:createDxlExporter() 匯出、createDxlImporter() 匯入。這裡第一個坑就在名字——是 createDxlExporter,不是你直覺會打的 createDXLExporter(DXL 大寫),大小寫錯了就找不到方法。第二個坑在匯入:DocumentImportOption 的預設值是 DXLIMPORTOPTION_CREATE(永遠新建),所以同一份 DXL 匯兩次會變成兩份重複文件;要「有就更新、沒有才建」得自己改成 REPLACE_ELSE_CREATE 或 UPDATE_ELSE_CREATE。這篇講匯出、匯入、那個命名坑,以及為什麼每次都要看 Log。
2026.11.22 - Java 的 ViewEntryCollection:stampAll 一次改,FTSearch 窄化,集合運算組條件
你用 view.getAllEntries() 或 getAllEntriesByKey(key) 拿到一批照 view 排序的文件 entry,接下來要對它們做事:把某個欄位全部改成同一值、把範圍再用全文搜尋縮小、或把「A 查詢的結果」扣掉「B 查詢的結果」。第一反應是迴圈、每筆 getDocument 再 save——但 ViewEntryCollection 本身就有批次與集合運算:stampAll 一次改整批某個欄位、FTSearch 原地把集合窄化成符合的子集、intersect/merge/subtract 做交集聯集差集。這篇講這三招、getNthEntry 依位置取、以及走訪前要把 view 的 autoupdate 關掉(否則會 Entry not found in index)和每個 entry 要 recycle。
2026.11.21 - XPages 的 ACL:查權限用 queryAccess,改權限要 sessionAsSigner 提權
在 XPages 跟 ACL 打交道通常是兩件事,做法完全不同。一是查:這個登入者是不是 Editor 以上、有沒有某個角色,用來決定一個按鈕顯不顯示、一個 panel 渲不渲染——這用 database.getCurrentAccessLevel()、queryAccess(name)、queryAccessRoles(name) 就好,不必開 ACL 物件。二是改:做一個管理介面去調別人的權限——這要開 getACL、改完 save,但網頁上的使用者多半不是 Manager,改不動 ACL,得透過 sessionAsSigner 以設計元件簽署者的身分提權。這篇把這兩種場景分清楚:查權限的幾個捷徑、怎麼跟 LEVEL 常數比、角色門禁,以及為什麼改 ACL 一定繞 sessionAsSigner。
2026.11.20 - Java 改 ACL:不呼叫 save(),關庫後全部白改
你在 Java 用程式改一個資料庫的 ACL:把某個人升到 Editor、幫他開一個 role、再加一條新 entry。每一步 API 都成功、沒報錯。結果重開資料庫一看,什麼都沒變。原因是 ACL 的修改不會自動存——官方白紙黑字:不在關庫前呼叫 save,你對 ACL 做的改動就會遺失,而且沒有任何警告。這篇講怎麼拿 ACL、改一條 entry 的 level、roles 的「定義」與「授予」是兩層、最大的那個 save 坑,以及別把 Database 的 grantAccess 跟手上的 ACL 物件混用。
2026.11.19 - Java 的 QueryResultsProcessor:多來源結果跨庫合併排序,輸出 view 或 JSON
你手上有來自三個不同資料庫的文件集合,要合成一份、照同一個欄位排序、算個小計,最後給前端一段 JSON 或存成一個 view。土法是把三批都拉進記憶體、自己 merge、自己 sort——跨庫、資料量一大就撐不住。QueryResultsProcessor(R12 之後)把這件事做在 server 端:官方一句話是「Aggregates, computes, sorts, and formats collections of documents across any set of Domino databases.」。你用 addCollection / addDominoQuery 把多個來源(各給一個唯一名稱)餵進去、用 addColumn 定義要回哪些欄與怎麼排,再 executeToView 存成一個會自動過期的 results view、或 executeToJSON 直接拿 JSON。這篇講這個「多輸入、一輸出」的形狀、兩種輸出的差別與坑,以及建立它的方法名(官方頁自己寫錯的那個)。
2026.11.18 - XPages 的 NotesName:getCommonUserName 省一步,比對還是要正規化
在 XPages 要顯示登入者的名字,很多人會寫 session.createName(session.getUserName()).getCommon()。其實不用——session 本身就有 getCommonUserName(),一步拿到 common 名;要一個 NotesName 物件也有 getUserNameObject() 直接給你。這是 XPages 比後端 Java 方便的地方。但有一件事 XPages 省不掉:比對使用者名稱、或用 OU 做條件可見性(rendered)時,還是會踩「同一個人 canonical 和 abbreviated 不相等」的坑,一樣要 createName 正規化成同一形式再比。這篇講 session 的幾個名字捷徑、XPages 裡怎麼正確比對與判斷 OU,以及把名字存進 Readers 欄位時該用哪種形式。
2026.11.17 - Java 比對 Notes 使用者名稱:同一個人卻不相等?先正規化再比
你在 Java 比對兩個 Notes 使用者名稱——一個是登入者 session.getUserName()、一個是存在文件裡的簽核人。明明是同一個人,字串 equals 卻回 false。原因是同一個人的名字在不同地方形式不一樣:一邊是 canonical 的 CN=John B Goode/O=Acme/C=US,另一邊是 abbreviated 的 John B Goode/Acme/US,或只是 common 的 John B Goode。直接比字串當然不相等。正解是用 session.createName 把兩邊都正規化成同一形式(例如都 getCanonical)再比。這篇講 Name 的三種形式、怎麼正確比對、怎麼拆出名字的各個部分(OU、O、C)來判斷某人在不在某個組織單位,以及它也能解析 RFC 821/822 的 internet 地址。
2026.11.16 - XPages 的 ViewEntry:用 getColumnValues 讀 view,不開每份文件
在 XPages 你要列一批資料——一個 typeahead 清單、一段 JSON、一個自訂的 repeat。資料都在某個 view 的欄位裡。直覺是走訪 view、每一列 getDocument 再讀欄位,但那等於把每份文件都開一次,大 view 很慢。NotesViewEntry 讓你直接讀索引層的欄值:getColumnValues 回的是這一列在 view 裡每一欄的值,整趟可以一份文件都不開。這篇講在 XPages 怎麼拿 ViewEntry、getColumnValues 怎麼用、一個容易混淆的點(getAllEntries 回的集合只含 document 列,分類列要改用 ViewNavigator),以及 XPages 不像 Java 要自己 recycle。
2026.11.15 - Java 的 ViewNavigator:讀大 view 要關 autoupdate、設 CacheSize
一個十幾萬筆的 view,你在 Java 要走過每一列做點事。用 getAllDocuments 會先把整批拉進記憶體,大 view 直接撐爆。ViewNavigator 不一樣——它沿著 view 的索引一列一列走,拿到的是 ViewEntry(索引層的 row 資料),不必逐筆開 Document。但要它真的快,有三個旋鈕得自己調:把 IsAutoUpdate 設成 false(背景自動更新會降效、還會讓 navigator 手上的 entry 失效),遠端操作時設 CacheSize 減少 server 往返,還有只需要移動指標、計數時用 goto 系列而不是 get 系列(官方明說 goto 不會建立 ViewEntry 物件)。這篇講怎麼建對走訪範圍、這三個效能旋鈕,以及走訪時每個 entry 要 recycle 的記憶體紀律。
2026.11.14