动作状态
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状态下的运行时错误。看到流状态重试和错误处理.