上一主题: getRelatedList下一主题: getPendingChangeTaskListForContact


getRelatedListValues

以下参数适用于 getRelatedListValues 方法:

参数

类型

说明

SID

整型

标识从登录检索的会话。

objectHandle

字符串

标识对象句柄。

listName

字符串

标识对象的列表类型属性名称。

numToFetch

整型

表示返回行的最大数量。

  • 不能为零
  • 指定 -1 则返回所有行

注意:无论指定什么整数,对于每次调用,Web 服务最多返回 250 行。

属性

字符串 []

标识要取值的一个或多个属性名称的数组。允许使用点名称。

getRelatedListValuesResult

String Holder

标识用于捕获返回数据的 String Holder 对象。

numRowsFound

整型持有者

标识用于捕获返回数据的整型持有者对象。

说明

返回与特定对象相关的列表中的值。列表必须定义为 QREL 或 BREL。使用 LREL 方法查询 LREL 类型。

例如,请求对象具有名为“子项”的相关列表,该列表是其子请求的列表。此方法是 getRelatedList() 的替代方法,与列表句柄无关。返回格式与 getListValues() 相似,如下所示:

<numRowsFound>
< UDSObjectList >
<UDSObject>
<Handle>
<AttributeName0>
<AttributeName1>

您可以使用对象架构 (majic) 检索对象列表属性的信息。另一种替代方法是使用 getObjectTypeInformation()。

返回

此方法的返回值如下:

XML 元素

类型

说明

<getRelatedListValuesResult>

N/A

标识包含 <UDSObject> 元素序列的外部元素 <UDSObjectList>。每个 <UDSObject> 元素都包含一个 <Handle> 元素以及零个或多个 <AttributeNameX> 元素。

<numRowsFound>

整型

指明查询列表中的总行数。

注意:总行数不一定等于返回的行数。