如何通过画布应用下载Dataverse中File数据类型字段的文件？

问题场景 #

在Dataverse自定义实体中新增File类型字段存储Excel、PDF格式文件，尝试通过画布应用的库（Gallery）控件、窗体（Form）控件读取字段实现下载功能时，持续触发报错Couldn't download the File（无法下载文件），无法正常获取文件。

核心原因 #

• 画布应用默认的库、窗体控件内置的文件下载逻辑，对自定义实体的独立File字段适配存在缺陷，调用接口时缺失表逻辑名、字段逻辑名等必填定位参数，直接触发下载失败
• 应用关联的连接账号/应用用户，没有对应自定义实体、File字段的读取权限，被Dataverse接口拦截
• 硬编码环境域名、字段用显示名而非逻辑名等写法错误，导致接口路径无效

可直接落地的解决步骤 #

• 第一步：先排查权限问题
  进入Power Platform管理中心，打开当前环境的安全角色配置，给画布应用使用的连接账号授予对应自定义实体的组织级读取权限，同时确认列权限配置中，你创建的File类型字段的读取权限已开启，测试环境可以直接开最高权限范围排除权限干扰。
• 第二步：弃用控件默认下载逻辑，改用显式函数调用
  不要依赖窗体、库控件自带的文件下载入口，在库项模板、窗体页中新增一个独立的下载按钮，给按钮的OnSelect属性配置如下Power Fx公式，替换参数为你自己环境的实际值即可：

  // 需替换的3个参数：
  // 1. new_mycustomtable 替换为你的自定义实体逻辑名
  // 2. Gallery1.Selected.实体唯一ID 替换为当前选中记录的主键ID值
  // 3. new_storedfile 替换为你创建的File字段的逻辑名
  Download(
      $"https://{First(Split(Param("serverrelay"),"/")).Result}/api/data/v9.2/new_mycustomtable(Gallery1.Selected.实体唯一ID)/new_storedfile/$value"
  )
  

  注意：不要用字段/实体的中文显示名替换参数，必须去解决方案资源里复制new_开头的逻辑名，否则接口会找不到对应资源；公式里的v9.2为Dataverse通用API版本，兼容所有9.x版本环境。

• 第三步：处理后缀异常问题
  如果下载后的Excel、PDF文件后缀缺失无法打开，可以在Download函数里显式指定文件名和后缀，参考写法：

  With(
      {
          fileUrl: $"https://{First(Split(Param("serverrelay"),"/")).Result}/api/data/v9.2/new_mycustomtable(Gallery1.Selected.new_mycustomtableid)/new_storedfile/$value",
          saveFileName: $"业务文件_{Text(Now(),"yyyyMMddHHmmss")}.xlsx"
      },
      Download(fileUrl, saveFileName)
  )
  

常见踩坑提醒 #

• 不要把独立File类型字段和实体自带的注释附件（Annotation）字段混淆，二者的接口调用路径完全不同，不要套用附件下载的公式
• 如果是Teams内嵌的画布应用，需要提前给应用授予Dataverse的Files.Read委托权限，否则跨域请求会被拦截直接报下载失败
• 不要硬编码环境的完整域名，用Param("serverrelay")拼接域名的写法适配开发、测试、生产多环境迁移，不会出现换环境后接口地址失效的问题

内容的提问来源于stack exchange，提问作者Rubalpreet Kaur