概要

Path コンポーネントを使用して、レポートなどの選択項目からルート項目へのパスをブレッドクラム形式で表示させることができます。例えば、ユーザーがフォルダやサブフォルダをドリルダウンして表示またはスケジュールするレポートを見つけるときに、このコンポーネントを使用することができます。この場合、パスを表示し、ユーザーがパスを移動するたびにパスの表示を更新させることができます。このようにして、ルート フォルダから最初のサブフォルダへ、さらに次のフォルダへと、目的のレポートに達するまでのパスが表示されます。

rootItemIDrootText は、パス内の最初のノードを決める重要な 2 つの属性です。rootItemID 属性には、パス内のルート(最初の)項目として表示する項目の識別子を設定します。この属性に値を設定すると、Crystal Enterprise 項目の階層内で移動できる上限が決まります。パス内のこの最上位項目を表す実際のテキストは、rootText 属性を使用してカスタマイズできます。

repeatDirection 属性の水平方向オプションを設定し、ユーザーに対してパスを左から右に表示させるか、あるいは垂直方向オプションを設定して、パスを上から下に表示するかを指定します。repeatDirection 属性は、com.businessobjects.jsf.sdk.properties.RepeatDirection クラスのフィールドに設定する必要があります。separatorText 属性を使用して、パスの項目を区切る文字を指定します。例えば、1 つの要素から別の要素への移動をパスに示す場合は、矢印("->")を使用します。この属性は、デフォルトで(">")に設定されています。showSelectedItem 属性を設定して、選択された項目をパスの最後の要素として表示するかどうかを指定できます。この属性は、デフォルトでは True に設定されています。false に設定した場合、選択した項目の親である項目がパスの最後の要素として表示されます。

コンポーネントの一般属性のほかに、showImages 属性は ImagesProps クラスにアクセスしますが、これにはさらに次のようなプロパティも含まれます。

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

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

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

itemStyle

パスに含まれるすべての項目のスタイルです。

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

selectedItemStyle

選択した個々の項目のスタイルです。

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

separatorStyle

パスに含まれる個別の項目を区切る文字のスタイルです。

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

イベント処理

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

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

ItemClicked

コンポーネント内のある項目をクリックすると、データ連結されている EnterpriseItem Bean または EnterpriseItems Bean が、その項目に指定されている parentItemID の元に項目を表示するように設定されます。

autoHandleEvents 属性が False の場合、このイベントは処理されません。

データ連結

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


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