EnterpriseItem Bean

関連項目  

この Managed Bean は、単一のレポートやフォルダ、プログラムなどの Crystal Enterprise オブジェクトのソースです。この Bean は、UI コンポーネントへの情報の提供と機能の追加を行います。

Crystal Enterprise の中核機能とアプリケーション開発についての詳細は、Crystal Enterprise Java SDK ガイドを参照してください。

次のリンクをクリックして、目的の節にジャンプしてください。

概要

EnterpriseItem Bean は、Crystal Enterprise オブジェクトのソースであり、ページ上のオブジェクトを表すのに使用します。EnterpriseItem Bean は、Crystal Enterprise の JavaServer Faces コンポーネント で作成するアプリケーションの重要な部分です。ScheduleCrystalReportViewer など、多くのコンポーネントが EnterpriseItem Bean に依存しています。なぜなら、これらのコンポーネントの機能は、Crystal Enterprise オブジェクトを操作することだからです。例えば、ReportPageViewer コンポーネントの機能は、レポート オブジェクトを表示することです。システムから Crystal Enterprise オブジェクトを取得するには、Crystal Enterprise クエリー言語を使用しているページで、このオブジェクトを照会する必要があります。しかし、EnterpriseItem Bean を使用すると、このような複雑な処理は必要ありません。自動的にクエリー文字列を生成する一連のプロパティを記述するだけですみます。対象となるオブジェクトを取得するには、これらのプロパティを適切な値に設定します。Crystal Enterprise クエリー言語に関する詳細は、『Crystal Enterprise Java SDK ガイド』を参照してください。

itemID プロパティは、EnterpriseItem Bean と実際のオブジェクトとの関係を作成するにあたって、中心的な役割を果たします。なぜなら、ItemID は、EnterpriseItem Bean が表すオブジェクトの ID または CUID を指定するからです。例えば、ItemID プロパティに、使用しているページのいずれかで選択したレポートの ID を設定することができます。次に、この EnterpriseItem Bean を ReportPageViewer コンポーネントに連結すると、そのレポートを作成し、ユーザーに表示することができます。itemID プロパティの設定方法はさまざまです。一般的な方法は、ユーザーがページ上の項目一覧からある項目を選択すると、その itemID プロパティをプログラムで設定する方法です。この場合は、実際に、EnterpriseItems Bean が表す項目のコレクションを照会し、ItemsGrid などのコンポーネントを用いてそれらの項目のコレクションを表示し、次に、ユーザーが選択した項目の単一 ID を EnterpriseItem Bean に渡します。詳細については、EnterpriseItems Beanを参照してください。ページ内の EnterpriseItem Bean の itemID プロパティの設定方法は、実装しようとしているシナリオによって大きく異なります。

fields プロパティでは、照会を行うデータベース フィールドを定義します。これによって、オブジェクトで取得されるオブジェクト プロパティとプロパティ バッグが決まります。EnterpriseItem Bean が必要な情報にアクセスできるように、どのフィールドがオブジェクトと共に返されるかを選択します。次に、有効な文字列の例を示します。

使用している EnterpriseItem Bean は、この fields プロパティの選択内容に基づいて、オブジェクトのフィールドにアクセスし、フィールドを操作することができます。そのため、例えば、All はすべてのフィールドを返すのに対して、{"SI_NAME, SI_DESCRIPTION, SI_PROGID"} は指定された 3 つのフィールド(title、description、および ProgID)のみを返します。

メモ    Crystal Enterprise ProgID に関する詳細は、『Crystal Enterprise Java SDK ガイド』を参照してください。

メモ    EnterpriseItem Bean のすべてのメンバを全体的に参照するには、『Crystal Reports for Rational Application Developer Java API リファレンス』の IEnterpriseItem インターフェイスを参照してください。

faces-config.xml 宣言の例

<managed-bean>

<description>単一レポートのソース。</description>

<managed-bean-name>レポート</managed-bean-name>

<managed-bean-class>

com.businessobjects.jsf.appcontrols.model.EnterpriseItem

</managed-bean-class>

<managed-bean-scope>session</managed-bean-scope>

<managed-property>

<property-name>itemID</property-name>

<value>0</value>

</managed-property>

</managed-bean>


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