この 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 ガイド』を参照してください。
enableDefaultParent と parentItemID は、オブジェクトの照会時に親項目を指定する重要な 2 つのプロパティです。enableDefaultParent プロパティに使用できる値は、com.businessobjects.jsf.sdk.properties.DefaultParentType クラスのフィールドです。
None
Crystal Enterprise システムのデフォルト ルート オブジェクトがオブジェクトの照会で親項目として使用されます。
Custom
parentItemID プロパティで指定するカスタム親項目が親項目として使用されます。parentItemID プロパティを、オブジェクトの照会時の親項目となる項目の識別子に設定します。
UserRootFolder
parentItemID では、クエリー対象となるコレクションに含まれるすべてのオブジェクトの親の ID または CUID を指定します。このプロパティの設定方法は、さまざまです。例えば、ユーザーが一覧からあるフォルダをクリックしたとき、parentItemID プロパティを、そのフォルダの itemID プロパティ値にプログラムで設定することができます。次に、この ID を使用して、親フォルダ内にあるレポートのコレクションを照会することができます。
fields プロパティでは、照会するデータベース フィールドを定義します。このプロパティとその値の詳細については、EnterpriseItem Beanを参照してください。
itemType プロパティには、照会を行ってコレクション内に返す Crystal Enterprise オブジェクトの種類(1 つまたは複数)を設定します。次に、有効な文字列(ProgIDs)の例を示します。
All
CrystalEnterprise.Report
CrystalEnterprise.Excel
CrystalEnterprise.FavoritesFolder
CrystalEnterprise.Folder
CrystalEnterprise.Hyperlink
CrystalEnterprise.ObjectPackage
CrystalEnterprise.Pdf
CrystalEnterprise.Program
CrystalEnterprise.Rtf
CrystalEnterprise.Shortcut
CrystalEnterprise.Txt
CrystalEnterprise.Word
そのため、例えば、All はすべてのフィールドを返すのに対して、{"CrystalEnterprise.Report", "CrystalEnterprise.Pdf", "CrystalEnterprise.Txt"} は Crystal レポート、PDF、またはテキスト ファイルである項目のみを返します。
メモ Crystal Enterprise ProgID に関する詳細は、『Crystal Enterprise Java SDK ガイド』を参照してください。
Crystal Enterprise システムに対しワイルドカード検索を行う場合は、searchFields と searchText の両方のプロパティを併用する必要があります。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 つのプロパティは他のプロパティを含むクラスにアクセスします。
sortBy プロパティ
sortBy プロパティは、EnterpriseItems Bean 内でコレクションの項目を並べ替える方法を指定するメソッドを含む、SortProps クラスのインスタンスを取得または設定します。SortProps クラスの getSortField メソッドと setSortField メソッドは、コレクションの項目の並べ替えに使用するフィールドを指定します。SortProps クラスの getSortDirection メソッドと setSortDirection メソッドは、その項目を英数字の昇順で並べ替えるか降順で並べ替えるかを指定します。
メモ ItemsGrid コンポーネントによって、このコンポーネントに連結されている EnterpriseItems Bean の並び替えプロパティの値が決まります。ItemsGrid コンポーネントにアタッチされている場合、手作業でデザイン時にこれらの値を EnterpriseItems Bean で変更することはできません。
paging プロパティ
paging プロパティは、EnterpriseItems Bean によって表示される項目の一覧のページを移動する方法を指定するメソッドを含む PagingProps クラスのインスタンスを取得または設定します。ページングは、デフォルトで無効になっています。ページングを有効にし、ユーザーが複数ページにわたる項目間を移動できるようにするには、PagingProps クラスの setEnabled のメソッドを引数 True とともに使用します。各ページに表示する項目数は、getPageSize メソッドと setPageSize メソッドで指定します。各ページに 1 度に表示される項目の数は、デフォルトで 10 です。getRangeSize メソッドと setRangeSize メソッドは、ページ範囲を定義するページ数を指定します。例えば、setRangeSize メソッドが引数 10 とともに使用され、EnterpriseItems Bean が ItemsGrid コンポーネントに連結されていると、ユーザーは、1 〜 10 ページの範囲のページを個々に選択し、グリッドの下部にあるページ番号ボタンを使用して移動することができます。次のページ範囲ボタンをクリックすると、範囲が 11 〜 20 ページの番号ボタンが利用できるようになります。
メモ ItemsGrid コンポーネントによって、このコンポーネントに連結されている EnterpriseItems Bean のページング プロパティの値が決まります。ItemsGrid コンポーネントにアタッチされている場合、手作業でデザイン時にこれらの値を EnterpriseItems Bean で変更することはできません。
メモ EnterpriseItems Bean のすべてのメンバを全体的に参照するには、『Crystal Reports for Rational Application Developer Java API リファレンス』の IEnterpriseItems インターフェイスを参照してください。
<description>フォルダのコレクションのソース。</description>
<managed
com.businessobjects.jsf.appcontrols.model.EnterpriseItems
<managed
<property
| Business Objects http://japan.businessobjects.com/ サポート サービス http://japan.businessobjects.com/services/ |