执行动作是连接器的重要功能之一。执行动作一般由API和其对应的出入参数构成,它能够携带输入参,调用具有业务逻辑的API,将业务处理结果通过输出参返回。执行动作能够作为连接流的执行节点,在流程运行到该节点时,完成特定的业务处理。连接流也因此具备了便捷的流程编排能力及集成自动化能力。
前提条件
已经完成连接器的创建,请参见创建连接器。
操作步骤
-
在已创建的连接器详情页面,然后选择。
-
在创建执行动作页中,配置执行动作信息。
-
在基础信息页签中,设置执行动作的基本信息,然后单击下一步。
重要如果接口路径是动态的,可以使用{{变量}}来指定动态路径变量。例如:https://demo.api.com/{{userId}}/info,其中
userId是动态用户ID。配置项
描述
示例
名称
设置执行动作的名称。
升级服务实例。
描述
填写执行动作的描述。
升级服务实例到指定版本。
接口路径
选择HTTP/HTTPS接口,方法支持GET/POST、填写接口URL地址。
https://computenest.console.aliyun.com/si-xxxxxxx/update
-
在入参配置页签中,设置执行动作API入参信息,然后单击下一步。
配置项
描述
HTTP请求头
API请求的Header信息。
HTTP请求体
API请求的Body信息。
URL查询参数
API请求的Query信息。
URL路径参数
无需填写,会自动解析接口路径上的满足
{{xxx}}的动态参数。字段key
接口入参的key。
字段名称
接口入参对外展示的名称。
字段类型
string(字符串类型)、number(数值类型)、boolean(布尔类型)、array(数组类型)、object(对象类型)。
导入json
如果已经有测试入参数据,可以通过测试数据快速导入进来。
例如,在HTTP请求体页签中添加如下入参字段:root(object 类型)作为根节点,其下包含 serviceId(string 类型,必填,描述为服务Id)和 template(object 类型,必填)两个子字段;template 下再添加 title(string 类型,模版名称)和 content(string 类型,模版内容)子字段。
-
在出参配置页签中,设置执行动作返回结果信息。例如,在响应体页签中配置如下出参字段:root(object 类型)作为根节点,其下包含 code(number 类型,错误码,描述为200:成功)、message(string 类型,错误消息,描述为ok)和 data(string 类型,返回对象)三个子字段。
-
单击保存草稿或发布。
-
FAQ
执行动作是否支持xml格式的参数?
不支持,当前对象参数仅支持JSON格式参数。
如果参数是string类型,应如何配置?
详细配置如下。在入参配置的HTTP请求体页签中,将 root 节点的字段类型直接设置为 string,并填写对应的字段名称和字段描述即可。例如,字段key为 root,字段名称和字段描述均设置为姓名。