概要

ItemsGrid コンポーネントは、レポートなどの項目のソースのフィールドを表の列に表示します。ItemsGrid の各行には、項目のソースのレコードが表示されます。ItemsGrid により、個々の項目の選択、項目の大きな集合のページング、列での項目の並べ替えが可能になります。ItemsGrid コンポーネントの各列は、個別の ItemsColumn コンポーネントです。

defaultRootrootItemID は、ItemsGrid コンポーネントの主要な 2 つの属性であり、これによって、移動できる最上位項目が決まります。defaultRoot 属性を使用して、ItemsGrid コンポーネント内の項目の階層のルート ノードを指定します。このプロパティに値を設定すると、Crystal Enterprise 項目の階層内で移動できる上限が決まります。使用できる値は、com.businessobjects.jsf.sdk.properties.DefaultRootType クラスのフィールドです。

ItemsGrid コンポーネントのページ上の位置を指定するには、horizontalAlign 属性に必要な値を設定します。showHeader 属性、showImages 属性、および showDrillUpLink 属性を使用して、ItemsGrid コンポーネントの全般的な外観をカスタマイズできます。showHeader 属性は、デフォルトで True に設定されており、ヘッダー テキスト ラベルはグリッド内の各列の上部に表示されます。showImages 属性は、com.businessobjects.jsf.sdk.properties.Image クラスのフィールドに設定する必要があります。この属性はデフォルトで None に設定されますが、グリッドの各項目の横に Icon または Thumbnail のいずれかを表示するように変更できます。アイコンの表示の詳細については、ItemsGrid コンポーネント内でのイメージの表示方法を参照してください。

showDrillUpLink 属性は、項目の階層を上に移動できるリンクを表示するかどうかを示します。この属性のデフォルト値は、True です。

このほかにも、ItemsGrid コンポーネント内の情報の表示方法をカスタマイズする多くの属性があります。デフォルトでは、allowSorting 属性が False に設定されており、ユーザーが項目を並べ替えることができないようになっています。この属性を True に設定すると、並べ替え用のリンクが表示され、ユーザーがグリッドの項目(行)を並べ替えられるようになります。最適化されていて並べ替えをお勧めできるフィールドは、次のフィールド(列)のみです。

各行と各列の情報を見分けやすくするために、グリッドに枠線を表示できます。枠線の種類を指定するには、showGridLines 属性を使用します。この属性は、com.businessobjects.jsf.sdk.properties.GridLines クラスのフィールドに設定する必要があります。このプロパティは、デフォルトで Both に設定されています。行間に枠線を表示するには Horizontal、列間に枠線を表示するには Vertical、両方の枠線を非表示にするには None に設定します。また、allowDrillDown 属性は、グリッド内の項目をクリックしたときの動作を制御できます。ユーザーがある項目をクリックすると、動的にその項目の内容にドリルダウンされます。このプロパティのデフォルト値は、True です。

グリッドの個別の列は、ItemsColumn サブコンポーネントを選択して属性値を設定することによっても、カスタマイズできます。ItemsColumn 属性の詳細については、タグ属性(itemsColumn)を参照してください。

注    EnterpriseItem Bean または EnterpriseItems Bean の fields プロパティで指定したこれらのフィールドだけを、ItemsColumn コンポーネントの fields 属性を使用して設定する必要があります。この情報は、Crystal Enterprise から照会する必要があります。これによって、ItemsGrid コンポーネントは、該当する列だけにデータを格納することができます。フィールドについての詳細情報は、EnterpriseItem Beanを参照してください。

コンポーネントの一般属性のほか、プロパティ クラスに設定する必要のある属性があります。

注    プロパティ クラスに関する詳細は、プロパティ クラスを Crystal Enterprise の JavaServer Faces コンポーネント と連係させてどのように使用できますか。を参照してください。

ItemsGrid コンポーネントの表示レイアウトをカスタマイズするには、コントロールの関係箇所のスタイルの属性を設定します。

スタイル属性説明スタイル クラス

alternatingItemStyle

交互に項目に適用するスタイルです。

スタイル シートに定義され、JSP ページからリンクされているか、JSP ページに直接指定されているスタイル クラスの文字列名。

headerStyle

一覧の先頭にあるヘッダのスタイルです(ヘッダがある場合)。

スタイル シートに定義され、JSP ページからリンクされているか、JSP ページに直接指定されているスタイル クラスの文字列名。

itemStyle

個々の項目のスタイルです。

スタイル シートに定義され、JSP ページからリンクされているか、JSP ページに直接指定されているスタイル クラスの文字列名。

pagerStyle

ページ選択 UI のスタイルです。

PagerProps

イベント処理

ItemsGrid コンポーネントの自動イベント処理機能を有効にするには、autoHandleEvents プロパティを True に設定します。このプロパティを True に設定すると、ユーザーがコンポーネントを操作したときにトリガされるデフォルトの動作またはアクションがプロパティに実装されます。以下はその例です。

イベントデフォルトの動作

AlertClicked

アラート項目をクリックすると、そのアラート項目の内容が表示されます。allowDrillDown 属性は True に設定する必要があります。

DrillUpClicked

1 レベル上に移動するハイパーリンクをクリックすると、ItemsGrid コンポーネントの階層が 1 つ上に移動し、親項目が表示されます。

ItemClicked

項目をクリックすると、その項目の内容が表示され、sortField プロパティに指定されているフィールドを基準として並べ替えられます。並べ替えの方向は、itemSourcesortDirection プロパティで決まります。ItemsGrid コンポーネントの allowDrillDown プロパティは、True に設定する必要があります。

PagerClicked

次のページ、前のページ、次のページ範囲、前のページ範囲の各ボタンをクリックすると、ページ インデックスが変更され、該当するページが現在のページに設定されて、そのページが表示されます。

SortClicked

フィールド(列)の見出しをクリックすると、ItemsGrid コンポーネントの項目(行)が、そのフィールドを基準として並べ替えられます。同じフィールドをもう一度クリックすると、並べ替えの方向が逆になります。

autoHandleEvents プロパティが False の場合、これらのイベントは自動的には処理されません。autoHandleEventsFalse に設定すると、ユーザー自身のイベント ハンドラを作成できます。

データ連結

ItemsGrid コンポーネントは、EnterpriseItem Bean または EnterpriseItems Bean とのデータ連結をサポートしています。これらは、ItemsGrid コンポーネントの行に表示される項目(1 つまたは複数)のソースを提供します。コンポーネントを必要な Bean に連結するには、itemSource 属性を使用します。



Business Objects
http://japan.businessobjects.com/
サポート サービス
http://japan.businessobjects.com/services/