概要

Logon コンポーネントを使用して、ユーザーを認証して BusinessObjects Enterprise セッションにログオンさせるのに使用するフォームを作成することができます。必要な基本情報はユーザー名とパスワードです。これらの情報の入力フィールドは 2 つに分かれています。ユーザー名とパスワードの入力フィールドのラベルのテキストは、userNameText 属性と passwordText 属性を使用してカスタマイズできます。

コンポーネントの一般属性のほか、プロパティ クラスに設定する必要のある属性があります。

• authentication 属性

authentication 属性は AuthenticationProps クラスのインスタンスにアクセスしますが、このクラスには visible と text という 2 つのプロパティがあります。デフォルトでは、visible プロパティは True に設定され、ユーザー グループのエイリアス名入力フィールドがフォームに表示されます。このエイリアスには、Enterprise ユーザー グループ エイリアスか、Windows NT、Windows AD、または LDAP などのサードパーティ認証プロバイダを使用できます。認証入力フィールド ラベルのテキストは、text プロパティで設定します。visible プロパティが False に設定されている場合、認証入力フィールドは表示されません。

• logoffButton 属性および logonButton 属性

logoffButton 属性と logonButton 属性は SubmitButtonProps クラスのインスタンスにアクセスしますが、このクラスにはログオン ボタンとログオフ ボタンの表示方法を指定するプロパティがあります。コンポーネントの状態によって、表示されるボタンが変わります。これらの属性の動作は、共通のコンポーネント属性に説明する submitButton 属性のそれと同じです。

• system 属性

system 属性は SystemProps クラスのインスタンスにアクセスしますが、このクラスには AuthenticationProps クラスと同様のプロパティがあります。visible プロパティは、デフォルトで True に設定されていて、システム入力フィールドがフォームに表示されます。このフィールドには、アクセスする BusinessObjects Enterprise システムの名前を入力します。システム入力フィールドが表示されている場合は、readOnly プロパティを設定して入力フィールドの表示方法を指定できます。True に設定すると、BusinessObjects Enterprise システム名が無効になり、ユーザーはフィールドを編集できなくなります。False に設定されると、ユーザーはシステム名を編集できます。システム入力フィールド ラベルのテキストは、text プロパティで設定します。visible プロパティが False に設定されている場合、システム入力フィールドは表示されません。

注    プロパティ クラスに関する詳細は、プロパティ クラスを JavaServer Faces Components for BusinessObjects Enterprise と連係させてどのように使用できますか。を参照してください。

イベント処理

Logon コンポーネントの自動イベント処理機能を有効にするには、autoHandleEvents 属性を True に設定します。この属性を True に設定すると、ユーザーがコンポーネントを操作したときにトリガされるデフォルトの動作またはアクションがプロパティに実装されます。以下はその例です。

イベント	デフォルトの動作
LogoffClicked	ログオフ ボタンをクリックすると、BusinessObjects Enterprise からログオフします。
LogonClicked	ログオン ボタンがクリックされると、コンポーネントで指定した認証情報が BusinessObjects Enterprise に送信され、ログオンが試行されます。

autoHandleEvents 属性が False の場合、これらのイベントは自動的には処理されません。autoHandleEvents を True に設定すると、そのイベントによって Logon コンポーネントの submit メソッドが呼び出されます。これは、デフォルトの機能を実装します。autoHandleEvents を False に設定すると、submit メソッドを呼び出す独自のイベント ハンドラを記述して、その他のイベントをキャプチャできます。

データ連結

Identity Bean を Logon コンポーネントに連結するには、identity 属性を使用します。Identity Bean は、BusinessObjects Enterprise システムへのログオンに必要なエンド ユーザー認証情報を提供します。