LDAPSearch - LDAP検索

このコンポーネントの前に処理されたLDAPAuthコンポーネントのコンテキストのLDAPサーバーに対して検索を行います。
LDAPサーバーとの接続にSSL通信を使う場合、管理コンソールで登録された証明書を使用してPKI基盤に従って通信を行います。

■ストリーム情報

入力	フォーマット	すべて
	接続数	1
出力	フォーマット	XML,ParameterList,Record
	説明	検索で一致したLDAPレコードの属性は、出力ストリームにおいて同じ名前を持つフィールドにマップします。詳しくは、下記トピックを参照してください。

■コンポーネントプロパティ

名前	プロパティ型	マッピング	説明
検索文字列	string	入力＆出力	検索のためのクエリーを記述します。クエリーの書式は、RFC-2254で定義された書式で記述します。
検索の起点	string	入力＆出力	検索に使うコンテキストのベースDNを指定します。 このプロパティに値が設定された場合、このコンポーネントの前で参照されたLDAPAuthコンポーネントで使われたコネクションで定義した「Provider URL」の値に対して相対的なベースDNとなります。 このプロパティに値が設定されない場合、コネクションのベースDNあればそれを使用します。 コネクションで設定したベースDNとこのコンポーネントのプロパティで設定されたベースDNを足した文字列を「AggregateBaseDN」と呼びます。 AggregateBaseDNは、検索の起点となります。
エントリ最大数	int	入力＆出力	検索結果として返すエントリの最大個数を指定します。0を指定した場合は、無制限となります。
タイムアウト（秒）	int	入力＆出力	検索結果をLDAPサーバーから受け取るときに待つ秒数（タイムアウト秒数）を指定します。0の場合はタイムアウトしません。
ループを開始	loopProcess	-	検索結果をまとめて出力するか1レコードずつ出力するか選択します。 はい [true] - 検索結果をレコードごとに出力します。 いいえ [false] - 一回の出力にすべてのレコードデータをいれて出力します。
エイリアスを展開	boolean	入力＆出力	検索時にLDAPエイリアスを展開するかどうかを指定します。 はい [true] - エイリアスを展開します いいえ [false] - エイリアスを展開しません。
検索スコープ	choice	入力＆出力	検索のためのスコープを指定します。 指定されたコンテキストのみ [Object] - 「AggregateBaseDN」で指定されているコンテキストのみを検索します。 1階層下まで [OneLevel] - 「AggregateBaseDN」で指定されているコンテキスト以下で1階層下の部分まで検索します。 すべての階層 [Subtree] - 「AggregateBaseDN」で指定されているコンテキスト以下すべてを検索します。

■ループ処理

ループを開始プロパティがはいの場合、検索結果が1レコードずつ出力されます。

■トランザクション処理

コミット	何もしません。
ロールバック	何もしません。

■エラー処理

タイプ	パラ メータ	エラー処理フロー へのストリーム	エラー コード	説明
汎用	なし	コンポーネントの入力ストリーム	なし	このコンポーネントが実行される前に、LDAPAuthコンポーネントによってLDAPサーバーの接続に成功していません。
			なし	「AggregateBaseDN」が正しいコンテキストを指定していません。
			なし	検索で一致したLDAPレコードにおける属性が、出力ストリームで指定されているフィールドの適当な型に変換できなかった。
レコードが無い	なし	コンポーネントの入力ストリーム	1	レコードが0件の場合

■出力ストリームのフィールド名

検索で一致したLDAPレコードの属性は、出力ストリームにおいて同じ名前を持つフィールドにマップします。 可能な限り、適切なデータ型に変換して出力します。
同じ名称の複数の属性が検索された場合には最初の属性の値だけをマップします。

例：

検索された属性名	検索された属性値	出力フィールド名	出力データ型	出力値
FirstName	John	FirstName	String	John
FirstName	John	FirstName	Integer	0
Age	32	Age	Integer	32
Colors	{Blue, Green, Red}	Colors	String	Blue
FirstName	John	LastName	String	<出力されません>