プロパティ | 役割 | 指定場所 |
action | 文書を開く際のアクションを指定します。
(ブランク): 新規文書を作成します。
openDocument: 既存文書を読み込みモードで開きます。
EditDocument: 既存文書を編集モードで開きます。
openDocument/EditDocument を指定した場合でも、同時に documentId を指定しない場合には新規文書の作成となります。 | データ |
allowDeletedDocs | 一時的に削除された文章でも開くこと許可します。
データベースの「一時的削除を許可」属性が設定されている場合に有効です。 |
|
computeDocument | 文書の再計算が必要な場合に発生するイベントです。
このタイミングで実行するアクションを指定します。
より具体的には、文書がロードされた直後(postOpenDocumentの後)および
文書保存前の最終段階(querySaveDocumentの後、
実際に文書保存が行われる直前)に発生します。 | イベント |
computeWithForm | フォームロジックを実行するタイミングを指定します。
指定したタイミングで文書に対して NotesDocument クラスの
computeWithForm() メソッドを実行します。
(ブランク): 実行しません。
onload: 文書のロード時に実行します。
onsave: 文書の保存時に実行します。
both: 文書のロード時、保存時両方で実行します。 | データ |
concurrencyMode | 同一文書を複数のユーザーが同時に編集した後、保存動作を指示した際の、
競合した編集内容を処理する方法を指定します。
createResponse: 競合文書を返答文書として生成し保存ます。
fail: 編集結果を破棄します。
exception: 例外を発生させます。
force: 上書き保存します。
デフォルトは createResponse です。 | データ |
databaseName | このデータソースが対象とする文書を含むデータベース名を、
サーバー名、パス名を含めて指定します。
XPagesアプリケーションとは異なるサーバーに存在する場合、
「サーバー名!!データベース名」の形式で指定します。 | データ |
documentId | このデータソースが対象とする文書の Note ID を指定します。 | データ |
formName | このデータソースが対象とする文書のフォーム名を指定します。 | データ |
ignoreRequestParams | このデータソースを作成する場合に、URLパラメータとして指定されている値を
無視するか利用するかをtrue/falseで指定します。
複数データソースを同一 XPage で利用する場合などに活用します。
詳しくは、「データソースとURL パラメータ」 の説明を参照してください。 |
|
loaded | ページロード時にこのデータソースを生成するかどうかを指定します。
条件によりデータソースを準備するかどうかをコントロールする場合に利用します。 |
|
parentId | 新規文書を既存文書の子文書として作成する場合に、親となる文書の
Note ID を指定します。 | データ |
postNewDocument | 新規文書の作成後に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
postOpenDocument | 既存文書をオープンした後に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
postSaveDocument | 文書を保存した後に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
queryNewDocument | 新規文書を作成する前に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
queryOpenDocument | 既存文書をオープンする前に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
querySaveDocument | 文書を保存する前に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
requestParamPrefix | このデータソースを作成する場合に参照するURLパラメータのキー名の
プレフィックスを指定します。
複数データソースを同一 XPage で利用する場合に活用します。
詳しくは、「データソースとURL パラメータ」 の説明を参照してください。 |
|
saveLinksAs | Notes クライアントで作成したリッチテキストフィールドを含む文書を
XPage で編集、保存した場合、保存されるデータは HTML 形式となります。
そのため、リッチテキスト内にデータベースや文書へのリンクが含まれる場合、
それらは URL 形式のホットスポットに変換されます。
その際、URL のプロトコルとして http:// と notes:// の
いずれを利用するかを指定します。
UseWeb: http:// プロトコルを利用します。
UseNotes: notes:// プロトコルを利用します。
デフォルトは UseNotes です。
保存した文書を Notes クライアントで開き、ホットスポットをクリックした際、
notes:// が利用されている場合には Notes クライアントで開くことができますが、
http:// が利用されている場合には、ブラウザを開こうとします。 |
|
scope | このデータソースの有効スコープを指定します
application/session/view/requestの中から選択します。
デフォルトは view スコープです。
詳しくは、「データソースのスコープ」 の説明を参照してください。 |
|
var | このデータソースを保存する変数名を指定します。
コントロールに対してこのデータソースをデータバインドする場合や、
JavaScript のロジックの中からアクセスする場合に利用します。 | データ |
webQuerySaveAgent | データソースを保存する前に実行するエージェントを指定します。
8.5.2 より、XPages から実行したエージェントでも、
インメモリー文書をアクセスすることが可能になっています。
そのため、エージェント内で、SaveOptionsフィールドに0を設定することにより、
データソースの保存をキャンセルすることができます。 |
|
プロパティ | 役割 | 指定場所 |
categoryFilter | ビューがカテゴリー分けされている場合に、
ビューに含まれるコンテンツを特定のカテゴリに含まれるものだけに制限します。
絞込みを行うカテゴリー名を指定します。 | データ |
databaseName | このデータソースが対象とするビューを含むデータベース名を、
サーバー名、パス名を含めて指定します。
XPagesアプリケーションとは異なるサーバーに存在する場合、
「サーバー名!!データベース名」の形式で指定します。 | データ |
dataCache | このデータソースが複数の HTTP リクエスト間でキャッシュするデータの種類を指定します。
full: ビューエントリーの全てのデータ(列値などを含む)をキャッシュします。
id: Note ID のみキャッシュします。
nodata: 何もキャッシュしません。
デフォルトは full です。
部分更新を利用しながら、ビューデータソースが提供するエントリの情報を
アクセスするような XPage を作成する際に、パフォーマンスチューニングのために
利用します。
アクセスするエントリ情報として列値まで必要な場合には、full を指定します。
Note ID のみでよい場合には id を指定します。
エントリ情報を必要としない場合には nodata を指定できます。
データキャッシュに必要なメモリーはこの順で減少します。 |
|
expandLevel | ビューがカテゴリーや返答文書といった階層を持つ場合に、
展開して表示するレベルを指定します。
0: 全ての階層を展開して表示します。
1: 1レベルめだけを(つまり、全ての階層を省略して)表示します。
2: 2レベルめまでを(つまり、1レベルめだけを展開して)表示します。
:
デフォルトは0です。 |
|
ignoreRequestParams | このデータソースを作成する場合に、URLパラメータとして指定されている値を
無視するか利用するかをtrue/falseで指定します。
複数データソースを同一 XPage で利用する場合などに活用します。
詳しくは、「データソースとURL パラメータ」 の説明を参照してください。 |
|
keys | ビューがソートされた列を持つ場合、その列の値によって絞込みを行います。
単純文字列、あるいは複数の文字列からなる配列値を指定します。
ひとつのキーがひとつのソートされた列に相当します。
指定文字列がソートされた列の数より少ない場合には、
指定がない列の値は絞込みに利用されません。 | データ |
keysExactMatch | keys プロパティで指定した値を完全一致で利用するかどうかを true/falseで指定します。
部分一致を指定した場合、指定したキーを先頭に持つ列値が一致します。 | データ |
loaded | ページロード時にこのデータソースを生成するかどうかを指定します。
条件によりデータソースを準備するかどうかをコントロールする場合に利用します。 |
|
parentId | ビューに含まれるコンテンツを、特定の文書の返答文書およびその子孫に制限します。
絞込みを行う親文書の Note ID を指定します。 |
|
postOpenView | ビューをオープンした後に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
queryOpenView | ビューをオープンする前に発生するイベントです。
このタイミングで実行するアクションを指定します。 | イベント |
requestParamPrefix | このデータソースを作成する場合に参照するURLパラメータのキー名の
プレフィックスを指定します。
複数データソースを同一 XPage で利用する場合に活用します。
詳しくは、「データソースとURL パラメータ」 の説明を参照してください。 |
|
scope | このデータソースの有効スコープを指定します
application/session/view/requestの中から選択します。
デフォルトは view スコープです。
詳しくは、「データソースのスコープ」 の説明を参照してください。 |
|
search | ビューに対して全文検索の絞込みを行います。
検索文字列を指定します。
この機能を利用するためには、データベースに対して全文索引が
作成されている必要があります。 | データ |
searchExactMatch | 全文検索時に完全一致を検査するかどうかを true/false で指定します。 |
|
searchFuzzy | 全文検索時にあいまい検索を行うかどうかを true/false で指定します。 |
|
searchList | 全文検索に使用する検索文字列を複数、配列の形で指定します。
配列内の全ての文字列が含まれるよう絞込みが行われます。 |
|
searchMaxDocs | 全文検索結果に含める最大件数を指定します。 |
|
searchVariants | 全文検索時に単語の語尾変化を考慮するかどうかを true/false で指定します。 |
|
sortColumn | ビューをソートする列名を指定します。
指定する列には元のビューでソートが設定されている必要があります。 | データ |
sortOrder | ビューのソート順を指定します。
ascending: 昇順に並べます。
descending: 降順に並べます。 |
|
startKeys | ビューを表示する際、先頭となるエントリーをキーで指定します。
指定方法は keys パラメータと同です。 |
|
var | このデータソースを保存する変数名を指定します。
コントロールに対してこのデータソースをデータバインドする場合や、
JavaScript のロジックの中からアクセスする場合に利用します。 | データ |
viewName | このデータソースが対象とするビューの名前を指定します。 | データ |