用例开发WorkshopEvent-trigger & navigational widgets评论

注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

评论

评论微件支持在Workshop模块中进行协作。

引用

您可以在评论中使用引用来提及对象。引用是互动的,选择一个引用可以在工具提示中显示所提及对象的属性,或者在模块中触发一个事件,例如打开一个模态窗口或显示对象视图

请参见下方的配置和使用评论微件中引用的示例:

配置用法
可以在评论微件配置中配置引用。引用配置允许以简单的方式引用给定对象集中的对象。使用@符号在评论中包含引用。当您开始输入时,可能的引用将显示在弹出窗口中。

权限

评论不是独立的对象,它们直接附加在父对象上。它们不会显示在对象浏览器中,只能通过评论微件显示。要使评论在Ontology中可搜索,请参阅下面的部分

评论遵循父对象的权限,因此如果您可以访问该对象,则可以查看并在其下发布新评论。这意味着受限视图会自动支持。您也可以删除您自己的评论,如果您不小心发布了某些内容。

关于细粒度权限的说明

让我们通过一个医疗实践的例子来探讨更细粒度的权限。医疗实践可以为patient对象配置列级权限,以便只有管理员可见基本字段,医生可以查看基本字段和任何敏感字段。为了防止管理员查看医生在敏感字段上留下的评论,实践会创建一个名为PatientSensitiveComments的单独代理对象。这样,他们可以在其模块中拥有两个评论线程,一个评论线程直接在patient对象上,管理员和医生都可见,另一个评论线程在代理对象PatientSensitiveComments上,只有医生可见。

(高级)使评论在Ontology中可搜索

您可以通过启用操作日志来保存Ontology中的评论历史记录。为此,打开评论后的操作并导航到Ontology以配置诸如评论文本父对象当前用户等字段。或者,您可以选择在Ontology中进行更复杂的评论镜像,通过创建一个专门的对象类型来存储评论,这可以允许镜像评论的删除,而操作日志仅为追加。

在将评论文本添加到操作日志之前,有几件事情需要考虑:

  • 如果父对象配置为受限视图,并且行级权限引用可以更改的字段,则应谨慎,因为操作日志仅为追加。例如,如果工单有一个名为Sensitivity level的字段,其值从Public更改为Legal only,则已经存储在操作日志中的评论仍将包含先前的值Public。为了确保您复制到Ontology层的评论遵循父对象的权限,您应该创建一个专用的Ticket Comment对象,并配置一个操作,以更改工单的Sensitivity level,同时更新存储在Ticket Comment对象中的评论的Sensitivity level
  • 操作日志不会像评论微件那样显示评论的富文本。

通知

在对象上评论后,您将自动订阅以接收当其他用户在该对象上发表评论时的通知。在评论中提及用户也会向他们发送通知,并订阅他们接收该对象的未来评论通知。通知以电子邮件形式发送给用户,并显示在Foundry中的通知收件箱中。

通知应被视为工作流程的增强功能,而不应是通知用户有待处理操作的唯一方式。用户应能在您的Workshop应用程序中看到指派给他们的任务,在收件箱视图中查看。

默认通知

评论微件默认启用通知。默认通知包含一个链接,指向留下评论的对象的对象视图。为了确保用户点击链接时可以看到评论,您应该配置对象视图由Workshop模块支持并包含评论微件。要自定义通知文本或包含指向Workshop应用程序的链接,请遵循自定义通知的说明。

自定义通知

要发送自定义通知,您可以禁用“发送默认通知”,并配置一个“评论后的操作”,该操作具有通知副作用,参阅操作通知文档以获取更多信息。评论微件提供了可以传递给操作的特殊值,如通知用户评论文本。这些允许您轻松构建自定义通知。要包含指向您Workshop应用程序中特定位置的链接,您可以配置一个模块接口变量。以下示例展示了如何配置自定义通知:

  1. 在Ontology中设置一个操作,并包含以下字段

    可以添加诸如评论文本或通知用户之类的字段。
  2. 然后将通知副作用添加到操作规则中

    在Ontology应用中,您可以为操作添加通知副作用。
  3. 配置要发送的通知 通知配置允许您使用评论微件提供的特殊值,如“通知用户”和评论文本

  4. 在评论微件中配置操作以传递通知用户评论文本

    评论微件配置允许您将评论文本和通知用户传递给您在Ontology应用中配置的操作

附件

您可以上传附件,如文件和图片,既可以上传到父对象下,也可以直接上传到评论下。在评论下上传的附件仅在评论微件中可见,最适合用于草稿文件和迭代。我们建议只上传小附件,对于较大的附件,您会注意到较长的上传时间,并且有200MB的限制。我们建议将较大的附件直接上传到父对象上。

操作日志

评论微件可以在一个统一的动态中显示相关对象上的评论和操作。在这里了解更多关于操作日志的信息。

评论微件在一个统一动态中显示评论和操作。

常见问题

当某个操作发生时,我可以自动创建评论吗?

评论微件允许您在一个共同的动态中显示操作日志条目和评论,因此自动“评论”应表示为操作日志条目。

我可以通过Workshop的评论微件在对象浏览器中显示来自评论助手的评论吗?

来自对象浏览器中的评论助手的评论无法在Workshop的评论微件中显示或重用。