EnterpriseItems Bean

這個 Managed Bean 為 BusinessObjects Enterprise 物件 (如報表、資料夾或程式) 集合的來源。這個 Bean 會提供資訊，並將功能加入 UI 元件中。

若要進一步瞭解 BusinessObjects Enterprise 核心功能及應用程式開發的相關資訊，請參閱《BusinessObjects Enterprise Java SDK 指南》。

按一下適當的連結，以跳至該小節：

• 總覽
• faces-config.xml 宣告範例

總覽

EnterpriseItems Bean 是 BusinessObjects Enterprise 物件集合的來源，並可用來代表頁面上物件的集合。集合是在程式碼後置 (Code-Behind) 中使用查詢字串，從 BusinessObjects Enterprise 系統中查詢而得。這些查詢字串可藉由設定 Bean 屬性，以與 EnterpriseItem Bean 相同的方式來建構。如需有關 BusinessObjects Enterprise 查詢語言的詳細資訊，請參閱《BusinessObjects Enterprise Java SDK 指南》。

enableDefaultParent 和 parentItemID 是決定查詢物件時所用父項目的兩個主要屬性。enableDefaultParent 屬性的可能值為 com.businessobjects.jsf.sdk.properties.DefaultParentType 類別的欄位：

• None

使用 BusinessObjects Enterprise 系統內預設的根物件作為查詢物件的父項目。

• CorporateCategory

主要的 BusinessObjects Enterprise 企業類別是用來查詢物件的父項目。

• Custom

使用 parentItemID 屬性所指定的自訂父項目作為父項目。設定 parentItemID 屬性為查詢物件之父項目的項目識別項。

• PersonalCategory

主要的 BusinessObjects Enterprise 企業類別是用來查詢物件的父項目。

• RootFolder

使用 BusinessObjects Enterprise 系統內預設的根資料夾作為查詢物件的父項目。

• UserRootCategory

使用一般使用者的自有根類別作為父項目。

• UserRootFolder

使用一般使用者的自有根資料夾作為父項目。

parentItemID 指定集合中待查詢的所有物件父系的 ID 或 CUID。這個屬性可以用許多不同的方法來設定。例如，您可能想要在使用者從清單中按一下資料夾時，以程式設計的方式，設定 parentItemID 屬性為資料夾的 itemID 屬性值。接著便可使用這個 ID，在該父資料夾內查詢報表的集合。

fields 屬性定義了您想要查詢的資料庫欄位。如需這個屬性及其值的完整說明，請參閱EnterpriseItem Bean。

將 itemTypes 屬性設定為您想要查詢的一種或多種 BusinessObjects Enterprise 物件，然後在集合中傳回。有效字串 (ProgID) 的範例包括：

• All
• CrystalEnterprise.Category
• CrystalEnterprise.Analytic
• CrystalEnterprise.Excel
• CrystalEnterprise.FavoritesFolder
• CrystalEnterprise.Folder
• CrystalEnterprise.Hyperlink
• CrystalEnterprise.MyInfoView
• CrystalEnterprise.ObjectPackage
• CrystalEnterprise.PersonalCategory
• CrystalEnterprise.Pdf
• CrystalEnterprise.Program
• CrystalEnterprise.Report
• CrystalEnterprise.Rtf
• CrystalEnterprise.Shortcut
• CrystalEnterprise.Txt
• CrystalEnterprise.Webi
• CrystalEnterprise.Word

所以，舉例來說，"All" 會傳回所有欄位，而 {"CrystalEnterprise.Report", "CrystalEnterprise.Pdf", "CrystalEnterprise.Txt"} 則只會傳回 Crystal 報表、PDF 或純文字檔等項目。

注意:
   如需有關 BusinessObjects Enterprise ProgID 的詳細資訊，請參閱《BusinessObjects Enterprise Java SDK 指南》。

searchFields 和 searchText 屬性必須一起使用，才能在 BusinessObjects Enterprise 系統上執行萬用字元搜尋。設定 searchFields 屬性為您想要進行搜尋的欄位，並設定 searchText 屬性為您想要比對的文字。例如，設定 searchFields 屬性為¶W½Ÿ，並設定 searchText 屬性為•žðyæPׂŠ¯™Ì，就會搜尋具有「全球銷售報表」名稱的報表。只有特定欄位經過最佳化，並建議用於搜尋：

• SI_NAME
• SI_DESCRIPTION
• SI_PROGID
• SI_OWNER

有幾個其他的屬性可以控制查詢物件集合的特定層面。設定 filterByOwner 屬性為 True，僅查詢使用者所擁有的項目。根據預設，此屬性為 False。instances 屬性可決定執行個體是否要包括在傳回的物件集合內，以及是否要設定為 EnterpriseItems Bean。這個屬性必須設定為 com.businessobjects.jsf.sdk.properties.InstanceFilter 類別的欄位：IncludeInstances，將執行個體納入查詢結果內；ExcludeInstances，將執行個體從查詢結果中排除；以及 InstancesOnly，傳回僅包含物件執行個體的集合。

除了 Bean 的一般屬性之外，還有兩個屬性會存取包含其他屬性的類別：

• sortBy 屬性

sortBy 屬性會取得或設定 SortProps 類別的執行個體，而此類別包含一些屬性，可在 EnterpriseItems Bean 內指定如何排序集合中的項目。SortProps 類別的 sortField 屬性指定排序集合項目所依據的欄位，而 SortProps 類別的 sortDirection 屬性可以指定以遞增或遞減的英數字元順序排序項目。

注意:
   ItemsGrid 元件指示繫結至元件的 EnterpriseItems Bean 的排序屬性值。如果這些值已附加到 ItemsGrid 元件，千萬不要在設計階段於 EnterpriseItems Bean 上以手動變更它們。

• paging 屬性

paging 屬性會取得或設定 PagingProps 類別的執行個體，而此類別包含一些屬性，可指定使用者如何瀏覽 EnterpriseItems Bean 所代表的項目清單。根據預設會停用分頁功能。若要啟用分頁功能，並讓使用者能夠導覽多頁的項目，則可以使用 PagingProps 類別的 setEnabled 方法，並將其引數設為 True。使用者可在每一頁上看見的項目數是由 pageSize 屬性決定的。預設值是在頁面上一次顯示十個項目。rangeSize 屬性指定定義頁面範圍的頁面數。例如，如果使用 setRangeSize 方法，並將其引數設為 10，再將 EnterpriseItems Bean 繫結至 ItemsGrid 元件，則使用者便可以使用格線底部的 [頁碼] 按鈕，個別選取頁面 1-10 來進行導覽。如果按一下 [下一頁範圍] 按鈕，頁面 11-20 的 [頁碼] 按鈕即可供選擇。

注意:
   如需所有 EnterpriseItems Bean 成員的完整參考，請參閱《BusinessObjects Enterprise Java API 參考的 JavaServer Faces 元件》中的 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>