Update README.md

添加测试用例模板文件xml文件结构介绍
This commit is contained in:
pyqone 2020-08-02 18:15:26 +08:00 committed by GitHub
parent a351ce342e
commit 274a1b09c2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 67 additions and 0 deletions

View File

@ -19,7 +19,74 @@ autest的目标是使用代码来简化繁杂的测试工作让测试工作
### 1 测试用例编写工具
该工具是通过预先写好的测试用例文件模板调用其中添加内容的方法对测试用例进行编写之后再生成一个Excel文件以方便测试用例阅读与上传。当然看到这许多人就有疑问了既然最后要生成一个Excel文件那编写测试用例直接在Excel文档里写就好何必还要编写代码然后再生成呢的确在office的Excel软件中其可视化界面确实要比写代码要强很多但Excel软件也存在上下滚动不方便的缺点并且大家也清楚很多测试用例都可以复用在编写过程中难免会有大量的复制和替换的工作对于少量的用例还好一旦用例较多时复制用例后就容易遗漏需要替换文本的用例或者多复制用例导致编写出错。为解决这一类的问题所以我封装了一个测试用例编写工具将测试用例的编写工作由Excel向eclipse不要问我为什么不用IDEA有伤T_T转移当然缺点就是可视化差了一些。
测试用例工具暂时做了Jira用例模板故此处以Jira为例讲解工具的使用在最后再讲解测试用例模板的扩展。
#### 1.1 测试用例文件创建
在编写测试用例时,我们需要有一个存放测试用例的文件,之后在文件中编写测试用例,程序中也不例外,首先我们需要创建测试用例模板文件,该模板文件可以是自行创建,也可以是根据配置文件中编写的内容,通过程序进行创建,个人建议选择后者,因为我们创建的配置文件模板是符合我们在类中定义的字段位置的,若是通过自行创建的模板,此时可能遗漏字段或字段位置有误,导致程序失效。下面将介绍如何使用配置文件来创建测试用例模板。
首先配置文件采用xml的文件形式其内容主要是对测试用例模板文件中一些基本的参数进行配置例如行宽、字段名称、是否居中等等其结构如下
```xml
<?xml version='1.0' encoding='UTF-8'?>
<templet>
<sheet name='测试用例' freeze='2'>
<column id='标题' name='Name' wide='30.88' align='left'/>
<column id='步骤' name='Test Script (Step-by-Step) - Step' wide='45.75' align='left' row_text='1' index='true'/>
<datas id='优先级'>
<data name='High' />
<data name='Normal' />
<data name='Low' />
</datas>
<datas id='项目'>
<file path='JiraCaseFileTemplet/Jira数据有效性.xlsx' regex='Sheet1' column='0' start_row='1' />
</datas>
</sheet>
</templet>
```
配置文件中的标签解释如下:
- templet是根标签其不包含属性可包含多个sheet标签
- sheet标签表示其下的字段标签或数据有效性标签写入的工作簿位置该标签下可有多个column和datas标签其具有以下属性
| 属性 | 介绍 |
|-------------|------------|
|name|工作簿的名称,该属性必须存在|
|freeze|需要冻结的列数值为2表示冻结前两列若不写则表示不冻结|
- column标签表示需要生成到文件中的字段其具有以下属性
| 属性 | 介绍 |
|-------------|------------|
|id |程序中的标识符,在程序中填写内容时使用该字段作为传参,该属性必须存在|
|name|在测试用例模板中的字段名称,该名称不能作为程序中的传参,该属性必须存在|
|wide|字段在模板文件中所占的宽度,该属性必须存在|
|align|字段内容在模板文件中的对其方式有三个可选值left左对齐、center(居中对齐)、right右对齐该属性必须存在|
|row_text|字段每段内容在文件中所占的行数值为1表示每段内容在文件中占1个单元格一段一分行若无该属性则表示所有内容只写在一个单元格中|
|index|字段每段内容是否自动加上编号有两个可选值true创建编号、false不创建编号若无该属性则默认为false|
- datas标签表示写在sheet标签中的数据有效性内容可包含多个data和file标签其具有以下属性
| 属性 | 介绍 |
|-------------|------------|
|id|程序中的标识符,在程序中填写内容时使用该字段作为传参,该属性必须存在|
- data标签表示数据有效性的内容是直接写在xml文件中的数据有效具有以下属性
| 属性 | 介绍 |
|-------------|------------|
|name|数据有效性的内容,该属性必须存在|
- file标签表示数据有效性的内容该标签表示需要读取写在其他文件中的数据有效性可与data标签同时存在不会冲突具有以下属性
| 属性 | 介绍 |
|-------------|------------|
|path|文件所在路径支持word文件、excel文件、txt文件以及csv文件该属性必须存在|
|regex|内容切分规则若为excel文件则需要写入需要读取sheet名称若为文本文件则传入切分文件的规则对csv文件则无效该属性必须存在|
|column|需要读取的列,该属性必须存在|
|start_row|需要读取的起始行,该属性必须存在|
|end_row|需要读取的结束行,该属性必须存在|
***注意file标签所有属性完全参考 pres.auxiliary.work.selenium.datadriven.ListFileRead 类的内容支持的文件及参数介绍可查询该类的api***
```java
@Test
public void createCaseTemplate() {
}
```
```
#### 1.2 测试用例编写
#### 1.3 测试用例模板
##### 1.3.1 测试用例模板使用