Logon 元件可讓您建立可用來驗證並讓使用者登入至 Crystal Enterprise 工作階段的表單。所需要的基本資訊為可在兩個不同輸入欄位中輸入的使用者名稱及密碼。[使用者名稱] 及 [密碼] 輸入欄位標籤上的文字可以用 userNameText 和 passwordText 屬性加以自訂。
除了元件的一般屬性 (Attribute) 之外,尚有一些屬性 (Attribute) 必須設定為屬性類別 (Property Class)。
authentication 屬性
authentication 屬性會存取 AuthenticationProps 類別的執行個體;此類別包含兩個屬性:visible 和 text。根據預設,visible 屬性設定為 True,並且表單上會顯示 [使用者群組別名] 輸入欄位。這個別名可能是 Enterprise 使用者群組別名或協力廠商驗證提供者,例如:Windows NT、Windows AD 或 LDAP。[驗證] 輸入欄位標籤上的文字也可以使用 text 屬性來設定。如果 visible 屬性設定為 False,便不會顯示 [驗證] 輸入欄位。
logoffButton 和 logonButton 屬性
logoffButton 和 logonButton 屬性會存取 SubmitButtonProps 類別的執行個體;此類別包含用來指定如何顯示 [登入] 和 [登出] 按鈕的屬性。顯示的按鈕會依元件的狀態而定。這些屬性會以與 submitButton 屬性相同的方式運作;這在通用元件屬性中有詳細說明。
system 屬性
system 屬性會存取 SystemProps 類別的執行個體;此類別包含與 AuthenticationProps 類別類似的屬性。根據預設,visible 屬性設定為 True,並且會在表單上顯示 [系統] 輸入欄位。這個欄位可用來輸入要存取的 Crystal Enterprise 系統名稱。當 [系統] 輸入欄位可以看見時,您可以設定 readOnly 屬性來決定如何顯示輸入欄位的內容。如果設定為 True,則會停用 Crystal Enterprise 系統名稱,而且使用者也將無法編輯欄位。如果設定為 False,則使用者可以編輯系統名稱。[系統] 輸入欄位標籤上的文字也可以使用text 屬性來設定。如果 visible 屬性設定為 False,則不會顯示 [系統] 輸入欄位。
注意 如需有關屬性類別的詳細資訊,請參閱我要如何使用結合 JavaServer Faces Components for Crystal Enterprise 的屬性類別?。
若要啟用 Logon 元件的自動事件處理功能,請設定 autoHandleEvents 屬性為 True。設定為 True 時,這個屬性會實作當使用者與元件互動時所觸發動作事件的預設行為。例如:
| 事件 | 預設行為 |
|---|---|
如果 autoHandleEvents 屬性設定為 False,就不會處理這些事件。當 autoHandleEvents 設定為 True 時,這些事件會呼叫 Logon 元件的 submit 方法,以實作預設的功能。如果您設定 autoHandleEvents 為 False,您就可以自行撰寫呼叫 submit 方法的事件處理常式,以擷取這些其他的事件。
使用 identity 屬性以將 Identity Bean 繫結至 Logon 元件。Identity Bean 提供了登入 Crystal Enterprise 系統所需要的一般使用者驗證憑證。
| Business Objects http://www.china.businessobjects.com Support services http://www.china.businessobjects.com |