Azure Data Factory中Web Activity发送表格格式邮件异常求助

1. 确认Lookup Activity的输出结构 #

先确保Lookup的输出是标准数组格式，示例如下：

{
    "count": 2,
    "value": [
        {
            "ID": 1,
            "Name": "Alice",
            "Age": 30
        },
        {
            "ID": 2,
            "Name": "Bob",
            "Age": 28
        }
    ]
}

核心是value字段，它是包含所有数据行的数组，后续表格转换都基于这个数组。

2. 用ADF表达式构建HTML表格 #

问题根源是表达式未被正确解析，或未将JSON数组转换为HTML结构。你需要在Web Activity的请求体中，用ADF的字符串拼接和数组迭代函数生成完整HTML表格：

示例表达式（替换为你的实际字段） #

{
    "subject": "SQL表数据报表",
    "body": "<html><body><table border='1'><tr><th>ID</th><th>姓名</th><th>年龄</th></tr>@{join(map(activity('Lookup1').output.value, (item) => concat('<tr><td>', item.ID, '</td><td>', item.Name, '</td><td>', item.Age, '</td></tr>')), '')}</table></body></html>"
}

关键注意点：

• 动态内容必须用@{}包裹，确保ADF解析表达式而非直接输出字符串
• 用map()遍历Lookup的value数组，把每一行数据转为HTML的<tr>标签
• 用join()把所有<tr>拼接成完整的表格行部分
• 手动添加表头<tr><th>...</th></tr>，对应你的数据表字段

3. 检查Web Activity配置 #

• 确保请求方法为POST（匹配你使用的邮件API，比如SendGrid或Office 365邮件API）
• 请求头设置Content-Type: application/json，避免API无法识别HTML内容
• 如果用Office 365邮件API，需将body的contentType设为HTML，示例结构：

{
    "message": {
        "subject": "SQL数据报表",
        "body": {
            "contentType": "HTML",
            "content": "<html><body><table border='1'>...</table></body></html>"
        },
        "toRecipients": [{"emailAddress": {"address": "xxx@xxx.com"}}]
    },
    "saveToSentItems": "true"
}

4. 调试验证 #

• 先测试Lookup Activity，确认output.value包含正确数据
• 用调试模式运行管道，查看Web Activity的输入是否已将表达式解析为完整HTML表格，而非保留@{...}原始字符串
• 如果输入仍显示表达式，检查语法错误（比如引号不匹配、函数拼写错误）

常见错误排查 #

• 未用@{}包裹动态内容：直接写activity('Lookup1').output.value会被当作字符串输出，必须用@{}触发ADF解析
• 数组路径错误：确认用activity('Lookup1').output.value，而非activity('Lookup1').output（后者包含count字段，不是数据数组）
• HTML标签不闭合：确保每个<tr>和<td>都有对应闭合标签，否则邮件客户端无法正确渲染表格

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