接口说明
应用可以使用该接口提供按钮,让企业管理员打开应用的管理页面,快速进行修改可见范围等操作。
调用前提
必须前置调用过wx.agentConfig
调用人身份要求
企业超级管理员
具有应用管理权限的企业分级管理员
示例代码
wx.invoke('openAppManage',
{
"page": "permission", // 非必填,指定跳转的页面地址
"suiteId": "wwabcdefghijk", // 非必填,指定跳转的关联应用
},
function(res){
if(res.err_msg == "openAppManage:ok") {
// 调用成功
}
if(res.err_msg == "openAppManage:fail:no permission") {
// 调用人身份不符合
}
if(res.err_msg == "openAppManage:fail:unknown app") {
// 应用信息获取失败
}
if(res.err_msg == "openAppManage:fail:unsupported app type") {
// 应用类型不符合要求
}
if(res.err_msg == "openAppManage:fail") {
// 其它错误
}
})
参数说明
参数名 | 类型 | 必填 | 说明 | 企业微信版本要求 |
---|---|---|---|---|
page | String | 否 | 不指定时,表示为跳转至应用管理首页。 指定时,表示跳转的应用二级页。目前支持的二级页有: permission:对应为应用权限详情页。 datazone_permission:对应为数据与智能专区权限授权页。 | ≥4.1.22 |
suiteId | String | 否 | 不指定时,表示为跳转agentConfig指定的应用管理页。 指定时,表示为跳转的其他应用管理页。目前仅支持会话内容存档应用。指定的suiteid必须是同服务商的应用,且当前企业有授权关系,同时当前用户必须是超管 | ≥4.1.22 |
page=datazone_permission,需要满足:
- 企业访问者身份为超级管理员
- 应用需要满足勾选了“数据与智能专区权限”(注:该权限目前灰度开放)
- 应用类型为第三方应用/代开发应用(注:不支持上下游共享应用)
平台版本说明
平台 | 企业微信版本要求 |
---|---|
ios | ≥4.0.2 |
android | ≥4.0.2 |
win | ≥4.0.2 |
mac | ≥4.0.2 |
应用权限说明
应用类型 | 是否支持 |
---|---|
自建应用 | 支持 |
第三方应用 | 支持 |
代开发自建应用 | 支持 |
调用场景
跳转应用管理:当需要应用信息查看或者修改(如:可见范围/购买付费/应用评价),可跳转至该管理页进行操作。
ww.openAppManage();
跳转应用权限详情页:查看应用已授权权限项,及更新应用最新权限(如应用有权限变更时)。
ww.openAppManage({
page: "permission"
});
跳转数据与智能专区权限授权页:授权数据与智能专区权限,若已授权则为修改授权内容。
ww.openAppManage({
page: "datazone_permission"
});