Find User 操作

指定された検索フィルターに基づいて、User Manager からユーザーアカウントに関する情報を取得します。検索では、検索条件を満たす最初のユーザーが返されます。また、条件を満たすユーザーの合計数も返されます。

同じ検索条件を満たす複数のユーザーを取得するには、Find Users 操作操作を使用します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、共通の操作プロパティを参照してください。

Filter プロパティ

検索条件を指定するためのプロパティです。少なくとも 1 つのフィルターを指定する必要があります。複数のフィルターを指定して検索結果を絞り込むことができます。

Exact Match

プロパティが Name フィルターおよび Email フィルターと完全に一致するユーザーのみを返すかどうかを指定する boolean 値です。値を true に設定した場合、完全一致が返されます。値を false に設定した場合、検索条件と部分的に一致する最初のユーザーが返されます。

リテラル値を表す場合は、「Exact Match」を選択して、ユーザー名全体または電子メールアドレス全体を照合してください。

Domain Name

ユーザーが属する User Management ドメインを表す string 値です。リテラル値を指定するには、リストからドメインを選択します。

ドメインについて詳しくは、LiveCycle 管理ヘルプの「ドメインの設定と管理」を参照してください。

Universal ID

ユーザーの一意の ID を表す string 値です。この値では、User Management で作成されるドメインの Directory Users プロパティで設定される Unique Identifier プロパティを検索します。

56e04201-1dd211b2-80cafe29-7dd5631b のように、ID 全体を指定する必要があります。

Name

ユーザーの名前を表す string 値です。この値では、User Management で作成されるドメインの Directory Users プロパティで設定される Full Name プロパティを検索します。

取得するユーザーの名前全体またはその一部を指定できます。

Email

ユーザーの電子メールアドレスを表す string 値です。この値では、User Management で作成されるドメインの Directory Users プロパティで設定される Primary Email プロパティを検索します。

取得するユーザーの電子メールアドレス全体またはその一部を指定できます。

Login Id

ユーザーがログインするときに使用するログイン名を表す string 値です。この値では、User Management で作成されるドメインの Directory Users プロパティで設定される Login ID プロパティを検索します。

取得するユーザーのログイン名全体またはその一部を指定できます。

Result プロパティ

操作結果を格納する場所を指定するためのプロパティです。

Results

検索フィルターと一致するユーザーの数を示す戻り値 int を格納する場所です。Result の最大値は 10 です。一致するグループが 10 個見つかった時点で、サーバーリソース節約のため検索が停止されます。

User

検索フィルターと一致する最初のユーザーアカウントを表す User 値です。

Exceptions

この操作に関連付けられている例外イベントは、UMException例外を受け取る場合があります。