接口简介

selectDatazoneFile —— 在「数据与智能专区」能力下，调起企业微信原生的微盘文件选择面板，让用户从自己所在的所有空间中、本人上传的微盘文件里勾选若干，返回文件的 fileId 与 url 列表给业务网页。

适用场景：在数据与智能专区中选定文件后，调通用模型能力进行分析；业务网页内一键挑选用户的微盘资料；从知识库 / AI 助手入口承接文件选择动作。

本接口只能选择当前用户本人上传的微盘文件，不能选择他人上传或公共空间内非本人的文件。文件选定后只返回 fileId 与 url，业务侧的后续操作（如调用模型、归档、转存）需自行调用对应后台 API。

灰度内测中：本接口依赖「数据与智能专区文档存档权限」，需该权限灰度通过后方可调用。

调用前提

• 必须先使用 ww.register 进行应用身份注册
• 当前成员必须在应用的可见范围内，否则报 selectDatazoneFile:fail no permission
• 应用必须具有数据与智能专区文档存档权限，且成员在该应用的文档存档范围内，否则报 selectDatazoneFile:fail no permission
• 自建 第三方 代开发应用均需先获得灰度准入

调用方式

示例代码

ww.selectDatazoneFile({
  success(result) {
    // result.errMsg === 'selectDatazoneFile:ok'
    result.fileList.forEach((f) => {
      const { fileId, url } = f
      // ...
    })
  },
  fail(result) {
    // result.errMsg：失败详情
  },
  complete(result) {
    // 无论成功还是失败都会回调
  }
})

参数

success 回调入参

fail / complete 回调入参

错误码

通用错误码参见 全局错误码。

兼容性

应用权限

相关接口

• 数据与智能专区文档选择：选择微盘 doc 文档（同能力域兄弟接口）
• ww.register：注册应用身份

旧版 jweixin 兼容

仅供使用 jweixin-1.2.0.js 旧 SDK 的存量项目参考。新项目请使用上方调用方式。

示例代码

wx.invoke('selectDatazoneFile', {
}, function(res) {
  if (res.err_msg === 'selectDatazoneFile:ok') {
    var fileList = res.fileList
    for (var i = 0; i < fileList.length; i++) {
      var fileId = fileList[i].fileId
      var url = fileList[i].url
    }
  } else if (res.err_msg === 'selectDatazoneFile:cancel') {
    // 用户取消
  } else {
    // 失败
  }
})