因软件更新较快,部分文档内容与软件最新版本有所出入,请知悉。
执行python代码片段。
使用本模块有一些基础需求:
- 您需要了解python;
- 本模块使用了pythonnet库实现,仅支持python3。
- 64位windows应安装64位版本python,32位windows安装32位python。
注意事项
- 请使用从官网下载安装的python(https://www.python.org/downloads/),第三方python环境可能无法正常运行。
- 目前支持的python版本为3.7 - 3.12(https://pythonnet.github.io/)。
- 在py脚本中,尽量只访问简单类型的quicker变量,如数字/文本。目前底层依赖库可能存在bug,使用复杂类型(如列表/词典)有概率遇到闪退问题。
- py脚本将在quicker进程中执行,拥有比普通非管理员身份运行的程序具有更高的权限。因此在py代码中不能使用com接口访问和控制第三方软件(如访问和使用Word.Application对象)。
Python的路径
可以直接设定cpython主运行库的路径,也可以让Quicker自动查找python。
1) 直接指定python主运行库的路径(1.35.37+版本)
2)自动查找python运行库
未设定运行库路径时,Quicker 会尝试从系统PATH环境变量所包含的目录中寻找符合条件的目录。
目录名需要包含版本信息,如3.9版目录名应该为xx\xxx\python39(目录内有python39.dll,目录名和dll文件名匹配)。
参数
【脚本内容】需要执行的python脚本内容。
py脚本中,通过quicker.context.GetVarValue('变量名')
读取动作变量。通过quicker.context.SetVarValue('变量名',value)
更新动作变量。
从python返回内容
简单的内容,可以在python脚本中可以直接使用quicker.context.SetVarValue('变量名',value)
返回到对应类型的变量中。Quicker 3.35.37版本后,也可以使用此方式返回文本列表和简单的词典变量。
##.py
quicker.context.SetVarValue('text', 'hello world')
quicker.context.SetVarValue('list', ['hello1','hello2','hello3'])
quicker.context.SetVarValue('dict', {'a':1, 'b':2, 'day':'2022-1-1'})
建议不要返回更复杂的数据类型(从python到c#的转换可能会出现奇怪的问题),而是在python中完成所有处理以后将简单的值返回到动作。
测试动作
更新历史
- 20230215 增加一些注意事项说明。