队列管理

监控发送状态、排查错误并管理邮件队列。

队列管理 用于监控 PDF 生成和邮件发送任务的进度。它提供从整体配置文件状态到单个邮件项目的详细视图。

概述

队列管理系统分为四个层级，帮助您逐级深入排查问题：

  1. 配置文件列表：所有配置文件及其近期活动的概览。
  2. 批次列表：特定配置文件的导入历史（文件）。
  3. 队列列表：批次中的各个项目（收件人）。
  4. 项目详情：单个项目的详细数据和状态。

1. 配置文件列表（概览）

主视图为每个已配置的 配置文件 显示一张卡片。

  • 统计：每张卡片展示过去 30 天内项目的状态。
    • 错误：失败的项目（PDF 生成、发送或导入）。
    • 待处理：等待处理的项目（PDF 生成）。
    • PDF 已生成：PDF 已生成，等待发送的项目。

操作： 点击配置文件卡片（或 编辑 图标）查看其 批次列表。

2. 批次列表（历史记录）

此列表显示为所选配置文件导入的所有文件。

  • 批次名称：对应导入 CSV 的 文件名。
  • 导入日期：用于区分同一文件的多次导入。
  • 状态列：
    • 总计：批次中的项目总数。
    • 错误：失败总数。
    • 待处理：等待 PDF 生成。
    • PDF 已生成：PDF 已生成，等待邮件发送。
    • 已发送：发送成功。

操作： 点击特定批次行的 编辑 图标查看其 队列列表。

3. 队列列表（项目）

此视图列出所选批次中的每个收件人。

功能

  • 搜索：可按收件人（To）、状态、错误消息或数据内容（JSON）搜索。
  • 筛选：使用下拉菜单仅显示特定状态（例如仅显示"错误"）。
  • 删除批次：删除批次 按钮可删除整个批次历史。

状态定义

状态内部值说明
待处理pending等待系统生成 PDF。
PDF 已生成pdf_generatedPDF 已成功创建，等待发送。
已发送sent邮件已成功投递到 SMTP 服务器。
错误（导入）error_import此项目的数据导入失败。
错误（PDF）error_pdfPDF 生成失败。
错误（邮件）error_email邮件发送失败（可重试）。
错误（邮件-致命）error_email_fatal邮件发送永久失败（例如无效地址）。

常见错误消息

以下错误可能出现在 错误消息 列或批次的 错误列表 中：

邮件发送错误

  • MISSING_TO_RECIPIENT："To"地址为空。请检查映射配置。
  • INVALID_EMAIL_FORMAT：邮件地址格式无效。
  • BACKEND_CONNECTION_FAILED：无法连接到 SMTP 服务器。请检查网络连接或 VPN。
  • SMTP_AUTH_ERROR：SMTP 认证失败。请检查用户名和密码。
  • RETRY_LIMIT_REACHED_SKIP：达到最大重试次数后跳过此项目。
  • RETRY_LIMIT_REACHED_ABORT：达到最大重试次数后中止批次。

导入与处理错误

  • TEMPLATE_FILE_NOT_FOUND：工作区中找不到配置的 PDF 模板文件。
  • MISSING_MASTER_LOOKUP_VALUE：项目缺少查找键的值（例如客户 ID 为空），无法检索收件人数据。
  • CSV_DATA_EMPTY_OR_UNREADABLE：导入的 CSV 文件为空或已损坏。

4. 项目详情（编辑与重试）

点击项目的 编辑 图标可以修改数据或重试失败的流程。

修改数据

如果邮件地址（To、CC、BCC）导入有误，可以在此处修正。

修改状态（重试）

保存时状态不会自动改变。您需要手动选择适当的状态以触发重试：

  • 待处理：选择此状态以丢弃当前 PDF 并重新生成（例如修正 JSON 数据后）。
  • PDF 已生成：选择此状态以重试发送 现有 PDF（例如修正邮件地址后）。

编辑 JSON

您可以直接编辑 文档内容数据 和 收件人数据。