@SetViewInfo (式言語)

構文

@SetViewInfo( [SETVIEWFILTER] ; filterString ; columnName ; isCategory [; exactMatch ] )

パラメータ

[SETVIEWFILTER]

キーワード。必須。ビューに表示する文書を限定することを示します。

filterString

文字列。どの文書をビューに表示するかを決定するキーとなります。columnName で指定した列にこの文字列が存在する場合は、その文書がビューに表示されます。

columnName

文字列。列のプログラム名です。文書がビューに表示されるためには、ここで指定する列に filterString が含まれていなければなりません。

isCategory

数値。論理値です。標準のアウトラインビューの場合は必須です。カレンダービューの場合は使用しません。1 は columnName で指定した列がカテゴリであることを示します。0 はその列がカテゴリではないことを示します。カレンダービューに対して exactMatch パラメータを使用する場合は 0 を設定します。

exactMatch

数値。論理値です。カレンダービューの場合は省略可能です。標準のアウトラインビューの場合は使用しません。1 は columnName で指定した列の文字列が filterString で指定した文字列と完全に一致しなければならないことを示します。0 は filterString が完全には一致しなくてもよいことを示します。例えば、filterString を「A」に設定し、exactMatch を 0 に設定した場合は、columnName で指定した列の内容が「A」の文書と「A plus」の文書はどちらもビューに表示されます。

使用法

この @関数は、特定のデータが含まれているサブグループのみを表示するようにビューの文書を抽出する場合に便利です。

例

1. 次の式をフォームのホットスポットボタンに追加すると、Customers という標準のアウトラインビューが開きます。このビューは、companyName で分類されています。このビューには、さまざまな企業の従業員に関する文書が表示されますが、Acme Corp. に勤務する人物の文書のみを表示するようにビューの内容を抽出します。

   @Command([OpenView];"Customers");
   @SetViewInfo([SETVIEWFILTER];"Acme Corp.";"companyName";1)

2. 次のコードを標準アウトラインビューの [Sort] アクションボタンに追加すると、現在のビューの内容が抽出され、[empolyeeName] フィールドに現在のユーザー名が含まれている文書だけが表示されます。ビューは employeeName で分類されています。

   @SetViewInfo([SETVIEWFILTER];@Name([CN];@UserName);"employeeName";1)

3. 次のコードを [予約状況] テンプレート (resrc60.ntf) の [View by Room] アクションボタンで使用すると、選択リストからユーザーが選択したリソース名と [resourceName] の値が一致するカレンダーのエントリのみが表示されるようにカレンダービューが更新されます。$20 は Resource 列のプログラム名で、この値は [resourceName] フィールドによって決まります。

   choice:=@PickList([CUSTOM] : [SINGLE]; @DbName; "Resources";"View by Room or Resource";"Select the room or resource whose calendar you want to see:"; 1);
   @SetViewInfo([SETVIEWFILTER];choice;"$20";0)

4. カレンダービューから起動されるエージェント内で次のコードを実行すると、自分の会議だけが表示されます。

   @SetViewInfo([SETVIEWFILTER];"3";"$152";0;1)