不同触发方式的流程入参设计方法-机器人流程自动化-阿里云

文档备案控制台

输入文档关键字查找

自动化流程的输入和输出，是与您的系统对接、集成方式的具体体现，本文重点介绍在不同情况下如何设计输入方式。

流程输入设计建议

设计流程的输入主要需要考虑如下几方面：

确定自动化流程的触发方式：客户端手动执行、定时执行、OpenAPI触发、MCP触发
确定输入给流程的信息类型，包括：
- 字符数、数字、时间等。如开始时间、结束时间；
- 批量数据，如多个需要退款的订单号。形式可能是文件（如Excel）、可能是一串能够结构化的字符串（如JSON字符串）；
- 二进制文件，如图片、视频等。

客户端手动执行

信息类型	建议使用方式
字符串、数字等	参数面板选择对应类型，便于手动执行时操作。
批量数据	如果需要使用者手动准备的数据，建议使用Excel文件，参数面板中的参数类型选择“打开文件”或“打开文件夹”。如果可通过接口从其他系统中获取，可在流程中调用该接口。
图片、视频	如果文件在机器人所在电脑主机的硬盘中，参数面板中的参数类型选择“打开文件”或“打开文件夹”。如果图片、视频可自动下载，建议以字符串形式传入下载地址。如果多条，可考虑使用Excel文件。

定时执行

信息类型	建议使用方式
字符串、数字等	参数面板的参数类型使用“文本框”类型。
批量数据	如果数据量很小，可使用“文本框”类型的参数。在配置定时执行任务时，添加到任务参数中。其他情况，如果能够通过接口等方式从其他系统中获取，建议优先在流程中调用该接口；否则只能提前将数据在机器人所在电脑主机的硬盘中准备好，机器人运行时读取。
图片、视频	建议优先考虑能够在流程中下载图片、视频等。其他情况下，只能提前将数据在机器人所在电脑主机的硬盘中准备好，机器人运行时读取。

OpenAPI触发和MCP触发

信息类型	建议使用方式
字符串、数字等	参数面板的参数类型使用“文本框”类型。
批量数据	如果数据量很小，可使用“文本框”类型的参数，内容为JSON格式字符串。其他情况，可提供给自动化流程一个能够远程访问的地址，流程下载后进行后续动作
图片、视频	建议优先考虑能够在流程中下载图片、视频等，入参内容为下载链接。多个地址可使用JSON字符串，或保存到云端后将访问地址传入。如果需要传入单张图片且文件大小很小，可考虑将图片的二进制内容读出后base64编码后，作为入参传入。

使用参数面板创建流程入参

编码开发模式或可视化开发模式中，客户端底部都提供了参数面板功能，可使用该功能创建流程入参。

目前参数类型支持文本框、密码框、下拉框、复选框、打开目录、打开文件、时间（时间选择框）、颜色（颜色选择框）、文本编辑器等类型。
定时任务、OpenAPI触发和MCP触发等几种远程触发方式，只适合使用“文本框”类型的参数。
手动执行，可根据需要选择相应的类型。
参数传入流程中后，在流程中的数据类型都是字符串类型，需要您在流程中进行对应的格式转换。

编码开发模式下使用

流程代码中可以使用 rpa.project.params["参数名称"]方式读取输入的参数值，更多用法详见 Param。

下图为读取参数内容和类型转换的例子，本例中已经定义了名为p1_str和p2_number两个参数，类型都是文本框。

可视化开发模式下使用

可视化流程中，可以使用获取工程参数面板信息读取流程的入参信息。

下图为读取参数内容和类型转换的例子，本例中已经定义了名为p1_str和p2_number两个参数，类型都是文本框，并使用字符串转为数字类型进行类型转换。

更多示例

入参内容为JSON字符串

编码开发模式。使用json.loads方法，将JSON字符串转换为dict类型。
可视化开发模式。使用自定义脚本将JSON字符串转换为字典类型（dict）

使用阿里云OSS传递数据

在使用OpenAPI或MCP调用时，可将数据先传到云端存储（如阿里云OSS），将地址信息传给自动化流程，完成后续的处理。

此种情况下，建议优先使用阿里云OSS的预生成URL功能，详见使用预签名URL方式。

上一篇：流程开发通用功能下一篇：流程的输出

该文章对您有帮助吗？