python 活动概述
uipath.python.activities 是一个新的活动包,创建它是为了支持直接从工作流运行 python 脚本和方法。 其包含以下活动:
python 作用域(python scope) - 为 python 活动提供作用域的容器。
加载 python 脚本(load python script) - 将 python 代码转换为 pythonobject 变量。
调用 python 方法(invoke python method) - 在工作流中运行 python 脚本中的调用指定方法。
获取 python 对象(get python object) - 检索指定的 python 脚本中使用的 .net 类型。
运行 python 脚本(run python script) - 执行 python 代码或python 文件。
uipath 调用python 前置条件
1。电脑安装python 环境,python 下载地址:
python releases for windows | python.org
注意:目前官方是支持python3.11 及以下的低版本,建议安装python3.10 环境
选择对应的python 版本,本文的python 环境是3.10.11
2。电脑安装.net 5.0 ,.net 5.0 下载地址:
下载 .net 5.0 (linux、macos 和 windows)
选择应对的操作系统下载:
注意:如果电脑没有安装.net 5.0 在使用uipath 调用python 时,一直卡在python scope 作用域活动,没有反应,也没有报错,这时需注意是否有安装.net5.0 sdk
3。如果python 脚本有导入第三方类库,在uipath 调用python 前,先使用pip install 库名 安装后,再执行,否则提示 one or more errors occurred 类似错误
1.python activities 包安装
点击【管理程序包】,在对话窗口点击【所有包】,在查询输入框输入“python",找到uipath.python.activities包,选择后,点击【安装】,再点击【保存】,如下图所示:
提示安装版本选择1.7.1 最新版本。
2. python 作用域(python scope)
python 作用域 ”容器活动连接到计算机上安装的 python 环境,使您能够使用其内部的其余活动。
python scope 类似excel scope,需运行excel 文件时,需将excel 活动嵌套在excel scope 内。同样,需运行python 活动时,需求python 活动嵌套在python scope内。python scope 提供一个python 运行环境。
python scope 作用域功能:
功能:python scope 活动提供作用域并初始化指定 python 环境的容器。 当“ python 作用域 ”活动结束时,系统将删除到目前为止加载的所有 python 对象。
2.1 属性配置说明
- 库路径(linux 或版本 > 3.9)- 对于 linux,为
libpython**.so
库的路径,包括库名称。对于 windows(版本 > 3.9),为python**.dll
的路径,包括库名称。对于 windows(版本 <= 3.9),请将此字段留空。 - 路径 - python 环境安装文件夹的路径
- “目标 ” - python 运行时平台。 选择以下两个可用选项之一:x86 或 x64。
- “超时 ” - 在 python 脚本终止并引发异常之前,允许其运行的时间(以秒为单位)。
-
“版本” - 一个下拉列表,其中包含用于选择要使用的 python 版本。 默认情况下,此属性设置为 “自动”。
2.2 示例说明
如果系统是64位则选择x64 否则选择x86
路径 c:\python 是指python 的安装目录,如下图所示
库路径,python脚本>=3.10 则需设置dll路径,否则提示:
python scope: error initializing python engine 类似错误
工作文件夹:设置需要执行python 脚本的所在文件夹,可以为空
3. 加载python脚本(load python script)
load python script功能:
将 python 脚本的处理程序存储在 pythonobject 变量中,则可以使用生成的变量来调用代码中的方法。
3.1 了解pythonobject变量类型
了解pythonobject
变量类型,之前有使用string,datarow ,datatable 等类型,在和python 脚本数据交互时,我们需使用pythonobject变量类型。
pythonobject 变量类型功能:
用于处理和操作 python 数据, 通过使用“ 加载 python 脚本 ”活动,可以轻松地将包含 python 脚本的任何文件中的代码分配给 pythonobject ,还可以使用“ 获取 python 对象 ”活动将其转换为 .net 数据类型。有了这个强大的变量,可以使用每个任务的专用活动来运行脚本、提取 .net 类型或调用 python 方法。
3.2 属性配置说明
- “代码” - 要加载的 python 代码。
- “脚本 ” - 包含要加载的 python 代码的文件的路径。
- “结果 ” - 指定 python 脚本的处理程序,存储在
pythonobject
变量中。
注意:
1.代码和脚本 选项,二选一,建议使用脚本路径,便于维护。
2.结果输出项: python 脚本的处理程序存储在 pythonobject
变量类型中,创建其变量用来接收。
3.3 示例说明
如下图,创建变量python_excel_instance,用来保存python脚本处理程序,后面其他活动需要与python 交互时,则使用该变量则可。
4. 调用python方法(invoke python method)
调用python方法功能:
在工作流中运行 python 脚本中的调用指定方法。
注意:
使用调用python方法活动时,先使用“ 加载 python 脚本 ”活动拖拉到python作用域内。
4.1 属性配置说明
- “输入参数 ” - 要调用的 python 脚本的输入参数列表(如果调用python 方法有参数,则必填)。 字段仅支持
ienumerable<object>
变量。 - 实例 - 包含要运行的方法的 python 脚本,存储在
pythonobject
变量中。 字段仅支持pythonobject
变量。 - “名称 ” - 要调用的方法的名称。 此字段仅支持
string
变量。 - “结果 ” - 调用方法的结果,存储在
pythonobject
变量中。 可以使用“ 获取 python 对象 ”活动进一步处理,并将其转换为 .net 数据类型。
4.2 示例说明
参数格为式 {}
如{"参数名称值1”,"参数名称值2”,"参数名称值3”} 也可以使用变量,本文案例 参数值为:
{in_transactionitem("pdffilepath"),in_str_outputfolder,convert.tostring(in_transactionitem("filename"))+".xlsx"}
5. 获取python对象(get python object)
获取python对象功能:
用于从 python 对象获取 .net 数据类型。python 数据类型与uipath 数据类型不一致,当uipath 调用python 脚本时,如果脚本有返回值,uipath 需依其返回值做相关业务逻辑判断,这时需使用获取python 对象活动。
5.1 属性配置说明
- “python 对象 ” - 要从中提取值的 python 对象。 此字段仅支持
pythonobject
变量。 - “类型参数 ” - 要从
pythonobject
变量获取的 .net 数据类型。 默认情况下,它设置为object
。 支持 studio 中可用的所有数据类型。 - “结果 ” - 在“类型参数” 属性中选择的与 python 对象对应的 .net 类型变量。
5.2 示例说明
6. 运行python脚本(run python script)
运行python脚本功能:
执行 python 代码,支持代码或python文件路径。
6.1 属性配置说明
- “代码” - 要运行的 python 代码。 字段仅支持
string
变量。 - “文件 ” - 包含要运行的 python 代码的文件的路径。 字段仅支持
string
变量。
6.2 示例说明
发表评论