核心概念

在使用 Recipes 之前，我们建议了解定义在 Foundry 中创建和使用 recipes 的核心概念：过期、运行历史记录和权限。

过期

Recipes 需要计算资源来持续运行。为了确保未使用的 recipes 不占用资源，我们要求 recipes 过期。当 recipes 过期时，它们不会被删除。过期的 recipes 只是不会继续监控感兴趣的条件，这意味着所有该 recipe 的通知接收者将不再收到通知。在设置 recipe 过期之前，作者会在某些间隔时间内收到通知，并可以随时选择延长过期时间以继续运行。如果他们忘记这样做并且 recipe 过期了，他们仍然可以选择恢复并延长 recipe。

了解更多关于更改 recipe 过期时间。

运行历史记录

根据您的计划，您的 recipe 将按时间表（例如，每 3 小时或每周一上午 9 点）或事件驱动的时间表（当数据集更新或检测到新对象时）运行。

每次 recipe 运行时，其运行历史记录将记录以下运行状态之一：

• 带有例外的成功: recipe 运行成功并通知了所有有资源访问权限且未静音该 recipe 的接收者。如果有些接收者没有资源访问权限并且没有收到通知，这种状态可能会发生。在报告 recipe 的情况下，如果导出报告对于某些接收者失败并且他们收到链接而不是报告，也可能会出现带有例外的成功。了解更多关于 recipe 权限和安全性的内容如下。
• 成功: recipe 运行成功并通知了所有未静音该 recipe 的人。
• 跳过: recipe 成功触发但未发送任何通知。这可能是因为所有接收者都已静音该 recipe 或者它检查的条件不等于 true。
• 失败: recipe 未成功运行，在运行时遇到错误。可以通过展开该运行的 recipe 历史记录查看更多关于此错误的详细信息。

作者会收到失败和带有例外的成功的通知。了解更多关于配置您的通知偏好。

隐私、权限和共享

Recipes 继承其监控资源的权限。这意味着任何可以查看资源的人都可以查看 recipe，任何拥有资源的人都可以编辑 recipe，等等。

尽管 recipes 可以通过电子邮件向其他用户发送数据，权限确保只有有数据访问权限的用户才能在邮件中实际接收到该数据。

权限摘要

定义

• 作者/所有者: 创建 recipe 的用户。
• 接收者: 触发的 recipe 的邮件/通知的接收者。
• 监控资源: recipe 监控的实际文件（数据集、报告、Quiver 分析等）。

下表显示了用户在 Recipes 中执行某些操作所需的权限：

如果接收者没有报告的访问权限，他们仍然会收到通知。但是，他们会收到一个指向报告的链接，链接会指引他们请求访问权限。