この 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/ |