看懂 APA Creator 的界面

四个基本概念、两处视图、几块面板——界面的全部骨架。

知识地图

整套课程按"概念 → 界面 → 语法 → 四类办公自动化 → 综合项目"七步走。第 1 课回答了"RPA 是什么"，本课回答"你在哪里做 RPA"——把 APA Creator 这台工作台认全。认不清界面，后面写流程就像闭着眼拧螺丝。

一、一个流程的骨架：从"流程"到"属性"的四层包含

官方开发者指南把界面里的一切归纳为四个概念：流程、流程块、命令、属性，它们是包含关系。[1] 这套概念在 2.x 里没有变，变的是它摆在界面的哪个位置。

1.1 四层是什么（一层套一层）

一个流程包含多个流程块，一个流程块包含多条命令，一条命令包含多个属性。记住这个层级，后面所有概念都挂在它上面。

1.2 为什么这样分层：它是在对应"人怎么做事"

想想你自己做一次"对账"：你不会把它当成一个巨大的动作，而是先分成几大步骤（登录网银、下载流水、和账面核对、生成结果），每一步里再做几个小动作（点登录、输入账号、点确认），每个小动作还有细节（输入哪个账号、等几秒）。 机器人流程也是照这个思路组织的——分层的目的是让"一件事"能被拆成可检查、可复用、可单独调试的小块。如果所有动作堆成一大坨，出错时你根本不知道是哪一步坏掉的。

二、界面长什么样

三、两处视图：同一件事的两个层级

这是认证的高频考点，也是新手最容易糊涂的地方。先记住一句话：不是两个流程，是同一件事的两个层级。

3.1 一条最实用、也最容易误判的规则

在流程图视图下打开左竖栏的"命令"面板，你会看到它写着：

这不是故障，也不是没登录。命令是流程块内部的东西，你还站在"整张图"这一层，所以它没东西给你取。 解决办法只有一个：进入流程块编辑视图，命令面板立刻就亮了。

3.2 进入流程块编辑视图之后

怎么进：点流程块上的铅笔图标。记住这条——在画布上双击节点改的是"描述"，不是进入编辑，两件事很容易混。进来之后有四处变化：

3.3 命令在这里长什么样

命令不是一行行代码，而是一句句中文，按执行顺序编号排列：

2  打开Excel工作簿，路径为 C:\...\台账.xlsx，输出到 objExcelWorkBook
3  读取单元格 A1 的值，输出到 objRet
4  关闭Excel工作簿

这种"一句话说清这条命令在干什么"的写法，比读代码直观得多。截图里第二条命令被选中（高亮）， 于是右竖栏的属性面板立刻列出它的四个参数：工作簿对象、工作表、单元格、显示即返回。

3.4 同一个流程块的另一副面孔：源代码视图

编辑器右上角那个写着「可视化」的蓝色标签，就是当前视图的标识。 点它一下，标识变成「源代码」，同一段命令立刻换成代码写法：

hWeb = WebBrowser.BindBrowser("edge",10000,{"bContinueOnError":false})
Dim arrayRet,objExcelWorkBook
sRet = UiElement.GetValue(@ui"表格单元格<td>_林静",{"bContinueOnError":false})
Keyboard.InputText(@ui"输入控件<input>",sRet,true,300,10000,{"bContinueOnError":false})
Mouse.Action(@ui"按钮<button>_自检","left","click",10000,{"bContinueOnError":false})

三点值得注意：

• 命令的写法是 模块.命令——UiElement.GetValue、Mouse.Action、WebBrowser.BindBrowser。
• 界面上选好的元素，在代码里以 @ui"…" 出现，引号里那串就是元素名。 所以你在界面库里改个名，代码会跟着变——这也是"界面库"值得好好起名的原因。
• 每行末尾的 {"bContinueOnError":…} 是可选参数（这条命令出错时要不要继续往下走）。

四、流程图上的四种组件

打开一个流程，看到的是一张流程图。图上只有四种常用组件：[1]

4.1 怎么把组件"拖"成一张图

在流程图视图里，画布左侧有一条竖向的组件图标条，把图标拖到画布上就成了节点。

1. 在画布左侧的组件图标条里找到"流程块"图标。
2. 按住拖到画布空白处松手，画布上就多出一个流程块节点。
3. 鼠标移到节点边缘会露出连接点；从这里拖到另一个节点，就画出一条箭头，表示"执行完这个再去那个"。
4. 进入流程块内部去加命令：点流程块上的铅笔图标，它会以一个新标签页出现在中央（见 3.2）。注意——在画布上双击节点改的是描述，不是进入编辑。
5. 点顶部工具条的运行，程序就从"流程开始"出发，沿箭头一路走。

4.2 举个例子：一张最小但完整的流程图

[流程开始] ──▸ [流程块：登录网银] ──▸ [判断：登录成功？]
                                            ├─ 是 ▸ [流程块：下载流水] ──▸ [结束]
                                            └─ 否 ▸ [流程块：重试一次]

读法：开始只有一个；流程块有三个（登录、下载、重试）；判断有一个，它把路分成"是/否"两条；结束可以没有，但这里放了一个明确的终点，读起来更清楚。

五、命令、界面库与工具条

5.1 命令面板：你 90% 的时间花在这里

进入流程块编辑视图后，左竖栏的"命令"面板就亮了。它按用途分组：

完整分组还有：我的收藏、扩展命令、AI、鼠标键盘、智能文档处理、文件处理、系统操作、网络。找命令最快的办法是顶部的搜索框。

5.2 流程面板：这个流程由什么组成

左竖栏的"流程"面板是一棵目录树，列出这个流程下面挂着的东西：

• 流程块——干活的主体，可以有很多个；
• 界面库——你选过的网页与窗口元素都存这儿（做网页自动化时你会天天进来）；
• 资源文件——流程要用到的数据文件；
• 扩展——额外的包（比如 Python 库）；流程设置——这个流程的整体配置。

5.3 顶部工具条

后四个按钮（录制 / 数据抓取 / 智能文档处理 / 查找目标）是进入流程块编辑视图后才出现在工具条上的——界面是随视图变的，别因为找不到某个按钮就以为装错了。本课程主要用到的是"运行 / 调试 / UI 分析器 / 内置浏览器"。

5.4 UI 分析器：第 10 课的地基

机器人要"点"网页上的一个按钮，首先得让你的流程认识这个按钮。干这件事的工具就是 UI 分析器。

1. 点顶部工具条的 UI 分析器，打开一个独立窗口。
2. 点 从界面上选取，把鼠标移到目标上——会有蓝色高亮框住它，点一下即选中。
3. 用 高亮显示元素 / 验证目标 反查：选中的是不是你要的那个？目标会闪一下。
4. 选不到时，直接在左边的可视化树里按层级往下找。
5. 确认无误后点右下角 保存到界面库，之后命令里就能直接引用它。

窗口右侧还有一个页签叫 特征筛选器（支持通配符 *）——这就是课程里说的"通配元素"的落点：把会变的那部分（比如行号）换成 *，一个元素就能对应一整列。

5.5 从哪儿开始：新建一个流程项目

写第一行代码之前，先认一下"从哪儿开始"。

点「新建」，对话框只问你两件事：名称和位置。填完点「创建」，就得到一个可以开工的流程项目。 左侧那一列（工作区 / 流程 / 命令库 / 触发器 / 命令库管理 / 扩展中心 / 设置）是这个客户端的首页导航， 与编辑界面里的左竖栏不是一回事。

六、输出面板与运行

底部是输出面板。运行流程时，输出调试信息 打出来的内容、报错信息、运行日志都显示在这里。 写流程时你会一直盯着它——它是你和机器人之间唯一的"对话窗口"。

更完整的对照速查见 参考页：APA Creator 界面与视图速查； 平台组件分工见 平台地图；术语见 语法与术语速查。

本课小结

自测

不看上面，凭记忆作答。答错不要紧，解析会告诉你为什么。

上机实践（回到 Windows）

精读一手来源

RPA 财务机器人应用 · 第 2 课 / 共 10 课 · 目标：通过来也RPA实施工程师认证（初级） · 蜀ICP备2025153217号