配置 Python 以便与 Analytics 一起使用

Analytics 为您提供了将 Python 编程语言和 Python 脚本与数据自动化和数据分析工作流集成的不同选项。

Analytics 功能区域	需要的 Python 位数	受支持的 Python 版本	Python 设置方法
ACLScript Python 命令 (PYCOMMAND)	64 位（推荐） 32 位	3.12.4（已测试） 其他版本的 Python 可能可以使用，但尚未经过测试。	客户将 Python 与 Analytics 分开安装和配置 请参阅配置 Python 以支持 ACLScript Python 命令
ACLScript Python 函数	32 位	3.7.x 或更新版本	客户将 Python 与 Analytics 分开安装和配置 请参阅配置 Python 以支持 ACLScript Python 函数
ACLScript 机器学习命令	32 位	3.7.9	客户在 Analytics 安装过程中选择安装了可选的 Python 请参阅安装 ACL for Windows

配置 Python 以支持 ACLScript Python 命令

安装并配置 Python 以支持使用 ACLScript Python 命令 (PYCOMMAND)。Python 命令允许您无缝集成 Analytics 脚本和 Python 脚本，并在两个环境之间来回移动数据。

安装 Python（64 位或 32 位）

1. 从 Python 下载页面中，将最新版本的 Python 下载到您的计算机或该服务器。

   ACLScript Python 命令已经使用 Python 3.12.4 进行了测试。其他最新版本的 Python 应该可以运行，但不能保证可以运行。

2. 在您的计算机或服务器上，双击 Python 安装程序。

3. 在安装程序中，选择安装 py.exe 时使用管理员权限。

4. 单击立即安装并按照屏幕上的说明操作。

将 Python 文件夹路径添加到 PATH 环境变量中

将 Python 安装的两个文件夹路径添加到 PATH 环境变量中。

1. 在 Windows 工具栏中搜索环境变量。

2. 选择编辑系统环境变量。

   系统属性对话框出现。

3. 在高级选项卡中，选择环境变量。

   环境变量对话框出现。

4. 在系统变量列表中，选择路径，然后选择编辑。

   编辑环境变量对话框出现。

5. 执行以下操作以添加两个 Python 文件夹路径：

   1. 选择新建，并添加此文件夹路径（默认 Python 安装位置）：

      C:\Users\<USER>\AppData\Local\Programs\Python\Python<版本>\

      说明

      如果您在其他位置安装了 Python，请指定包含 Python 可执行文件 (python.exe) 的文件夹的正确路径。

   2. 选择新添加的路径，然后使用上移将路径移动到列表顶部。

   3. 再次选择新建并添加此文件夹路径，根据需要进行修改：

      C:\Users\<USER>\AppData\Local\Programs\Python\Python<版本>\Scripts

   4. 选择第二个添加的路径，然后使用上移将路径移动到您添加的第一个路径下方。

6. 要保存更改，请在每个对话框中选择确定：

   • 编辑环境变量

   • 环境变量

   • 系统属性

7. 重新启动计算机或服务器，以确保对路径环境变量的更新生效。

   说明

   根据您的操作系统和环境，可能不需要重新启动。但是，如果下一组步骤不起作用，请在重试这些步骤之前重新启动计算机或服务器。

创建 Python 虚拟环境

1. 创建一个 Windows 文件夹来包含 Python 虚拟环境。

   例如，C:\Python_ACL_integration。

2. 打开一个 Windows 命令提示窗口，然后以管理员身份运行。

3. 输入 python.exe --version，然后按 Enter。

   应该返回您安装的 Python 版本。例如：
   Python 3.12.4。

   如果 Windows 命令提示无法识别该命令，则您对路径环境变量的更新可能尚未生效。请重新启动计算机或服务器，然后重试。

4. 切换到您为 Python 虚拟环境创建的文件夹。

   例如，cd C:\Python_ACL_integration。

5. 要创建 Python 虚拟环境，请输入以下命令：Python-m venv-venv。

   第一个 venv 指定使用 Python venv 模块。第二个 venv 命名虚拟环境。如果需要，您可以为虚拟环境指定其他名称，但请确保该名称明显指向虚拟环境。

   现在，在为 Python 虚拟环境创建的文件夹中，应该有一个 venv 子文件夹。例如，C:\Python_ACL_integration\venv。

   如果创建 Python 虚拟环境不成功，则对 Path 环境变量的更新可能未生效。请重新启动计算机或服务器，然后重试。

6. 要激活 Python 虚拟环境，请输入以下命令：.\venv\Scripts\activate。

   命令提示符应返回以 (venv) 开头的虚拟环境文件夹。例如，(venv) c:\Python_ACL_integration>

7. 要在 Python 虚拟环境中安装 Pandas 模块，请输入以下命令：pip install Pandas。

   如果 Pandas 安装成功，命令提示符消息应显示最后一行，例如：

   成功安装 numpy-2.2.2 pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2024.2 six-1.17.0 tzdata-2025.1

将虚拟环境路径添加到 Analytics 选项中

1. 打开 Analytics。

2. 从 Analytics 主菜单中选择工具 > 选项。

3. 选择系统选项卡。

4. 在 Python 路径域中，输入您刚刚创建的虚拟环境中的 Python 可执行文件的完整路径和文件名。

   例如，C:\Python_ACL_integration\venv\Scripts\python.exe

5. 单击确定保存更改。

后续步骤

如果 Python、虚拟环境和 Pandas 的安装和配置成功，您就可以测试 Analytics 和 Python 的集成了。有关详细信息，请参阅集成 Python 脚本或PYCOMMAND 命令。

配置 Python 以支持 ACLScript Python 函数

要配置 Python 以与 Analytics 一起工作，您必须安装兼容版本的 Python，并且将 Python 可执行文件添加至您的计算机的 PATH 环境变量。您还必须设置 ACLPYTHONDLL 和 PYTHONPATH 系统环境变量。

工作原理

要运行 Python 脚本，Analytics 必须能够调用 Python 可执行文件并且找到它要按照指示运行的脚本。Analytics 使用 PATH 环境变量来查找 Python，使用 PYTHONPATH 环境变量来查找脚本。

安装 Python（32 位）

1. 从 Python 下载页面中，将以下 Python 版本之一下载到您的计算机或服务器：
   • 3.7.x
   • 3.8.x
   • 3.9.x

   说明

   列出的 Python 版本已经过测试和验证，可以与 Analytics 或机器人代理一起工作。

   从 3.7.x 开始的任何 Python 版本都应该能够工作。但是，除了列出的版本以外的版本不能保证可以工作。

2. 在您的计算机或服务器上，双击安装程序。
3. 在安装程序中，选择添加 Python 版本号到 PATH。
4. 单击安装并按照屏幕上的说明操作。
5. 在运行 Analytics 脚本所调用的任何 Python 脚本之前，请重新启动计算机或服务器。

设置 ACLPYTHONDLL 和 PYTHONPATH 环境变量

1. 在操作系统的 C:\ 驱动器中，创建一个或多个文件夹以存放您的 Python 脚本。

   示例 C:\python_scripts

2. 从操作系统中，打开系统属性对话框，然后单击环境变量。
3. 在系统变量部分，单击新建并输入以下变量：

   变量名称	变量值
   PYTHONPATH	您创建以存放 Python 脚本的文件夹的完整路径。用分号分隔多个文件夹路径。 示例： C:\python_scripts;C:\dev;C:\tmp
   ACLPYTHONDLL	Python 安装文件夹中 Python DLL 文件的完整路径和文件名。 示例： c:\python_install\python35.dll 说明 完成安装后，Python 将 DDL 文件添加到系统文件夹 (c:\windows\system32\python35.dll) 而不是安装文件夹。您必须将该 DLL 从系统文件夹复制到安装文件夹，并且使用安装文件夹位置作为变量值。Analytics 或机器人代理在 Python 安装文件夹中寻找该 DLL。 您可能还需要从安装文件夹中移除任何只读设置。

4. 要保存变量，请单击确定，然后在系统属性对话框，然后单击确定。

在 Analytics Python 函数中使用 Python

从 Analytics 中，使用 Analytics Python 函数调用您的 PYTHONPATH 中存在的脚本中的函数。

要了解更多信息，请参考Python。