本体动作类型规则

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

规则

规则 定义了将参数转换为Ontology编辑或其他效果的操作类型的逻辑。规则主要有两种类型:一种是编辑Ontology,另一种是在Foundry中触发其他效果。

Ontology规则

一个Ontology规则更改了Ontology的特定元素。它们可以创建、修改或删除现有类型的对象和链接。要创建或删除一对多或一对一的链接,需要使用对象规则并修改对象上的外键属性。

  1. 创建对象: 被用于创建预定义类型的对象。对象类型的主键是必填属性,必须填写。可以非必填地添加其他属性。
  2. 修改对象: 被用于修改通过对象引用参数派生的现有对象的主键。这不能引用作为当前操作一部分创建的对象。
  3. 删除对象: 被用于删除通过对象引用参数派生的现有对象的主键。这不能引用作为当前操作一部分创建的对象。
  4. 创建链接: 被用于在通过对象引用参数传递的对象之间创建多对多链接。对于外键链接,需要使用修改对象规则来显式修改外键属性。
  5. 删除链接: 被用于删除在通过对象引用参数传递的对象之间的多对多链接。对于外键链接,需要使用修改对象规则来显式修改外键属性。
  6. 函数规则: 被用于引用输入源自操作参数的Ontology编辑函数。当此规则存在时,不能配置其他规则,因为仅函数代码就能够处理其他规则可以执行的所有操作。阅读更多关于函数操作类型的信息。

值和参数

在创建或修改链接和对象时,规则需要额外的值来进行操作。在修改对象时,规则还定义了哪些属性被更改。每个属性依次映射到由多个选项之一提供的值(链接上的规则只能采用对象引用参数):

  • 来自参数: 与属性类型相同的现有参数。默认情况下,添加到规则的每个新属性都会自动创建一个具有相同名称的参数,并映射以获取此参数的值。
  • 对象参数属性: 现有对象引用参数的属性。对象参数的属性类型需要与其映射的属性类型匹配。
  • 静态值: 仅存在于操作类型规则部分的静态值。在Workshop、Slate或Object视图中与操作交互时,该值不可更改。
  • 当前用户/时间: 字符串和时间戳属性也可以采用操作当前用户或提交时间的上下文值。就像静态值一样,这些值在提交操作时无法进行交互,并且无法在操作类型的其他部分使用。

创建对象和多对多链接

您还可以同时创建对象和多对多链接。虽然仅创建多对多链接需要链接两侧的对象事先存在,但您可以通过一个操作类型同时创建这两个实体。首先配置具有多对多链接的对象类型的创建对象规则。然后单击添加链接按钮,选择链接类型并配置链接。

为了创建一对多或一对一的链接类型,只需编辑对象上的外键。

无效组合

操作类型可以包含Ontology规则的组合。当定义多个规则时,操作的后端编译规则以生成每个对象的单一编辑(例如,添加对象修改对象删除对象)。例如,如果一个规则的结果将属性更新为“A”,但同一操作类型中的另一个规则将同一对象的属性更新为“B”,则最终的编辑只会将属性更新为“B”。规则的顺序会影响最终的对象编辑。因此,不支持以下对象编辑组合:

  • 对象在被添加或修改之前不能被删除。
  • 对象在被添加之前不能被修改。
  • 对象在一次表单提交中不能被创建两次。

其他规则

有两种类型的规则会触发副作用

  • 通知规则可用于发送关于操作的通知。参数可以用于自定义通知的内容和接收者。终端用户可以调整其偏好以通过平台内推送通知、电子邮件或两者接收通知。通知在所有操作编辑应用后发送,然而通知的内容将基于应用编辑前的Ontology状态生成。
  • Webhooks 使操作在应用时可以向外部系统发出请求。操作参数可以传递到Webhook中,Webhook反过来可以将参数传递到外部请求中。可以配置Webhook在应用编辑之前或之后运行。