我要如何使用結合 JavaServer Faces Components for BusinessObjects Enterprise 的屬性類別？

就 UI 元件的屬性 (Attribute) 以及 Managed Bean 的屬性 (Property) 而言，其中有許多都必須設定為屬性類別 (Property Class) 的執行個體。為了方便說明如何在應用程式中使用這些屬性類別，請設想下列範例。

範例

Logon 元件具有名為 logonButton 的屬性 (Attribute)。該屬性必須設定為 SubmitButton 類別的執行個體；因為類別中包含定義著登入表單按鈕之外觀及行為的屬性 (Property)。若要存取並操作這些屬性，Logon 元件必須參考會將 SubmitButton 類別執行個體化的 Bean。您首先必須建立 Java Bean。

建立 Java Bean

1. 在 [調色盤] 檢視的 [資料] 索引標籤之下，按一下 [JavaBean]，並拖曳 Bean 到視覺化設計工具的頁面上。

提示:
   或者，您可以在 [頁面資料] 檢視中用滑鼠右鍵按一下 [JSP 指令碼]，再按一下 [新增] > [JavaBean]。

2. 在 [加入 JavaBean] 對話方塊的 [名稱] 欄位中，輸入 logonButton1。
3. 在 [類別] 欄位中，輸入 SubmitButtonProps 類別的完整名稱：

com.businessobjects.jsf.sdk.properties.SubmitButtonProps

提示:
   或者，您可以按一下 [類別] 欄位旁邊的按鈕，搜尋要加入的類別。[類別選項] 對話方塊會出現；您便可在其中的 [選擇類別] 欄位內輸入類別名稱的開頭部分，依字母順序搜尋有效的類別。

4. 按一下 [使這個 JavaBean 可重複使用]，讓 Bean 可以供其他頁面使用，然後在 [Scope] 清單上按一下 [工作階段]。
5. 按一下 [初始化屬性] 設定 SubmitButton 類別的屬性初始預設值。
6. 在 [初始化 JavaBean 屬性] 對話方塊中，按一下 [加入] 將新屬性加至清單。
7. 在 [名稱] 欄位中按一下，並從清單中選取屬性。

在此情況下，清單中會顯示所有可供選擇的 SubmitButton 類別屬性，您將會看見如 text、imageUrl、type、alignment 和 visible 之類的屬性。

8. 在 [值] 欄位中輸入屬性值。

例如，如果選取的是 text 屬性，就輸入您想要在登入按鈕上顯示的字串，例如「登入」或「提交」。

9. 重複步驟 6 至 8，直到已經初始化所有指定屬性的預設值為止。
10. 按一下 [確定]，然後按一下 [完成]。

叫做 logonButton1 的 Java Bean 會加至頁面，並且可在 [頁面資料] 檢視中看到。接下來，從 Logon 元件加入參考至這個 Bean。

從 logonButton 屬性參考屬性 Bean

1. 在視覺化設計工具中選取 Logon 元件。
2. 在 [屬性] 檢視中，按一下 logonButton 屬性欄位旁邊的按鈕。
3. 在 [選取頁面資料物件] 對話方塊中，選取 [logonButton1]，然後按一下 [確定]。

新建立的 Bean 資料會立即影響 Logon 元件登入按鈕的格式及行為。您可以在 [頁面資料] 檢視中進一步設定 Bean 並變更其屬性值。需要屬性類別的所有元件屬性都會以這種方式運作。

此外，EnterpriseItems 和 Identity Bean 還包含必須設定為屬性類別的屬性。您可以從 [頁面資料] 檢視中初始化 EnterpriseItem 或 Identity Bean 的屬性，並使用類似於加入元件的方式來加入屬性 Bean 的參考。如需詳細資訊，請參閱我要如何初始化 Java Bean 的預設值？。

下列表格中顯示需要屬性類別 (Property Class) 的元件屬性 (Attribute) 及 Managed Bean 屬性 (Property) 的清單。

注意:
   如需屬性類別的詳細文件，請參閱《Crystal Reports for Rational Application Developer Java API 參考》。

UI 元件	屬性 (Attribute)	屬性類別
Logon	authentication	AuthenticationProps
Logon	logoffButton	SubmitButtonProps
Logon	logonButton	SubmitButtonProps
Logon	system	SystemProps
ItemsGrid	alerts	AlertProps
ItemsGrid	pagerStyle	PagerProps
Path	showImages	ImagesProps

Managed Bean	屬性 (Property)	屬性類別
EnterpriseItems	paging	PagingProps
EnterpriseItems	sortBy	SortProps