从订单或客户元字段中附加文件
许多应用会在订单或客户信息中保存文件：例如来自开票应用的发票或装箱单 PDF、证书、已签署的合同等。Shopify 会将其存储在元字段中，形式可以是存储在您的 Shopify Files 中的文件，也可以是该文件的链接。 该应用可将该文件作为附件添加到 Shopify Flow 工作流程发送的电子邮件中，而无需您手动上传或添加链接。
工作原理
- 另一个应用（或您）将文件（或其链接）写入订单或客户的元字段中。在您的 Shopify 管理后台中，路径为**“设置 > 自定义数据 > 订单**（或客户）”：这里可以定义为“文件”或“URL”类型，也可以是一个文本字段，供应用将链接写入其中。
- 在电子邮件布局中，您添加附件并选择**“元字段”**作为其来源，然后选择该定义。选择器会显示每个元字段包含的内容：文件、链接，或者两者的列表。
- 在Shopify Flow中，“发送事务性电子邮件”或**“发送营销电子邮件**”步骤包含**“订单**”字段和**“客户**”字段。Shopify Flow 会根据触发器自动填充这些字段，因此由_“订单创建_”触发的工作流程已知具体是哪一笔订单。
- 当电子邮件发送时，该应用会读取该订单或客户对应的元字段，下载文件（从您的 Shopify 文件中，或通过链接），并将其作为附件添加。列表元字段会将每个条目作为附件添加。
该布局仅命名了元字段。工作流程会指定是哪一笔订单或哪位客户，因此一个布局即可适用于所有订单。
文件和链接
| 该元字段包含 | 定义类型 | 该应用的功能 |
|---|---|---|
| 一个Shopify文件 | 文件、文件列表 | 根据您“文件”中的文件路径定位该文件并将其下载 |
| 一个链接 | URL、URL 列表或文本输入框 | 从该链接下载文件。仅支持 https:// 格式的链接；如果链接无法响应，或指向的文件类型不是 PDF、图片、CSV 或文本文件，则发送失败，原因如下： |
无论哪种情况，大小检查都是在发送邮件时进行的，而不是在编辑器中进行的，因此元字段附件不会计入编辑器中的附件总数。
设置好它
富文本和HTML布局
在编辑器底部的**“附件**”卡片中，点击**“从元字段添加**”。选择**“订单**”或**“客户**”，然后选择相应的定义。该行会显示定义的名称、其包含的内容及其namespace.key；点击“更改”可选择另一个定义。
视觉布局
添加一个**“附件**”块（或打开一个），并将它的数据源切换为**“元字段”**。**选择“元字段”**会打开相同的选择器。
权限
安装该应用时，它不会访问您的商店数据。当您首次选择订单或客户元字段时，选择器会请求读取该资源的元字段及其所指向文件的权限。Shopify 会显示其自身的同意对话框；点击“更新”后，定义列表即会加载。
您可以在应用的**“权限**”页面上随时查看并撤销每项权限。撤销某项权限后，所有附带来自该元字段文件的电子邮件都将无法发送，直到该权限再次被授予为止。各项权限的具体内容及其不包含的内容，请参阅 权限：该应用可以从您的商店读取哪些信息。
文件名
默认情况下，附件会保留文件本身的名称：即您在Shopify文件中的名称，或链接的最后一部分。 “文件名”字段会覆盖该名称，并支持Liquid语法，例如 invoice-{{ variables.order_name }}.pdf。当列表元字段包含多个条目时，从第二个条目开始，会在覆盖的名称后附加 -2、-3。
当元字段为空时
写入文件的应用程序通常会在触发器触发后几秒钟才运行，因此当电子邮件步骤运行时，元字段可能仍然为空。此时的情况取决于附件的**“可选**”复选框：
| 可选 | 行为 |
|---|---|
| 关闭（默认） | 该电子邮件尚未发送。应用程序会指示 Shopify Flow 重试该步骤，Shopify Flow 稍后会重新发送；文件一到位，电子邮件就会立即发出。 |
| 关于 | 该电子邮件未附带此附件。 |
对于必须包含该项的发票，请保持该选项关闭；对于仅部分订单包含该项的文件，请开启该选项。
要求与限制
- “Shopify Flow”步骤需要设置**“订单**”或**“客户**”字段。在此版本发布之前添加的步骤尚不包含这些字段：请在Shopify Flow编辑器中删除该步骤，然后重新添加。
- 每个文件大小不超过 10 MB；支持 PDF、图片、CSV、纯文本和日历文件。视频和 3D 模型将被跳过。
- 链接必须以
https://开头，且无需登录即可访问。若链接重定向至非 https 地址或私有网络，则不予接受。 - **过去 60 天内的订单。**Shopify 仅允许应用读取最近的订单。若对较早的订单执行工作流程，发送操作将失败并显示明确的错误信息。
- Microsoft 365 会拒绝总附件大小超过 4 MB 的邮件；请参阅 附件和图片。
你在“历史”中看到的内容
所有结果都会显示在“历史记录”页面上。没有订单的步骤、被撤销的授权、Shopify 无法找到的订单、无法响应的链接，或超过限制的文件，都会被记录为**“失败**”，并附带原因及应修改的内容。 “可选”选项关闭的空元字段不视为失败：Shopify Flow 会显示重试记录，且一旦文件就位，发送操作即会显示。从“历史记录”中选择**“重新发送**”将再次读取同一订单或客户信息。
试一试
在布局编辑器中发送测试邮件时，系统没有订单或客户可供读取，因此发送时不会附带元字段附件。若要测试附件，请在 Shopify Flow 中针对已包含该文件的订单运行工作流程，或使用“在 Shopify Flow 上运行”测试功能并选择此类订单进行测试。
相关
- 权限：该应用可以从您的商店读取哪些信息 - 可选权限的具体内容，以及如何撤销这些权限。
- 附件和图片 - 上传的附件、附件模式与链接模式以及文件大小。
- 从Shopify Flow传递数据 - 步骤字段和变量。
- 历史与故障排除 - 读取发送失败的消息。