影刀RPA新手教程：网页截图与区域截图——证据留档的用法

影刀RPA新手教程网页截图与区域截图——证据留档的用法流程跑挂了想复盘日志里只有一行报错文字页面当时长什么样完全不知道这种抓瞎的感觉我经历过太多次。后来我给每条正式流程都加了截图留档出错时截图、关键节点截图、采集结果截图出了问题翻图就知道现场。影刀RPA的截图指令就两三条用法简单但文件命名、存储路径、和异常处理的配合有不少讲究乱用等于没留证据。我是做电商运营的非技术出身用影刀RPA两年多。第一次给客户交付采集流程时没做截图留档页面改版后流程采回一堆空数据客户问我到底哪一步出的问题我翻遍日志说不清楚最后重跑了一晚上才定位。从那以后截图留档成了我的固定动作。这篇新手教程把网页截图、元素截图、截图与异常处理的配合一次讲清顺带把截图在图像识别、验证留证、报表生成三个场景里的用法铺开读完可以直接给自己的流程加上证据链。环境准备装好影刀RPA和浏览器插件影刀RPA客户端从官网下载安装装完在设置里给Chrome或Edge装浏览器插件网页截图和元素捕获都依赖插件。界面三块左上指令区、中间流程画布、右侧指令详情面板指令面板顶部搜索框直接搜截图就能找到本文所有指令。社区版每天30分钟运行时长做截图这类操作绰绰有余截图文件占磁盘建议定期清理老图这个坑在速查表里会展开。流程第一步老规矩【获取已打开的网页对象】拿到网页对象变量截图指令都基于这个对象工作。新手先建立一个认知截图不是给流程看的是给人看的。流程判断状态要用IF元素可见(web)这类指令截图只负责把现场固定下来两者职责不同别用截图加图像识别去替代本来能用元素定位做的事那是绕远路。网页截图指令三种截图区域怎么选网页自动化的主力是【网页截图】指令指令面板搜索网页截图拖进流程第一个参数选网页对象。核心参数是截图区域官方给了三个选项用途完全不同网页元素通过指定操作目标的显示内容进行截图截元素本身网页可见区域截取当前浏览器中可视区域的内容看到什么截什么整个网页整个网页有滚动条的情况会截图滚动条长度内的所有内容选型很简单留某个模块的证据比如价格卡片、订单列表用网页元素还原用户看到的现场用网页可见区域要完整长图留档用整个网页。第三个选项对验证码、活动页这类必须看全貌的场景特别有用相当于自动滚屏拼接。保存参数有四项保存图片至剪切板支持后续流程通过CtrlV操作将图片进行粘贴、保存文件夹设置图片的保存文件夹路径、使用自动随机文件名为截图自动生成不重复的文件名以时间戳命名、截图保存位置把截图文件路径信息保存为变量。我的固定配置是指定文件夹加自动随机文件名路径存变量后面写入Excel用。元素截图(win)与手机端截图桌面和手机场景网页之外的场景用【元素截图(win)】对桌面软件中的元素进行截图窗口对象根据操作目标自动匹配或选一个之前通过【获取窗口对象】指令创建的窗口对象。参数和网页截图基本一致保存图片至剪切板、保存文件夹、使用自动随机文件名时间戳命名、截图保存位置输出变量。桌面软件操作留证靠它比如ERP系统的异常订单页面。指令作用对象典型场景网页截图网页对象页面留证、长图存档元素截图(win)窗口对象桌面软件留证屏幕截图(手机)手机设备ADB自动化留证元素截图(手机)手机元素具体控件留证手机自动化这边有【屏幕截图(手机)】和【元素截图(手机)】做ADB手机自动化时用来留证和配合图像识别。四条指令参数风格统一学会一条其他三条照搬。截图保存路径是流程里流转的关键变量拿到路径后可以写入Excel台账、作为附件发邮件、或者发飞书消息带图报警。证据的价值在于能被找到只截不存等于白截。证据留档的目录与命名规范自动随机文件名是时间戳命名能保证不重复但一个月后翻图全靠时间猜。我的做法是日期文件夹加用途前缀流程开始时用日期时间指令算出当天日期拼出保存文件夹路径比如D盘下的截图归档目录再加当天日期子目录时间戳文件名保留Excel台账里追加一行记录截图用途和路径。文件夹路径动态生成后记得用创建文件夹指令确保目录存在首次运行目录不存在会让截图指令报错这是新手高频坑。截图用途写进文件名前缀也行比如报错_“结果_”“对比_”配合Excel台账双保险。留档分级建议日常结果截图保留30天报错现场截图永久保留或至少保留90天验证码和登录相关截图用完即删里面可能有敏感信息。磁盘清理用定时子流程做别等人来删。截图与异常处理Try-Catch里的标准动作截图最大的价值在异常处理里。标准写法把业务指令包进Try块Catch块里第一件事用【网页截图】截当前可见区域路径存变量再用【输出日志】把报错信息和截图路径一起写进日志最后【飞书机器人发送消息】或【邮件发送】把截图发出来。fromxbotimportwebdefmain(args):pageweb.get_active()try:# 业务操作点击导出按钮并等待结果page.find(导出按钮).click()exceptExceptionase:# 出错先截图留证再记录日志page.scroll_to(locationtop,behaviorinstant)img_pathpage.screenshot(shot_typeclient)print(f流程报错{e}现场截图{img_path})raise# 重新抛出让上层流程感知失败截图前先把页面滚回顶部或目标区域保证截到的是关键信息而不是页面底部这个细节我在吃了两次亏之后才加上报错时页面正好停在页尾截图里什么都没有。Finally块里放清理动作比如关闭弹窗保证下一轮循环环境干净。正式流程我还会在关键节点加截图登录成功后截一张、导出完成后截一张、每批数据入库前截一张。截图多不多不重要关键节点的现场必须在出问题时按时间线能把过程拼出来。截图的另外三个实战用途用途一图像识别的前置素材。影刀图像库的添加新图像功能需要目标图像素材遇到点击右键菜单就消失的元素官方文档给的办法是用Windows的PrtSc快捷键截到剪贴板再裁剪或用带延迟截图功能的软件比如延时2秒的截图工具点区域截图按钮后在2秒内把右键菜单打开延时到点后出现截图指示器自由选择区域再通过图像库的本地文件导入加进去。用途二报表生成。把采集结果渲染成页面后整页截图作为日报图片发飞书群比裸Excel好看也直观。配合网页截图的整个网页选项长报表一张图搞定。用途三对比留证。改价前后各截一张图、活动开始前后各截一张路径写进同一行Excel客服和运营核对时一目了然。截图成本极低但每次要用的时候都会感谢自己留了这一手。数据处理与工程化截图台账的闭环截图路径别散落各处统一进台账。用【追加写入Excel】把时间、用途、截图路径、关联订单号写进一张总表查证据时先查表再开图。表本身用日期分表避免单表过大变慢。工程化上把截图留档封装成子流程输入网页对象、用途说明、保存根目录内部完成建目录、截图、写台账输出截图路径。主流程里一行调用所有流程统一证据格式交付给客户也显得专业。调试阶段不用到处截图右键添加断点加单步执行配合变量面板看值就够了截图留档是给无人值守的定时任务用的两者别混。网页截图与区域截图易错速查现象原因解决截图指令报路径错误保存文件夹不存在先创建目录再截图截图里没有目标内容目标在视口外或页面底部截图前先滚动到位长图只有一屏区域选错截图区域选整个网页Excel区域截图有怪图区域含数据透视表换区域或先转成普通区域右键菜单截不到菜单点开就消失PrtSc或延迟2秒截图再导入补三条教训一是截图文件会吃磁盘定时清理子流程要配二是敏感页面截图注意脱敏和保存期限别把客户数据裸奔在共享盘三是截图和图像识别别混用能元素定位的不要用图像识别兜底脆得多。学习资源与延伸阅读本文依据官方文档的网页截图元素截图(win)两篇指令说明三个截图区域的定义和剪切板、时间戳命名的说明都出自原文。完整流程源码我放在代码仓库 home.linyan.cloud可以直接参考改造里面有截图留档子流程、Excel台账模板和定时清理模块导入影刀改个保存路径就能用。#影刀RPA #RPA自动化 #网页自动化 #异常处理 #Excel作者林焱