Named Document って何？ 12.0.1 で登場した文書タイプを 12.0.1 で検証しました 中野 晴幸 Haruyuki Nakano harunakano.blogspot.com (blog) @harunakano (twitter)

「Named Document」とは 1. NoteID ではなく名前を持っている 2. Notes クライアントやビューには表示されない 3. プログラムによるアクセスのために設計されてい る 4. キャッシュは（プロフィール文書ほど）効かない 5. プロフィール文書の機能的な置き換えとなる

「Named Document」とは 1. NoteID ではなく名前を持っている 2. Notes クライアントやビューには表示されない 3. プログラムによるアクセスのために設計されてい る 4. キャッシュは（プロフィール文書ほど）効かない 5. プロフィール文書の機能的な置き換えとなる

文書に名前を付ける 構文： NotesDatabase.GetNamedDocument( 名前, ユーザー名 ) 例： db.GetNamedDocument( “Player”, “Ichiro Suzui” ) 名前とユーザー名を指定して文書 へアクセスし、指定した文書が 無ければ作成される ※CreateNamedDocument と いったメソッドは無い 名前とユーザー名が 同じ文書を複数作成 できない ユーザー名は省略できる

文書に NoteID が無いわけではない

「Named Document」とは 1. NoteID ではなく名前を持っている 2. Notes クライアントやビューには表示されない 3. プログラムによるアクセスのために設計されてい る 4. キャッシュは（プロフィール文書ほど）効かない 5. プロフィール文書の機能的な置き換えとなる

Notesクライアントに表示されない  Compose @コマンドでは Named Document にならない  プロフィール文書をフォームで表示するコマンド/メソッドは現状無い @Command([EditProfileDocument]) の Named Document 版無し NotesUIWorkspace クラスの EditProfile メソッドの Named Document 版無し  NotesUIWorkspace.EditDocument メソッドの使用でフォームに表示することは可能 （だが、保存すると “Form” などのアイテムが作成される）

ビューに表示されない  「ビューの選択」に式「SELECT @All」を指定 したビューに表示されない  フォルダへ追加するメソッドを実行しても追加 されない

「Named Document」とは 1. NoteID ではなく名前を持っている 2. Notes クライアントやビューには表示されない 3. プログラムによるアクセスのために設計されてい る 4. キャッシュは（プロフィール文書ほど）効かない 5. プロフィール文書の機能的な置き換えとなる

プログラムによるアクセスに特化  LotusScript とJava に新たなメソッドが追加された  現状は @GetProfileField/@SetProfileField のような @関数 は存在しない  文書の作成と既存文書へのアクセスはともに GetNamedDocument を使用す る

「Named Document」とは 1. NoteID ではなく名前を持っている 2. Notes クライアントやビューには表示されない 3. プログラムによるアクセスのために設計されてい る 4. キャッシュは（プロフィール文書ほど）効かない 5. プロフィール文書の機能的な置き換えとなる

キャッシュの検証（未保存文書の読出し） Name Document プロフィール文書

保存せず閉じた文書を再び開くと Name Document  新規文書が開く プロフィール文書  閉じる前の状態を維持 プロフィール文書ならデータベースが開いている間は 文書が未保存でも設定した値の取得が可能だが NamedDocument は取得できない

「Named Document」とは 1. NoteID ではなく名前を持っている 2. Notes クライアントやビューには表示されない 3. プログラムによるアクセスのために設計されてい る 4. キャッシュは（プロフィール文書ほど）効かない 5. プロフィール文書の機能的な置き換えとなる

プロフィール文書の機能的な置き換え  キャッシュが利きすぎる事がプロフィール文書の扱いの難しさとなっているが Named Document はプロフィール文書ほどキャッシュが利かない プロフィール文書の場合、変更内容を保存せずに一旦データベースを閉じて開き なおしても変更内容は維持されたままだが、Named Document はそうならな い  複製競合は（プロフィール文書と同じ仕組みで）発生しない 【参考】KB0036541 プロフィール文書の複製競合について https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0036541

現状の不具合

競合文書が発生する  プロフィール文書は競合文書が発生しない  Named Document はプロフィール文書の後継機能のため、競合文書を作成する べきではない  この問題は SPR CSAOCAEFP4 として開発部門に報告されている  再現手順と現状の回避策などが技術情報 KB0095930 で公開されている Notes Named Document で競合文書が発生する

正しい値が返されない  GetNamedDocCollection で Named Document のコレクションを取得しよう としても正しい値が返されない問題あり  この問題は SPR MNIAC9Z6H3 として開発チームに報告されている  技術情報 KB0096802 が公開されている Named document method GetNamedDocCollection does not work properly

ヘルプの誤り

GetNamedDocumentCollection (NotesDatabase - LotusScript) https://help.hcltechsw.com/dom_designer/12.0.0/basic/H_GETNAMEDDOCUMENTCOLLECTION_METHOD.html 文書コレクションを取得するためのメソッドの名前 GetNamedDocumentCollection は誤りです

「リファレンス」タブも GetNamedDocCollection と正しいメソッド名が表示されます Domino Designer でタイプしていくと GetNamedDocCollection がリストに現れます これが正しいメソッド名です

改善要望

「高度なプロパティボックス」に表示したい 12.0.1 の新機能

スライドの最後