所有套件Growth、Professional、Enterprise 或 Enterprise Plus

注意:操作生成器目前处于早期试用计划 (EAP) 阶段。您可以在此处注册 EAP。

操作工作流程 是用户定义的自动工作流程。每个操作流程都包含一个操作流程触发器和一个或多个操作,该触发器可启动工作流程。

您可以使用 预定义的操作工作流程触发器,或者管理员可以定义自定义操作工作流程触发器。本文章介绍了如何创建自定义操作工作流程触发器以侦听来自特定外部系统的 HTTP 请求。

创建操作流程触发器后,您可以在任何操作流程中使用它。请参阅 创建操作流程。

创建自定义操作工作流程触发器

操作流程触发器是在操作生成器中创建和管理的。

创建自定义操作工作流程触发器

  1. 在 管理中心,单击 应用和整合 ,然后选择 操作 > 操作流程。
  2. 创建 或 编辑 操作工作流程。
  3. 单击 + 添加触发器。
  4. 在步骤侧栏中的 自定义触发器下,单击 创建触发器。
  5. 为操作工作流程触发器输入一个唯一且可识别的 名称 。

    最大长度为 255 个字符。

  6. (可选)输入您希望触发器接收的 HTTP 请求的 有效载荷示例 。

    这应该是一个带有有效 JSON 正文的 POST 请求。有效负载不能超过 200KB。

    示例有效负载必须包含所有属性和适当的数据类型,供您稍后在以此触发器开头的操作流程中使用。

  7. 单击下一步。
  8. 如果您提供了有效载荷示例,请映射数据,方法是单击 添加 下一个您要在操作工作流程中捕获为输出的每个键值对,然后单击 下一步。

    如有必要,您可以使用选项菜单编辑键值对的名称和类型,或将其从触发器中移除。输出名称在触发器中必须是唯一的,并且不能超过 255 个字符。

    支持将以下数据类型用作自定义触发器的输出:

    • 文本
    • 数字
    • 小数
    • True/false
    • 日期(YYYY-MM-DD)
    • 日期和时间(YYYY-MM-DDTHH:MM:SS[.sss]Z 或 YYYY-MM-DDTHH:MM:SS[.sss]+/-hh:mm)
    • 数组和对象将转换为字符串。
  9. 使用为触发器生成的自定义 Webhook URL 在外部系统中配置 Webhook,该系统将发送请求到自定义触发器以启动操作工作流程。

    此外,如果可以的话,请将外部系统的重试策略配置为使用带抖动的指数回退,分别在速率受限的请求后 20 秒、120 秒和 300 秒重试 3 次。

    注意:

    • 将自定义操作工作流程触发器的 Webhook URL 视为密钥,请勿共享。
    • 对 Webhook URL 实施您帐户的 IP 限制 。
  10. 将自定义操作工作流程触发器添加到操作工作流程。请参阅 创建操作流程。

使用自定义操作工作流程触发器的输出

您要从操作工作流程触发器输出的所有数据都必须分配正确的数据类型。这是根据示例有效负载自动设置的,但您可以根据需要进行修改。如果接收到的数据与预期有效负载不同,操作流程将尝试使用以下规则转换数据:

  • 文本输出:
    • 任何数字、小数、true/false、日期或日期时间值都将转换为文本。
    • 如果请求正文中缺少该键,则表示为 null。
  • 数字输出:
    • 小数值舍入为最接近的整数,0.5 的值向上舍入。
    • 对于 true/false 值,true 将转换为 1,false 将转换为 0。
    • 表示数字的字符串将转换为整数。
    • 表示小数的字符串将舍入为最接近的整数。
    • 所有其他字符串都将转换为 nil。
    • 如果请求正文中缺少此键,则表示为 nil。
  • 小数输出:
    • 数字值将不加修改地传递。
    • 对于 true/false 值,true 将转换为 1,false 将转换为 0。
    • 表示数字的字符串将转换为小数。
    • 表示小数的字符串将转换为小数。
    • 所有其他字符串都将转换为 nil。
    • 如果请求正文中缺少此键,则表示为 nil。
  • True/false 输出:
    • Null 值将转为 false。
    • 数字和小数值零(0、-0、0.0、-0.0)将转换为 false。
    • 空字符串(""、"''" 和 "``")将转换为 false。
    • 所有其他数字、小数、字符串、日期和日期时间值都将转换为 true。
    • 如果请求正文中缺少此键,则表示为 nil。

翻译免责声明:本文章使用自动翻译软件翻译,以便您了解基本内容。 我们已采取合理措施提供准确翻译,但不保证翻译准确性

如对翻译准确性有任何疑问,请以文章的英语版本为准。

由 Zendesk 提供技术支持