Uipath 调用Python 脚本程序详解

news2024/11/29 22:32:35

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 类型变量。