プロフィール文書って何？

プロフィール文書って何？ 12.0.1 で登場予定の新機能を理解するために復習しましょう中野晴幸 Haruyuki Nakano harunakano.blogspot.com (blog) @harunakano
(twitter)

プロフィール文書の特徴通常の「文書」との違いとは

特徴 • ビューに表示できない/フォルダへ追加できない • 通常の文書検索では探せない • 文書数にカウントされない • プログラムによるアクセス •
高速アクセス • 競合文書が発生しない隠し文書と表現されることも!?

ビューに表示できない/フォルダへ追加できない SELECT文にプロフィール文書用のフォームを指定しても @All でも、プロフィール文書は表示されない ※プロフィール文書上のアイテムのサマリーフラグがFalseという訳ではない

通常の文書検索では探せない • フォルダ/ビューに表示できない • 全文索引に含まれないビュー検索、全文検索では文書が探せない

文書数にカウントされない全文書の数よりプロフィール文書の数が多い

プログラムによるアクセス • フォーム名とユニークキーを指定して文書にアクセス • 値の取得が容易 • 文書が存在しなければ自動作成されるいかにも作成しそうな名称の（”CreateProfileDocument” のような）コマンド/メソッドは存在しない

高速アクセス • アクセスした文書をクライアントのキャッシュに保持する • データベースを開いている間はキャッシュを参照一方の更新内容が他方へ反映されにくいため、更新が頻繁に発生する情報の共有に向かない

競合文書が発生しない • フォームのプロパティで「競合の作成」を選択している場合であっても、競合文書は作成されない仕様です競合の扱いは文書の $ConflictAction アイテムの値によって管理されますが、プロフィール文書では通常の文書と異なる値が設定されます。「競合の作成」を選択していた場合でも強制的に内部で「競合を作
成しない」を選択した状態となり、「競合のマージ」を選択していた場合も強制的に内部で「マージ/競合なし」を選択した状態となります。競合が発生する状況になった場合は、更新日時が新しい方の文書が保存されます。

使用例データベースの使用に必要な各種設定値を保存する

使用例 • メールDB カレンダープロフィールカラープロフィール iNotesプロフィールアーカイブデータベースプロフィール • ディスカッションDB アーカイブデータベースプロフィール
• スクリプトデバッガのブレイクポイント「各種設定の保存」といえば notes.ini もこのような使い方ができます。どんな違いがあるのでしょうか？

notes.ini との比較 notes.ini • データベース間で設定情報の共有が可能 • ユーザー自身による設定の閲覧・修正・削除が可能 • 端末ごとの設定のため、複数のユーザー
アカウントを使い分ける場合に注意が必要 • 自分が使用する複数の端末や他のユーザーとの間で設定の共有が困難 • 端末の入れ替えや機種変更などで設定が消える可能性ありプロフィール文書 • 端末間/ユーザー間で設定情報の共有が可能 • 複製されるためレプリカ間の共有が可能 • 可視性に難あり。設定をユーザー自身で自由に閲覧・修正させるにはフォーム等のアクセス手段の構築が必要 • 削除に難あり。多少プログラミングが必要

プログラミングプロフィール文書を使ってみよう

プロフィール文書(NotesDocument)のプロパティ IsProfile True NameOfProfile プロフィール名 Key ユニークキー NotesPeek では
ユニークキーを user-name と表示します

プロフィール文書の作成・既存文書の編集 LotusScript set notesDocument = notesDatabase.GetProfileDocument( profilename$ [, uniqueKey$]
) set NotesUIDocument = notesUIWorkspace.EditProfile( profilename$ [, uniqueKey$] ) @コマンド/@関数 @Command( [EditProfileDocument] ; profilename; uniqueKey ) ※すぐに実行される @Command( [EditProfile] ; profilename; uniqueKey ) ※すべての関数の実行された後に実行される • プロフィール名とユニークキーの組合せで1文書だけ作成可能（同じ組み合わせの文書を複数作成できない） • CreateProfileDocument のような作成に特化したメソッドが無い • Compose @コマンドではプロフィール文書を作成できない • GetProfileDocument で取得する文書の IsNewNote プロパティは、プロフィール文書が存在しなかった場合は True を返す

プロフィール文書コレクションの取得 LotusScript set notesDocumentCollection = notesDatabase.GetProfileDocCollection( profilename$ ) • プロフィール名が同じプロフィール文書のコレクションを取得する

値の取得・更新 LotusScript ※通常の NotesDocument クラスと同様の操作のため割愛 @コマンド/@関数 @GetProfileField( profilename; fieldname; uniqueKey
) @SetProfileField( profilename; fieldname; value; uniqueKey )

次回予告冒頭で「今回は 12.0.1 の新機能を知るための復習」と言いましたが…

Named Document （名前付き文書）とは • 12.0.1 では Named Document（名前付き文書）と呼ばれる新しいタイプの文書を作成および管理するための新しいメソッドが用意されている
• NoteID ではなく名前を持つ • Notesクライアントやどのビューにも表示されない • プログラムによるアクセスを想定して設計されている • これまでのプロフィール文書を機能的に置き換えるもの

プロフィール文書って何？

プロフィール文書って何？

Haruyuki Nakano

More Decks by Haruyuki Nakano

Other Decks in Programming

Featured

Transcript