注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
Automate应用程序允许您在满足条件时自动向其他平台用户发送通知。
通知可以通过两种方式发送:直接在平台中发送和通过电子邮件发送。内容可以通过函数静态定义或动态确定。通知也可以包含PDF附件。本页面包含有关通知接收者、内容和附件的选项的信息。
当使用暴露受影响对象的条件时,可以选择一个对象分组来定义这些对象在发送通知之前应如何分组。
暴露受影响对象的条件包括:
当多个对象同时触发条件时,每个接收者只会收到一条通知。
在下面的截图示例中,三个不同的Support Ticket
对象触发了自动化,并发送了一条通知。函数支持的通知可以访问包含所有三个对象的对象集。
当多个对象同时触发条件时,对象将按一组选定的属性进行分组。每个组的每个接收者将收到一条通知。
请注意,分组基于属性值的精确匹配。对于数组类型属性,值必须是精确的、按顺序匹配才能被分组在一起。
在下面的示例中,三个不同的Support Ticket
对象同时触发了自动化。两个对象属于Billing类别,一个属于Technical Support。
当多个对象同时触发条件时,每个对象将发送一条通知。
例如,如果三个Support ticket
对象触发了自动化,则每个Support ticket
都将发送一条单独的通知。函数支持的通知可以访问单个对象及其属性值。
在配置通知时,您必须首先定义谁应该接收通知。接收者可以是Foundry用户或组,可以在静态接收者列表中定义,也可以通过对象属性动态定义。
由自动化发送通知的接收者至少需要具有只读权限。这对于静态和动态接收者都是必需的。
定义通知接收者的第一种选择是通过Static提供这些接收者作为静态列表。要定义列表,请单击关联的文本字段并选择希望成为接收者的用户或组。
第二种选择是通过受影响对象的对象属性动态定义通知接收者。此配置选项需要一个暴露效果输入的对象集条件。
动态接收者定义允许您指定包含用户ID或组ID的对象属性,以在运行时确定通知接收者。因此,对象属性类型必须是字符串
或字符串数组
。
在下面显示的示例中,我们在Contract
对象类型上定义了一个对象修改条件。然后,我们可以使用Contract Owners
属性,其中包含用户ID的数组,以定义通知接收者集。
有两种方式定义通知的内容:作为普通通知或作为函数生成的通知。
通知将为每个接收者单独渲染。因此,生成的内容可能会因用户而异。
普通通知提供界面组件以直接指定通知内容。您必须提供一个标题和消息。非必填项,您还可以修改URL链接。默认情况下,URL链接是指向仅在电子邮件中显示的平台内通知的链接。
您还可以使用高级电子邮件配置来配置电子邮件的不同值。默认情况下,您上面为平台内通知提供的标题、消息和URL链接值将被使用。如果需要,可以在高级电子邮件配置中使用HTML。
您所做的所有更改将在配置组件的右侧实时预览。
最后,您可以为通知定义一个附件。
作为使用普通通知的替代方案,您可以通过一个函数动态生成通知内容来支持您的通知。这应仅用于普通通知无法满足的通知需求。
要创建自定义通知函数,请按照函数文档中的说明进行操作。函数必须返回Notification
或Notification | undefined
。当返回undefined
时,Automate将跳过通知。这可以在函数逻辑中用于有条件地决定是否发送通知。
在您编写并发布通知函数后,可以在通知效果中使用它。首先选择您的函数和版本。然后,界面将更新以根据函数定义暴露所需的输入。
根据输入参数的类型,您可能能够使用特殊效果输入而不仅仅是提供静态值。支持的效果输入包括:
用户
类型的函数输入,并将渲染通知的接收者传递到函数中。下面的示例显示了如何使用接收者
输入和合同修改
条件效果输入来创建一个针对接收者和触发自动化的相应对象量身定制的自定义通知。
您可以配置通知效果,以在通知电子邮件中包含来自记事本文档或记事本模板文档的PDF附件。PDF将在运行时为每个接收者自动生成。
在附件部分选择**+ 选择**并选择一个记事本文档或记事本模板。然后,指定附件的文件名。根据所选资源类型,您可能需要提供更多值,如以下部分所述。
记事本模板可用于在执行通知效果时动态生成并以PDF格式导出记事本文档。这是通过记事本模板输入完成的。记事本模板输入可用于在生成步骤中将值传递到记事本文档中。有关记事本模板功能的更多信息,请参阅模板文档。
选择记事本模板和模板版本后,将显示所需的模板输入。Automate应用程序支持将静态值和条件效果输入传递给记事本模板输入。如果模板暴露了一个对象或对象集模板输入,并且条件暴露了同类型的条件效果输入,则可以将条件效果输入传递到模板中。
记事本模板不暴露对象或对象集模板输入的对象类型信息。您必须亲自确保提供的对象值类型匹配。
下图显示了一个示例,其中记事本模板Support tickets overview
被附加到通知效果中。模板输入support tickets
连接到由对象添加到集合
条件暴露的New Support Tickets
条件输入。因此,每当条件触发时,触发条件的对象将被用于从模板生成文档的PDF。