Find Users 操作

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

注意: 返されるユーザーの上限数は 1000 です。

検索条件を満たすユーザーを 1 つのみ取得するには、Find User 操作操作を使用します。

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 プロパティ

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

List of Users

User 値で構成される戻り値 list を格納する場所です。各 User 値は、検索フィルターと一致するユーザーアカウントを表します。

リストから値を取得する方法について詳しくは、データコレクション内のデータへのアクセスを参照してください。

Output XML Document

プロセスデータモデルにおいて、検索結果を含む XML ドキュメントを表す戻り値 document を格納する場所です。XML は、User 値の list を表します。例えば、次の XML は、デフォルトの Administrator ユーザーを返す検索の結果です。

<?xml version="1.0" encoding="UTF-8"?> 
<users> 
    <user> 
        <principalOid>BA79A041-5DC7-102C-8ED7-00000A24CA8A</principalOid> 
        <userID>administrator</userID> 
        <domainName>DefaultDom</domainName> 
        <familyName>Administrator</familyName> 
        <givenName>Super</givenName> 
        <initials/> 
        <commonName>Super Administrator</commonName> 
        <canonicalName>SuperAdmin</canonicalName> 
        <telephoneNumber/> 
        <postalAddress/> 
        <email/> 
        <org/> 
    </user> 
</users>

Exceptions

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