LotusScript でビューへアクセスする方法 #1

この資料は、2025年9月11日開催の「第78回 のの会 」で使用したものです。
LotusScript を使い、ビューまたはフォルダの情報へアクセスする方法をサンプルコードを示して簡単に説明します。

Transcript

1. LotusScript でビューへ アクセスする方法 2025年9月11日 第78回 のの会 中野晴幸 Haruyuki Nakano harunakano.blogspot.com (blog) @harunakano (X twitter)
2. はじめに • 前回の「第77回 のの会」では、 LotusScript の NotesUIWorkspace, NotesDatabase, NotesView というクラス を使い文書へアクセスする方法を、サンプルとともに紹介しま した。 • 今回は、ビューに表示されている内容を効率よく処理するため のクラスをご紹介します。 • 本資料ですべてのメソッドを紹介できないため、よく使用され る（気がする）方法に絞っています。
3. 【参考】ビュー関連用語 • フォルダ 文書をユーザーが自由に出し入れできる文書一覧で、ビューと同様にNotesViewクラスで扱える • カラム Column 列のこと • エントリ Entry ビュー上に表示されている「カテゴリ」と「非カテゴリ」の各行のこと • カテゴリ Category エントリを同じ値でまとめる手段 • レベル Level カテゴリの階層の深さ • シブリン Sibling 同じカテゴリ階層にあるエントリ • ビューナビゲーター View Navigator ビュー内のすべてのエントリまたはサブセットへのアクセスを提供するもの
4. 【参考】フォルダとビューの違い • ビューは、表示する文書の条件を設計で指定する。 • フォルダは、設計に「ビューの選択」が無く、ユーザーが文書 をドラッグ＆ドロップ等で自由に出し入れできる。
5. ビューへのアクセスでできること • ビューの文書にソート順のとおりアクセスしたい • カテゴリ表示の列だけアクセスしたい • 特定の主要文書の子文書と孫文書にアクセスしたい • 特定のカテゴリにあるエントリにソート順のとおりアクセスし たい
6. カテゴリ別 主要文書と返答文書 【参考】階層表示は２種類 カテゴリ表示の行（図では”果物”） をダブルクリックしても文書は開 かない どの行をダブルクリックしても文書が開く
7. 使用するメソッドの特徴を理解しよう 1. NotesView.AllEntries から NotesViewEntryCollection のオブジェ クトを取得した場合 • 最初または最後または指定した番号の文書のエントリから順にアクセスでき る • カテゴリや合計のエントリにアクセスしない • 「複数値を別のエントリで表示」するエントリの列の値の取得が困難 2. NotesView.CreateViewNav？？？から NotesViewNavigator のオ ブジェクトを取得した場合 • 階層を意識したアクセスもできる • カテゴリや合計のエントリにアクセスできる • 「複数値を別のエントリで表示」するエントリの列の値も取得できる
8. 階層のレベルを意識したメ ソッドが用意されている
9. NotesViewNavigator オブジェクトの作成 取得する対象のエントリ <クラス>.<メソッド> ビュー内のすべてのエントリ NotesView.CreateViewNav 指定したエントリから始まるビュー内のすべて NotesView.CreateViewNavFrom ビュー内の未読エントリすべて NotesView.CreateViewNavFromAllUnread 指定したキー直下のすべて NotesView.CreateViewNavFromKey 指定したカテゴリ直下のすべての子 NotesView.CreateViewNavFromCategory 指定したエントリ直下のすべての子 NotesView.CreateViewNavFromChildren 指定したエントリの子孫すべて NotesView.CreateViewNavFromDescendants
10. NotesViewNavigator からエントリを取得 取得する対象のエントリ <クラス>.<メソッド> ソート順にアクセス NotesViewNavigator.GetFirst NotesViewNavigator.GetNext NotesViewNavigator.GetLast NotesViewNavigator.GetPrev NotesViewNavigator.GetNth カテゴリや親/子/兄弟へア クセス NotesViewNavigator.GetChild NotesViewNavigator.GetParent NotesViewNavigator.GetNextCategory NotesViewNavigator.GetNextSibling NotesViewNavigator.GetPrevCategory NotesViewNavigator.GetPrevSibling
11. サンプルのビュー「ByCategory」と文書 イチゴとブドウのエントリは同一文書で複数値を別のエントリで表示
12. 変数の宣言部分の省略について 表示エリアの都合上、 これから示すサンプルコードでは 変数の宣言部分を省略しますが 実際は (Declarations) に定義しています
13. ViewNavigator オブジェクトの作成 ビュー内のすべてのエントリ ① ② ③ ④ ⑤ ⑥ ⑦
14. ViewNavigator オブジェクトの作成 指定したエントリから始まる全てのエントリ ① ② ③ ④ ⑤ ⑥ NotesView.GetEntryByKey メソッドは、指定 したキーに一致するエントリのうち最初のエ ントリ（サンプルでは「イチゴ」）を返す
15. ViewNavigator オブジェクトの作成 ビュー内のすべての未読エントリ 本サンプルコードは動作未確認
16. ViewNavigator オブジェクトの作成 指定したキー直下のすべてのエントリ ① ② ③ ④ ⑤ CreateViewNavFromCategory との違いは、 引数に配列を指定すること
17. ViewNavigator オブジェクトの作成 指定したカテゴリ直下のすべての子 ① ② ③ ④ ⑤ CreateViewNavFromKey との違いは、引数が 配列ではないこと
18. 1列目 2列目 文書の親子関係を表示する サンプルのビュー「Parent-Child」と文書
19. ViewNavigator オブジェクトの作成 指定したエントリのすべての子 ① ent ② ent2 ③ ent2 エントリを指定するためのキーを配列で指定
20. ViewNavigator オブジェクトの作成 指定したエントリのすべての子孫 ① ent ② ent2 ④ ent2 エントリを指定するためのキーを配列で指定 ③ ent2 ⑤ ent2
21. NotesViewNavigator からエントリを取得 取得する対象のエントリ <クラス>.<メソッド> ソート順にアクセス NotesViewNavigator.GetFirst NotesViewNavigator.GetNext NotesViewNavigator.GetLast NotesViewNavigator.GetPrev NotesViewNavigator.GetNth カテゴリや親/子/兄弟へア クセス NotesViewNavigator.GetChild NotesViewNavigator.GetParent NotesViewNavigator.GetNextCategory NotesViewNavigator.GetNextSibling NotesViewNavigator.GetPrevCategory NotesViewNavigator.GetPrevSibling 【次回予告】 ココ、やります