フォルダ項目の表示

ユーザーに対してフォルダを一覧表示するには、このページに ItemsGrid コンポーネントと ItemsColumn コンポーネントを追加します。ItemsGrid コンポーネントは、フォルダやレポートの一覧などの反復情報を、行と列で構成されるグリッド上に表示します。グリッドの各行は別々の項目を表します。このチュートリアルの場合、各項目はフォルダです。グリッドの各列は、項目の各フィールドを表示する個々の ItemsColumn コンポーネントです。

後のステップで、ページの最上部に Path コンポーネントを追加して、ナビゲーション機能を持たせます。

ItemsGrid コンポーネントを追加する

1. contents.jsp ページを開きます。
2. Path コンポーネントを追加するためのスペースを確保しておくには、ページ最上部にカーソルを置き、改行を追加します。
3. パレット ビューの［Crystal Reports Faces コンポーネント］タブで［Enterprise ItemsGrid］をクリックし、ItemsGrid コンポーネントをビジュアル デザイナのページにドラッグします。

ここでは、ItemsGrid コンポーネントで使用する項目のソースを指定することを求められます。

EnterpriseItems Bean を作成し、それを ItemsGrid コンポーネントにバインドします。EnterpriseItems Ｂean は、グリッドに表示されるフォルダのコレクションを表示します。

4. ［新規 ItemsGrid］ウィンドウで、［アイテム ソース］フィールドを空白のままにして［新規］をクリックします。

Identity Bean を選択することを求められます。EnterpriseItems Ｂean には identity プロパティがありますが、このプロパティを Enterprise セッションとユーザー認証証明を提供する Identity Ｂean に初期設定する必要があります。

5. リストから既存の Bean の identity を選択して、［フォルダのみ］、［終了］の順にクリックします。

ここでは、［新規 ItemsGrid］ウィンドウの［アイテム ソース］フィールドに EnterpriseItems Bean を追加します。それを選択して［終了］をクリックします。

6. プロパティ ビューで、id 属性を foldersList に設定します。
7. ［プロパティ］ビューで、［showDrillUpLink］チェック ボックスをオフにします。

項目の階層でのナビゲートは Path コンポーネントによって処理されるため、リンクは必要ありません。

8. ［プロパティ］ビューで、［showHeader］チェック ボックスをオフにします。

ヘッダー フィールドの表示/非表示は、この属性で制御されます。このチュートリアルではヘッダー フィールドは非表示になりますが、showHeader 属性を True に設定すると、グリッド内の各フィールドを説明する列見出しを表示できます。

9. プロパティ ビューで、 showImages 属性を Icon に設定します。

グリッド内の各項目の横に、アイコンのイメージが表示されます。

注    Icon フィールドは、com.businessobjects.jsf.sdk.properties.Image クラスのメンバです。

ItemsGrid コンポーネントを作成すると、グリッドの列を表示する 1 つまたは複数の ItemsColumn サブコンポーネントも作成されます（デフォルトで作成されるフィールド表示列の数はカスタマイズ可能です。詳細については、UI コンポーネントのデフォルト設定は、どのような方法で変更しますか。を参照してください)。これらの個々の列をビジュアル デザイナで選択して、編集することができます。

このグリッドで、各フォルダの名前を表わす 1 つの列だけを表示するとします。したがって、この項目の SI_NAME フィールドを表示する列を残して、その他のすべての列（SI_PROGID や SI_DESCRIPTION フィールド列など）を削除します。

ItemsGrid コンポーネントから列（ItemsColumn コンポーネント）を削除する

• ItemsGrid コンポーネントの 1 つの列を右クリックし、［削除］をクリックします。

この操作を繰り返して、ItemsGrid コンポーネントから SI_NAME 列を除くすべての余分な列を削除します。列の操作方法の詳細については、ItemsGrid コンポーネント内の列を操作するには、どのような方法がありますか。を参照してください。