概览
此工作流使用 手动触发器,因此用户可以按需为任何选定的记录生成 PDF。 A Logic Function handles:- 从 URL(来自 PDF 生成服务)下载 PDF
- 将文件上传到 Twenty
- 创建与该记录关联的附件
先决条件
设置工作流之前:- 创建 API 密钥:前往 设置 → APIs 并创建一个新的 API 密钥。 You’ll need this token for the logic function.
- 设置 PDF 生成服务(可选):如果您想动态生成 PDF(例如报价单),可使用 Carbone、PDFMonkey 或 DocuSeal 等服务来创建 PDF 并获取下载 URL。
分步设置
步骤 1:配置触发器
- 转到 工作流 并创建一个新工作流
- 选择 手动触发器
- 选择要将 PDF 附加到的对象(例如,公司 或 商机)
Step 2: Add a Logic Function
- Add a Code action (logic function)
- 使用下面的代码创建一个新函数
- 配置输入参数
输入参数
| 参数 | 值 |
|---|---|
companyId | {{trigger.object.id}} |
If attaching to a different object (Person, Opportunity, etc.), rename the parameter accordingly (e.g.,
personId, opportunityId) and update the logic function.Logic Function Code
步骤 3:根据您的用例自定义
要附加到其他对象
将targetCompanyId 替换为相应的字段:
| 对象 | 字段名称 |
|---|---|
| 公司 | targetCompanyId |
| 人员 | targetPersonId |
| 机会 | targetOpportunityId |
| 自定义对象 | targetYourCustomObjectId |
variables.data 对象。
要使用动态 PDF URL
如果使用 PDF 生成服务,您可以:- 首先创建一个 HTTP 请求操作以生成 PDF
- Pass the returned PDF URL to the logic function as a parameter
步骤 4:测试并启用
- 保存工作流
- 导航到一条公司记录
- 单击 ⋮ 菜单并选择您的工作流
- 在记录上的 附件 部分检查并确认 PDF 已被附加
- 激活工作流
与 PDF 生成服务结合使用
用于创建动态报价单或发票:示例:生成报价单 → 附加 PDF
| 步骤 | 操作 | 目的 |
|---|---|---|
| 1 | 手动触发器(公司) | 用户在记录上发起 |
| 2 | 搜索记录 | 获取商机或行项目详情 |
| 3 | HTTP请求 | 使用记录数据调用 PDF 生成 API |
| 4 | 无服务器函数 | 下载并附加生成的 PDF |
常用的 PDF 生成服务
- Carbone - 基于模板的文档生成
- PDFMonkey - 基于模板的动态 PDF 创建
- DocuSeal - 文档自动化平台
- Documint - API 优先的文档生成
故障排除
| 问题 | 解决方案 |
|---|---|
| ”无法下载 PDF” | 检查 PDF URL 是否可访问并返回有效的 PDF |
| ”上传失败” | 验证您的 API 密钥有效且具有写入权限 |
| ”附件创建失败” | 确保对象 ID 字段名称与您的目标对象匹配 |