EnterpriseItems Bean

関連項目  

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

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

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

概要

EnterpriseItem Bean は、Crystal Enterprise オブジェクト コレクションのソースであり、ページ上のオブジェクトのコレクションを表すのに使用します。コレクションを Crystal Enterprise システムに対して照会するには、分離コード ファイルにクエリー文字列を記述します。これらのクエリー文字列を作成する方法は、EnterpriseItem Bean の場合と同様で、Bean プロパティを設定することです。Crystal Enterprise クエリー言語の詳細については、『Crystal Enterprise Java SDK ガイド』を参照してください。

enableDefaultParentparentItemID は、オブジェクトの照会時に親項目を指定する重要な 2 つのプロパティです。enableDefaultParent プロパティに使用できる値は、com.businessobjects.jsf.sdk.properties.DefaultParentType クラスのフィールドです。

parentItemID では、クエリー対象となるコレクションに含まれるすべてのオブジェクトの親の ID または CUID を指定します。このプロパティの設定方法は、さまざまです。たとえば、ユーザーが一覧からあるフォルダをクリックしたとき、parentItemID プロパティを、そのフォルダの itemID プロパティ値にプログラムで設定することができます。次に、この ID を使用して、親フォルダ内にあるレポートのコレクションを照会することができます。

fields プロパティでは、照会するデータベース フィールドを定義します。このプロパティとその値の詳細については、EnterpriseItem Beanを参照してください。

itemType プロパティには、照会を行ってコレクション内に返す Crystal Enterprise オブジェクトの種類(1 つまたは複数)を設定します。次に、有効な文字列(ProgIDs)の例を示します。

そのため、たとえば、“All”はすべてのフィールドを返すのに対して、{"CrystalEnterprise.Report", "CrystalEnterprise.Pdf", "CrystalEnterprise.Txt"} は Crystal レポート、PDF、またはテキスト ファイルである項目のみを返します。

注    Crystal Enterprise ProgID の詳細については、『Crystal Enterprise Java SDK ガイド』を参照してください。

Crystal Enterprise システムに対しワイルドカード検索を行う場合は、searchFieldssearchText の両方のプロパティを併用する必要があります。searchFields プロパティには検索を行うフィールドを、searchText プロパティには検索対象となるテキストをそれぞれ設定します。たとえば、searchFields プロパティには Name を、searchText プロパティには World Sales Report をそれぞれ設定して、“World Sales Report”という名前のレポートを検索します。最適化されていて検索をお勧めできるフィールドは、次のフィールドのみです。

この他に、オブジェクト コレクション照会の特定の属性を制御するプロパティがいくつかあります。ユーザーが所有している項目だけを照会する場合は、filterByOwner プロパティを True に設定します。このプロパティは、デフォルトで false に設定されています。instances プロパティでは、返されるオブジェクトのコレクションにインスタンスが含まれ、かつ、それらのインスタンスが EnterpriseItems Bean に設定されるかどうかを指定します。このプロパティは、com.businessobjects.jsf.sdk.properties.InstanceFilter クラスのフィールドに設定する必要があります。照会結果にインスタンスを含める場合は、IncludeInstances に設定し、逆に、クエリー結果からインスタンスを除外する場合は、ExcludeInstances に設定します。オブジェクトのインスタンスだけが含まれるコレクションを返す場合は、InstancesOnly に設定します。

Bean の一般属性のほかに、次の 2 つのプロパティは他のプロパティを含むクラスにアクセスします。

注    EnterpriseItems Bean のすべてのメンバを全体的に参照するには、『Crystal Enterprise の JavaServer Faces コンポーネント Java API リファレンス』の「IEnterpriseItems インターフェイス」を参照してください。

faces-config.xml 宣言の例

<managed-bean>

<description>Source for a collection of folders.</description>

<managed-bean-name>folders</managed-bean-name>

<managed-bean-class>

com.businessobjects.jsf.appcontrols.model.EnterpriseItems

</managed-bean-class>

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

<managed-property>

<property-name>parentItemID</property-name>

<value>0</value>

</managed-property>

</managed-bean>



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