getGroupMemberListValues

以下参数适用于 getGroupMemberListValues 方法：

参数	类型	说明
SID	整型	标识从登录检索的会话。
whereClause	字符串	标识 SQL where 子句。
numToFetch	整型	确认要返回的最大记录数。此数量不能为零 (0). 使用‘1’则返回全部记录。
属性	字符串 []	标识要为其检索值的属性名称数组（参见以下说明）。

说明

功能与 getListValues() 类似，但有一个例外，就是它可以查询系统的组和成员关系。系统使用特殊的“组成员”(grpmem) 对象表示每个组/成员关系。CA SDM 系统在后台管理 grpmem 对象（您无法直接操纵这些对象），这些对象对于某些查询必不可少。

grpmem 对象仅包含两个指针，一个指向联系人，另一个指向组，它本身就是一个联系人对象。属性名称分别是‘member’和‘group’。由于这些是指针，因此您必须使用点标记法构建标准查询。例如，要查找所有姓氏以‘B’开头并且位于“Seattle”组中的联系人，您可以使用：

member.last_name LIKE ‘B%’ AND group.last_name = ‘Seattle’

您也可以照常使用句柄，如下所示：

member.last_name LIKE ‘A%’ AND group.id = U‘555A043EDDB36D4F97524F2496B35E75’

切记，此方法可以从所有成员和组中检索值，而不仅仅是单个组。要仅获得关于特定组的全部成员或特定成员的信息，只需在 where 子句中指定句柄。例如，以下语句将从特定组中检索值：

group.id = U‘555A043EDDB36D4F97524F2496B35E75’

请务必熟记以下概念：

grpmem 方法实际查询 grpmem 对象表，从而返回表示两个联系人之间关系的对象。因此，您要在属性中提取的属性值必须从 grpmem 对象中使用点标记法。要从成员中提取值，所有属性名称必须使用‘member.ATTRNAME’的形式，如下例所示：

‘member.last_name’

要从组中提取值，可以使用‘group.ATTRNAME’。

注意：如需高效查询组和成员的示例，请参阅“Where 子句”。

不会自动返回任何句柄。返回中的 <Handle> 元素始终为空。要请求每行的成员或组句柄，可以使用下表描述的属性参数之一。

XML 元素	类型	说明
<UDSObjectList>	N/A	标识外部元素，该元素包含由 <UDSObject> 元素组成的数组。每个对象实际上是一个 grpmem 对象。