上一主题: getContact下一主题: 组管理方法


findContacts

以下参数适用于 findContacts 方法:

参数

类型

说明

SID

整型

标识从登录检索的会话。

userName

字符串

仅返回具有此用户名的联系人。可使用百分号 (%) 进行通配符搜索。

例如,要搜索用户名以 Smi 开头的所有联系人,请指定 Smi%。

lastName

字符串

仅返回具有此姓氏的联系人。可使用百分号 (%) 进行通配符搜索。

firstName

字符串

仅返回具有此名字的联系人。可使用百分号 (%) 进行通配符搜索。

email

字符串

仅返回具有此电子邮件地址的联系人。可使用百分号 (%) 进行通配符搜索。

accessType

字符串

仅返回具有此访问类型的联系人。您可以指定多个角色,使用逗号分隔。指定以下内容:

  • 10002 - 管理
  • 10004 - 客户
  • 10005 - 员工
  • 10009 - IT 工作人员
  • 10013 - 知识管理
  • 10014 - 过程管理
  • 10010 - 服务台管理
  • 10008 - 服务台工作人员
  • 10020 - 供应商职员

inactiveFlag

整型

仅返回非活动或活动的联系人。指定以下内容:

  • 0 表示现用
  • -999 表示全部
  • 其他值表示非活动

说明

检索联系人列表。

返回

具有零个或多个 <UDSObject> 节点的 <UDSObjectList> 节点,它使用以下 <Attributes> 子节点描述联系人:

XML 元素值

类型

说明

id

UUID

指定联系人的唯一 ID。

userid

字符串

指定联系人的用户名。

last_name

字符串

标识联系人的姓氏。

first_name

字符串

标识联系人的名字。

access_type

整型

指定联系人的角色 ID。

delete_flag

整型

表示联系人是处于活动状态还是非活动状态:

  • 0 - 活动
  • 1 - 非活动

loginWithArtifact

以下参数适用于 loginWithArtifact 方法:

参数

类型

说明

userid

字符串

标识用户 ID。

artifact

字符串

标识从 CA EEM 获取的印证码。

说明

通过所提供的 CA EEM 印证码执行用户身份验证,并打开与后端服务器的会话。该印证码在身份验证中只能使用一次。返回的会话 ID (SID) 可用于后续的 Web 服务方法调用。该印证码可以直接从 CA EEM 获取,也可以通过 getArtifact 方法获取。

注意:Service Desk 需要与 CA EEM 集成才能执行此操作。

SID 应当使用 logout() 进行释放。如果超时之前未使用 SID,则 SID 可能过期。

返回

返回以下内容:

参数

类型

说明

SID

字符串

标识用于所有其它 Web Services 调用的唯一会话 ID (SID)。使用纯文本格式。