共通のコンポーネント属性

いくつかの属性は、複数の JSF コンポーネント タグに共通していて、類似した値を設定する必要があります。次の表に、複数のコンポーネントに適用される属性を示します。

autoHandleEvents

次のコンポーネント タグには、autoHandleEvents 属性が含まれます。

  • itemsGrid
  • logon
  • path

True に設定すると、クライアント側で特定の動作が行われた後、コントロールのデフォルトのイベント ハンドラが起動します。この属性は、デフォルトでは True に設定されています。

各コントロールは、autoHandleEvents 属性が True の場合、自動的に実行される画期的なビジネス ロジックになっています。これで、時間をかけずに簡単に Crystal Enterprise Web アプリケーションを構築することができます。

このロジックでは、クライアント側のコントロールの操作は、アクション イベントがトリガされると、サーバー側で自動的に処理されます。

各コントロールで実装されるこれらのイベント ハンドラの個々の動作については、該当する JSF コンポーネントの節で説明します。

autoHandleEvents 属性が False に設定されていると、ユーザーによるボタンやリンクをクリックなど、クライアント側におけるコントロールとのやりとりによってイベントがトリガされても、サーバー側におけるコントロールの動作に影響しません。このような場合、カスタムのイベント ハンドラを分離コードに実装することができます。そうすれば、これらのイベント ハンドラを該当するイベントに結び付けて、必要なビジネス ロジックを実行できます。

identity

次のコンポーネント タグには、identity 属性が含まれます。

  • logon

コントロールにデータ連結させる認証証明やセッション情報を指定します。この属性によって指定された Identity Bean は、クライアント側で操作を行うユーザーと関連付けられたユーザー認証証明の固有のセットを表します。つまり、このコンポーネントにはユーザーの識別情報がカプセル化されています。

itemSource

次のコンポーネント タグには、itemSource 属性が含まれます。

  • itemsGrid
  • path

コントロールにデータ連結される、レポート、フォルダ、レポート インスタンスなどの項目または項目のセットを指定します。これらのコントロールは、itemSource 属性値として EnterpriseItem Bean または EnterpriseItems Bean を取ります。

labelAlignment

次のコンポーネント タグには、labelAligment 属性が含まれます。

  • logon

コントロール内のすべてのラベルの配置を指定します。使用できる値は、com.businessobjects.jsf.sdk.properties.HorizontalAlign クラスのフィールドです。

  • NotSet
  • Left
  • Center
  • Right
  • Justify

submitButton

次のコンポーネント タグには、submitButton 属性が含まれるか、SubmitButton クラスから継承した属性が含まれます。

  • logon

alignmentimageUrltexttype、および visible の各サブ属性が存在します。これらは、SubmitButton ボタンの動作を制御します。

alignment サブ属性は、コントロールの入力フィールドを基準とした、送信ボタンの水平方向の配置を指定します。使用できる値は、com.businessobjects.jsf.sdk.properties.HorizontalAlign クラスのフィールドです。

  • Not Set
  • Left
  • Center
  • Right
  • Justify

type サブ属性は、コントロールの送信操作に使用するボタンの種類を指定します。使用できる値は、com.businessobjects.jsf.sdk.properties.ButtonType クラスのフィールドです。

  • Button
  • LinkButton
  • ImageButton

text サブ属性は、Button 型または LinkButton 型の送信ボタンに表示されるテキスト、または ImageButton 型の送信ボタンのツールチップに表示されるテキストを指定します。

imageUrl サブ属性は、ImageButton 型のボタンに表示されるイメージの URL を指定します。

ボタンの表示/非表示は、visible 属性で設定できます。


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