Action状态执行ZIS流中的任务。例如,您可以使用Action状态来转换流中的数据或进行REST API调用。

             
“TransformTicketIdToString”“类型”“行动”“ActionName”“子:常见的变换:金桥”“参数”“expr”“.ticket_event.ticket。Id | tostring"“数据。美元”“.input美元”“ResultPath”“.transformed.ticket.id美元”“下一个”“NextState”

动作类型

Action状态支持两种类型的操作:

  • 内置操作
  • 自定义动作

内置操作是针对常见任务的预定义请求。例如,您可以使用内置操作从ZIS配置加载数据或使用jq转换数据。有关更多信息,请参见ZIS内置动作

自定义操作是HTTP请求的包装器。您可以使用自定义操作来执行内置操作未涵盖的任务。例如,您可以向Zendesk API或第三方服务(如Slack或Shopify)发亚博出请求。要使用自定义操作,必须将该操作定义为ZIS包中的独立资源。有关更多信息,请参见ZIS自定义动作

支持的属性

除了公共状态属性, Action状态支持以下属性。

的名字 类型 强制性的 描述
ActionName 字符串 真正的 操作名称。对于内置操作,名称是预定义的。对于自定义操作,名称基于操作定义
参数 对象

要传递给操作的参数。对于内置操作,支持的参数是预定义的。对于自定义操作,在操作定义中定义受支持的参数。

参数值支持参考路径而且路径占位符.看到在操作参数中使用引用路径

对象数组 包含在操作状态遇到运行时错误时要运行的回退状态。看到流状态重试和错误处理

在操作参数中使用路径

使用参考路径路径占位符在一个参数属性值时,属性键必须以.$.在运行操作时,ZIS重命名属性以去掉.$后缀。

例如LoadLinks操作传递“.accountId的引用路径left_object_name参数。

             
“LoadLinks”“类型”“行动”“ActionName”“子:常见:行动:LoadLinks”“参数”“link_type”“account_to_organization_link”“left_object_name美元。”“.accountId美元”“ResultPath”“.link_results美元”“下一个”“NextState”

下面是另一个例子自定义动作使用“{{”.input.user_event.user。的路径占位符消息参数。

             
“PostNewUserMessage”“类型”“行动”“ActionName”“子:example_integration:行动:PostMessage”“参数””消息。”"为{{$.input.user_event.user.email}}创建新用户"“下一个”“NextState”

限制

  • ZIS操作状态不支持重试来自亚马逊州语言的财产任务状态.相反,ZIS对失败的流使用内置的重试逻辑。或者,您可以使用块来处理Action状态下的运行时错误。看到流状态重试和错误处理