data - データソース

ページまたはコントロールのデータソースを定義します。

カテゴリ

data

構文

<xp:this.data>
	<xp:dominoDocument attributes>content</xp:dominoDocument> <!--for document source-->
	<xp:dominoView attributes>content</xp:dominoView> <!--for view source-->
	...
</xp:this.data
このプロパティは、ページと一部のコンテナコントロールに適用され、任意の個数の dominoDocument 要素および dominoView 要素を含むことができます。

使用法

設計モードでは、ページまたはコンテナコントロールがフォーカスされるようにしてください。 [プロパティ] の下の [データ] タブをクリックするか、[すべてのプロパティ] をクリックして、[data] の下の [data] を探します。 dominoDocument と dominoView のタイプのデータソースを、追加、編集、削除できます。

含まれるプロパティ

データソースには以下のプロパティがあります。
action="editDocument|openDocument"
 (dominoDocument) ページを開くとき、およびページを送信するときの、データソース処理のアクションを指定します。 デフォルトでは、ページの送信時に新規文書を作成します。 オプション editDocument と openDocument を設定すると、ページを開いたときにデータソースのデータがページに取り込まれます。 オプション editDocument を設定すると、ページを送信するときに文書が置き換えられます。 
allowDeletedDocs="true|false"
 (dominoDocument) 一時的に削除された文書を開くことを許可するか禁止するかを示します。 
categoryFilter="category"
 (dominoView) 1 つ以上のカテゴリ (1 つの配列内) にビューコンテンツを制限します。
computeDocument (dominoDocument) 文書が計算または再計算されたときにイベントハンドラを有効にします。 
computeWithForm="onload|onsave|both"
 (dominoDocument) 文書のロード、保存、またはその両方が行われたときに、フォーム検証スクリプトを実行します。 
concurrencyMode="createResponse|fail|exception|force"
 (dominoDocument) 複数のユーザーが同時に同じ文書を更新する場合の、並行更新の処理を指定します。 
databaseName="name"
 データソースを含むデータベースを指定します。ここで name は、Notes® データディレクトリからの相対パスで表した、データベースのファイル名です。 デフォルトは現在のデータベースです。 データベースがローカルにない場合は、名前にサーバーを含めることができます。 名前はレプリカ ID にすることもできます。 
dataCache="full|id|nodata"
 (dominoView) 同じページに対する要求の間でのデータのキャッシュ方法を指定します。 
documentId="#{javascript:database.script}"
 (dominoDocument) データソースのユニバーサル ID です。この場合、ユニバーサル ID は script によって返されます。 ページのロード時に計算する場合は、# を $ に置換します。 または、静的値を指定することもできます。 
expandLevel="n"
 (dominoView) 階層ビューの展開のレベルです。 
formName="name"
 (dominoDocument) 文書を保管および取得するための Domino® フォームにデータソースを関連付けます。 
ignoreRequestParams="true|false"
 要求マップにあるパラメータを無視するか認識するかを示します。 
keys="key(s)"
 (dominoView) ビューをフィルタリングするためのキーを指定します。 各キー (複数のキーを指定する場合は配列を使用します) は、ビュー内のソート対象の列に対応しており、ソートする順番に指定する必要があります。 
keysExactMatch="true|false"
 (dominoView) キーが正確に一致しなければならないか、部分的な一致でよいかを示します。 
loaded="true|false"
 ページのロード時に、タグインスタンスを作成するかどうかを示します。 
parentId="#{javascript:database.script}"
 データソースの親のユニバーサル ID です。この場合、ユニバーサル ID は script によって返されます。 ページのロード時に計算する場合は、# を $ に置換します。 または、静的値を指定することもできます。
postNewDocument (dominoDocument) 文書の作成後にイベントハンドラを有効にします。
postOpenDocument (dominoDocument) 文書を開いた後にイベントハンドラを有効にします。
postOpenView (dominoView) ビューを開いた後にイベントハンドラを有効にします。
postSaveDocument (dominoDocument) 文書の保存後にイベントハンドラを有効にします。
queryNewDocument (dominoDocument) 文書の作成前にイベントハンドラを有効にします。
queryOpenDocument (dominoDocument) 文書を開く前にイベントハンドラを有効にします。
queryOpenView (dominoView) ビューを開く前にイベントハンドラを有効にします。
querySaveDocument (dominoDocument) ビューの保存前にイベントハンドラを有効にします。 
requestParamPrefix="prefix"
 要求パラメータのプレフィックスを指定します。 
saveLinksAs="UseWeb|UseNotes|UseNotesAndWeb"
 (dominoDocument) リンクの処理を指定します。 
scope="application|session|view|request"
 データソースのスコープを定義します。 
search="query"
 (dominoView) ビューをフィルタリングするための検索照会を指定します。 
searchMaxDocs="n"
 (dominoView) 検索によってフィルタリングされたビューに表示する文書の最大数を指定します。 
sortColumn="title"
 (dominoView) ビューをソートするために使用する列のタイトルを指定します。 列は、ビュー設計でソート可能でなければなりません。 
sortOrder="n"
 (dominoView) 列の照合順序を指定します。 
startKeys="key(s)"
 (dominoView) ソートされたビューに表示する最初の列のキーを指定します。 各キー (複数のキーを指定する場合は配列を使用します) は、ビュー内のソート対象の列に対応しており、ソートする順番に指定する必要があります。 
var="name"
 データソースを参照するためのグローバル変数です。 デフォルトは、文書の場合、document1、document2 などで、 ビューの場合、view1、view2 などです。 
viewName="name"
 (dominoView) データソースを Domino ビューに関連付けます。 
webQuerySaveAgent="nameofagent"
 (dominoDocument) フィールド値が適用されてから、文書が保存されるまでの間に、エージェントを呼び出します。 エージェントは、LotusScript® NotesAgentContext クラスの DocumentContext または Java™ AgentContext クラスの getDocumentContext を介してメモリー内文書にアクセスできます。エージェントは、値が 0 (ゼロ) の SaveOptions という名前の項目を追加することにより、保存操作をキャンセルできます。

例

このページは、form1 に関連付けられた 1 つのデータソースを定義します。
<xp:this.data>
	<xp:dominoDocument var="document1" formName="form1"></xp:dominoDocument>
</xp:this.data>
このページは、3 つのデータソースを定義しており、そのうちの 2 つはフォームに関連付けられ、1 つはビューに関連付けられます。
<xp:this.data>
	<xp:dominoDocument var="document1" formName="form1"></xp:dominoDocument>
	<xp:dominoView var="view1" viewName="view1"></xp:dominoView>
	<xp:dominoDocument var="document2" formName="form2"></xp:dominoDocument>
</xp:this.data>
親トピック: プロパティの参照