(Temp)PicassoWR_V30用户帮助手册.doc

AlibabaAlibaba B2BB2B 规范文档规范文档 PicassoWRPicassoWR V3 0V3 0 系统系统 用户使用帮助文档 编写QA 测试架构组编写时间 2008 12 26 审批审批时间 2008 12 26 文档版本 V3 0 阿里巴巴网络有限公司版权所有阿里巴巴网络有限公司版权所有 文档中的全部内容属阿里巴巴网络有限公司所有 未经允许 不可全部或部分发表 复制 使用于任何目的 阿里巴巴网络有限公司版权所有阿里巴巴网络有限公司版权所有 文档中的全部内容属阿里巴巴网络有限公司所有 未经允许 不可全部或部分发表 复制 使用于任何目的 文档修订摘要文档修订摘要 日期日期修订号修订号描述描述著者著者审阅者审阅者日期日期 2009 07 021 增加了分发执行时的设置场景顺序的功能 增加了后台脚本执行的功能 增加了框架 需求管理模块 增加了三项公共配置项 是否需要旺旺提醒 是否需要邮件提醒 场景运行失败最大重跑次数 自动化 小组 2009 07 022 增加了中间数据管理功能 增加多个项目并行分发执行功能 增加了分发执行任务顺序调整功能 自动化 小组 2009 08 223 二期功能帮助文档添加 自动化 小组 ii 目录目录 文档修订摘要文档修订摘要 I 目录目录 II 第第 1 1 章章引言引言 1H 1H 1 1 1PICASSOWR 框架平台概述 1 1 2此文档用途 2 1 3阅读对象 2 1 4名词术语 2 1 5参考资料 1 第第 2 2 章章环境搭建一键安装环境搭建一键安装 5H 5H 2 2 1安装包版本及功能说明 2 2 2STAF 安装与信任建立 2 2 3如何操作一键安装 3 2 4如何搭建自动化运行环境 3 2 5如何搭建自动化开发环境 5 2 6PWATIR GEM包安装与后续升级 8 2 6 1通过 svn 下载 build gem 8 2 6 2通过 Gem server install 8 2 6 3通过 STAF 自动安装更新 8 2 6 4升级 pwatir 9 2 7NETBEANS插件 PWATIRPLUGIN1 0 9 第第 3 3 章章对象识别对象识别 10H 10H 14 3 1IE 14 3 2FRAME 14 3 3MODAL DIALOG 14 3 4FORM 15 3 5TABLE 15 3 6DIV 15 3 7SPAN 16 3 8HIDDEN 16 3 9AREA 16 3 10BUTTON 17 3 11TEXT FIELD 17 3 12SELECT LIST 17 3 13CHECKBOX 18 3 14RADIO 18 3 15ROW 18 3 16CELL 19 3 17LINK 19 iii 3 18POPUPWIN 19 第第 4 4 章章对象方法对象方法 10H 10H 20 4 1IE 20 4 1 1self start url 20 4 1 2self attach option what nil 20 4 1 3self start process url 20 4 1 4close 21 4 1 5document 21 4 1 6self each proc 21 4 1 7exists 21 4 1 8self exists option what nil 22 4 1 9goto url 22 4 1 10title 22 4 1 11url 23 4 1 12wait 23 4 1 13refresh 23 4 1 14back 23 4 1 15forward 24 4 1 16hwnd 24 4 1 17html 24 4 1 18text 25 4 2FRAME 25 4 2 1document 25 4 2 2html 25 4 2 3text 25 4 2 4exists 26 4 3MODAL DIALOG 26 4 3 1exists 26 4 3 2title 27 4 3 3close 27 4 3 4wait 27 4 4FORM 27 4 4 1wait 27 4 4 2flash num 10 28 4 4 3attribute value attribute 28 4 4 4html 28 4 4 5text 28 4 5TABLE 29 4 5 1row count 29 4 5 2column count index 1 29 4 5 3attribute value attribute 29 4 5 4row values rownumber 30 4 5 5column values columnnumber 30 iv 4 5 6get row by hash options 30 4 5 7html 30 4 5 8text 31 4 6DIV 31 4 6 1html 31 4 6 2text 31 4 6 3attribute value attribute 32 4 7SPAN 32 4 7 1html 32 4 7 2text 32 4 7 3attribute value attribute 32 4 8HIDDEN 33 4 8 1html 33 4 8 2text 33 4 8 3attribute value attribute 33 4 9AREA 34 4 9 1html 34 4 9 2text 34 4 9 3attribute value attribute 34 4 10BUTTON 35 4 10 1html 35 4 10 2text 35 4 10 3attribute value attribute 35 4 10 4click 36 4 10 5doclick 36 4 11TEXT FIELD 36 4 11 1html 36 4 11 2text 37 4 11 3attribute value attribute 37 4 11 4set text 37 4 12CHECKBOX 37 4 12 1html 37 4 12 2text 38 4 12 3attribute value attribute 38 4 12 4set value true 38 4 12 5clear 39 4 13SELECT LIST 39 4 13 1html 39 4 13 2text 39 4 13 3attribute value attribute 39 4 13 4getAllContents 40 4 13 5getSelectedItems 40 4 13 6includes text 40 4 13 7selected text 41 v 4 13 8select item 41 4 13 9rand select 41 4 13 10get select options 41 4 14RADIO 42 4 14 1html 42 4 14 2text 42 4 14 3attribute value attribute 42 4 14 4set 43 4 14 5clear 43 4 14 6isSet 43 4 15CELL 44 4 15 1html 44 4 15 2text 44 4 15 3attribute value attribute 44 4 16LINK 45 4 16 1html 45 4 16 2text 45 4 16 3attribute value attribute 45 4 16 4click 45 4 16 5doclick 46 4 16 6href 46 4 17POPUPWIN 46 4 17 1get static text 46 4 18CLICK与 DOCLICK的运用 47 4 19WEBTABLE识别与操作 47 4 20正则表达式 48 4 21检查点ASSERT使用说明 50 4 22LOGSTEP的运用 51 第第 5 5 章章PICASSOWRPICASSOWR 平台功能介绍平台功能介绍 10H 10H 53 5 1自动化平台功能总体流程图 53 5 1 1主干业务流程图 53 5 1 2主干功能介绍 54 5 2基础数据建立 55 5 2 1业务流程图 55 5 2 2操作功能介绍 55 5 3场景数据与配置维护 56 5 3 1业务流程图 56 5 3 2操作功能介绍 56 5 4项目HOST与用户HOST管理 63 5 4 1业务流程图 63 5 4 2操作功能介绍 63 5 5分发执行与监控 67 5 5 1业务流程图 67 vi 5 5 2操作功能介绍 68 5 5 3分发执行机状态的判定 74 5 5 4按测试套分发 74 5 5 5中断执行 重新分发与重新运行 77 5 6日志查询与问题归类 77 5 6 1业务流程图 78 5 6 2操作功能介绍 78 5 7报表 80 5 7 1Code Review 报表 81 5 7 2性能结果记录 82 5 8初始化SQL与恢复SQL参数 84 5 9特殊的参数 85 5 10框架需求管理 85 5 11中间数据管理 86 5 12运行时间过长步骤查询 87 第第 6 6 章章框架与平台协同操作框架与平台协同操作 4H 4H 88 6 1SVN 目录结构与PWATIR生成项目目录 88 6 21 0 版本DATALIST XML转换为 2 0 版本PLAN XML 89 6 3EXCEL场景导入与配置文件导出 90 6 4本地导入 EXCEL文件格式说明 91 6 5WEB配置对框架运行的影响 91 6 6DRIVERSERVICE动态调度模块运行与LOG输出到平台 92 6 7DRIVERSERVICE与WEB平台协作中代码DEBUG方式 92 6 8执行机 VNC 桌面监控程序的安装 92 第第 7 7 章章后台测试工具后台测试工具 ROBOMBROBOMB 10H 10H 96 7 1ROBOMB 96 7 2BROWSER 96 7 2 1new 96 7 2 2start url 96 7 2 3get options parameters referer nil 96 7 2 4post url post params post headers 97 7 3PAGE 97 7 3 1html 97 7 3 2title 97 7 3 3url 98 7 4对象识别 98 7 5对象方法 98 7 6数据库访问 98 7 7TESTCASE 98 7 7 1TestCase 98 7 7 2TestSuite 99 7 7 3TestData 99 vii 7 7 4TestRunner 99 1 第第 1 1 章章 引言引言 1h 1h 1 11 1PicassoWRPicassoWR 框架平台概述框架平台概述 PicassoWR 框架平台经历了 v1 0 v2 0 发展 版本演进过程中结合用户使用反馈与建议 不断优 化与完善 即将推出的 v3 0 进一步让 b2b QA 自动化技术具有里程碑的发展 和翻开了新的自动化 框架平台的一页 下面简单介绍 picassowr 功能特点 一 一 了解为何推出我们的产品 了解为何推出我们的产品 PicassoWR PicassoWR 毕加索自动化测试框架平台 有以下功能 首先 把原先用户在 Excel 文件进行场景与数据驱动配置的工作 转移到平台中来 自动 化测试流程 场景配置数据 集中管理 对系统的操作 access anywhere and anytime and by anybody 从而避免用户会独占某台执行机器 独占修改场景数据文件 其次 基于我们现在每个网站分别有多台执行机 修改一个脚本文件 需要手工分发或 svn 更新到多台机器 对于自动化执行人员来说费时费力 采用 STAF STAX 自动化脚本分发与 调度执行 做到在执行机脚本分发执行时 无人职守 您只需要关注监控到执行机运行 的实时 LOG 同时与多台机器进行交互 最后 PicassoWR 系统中包括对产品线项目 用户等基础数据的维护与管理 再结合每次执 行脚本时生成的 自动化运行 LOG 进行统计分析 挖掘项目测试时未经察觉的 BUG 总结 从而规避质量风险 另外 PicassoWR 平台 在用户操作体验 如 UI 操作风格一致性 操作响应性能 兼容 性 如 仍支持 v1 0 中 Excel 数据配置 可用性方面 如 提供快捷键操作 右击菜单 树展现与操作 等等 更多的从用户角度考虑 二 二 PicassoWR 有哪些功能 有哪些功能 基础数据管理 操作用户与个人资料与密码维护管理 业务组信息 项目信息与执行机管 理 项目 产品模块 业务流程配置 场景 数据与项目 用户数据配置 自动化脚本分发 调度与执行与监控 分发执行机 log 收集 日志查询 发现问题归档功能 统一 Gem 包发布与部署 Pwatir 出错中文信息提示 页面上支持 excel 导入 原 driver Service 的改造 从而支持 excel 与 xml 配置文件的解 析与执行 2 三 三 PicassoWRPicassoWR 与我有何关系 我能为此做什么 与我有何关系 我能为此做什么 PicassoWR 毕加索自动化测试框架平台 基本是由两部分组成 一个是框架 W 提供对象识别 偏野兽派 一个是平台 R 偏印象派 提供 web 配置与调度功能 Picasso 毕加索 众所周知 20 世纪最伟大的 10 位画家之首 印象派与野兽派的结合 而且是活 着的时候看到自己的作品收藏到卢浮宫的 除此之外 PicassoWRv2 0 从一定意义上讲也是技术与 艺术的结合 使用如此框架平台 你会非常幸运 alibaba b2b QA 框架组在抛弃业界 Top 1 成熟 商业自动化工具 QTP 基础上进行开发 让你领略到在国内同行中少有的 完全自主开发的自动化 框架平台 有理由相信 我们可以尽可能的完全定制 符合你的需求 当然再完美的自动化测试 框架平台 也难免会出现瑕疵 也希望听到你在使用过程中的反馈建议 一起共同改进 让你在现 在与将来同样幸运和有机会 一直使用优秀的自动化测试框架平台 1 21 2此文档用途此文档用途 文档目标文档目标 给我给我 4040 小时 让你搞定自动化小时 让你搞定自动化 使用用途使用用途 大家从事自动化脚本开发时 偶尔会遇到环境 对象识别与操作 框架与平台使用操作 等等诸如此类方面的问题 建立此文档犹如向自动化脚本开发的每个同学提供 自动化宝典 可 以最快的时间在帮助文档中找到答案 1 31 3阅读对象阅读对象 自动化脚本开发工程师 高级 资深测试工程师 自动化脚本维护与运行工程师 1 41 4名词术语名词术语 业务组 指目前 b2b 各产品线测试组 比如中文站 核心站 国际站等 项目 指在自动化测试的被测系统或者项目 模块 指自动化测试的功能点的集合 Case 类 指使用 pwatir 框架开发的一个 Testcase 的子类 业务流 指一系列 Case 类的组合 1 1 51 5参考资料参考资料 无 2 第第 2 2 章章 环境搭建一键安装环境搭建一键安装 5h 5h 2 12 1安装包版本及功能说明安装包版本及功能说明 0 gem plugin 0 2 3 gem Gem 安装包自己插件 1 hpricot 0 6 164 x86 mswin32 gem 解析与操作 xml 文件 2 activesupport 2 2 2 gem 3 activerecord 2 1 2 gem 4 activerecord oracle adapter 1 0 0 9250 gem rails 组件相关的 gem 包 5 mysql 2 7 3 x86 mswin32 gem 6 ruby oci8 1 0 3 x86 mswin32 gem 支持 ruby 与 mysql 和 oracle 数据库访问的接口 7 pwatir 1 0 6 gem 用户 pwatir 安装包 8 parseexcel 0 5 2 gem 操作与解析 excel 文件 如 driverservice 中的解析场景与参数化数 据 9 echoe 3 0 2 gem ruby gems 打包工具 10 net ssh 2 0 6 gem 打通 ssh 通道并进行后台操作 如执行 linux 后台命令 11 rubyzip 0 9 1 gem 基于 ruby 环境下操作 winzip 文件 2 22 2如何搭建自动化运行环境如何搭建自动化运行环境 从 10 20 134 36 自动化打包文档 pwatir 安装 上获取执行环境一键安装程序 PicassoWR DEV exe 双击 PicassoWR DEV exe 安装 不要关闭 cmd 窗口 3 安装 ruby 将 next 进行到底 安装 jdk5 同样将 next 进行到底 如果已经安装点击取消 安装 netbeans 再次将 next 进行到底 4 安装 IEDeveloper 再再次将 next 进行到底 自动安装 ruby gems 及配置自动化环境 安装完成 cmd 窗口将自动关闭 安装完成后请进入环境变量设置 RUBYOPT rubygems 5 打开 netbeans 编写自动化脚本吧 2 32 3 如何用如何用 netbeansnetbeans 打开打开 autotestautotest 项目项目 打开 Netbeans 文件 F 打开项目 选择 PicassoWR DEV 安装目录 用 PicassoWR DEV exe 安装 PicassoWR DEV 参考问题 2 打开 autotest 项目 正式 或者 autotest temp 项目 临时 项目开发时用 2 42 4 NetbeansNetbeans 项目设置项目设置 1 切换 autotest 项目的 ruby 引擎 项目图标点鼠标右键 选择属性 选择运行 ruby 平台选择 ruby 1 8 6 p 为安装的 ruby 小版本号 2 查看 netbean 的项目属性 将项目的编码格式改为 GBK 6 2 52 5 如何设置如何设置 webblogweb