配置 Python 以便与 Analytics 一起使用

要配置 Python 以使用 Analytics,您必须安装兼容版本的 Python,并且将可执行文件添加至您的系统 PATH 环境变量。您还必须设置 ACLPYTHONDLLPYTHONPATH 系统环境变量。

工作原理

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

安装 Python 版本 3.5.x(32 位)

  1. Python 下载页面中,将某个版本的 Python 下载到您的计算机或该服务器。

    说明

    我们建议使用 Python 3.5,因为它已被测试和验证,可以正确地与 Analytics 或机器人代理一起工作。

    从 3.3.xonward 开始的任何版本的 Python 也都应该能够正常工作,但是我们不提供与版本 3.5.x 相同的测试和支持保证。

  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

    您想要通过 Analytics 或机器人代理使用的 Python 安装文件夹中的 Python DLL 文件的完整路径和文件名。

    示例:

    c:\python_install\python33.dll

    如果您使用的是 Python 3.3.x,则适用下列限制:

    • 欧洲语言平台的路径中不支持 Unicode 字符
    • 亚洲语言平台的路径中不支持扩展字符

    说明

    Python 向系统文件夹 (c:\windows\system32\python33.dll) 而非安装文件夹中添加 DLL。您必须将该 DLL 从系统文件夹复制到安装文件夹,并且使用它作为变量值,以便 Analytics 可以访问该 DLL。

    您可能还需要从安装文件夹中移除任何只读设置。

    如果您不设置此值,则 Analytics 或机器人代理会尝试使用默认的受支持版本 3.5.x DLL python35.dll

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

在 Analytics Python 函数中使用 Python

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

说明

如果您对 Python 脚本进行任何编辑,您必须刷新您的 Analytics 项目中的视图以使用最新版本的 Python 脚本。刷新视图的最简单的方式是关闭您正使用的表,然后重新打开。