Compare-Attribute
説明
属性名の値をディレクトリ内のエントリの属性値パラメータと比較します。
構文
<ie:webject name="Compare-Attribute" type="ACT">
<ie:param name="ATTNAME" data="attribute_name"/>
<ie:param name="ATTVALUE" data="attribute_value"/>
<ie:param name="BASE" data="base_context_name"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="DBUSER" data="dbuser_name"/>
<ie:param name="GROUP_OUT" data=group_out"/>
<ie:param name="INSTANCE" data="instance_name"/>
<ie:param name="OBJECT" data="object_value"/>
<ie:param name="PASSWD" data="dbpassword"/>
</ie:webject>
パラメータ
|
必須
|
オプション
|
|
ATTNAME
|
BASE
|
|
ATTVALUE
|
CONNECTION ATTEMPTS
|
|
INSTANCE
|
CONNECTION_ATTEMPT_INTERVAL
|
|
DBUSER
|
|
GROUP_OUT
|
|
OBJECT
|
|
PASSWD
|
ATTNAME
指定された値と比較するエントリの属性名を指定します。これは必須のパラメータです。
ATTVALUE
比較されるエントリの属性値を指定します。これは必須のパラメータです。
BASE
サーチを開始するエントリのベース識別名を指定します。このパラメータに値が指定されている場合、アダプタの LDAP エントリに指定されているプロパティ値よりも Webject 値が優先されます。このパラメータのデフォルト値は、アダプタの LDAP エントリの searchBase プロパティに指定した値です。これはオプションのパラメータです。
CONNECTION_ATTEMPTS
エラーを返す前にアダプタの接続の確立を試行する最大回数を定義します。デフォルト値は 1 です。このパラメータはオプションです。
複数の INSTANCE パラメータ値を指定する場合、CONNECTION_ATTEMPTS の値は、アダプタインスタンスのリストを繰り返す最大数を定義します。
CONNECTION_ATTEMPT_INTERVAL
接続の試行間の遅延時間を秒単位で定義します。デフォルト値は 60 秒です。このパラメータはオプションです。
複数の INSTANCE パラメータ値が指定されている場合、CONNECTION_ATTEMPT_INTERVAL の値は、アダプタインスタンスのリスト全体を繰り返す試行間の待機秒数を定義します。
DBUSER
データリポジトリへのログイン時に使用するユーザー ID を指定します。このパラメータが Webject で指定されている場合、この Webject の値が、アダプタ LDAP エントリ、または認証マッピング設定で指定されているいずれの値よりも優先されます。このパラメータが指定されていない場合、認証マッピング設定およびアダプタ LDAP エントリで指定する必要があります。資格証明マッピングの詳細については、
資格証明マッピングのセクションを参照してください。
GROUP_OUT
操作によって返されるオブジェクトセットの名前を識別します。現在、GROUP_OUT はステータスメッセージのみを返します。このパラメータはオプションです。
INSTANCE
Webject を実行するアダプタの名前を指定します。アダプタ名は、Info*Engine 環境で使用するためにアダプタを設定する際に定義されます。このパラメータは必須です。
特定のアダプタを使用できない場合にほかのアダプタに接続できるように、このパラメータには複数の値を指定できます。Info*Engine は、決められた順番にアダプタへの接続を試みます。最初のアダプタが使用できない場合、次にリストされているアダプタへの接続が試行されます。これは接続が確立されるまで実行されます。リストされているどのアダプタとも接続できない場合は、エラーを返します。
このパラメータとともに、CONNECTION_ATTEMPTS と CONNECTION_ATTEMPT_INTERVAL の 2 つのパラメータを含めることができます。
OBJECT
エントリのコンテキスト名を指定します。指定できるオブジェクトは 1 つのみです。複数のオブジェクトを指定した場合、最初のオブジェクトが使用され、残りのオブジェクトは無視されます。これはオプションのパラメータです。
PASSWD
データリポジトリへのログイン時に使用するパスワードを指定します。このパラメータが Webject で指定されている場合、この Webject の値が、アダプタ LDAP エントリ、または認証マッピング設定で指定されているいずれの値よりも優先されます。このパラメータが指定されていない場合、認証マッピング設定およびアダプタ LDAP エントリで指定する必要があります。資格証明マッピングの詳細については、
資格証明マッピングのセクションを参照してください。
例
この例の Compare-Attribute Webject は、適切なアダプタインスタンスと接続するように Info*Engine に指示します。接続が完了すると、Info*Engine はオブジェクト "uid=pperson, ou=people" をチェックして、属性 "location" が "Pontiac" に設定されていることを確認します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<ie:webject name="Compare-Attribute" type="ACT">
<ie:param name="INSTANCE" data="jndiAdapter"/>
<ie:param name="ATTNAME" data="location"/>
<ie:param name="ATTVALUE" data="Pontiac"/>
<ie:param name="OBJECT" data="uid=pperson, ou=people"
<ie:param name="BASE" data="uid=pperson, ou=people"/>
<ie:param name="GROUP_OUT" data="Compare"/>
</ie:webject>