這個 Managed Bean 為單一 Crystal Enterprise 物件 (如報表、資料夾或程式) 的來源。這個 Bean 會提供資訊,並將功能加入 UI 元件中。
若要進一步瞭解 Crystal Enterprise 核心功能及應用程式開發的相關資訊,請參閱《Crystal Enterprise Java SDK 指南》。
EnterpriseItem
Bean 為 Crystal Enterprise 物件的來源,並可用來代表頁面上的物件。EnterpriseItem
Bean 是 JavaServer Faces Components for Crystal Enterprise 所建置的任何應用程式的關鍵層面。許多元件 (如 Schedule
或 ReportPageViewer
元件) 會依賴 EnterpriseItem
Bean,因為其功能是針對 Crystal Enterprise 物件運作。例如,ReportPageViewer
元件的用途就是檢視 (更明確地說) 報表物件。若要從系統擷取 Crystal Enterprise 物件,頁面就必須使用 Crystal Enterprise 查詢語言來查詢物件。但是 EnterpriseItem
Bean 卻可將這種複雜性降低到一組會自動產生查詢字串的屬性。設定屬性為所要的值以擷取相關物件。如需有關 Crystal Enterprise 查詢語言的詳細資訊,請參閱《Crystal Enterprise Java SDK 指南》。
itemID
屬性在讓 EnterpriseItem
Bean 與實際物件之間產生關係的工作上相當重要,因為它會指定 EnterpriseItem
Bean 所代表物件的 ID 或 CUID。例如,您可以將這個屬性設定為使用者於其中一個頁面選取之報表的報表 ID。這個 EnterpriseItem
Bean 可能接著繫結至 ReportPageViewer
元件,為使用者建構並顯示該報表。itemID
屬性可以用許多不同的方法來設定。常見的案例就是在使用者從頁面的項目清單中選取單一項目之後,以程式設計的方式設定 itemID
屬性。在這個案例中,您會實際查詢 EnterpriseItems
Bean 所代表的項目集合,接著使用元件 (如 ItemsGrid
元件) 顯示 EnterpriseItems
Bean 所代表的項目集合,然後將使用者所選取項目的單一 ID 傳入 EnterpriseItem
Bean 中。如需更多資訊,請參閱EnterpriseItems Bean。如何在頁面中設定 EnterpriseItem
Bean 的 itemID
屬性,主要依您試圖實作的案例而定。
fields
屬性定義您想要查詢的資料庫欄位,如此便可決定要使用物件來擷取哪些物件屬性及屬性包。選取要與物件一起傳回的欄位,讓 EnterpriseItem
Bean 能夠存取您所需要的資訊。有效字串的範例包括:
All
SI_ID
在 Crystal Enterprise 系統中可唯一識別物件的號碼。
SI_CUID
SI_NAME
SI_DESCRIPTION
SI_GUID
SI_PARENTID
SI_PARENTCUID
SI_INSTANCE
SI_PROGID
指定實作物件之元件的名稱字串。有效 ProgID 值的範例包括 CrystalEnterprise.Folder、CrystalEnterprise.Report 和 CrystalEnterprise.PDF。如需完整清單,請參閱《Crystal Enterprise Java SDK 指南》。
SI_OWNER
SI_OWNERID
SI_CREATION_TIME
SI_LAST_RUN_TIME
SI_UPDATE_TS
SI_PROCESSINGINFO
SI_SCHEDULEINFO
SI_HASTHUMBNAIL
EnterpriseItem
Bean 將能夠根據您對此欄位屬性所做的選擇,存取及操作物件的欄位。舉例來說, "All"
會傳回所有欄位,而 {"SI_NAME, SI_DESCRIPTION, SI_PROGID"}
則只會傳回三個特定欄位,包括項目的標題、說明和 ProgID。
注意 如需有關 Crystal Enterprise ProgID 的詳細資訊,請參閱《Crystal Enterprise Java SDK 指南》。
注意 如需所有 EnterpriseItem
Bean 成員的完整參考,請參閱《Crystal Reports for Rational Application Developer Java API 參考》中的 IEnterpriseItem
介面。
<description>Source for a single report.</description>
<managed
com.businessobjects.jsf.appcontrols.model.EnterpriseItem
<managed
<property
Business Objects http://www.china.businessobjects.com Support services http://www.china.businessobjects.com |