更新时间:2025-06-23 GMT+08:00
分享

根据角色查询人员信息

功能介绍

根据角色查询用户信息。

URI

POST /console/servicetask/api/localMethod/participant/getUserInfosByRole

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

IAM用户的token。

通过调用IAM服务获取用户Token接口获取(即响应消息头中X-Subject-Token的值)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Application-Id

String

参数解释:

应用ID。

您可以在应用设计态的“应用中心 > 应用发布”页面获取,详情请参见应用发布

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Tenant-Id

String

参数解释:

数据建模引擎运行态租户ID。

您可以从访问流程引擎编排服务的浏览器地址栏中获取。

流程编排服务地址:http://{承载流程编排服务的服务器域名或IP地址}:{流程编排服务的端口号}/{流程编排服务文根}/index.html#/processApplicationForm?tenantId={数据建模引擎运行态租户ID}&applicationId={应用ID}

例如tenantId=-1,表示数据建模引擎运行态默认租户“basicTenant”的租户ID为-1。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-User-Id

String

参数解释:

请求当前接口时上下文中的用户ID,即OrgID的用户ID。仅基础版数据建模引擎-流程引擎需要配置此参数。

通过调用OrgID服务的获取用户信息接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

userCn

String

参数解释:

用户中文名。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

pageSize

String

参数解释:

每页的条数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

curPage

String

参数解释:

当前页数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

agentUserQueryVo

Object

参数解释:

角色的xdmId对象Vo。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

ok

请求示例

https://dme.cn-north-4.huaweicloud.cn/workflowRuntime/console/servicetask/api/localMethod/participant/getUserInfosByRole

{
  "agentUserQueryVo" : {
    "teamAndTeamRoleXdmId" : [ ],
    "userGroupXdmId" : [ ],
    "roleXdmId" : [ "111", "222" ]
  },
  "userCN" : "hid_fje4j2nvnue3xwp",
  "pageSize" : 10,
  "curPage" : 1
}

响应示例

状态码

状态码

描述

200

ok

错误码

请参见错误码

相关文档