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

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

autoHandleEvents

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

  • itemsGrid
  • logon
  • path

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

各コンポーネントは、autoHandleEvents 属性が True の場合、自動的に実行される画期的なビジネス ロジックになっています。このため、Crystal Enterprise Web アプリケーションをすばやく簡単に作成できます。

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

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

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

identity

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

  • logon

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

itemSource

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

  • itemsGrid
  • path

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

labelAlignment

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

  • logon

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

  • Center
  • Justify
  • Left
  • NotSet
  • Right

submitButton

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

  • logon

submitButton 属性は SubmitButton クラスのインスタンスにアクセスします。このクラスは、alignmentimageUrltexttypevisible の各プロパティを保持します。

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

  • Center
  • Justify
  • Left
  • Not Set
  • Right

type プロパティでは、コンポーネントの送信アクションに使用するボタンの種類を指定します。使用できる値は、com.businessobjects.jsf.sdk.properties.ButtonType クラスのフィールドです。

  • Button
  • ImageButton
  • LinkButton

text プロパティは、Button 型または LinkButton 型の送信ボタンに表示されるテキスト、または ImageButton 型の送信ボタンのツールヒントに表示されるテキストを指定します。

imageUrl プロパティでは、ImageButton のボタンとして表示するイメージの URL を指定します。

ボタンの表示/非表示は、visible プロパティで設定できます。



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