注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
可以通过 添加新规则 下拉菜单将通知添加到操作中。了解有关如何添加通知的更多信息。
配置通知需要指定 收件人 和 内容。以下部分提供了这些选项的详细信息。
配置通知的 收件人 选项可以让您指定在操作运行时将收到通知的一组 Foundry 用户。通知将分别发送给每个收件人。添加用户作为电子邮件通知的抄送收件人是不支持的。
有几种支持的指定收件人的方式:
静态: 在配置中,您可以选择一组用户或组,这些用户或组将在操作运行时始终收到通知。
来自参数: 如果操作的一个参数是 Foundry 用户或组 ID,您可以将其指定为通知的收件人。
来自对象参数的属性: 如果操作有一个对象参数,并且该对象的一个属性包含一个 Foundry 用户或组 ID,您可以将该参数的属性指定为收件人。这对于包含 Foundry 用户和组 ID 的列表也是可能的。
来自函数: 如果您的应用案例不包括在上述选项中,您可以编写一个自定义函数,该函数接收操作参数并返回应通知的用户或组列表。了解有关如何编写返回用户或组列表的函数的更多信息。
基于函数的收件人应用案例示例包括:
指派人
,并始终通知一组静态的附加收件人。收件人可以更改他们的通知传递偏好。例如,一个用户可能选择只在其网页浏览器中接收通知,而另一个用户可能选择同时接收平台内弹窗和电子邮件通知。如果用户在个人偏好中关闭了操作通知,他们将不会被通知。但是,他们仍然可以在登录 Foundry 后通过转到“通知”然后点击“查看全部”来查看他们的通知。
有多种选项可用于自定义通知内容。内容可以通过 模板 配置或通过自定义 函数 提供。选择模板内容将允许您直接在配置对话框中配置完整内容。函数内容将要求您拥有一个已发布的函数,该函数返回相应的通知类型。
主题: 通常,内容将包括主题行。默认情况下,这对所有传递机制都是相同的。
正文: 通知的正文。对于平台内通知,这将显示在通知弹窗内。对于电子邮件,这将显示在电子邮件正文内。
链接: 您可以指定一个链接。该链接将显示为通知正文下方的一个按钮。按钮的文本可以自定义。
高级电子邮件配置: 在配置通知时,您可以指定一个自定义内容正文用于通过电子邮件传递通知。此选项允许您使用 HTML 进行更高级的格式化,这在平台内通知中是不支持的。预览将向您显示通知的外观,不包括任何参数引用。只有在收件人设置了通过电子邮件接收通知的偏好时,他们才会收到此内容。
可以在上述提到的主题、正文和链接中使用三重花括号来引用参数和用户属性。编辑某个部分时,点击一个可用参数将自动生成该参数或用户属性的正确花括号引用。
通知
对象,指定您自定义内容的每个部分。如果符合以下任何一项,您可能需要使用函数:
更多关于通知返回类型的信息可以在 函数文档 中找到。
用于生成通知内容的任何 Ontology 数据将反映在应用当前操作的编辑之前的 Ontology 状态。为了使通知收件人能够访问特定对象的最新状态,可以在通知中嵌入通过对象参数引用的对象链接,或嵌入新创建对象的链接(如果这些对象是通过“创建对象”规则而不是通过函数创建的)。
这是一个通知的示例配置。
通知
对象的函数)。{{{}}}
语法来引用该参数。请注意,这些最大内容长度将在通知渲染时进行验证和截断。这意味着如果渲染的内容是动态的(例如,如果通知内容包含对象数据),任何超过允许的最大长度的内容将被截断,并以尾随 ...
表示。
如果您的 Foundry 实例启用了“严格编辑”或“组编辑”出站电子邮件通知,自定义通知内容将不会被渲染。相反,用户将收到如下所示的通用消息。选择“查看”将引导他们进入 Foundry,在那里他们可以查看完整的通知内容。了解有关 Foundry 中电子邮件内容编辑的更多信息。
链接时必须引用新对象的主键,因为在通知渲染时不会生成对象 RID。
示例: 您有一个创建新 task
对象的操作,并将在创建任务时生成一个唯一 ID。在操作通知中,您可以使用 对象资源管理器提供的参数选项 渲染一个链接到新创建对象的链接。
https://<your-foundry-instance>.com/workspace/module/view/latest/<module-rid>
/module/view/latest/<module-rid>