使用Office Script从Dataverse表导入图片至Excel遇脚本报错

核心问题分析 #

你的脚本保存报错，大概率是参数类型不匹配或者Dataverse图片的格式处理逻辑缺失，以下是具体排查点：

1. 参数类型错误 #

addImage方法要求传入的是Base64编码的图片字符串（带格式前缀，如data:image/png;base64,xxxx）或者可访问的图片URL，但Dataverse图片附件列返回的是二进制原始数据，直接传递会导致addImage无法解析：

• 你的脚本参数Image_2定义为string，如果实际传入的是二进制数据而非符合要求的字符串，保存时会触发类型校验错误。

2. 脚本环境与语法校验 #

• 确认脚本是在Excel网页版中编写：Office Script仅支持网页版环境，桌面版保存会直接报错。
• 检查参数名称Image_2的大小写、拼写：脚本参数定义需和后续Power Automate传递的参数完全一致，否则会触发参数不匹配的保存错误。

3. 修正后的参考脚本 #

如果要接收Dataverse转换后的Base64图片数据，脚本需要增加格式校验逻辑，示例如下：

function main(workbook: ExcelScript.Workbook, Image_2: string) {
    let selectedSheet = workbook.getActiveWorksheet();
    // 校验传入的是否为标准带前缀的Base64图片字符串
    if (Image_2.startsWith('data:image/')) {
        let picture_1 = selectedSheet.addImage(Image_2);
        picture_1.setTop(372);
        picture_1.setLeft(372.75);
    } else {
        console.error("传入的图片格式错误，需为带格式前缀的Base64字符串");
    }
}

4. Power Automate前置处理要求 #

在调用脚本前，必须先对Dataverse图片做格式转换：

• 使用"获取附件内容"动作提取Dataverse图片的二进制数据。
• 通过"转换数据"动作将二进制数据转为Base64字符串，并添加对应图片格式的前缀（如data:image/png;base64,），再传递给脚本的Image_2参数。

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