Find Groups 操作

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

注意: 返されるグループの上限数は 1000 です。

検索条件を満たすグループを 1 つのみ取得するには、Find Group 操作操作を使用します。

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

Filter プロパティ

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

Domain Name

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

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

Universal ID

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

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

Name

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

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

Result プロパティ

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

List of Groups

Group 値で構成される戻り値 list を格納する場所です。各 Group 値は、検索フィルターと一致するグループを表します。例えば、変数にリストを保存するには、リストから list 変数を選択します。

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

Output XML Document

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

<?xml version="1.0" encoding="UTF-8"?> 
<groups> 
    <group> 
        <principalOid>B98E6F7F-5DC7-102C-A430-00000A24CA8A</principalOid> 
        <domainName>DefaultDom</domainName> 
        <commonName>All Principals</commonName> 
        <canonicalName>GROUP_ALLPRINCIPALS</canonicalName> 
    </group> 
</groups>

Exceptions

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