编码开发模式

介绍编码开发过程,整体介绍详见 概述

1. 创建编码开发模式的工程

在编辑器新建工程时,选择“基础编码工程模板”即可创建编码开发模式的工程。

2. 开发界面

编码模式开发界面主要分为5个区域:菜单和快捷按钮,左侧面板(组件面板、工程面板)、中间的流程代码编写区域、右侧的控件管理,底部面板(日志、数据视图、参数面板)。

image

  1. 菜单。主要包括:

    1. 文件:可新建、打开、保存和关闭工程,退出按钮可退出编辑器。

    2. 视图:可设置各项面板的显示和隐藏,如果关闭了编辑器的任意一个面板,在此处可选择显示该面板。

    3. 工程:组件管理对自定义SDK和第三方库进行管理,可在此处将企业自定义SDK或第三方库导入该工程使用,发布功能可以将此工程发布成应用到企业应用市场。

    4. 设计:捕捉控件可激活捕捉控件工具。

  2. 工具栏。提供新建工程、打开工程、保存本工程、关闭本该工程、捕捉控件、选择某个流程开始调试、组件管理、发布等快捷按钮。

  3. 组件面板。按照用途以树状形式列出所有可用的SDK,选中后下方同时出现相应的代码帮助信息。

  4. 工程面板:对本工程进行结构管理,支持通过右键菜单进行工程重命名、快速打开工程所在文件夹、创建新文件夹组织流程,以及新建自动化流程。

  5. 流程代码编写区域。内置Python IDE,支持编写Python代码。编辑区域支持代码提示功能,引用SDK组件时自动显示可用方法;行号区域可设置断点进行流程调试;鼠标悬停组件时显示参数详情与使用说明。

  6. 控件面板。支持多种方式进行控件捕捉,提供分组管理功能,右键可复制名称、编辑或删除控件,通过设置按钮快速选择点击、输入等操作。

  7. 日志面板。显示流程运行产生的日志,如系统日志,操作日志以及调试日志。

  8. 数据视图。支持将自动化采集的数据实时写入结构化视图,并实现与Excel的无缝导入导出,便于数据验证、分析和后续处理。

  9. 参数面板。定义本流程的输入参数。

3. 工程结构

编码工程结构中,包含三类:

  • 流程:主流程与子流程。

    • main是主流程,发布为应用后,调用入口为mainstart()方法。

    • 工程面板中右键可新建子流程,并且支持创建多级文件夹。

    • 流程间支持互相调用。

  • 引用:存放的是引用的第三方库与自定义组件

    • 需要使用组件管理功能。

  • 资源:可以存放运行时所需的资源文件,例如Excel

4. 基本语法

在编辑器右下角可以看到使用的Python版本,因此编码开发模式下需要遵从对应Python版本要求。

常用语法

  • 函数定义:使用 def 创建可复用函数,提高代码组织性

  • 模块导入:通过 import 引入标准库或第三方模块

  • 流程控制:for/while 循环与 if/elif/else 条件判断

  • 异常处理:try/except 结构捕获并处理运行时错误

  • 字符串操作:"{}".format() 实现动态内容插入,split()/join() 处理文本

常用模块

模块

用途

场景示例

os/sys

文件系统与进程操作

目录遍历、环境变量管理

datetime

日期时间处理

时间戳计算、格式化输出

json

数据序列化

API 响应解析、配置文件处理

re

正则表达式

文本模式匹配、数据清洗

requests

HTTP 请求

API 调用

pandas/numpy

数据处理

表格数据操作、数值计算

变量命名建议

使用语义化命名:order_total 优于 ot;布尔值使用 is_/has_ 前缀(如 is_valid);避免单字母变量(循环计数器 i 除外)。遵循 变量命名规范,确保代码可读性与团队协作效率。

5. 捕捉控件

“控件”是RPA机器人模拟人进行界面自动化操作的基础对象,代表其在执行一个应用(流程)时可能涉及的各类“界面元素”,如某个网页中的输入框、搜索按钮、页面标题、客户端上的登录按钮等,都可以被视作一个控件。具体操作详见 控件捕捉和使用

6. 使用SDK

内置了700多个自动化Python方法,常用分类如下表所示:

分类

用途

引用位置

相关自动化方法

Win32

操作窗口对象

rpa.ui.win32

Win32

Java

操作Java对象

rpa.ui.java

Java

IE

操作IE浏览器

rpa.app.ie

IE

Chrome

操作Chrome浏览器

rpa.app.chrome

Chrome

Edge

操作Edge浏览器

rpa.app.edge

Edge

SE360

操作360浏览器

rpa.app.se360

SE360

SAP

操作SAP客户端

rpa.app.sap

SAP

MIcrosoft/WPS

操作Excel

rpa.app.microsoft

rpa.app.wps

Microsoft/WPS

CV

操作CV录制的控件

rpa.ai.cv

CV

LLM

基于OpenAI SDK,调用大模型接口

rpa.ai.llm

LargeLanguageModel

AliyunOCR

使用阿里云OCR

rpa.ai.aliyun_ocr

AliyunOCR

Asset

操作资产变量

rpa.console.asset

Asset

Logger

记录日志

rpa.console.logger

Logger

Workbench

设置任务结果

rpa.console.workbench

Workbench

Param

操作参数面板

rpa.project.params

Param

Datatable

操作数据视图

rpa.project.datatable

Datatable

Resource

操作工程的资源文件夹

rpa.project.resource

Resource

No Disturb Mode

设置勿扰模式

rpa.system.no_disturb_mode

No Disturb Mode

Screen Unlocker

屏幕解锁

rpa.system.screen_unlocker

Screen Unlocker

Dialog

设置对话框

rpa.system.dialog

Dialog

7. 扩展方式

8. 调试

  • 记录日志。详见Logger

  • 指定流程的方法调试运行。在工具栏中,可选择流程的方法,指定从该方法开始调试运行。

  • 断点调试。设置断点后,在调试时支持暂停、单步跳过、单步调试、单步跳出、停止。如下图所示。

    image

9. 发布