套件（数据文件）文件中的表

套件（数据文件）文件中的表

RF 支持四种表，分别是 Settings，Variables，Test Cases，Keywords。表名必须出现在第一单元中。表名大小写不敏感（建议大写）。

• Settings 表

Settings 表，顾名思义，就是这个测试套件的全局配置表。比如，这个测试套件要使用的测试库，资源文件，测试套件的环境初始化（setup）和清除（teardown），该套件内容的标签等等。Settings 表范例如下:

*** Settings ***
Library  SomeLibrary
Suite Setup  Do something  ${MESSAGE}
Test Teardown  Open Application  App A
Test Teardown  Close Application
Force Tags  req-42
Default Tags   owner-john   smoke
Test Template  Example keywoed
Resource  myresources.html

Library 库的导入，Suite Setup、Test Teardown 初始化清除，Force Tags、Default Tags 就是加一些标签，Test Template 一些模板，Resource 一些资源。这些都是 **Settings ** 表里能支持的。我们先知道这里面能存哪些东西，后面我们都会用到。

Settings 范例如下

*** Settings ***
Library           SeleniumLibrary

*** Test Cases ***
百度搜索
    Open Browser    http://www.baidu.com    chrome
    Set Selenium Implicit Wait    5
    Input Text    id=kw    宋曲\n
    ${firstRet}=    Get Text    id=1
    Should Contain    ${firstRet}    宋曲 新书上传

百度搜索2
    Open Browser    http://www.baidu.com    chrome
    Set Selenium Implicit Wait    5
    Input Text    id=kw    你好\n
    ${firstRet}=    Get Text    id=1
    Should Contain    ${firstRet}    你好

比如说我在 Settings 表里面导入了一个 SeleniumLibrary ，那么在这个测试套件的文件里面。这个文件里面所有的测试用例都可以用到 SeleniumLibrary ，比如说 Open Browser 是属于它的，在百度搜索里面可以用，在百度搜索2里面也可以用。Settings 里面的声明在这一个测试套件的文件里面，它是一个全局变量。在这个文件里面，每个测试用例都可以用它。所有的用例都是有效的。

• Test Cases 表

Test Cases 表，用来定义这个测试套件的测试用例用例的。Test Cases 范例如下：

*** Settings ***
Library           SeleniumLibrary

*** Test Cases ***
My Test
    [Documentation]     Exaple test
    log     ${MESSAGE}
    My Keyword          /tmp
    
Another Test
    should be equal     ${MESSAGE}      Hello, word

下面的章节会详细讲解，现在我们只要知道它能定义多个测试用例就可以了。

• Variables 表
  Variables 就是这个测试套件的全局变量表。RF 里面的变量的作用和编程语言里面的作用类似。套件里面的测试用例将会用它们。Variables 范例如下：

*** Variables ***
${JOHN HOME}    /hoem/john
${JANE HOME}    /home/jane

关于变量的定义详细用法，比如怎么定义怎么写语法格式后面会详细讲解，这里大家先知道：定义变量就是为了在我们测试套件里面的测试用例将会用到它们就可以了。

• Keywords 表
  Keywords 表，是用来定义这个测试套件的用户关键字的。前面说过 RF 的关键字是由测试库实现的。但是很多 QA 不会 Python 编程语言，所以 RF 提供一个方式，可以将关键字组合起来，形成一个高级关键字，称为用户关键字。而测试库实现的底层关键字，称为库关键字。Keywords 范例如下：

*** Keywords ***
Open Login Page
    open browser    http://host/login.html
    title should be    Login Page
    
Title Should Start With
    [Arguments]    ${expected}
    ${title} =    Get Tile
    should start with   ${title}    ${expected}

比如说我们这里定义了一个关键字 Open Login Page 打开登录页面，这里面有两个 Robot 里面的关键字，一个是打开浏览器，第二个 title should be 判断打开的是不是登录界面，这是用户用 Robot 组合出来的关键字。这是一个简单的例子。

现在我们基本上了解了测试套件这个文件的大体的组成结构，简单的说它是由几张表组成的，它可以包含Settings 表、Test Cases 表、Keywords 表、Variables 表。下面我们重点关注一下其中的一张表，测试用例表。因为我们的测试用例就是写在测试用例表里面的。

测试用例表 语法

测试用例表就是用来定义测试套件里面的测试用例的。再来看一个例子：

*** Settings ***
Library           SeleniumLibrary    10    20
Library           Collections
Library           Dialogs



*** Test Cases ***
百度搜索1
    [Documentation]    测试百度搜索 宋曲
    Open Browser    http://www.baidu.com    chrome
    Input Text    id=kw    宋曲\n
    Set Selenium Implicit Wait    4
    ${firstRet}=    Get Text    css=div.result:first-of-type>h3
    Should Be Equal    ${firstRet}    宋曲
    Close Browser

百度搜索2
    [Documentation]    测试百度搜索 宋曲小说
    Open Browser    http://www.baidu.com    chrome
    Input Text    id=kw    宋曲小说\n
    Set Selenium Implicit Wait    4
    ${firstRet}=    Get Text    css=div.result:first-of-type>h3
    Should Be Equal    ${firstRet}    宋曲小说(皓月未央)
    Close Browser

这个测试用例表它的第一列就是测试用例的名称百度搜索1百度搜索2。用例的内容也就是它的测试步骤，就是从用例名开始到下一个用例名结束之前，这里面所有的内容都是百度搜索1这个测试用例所对应的测试步骤。

大家看一下，测试用例表里面的每个测试用例可以分成两部分一个叫配置部分一个叫主体部分。所谓主体部分就是用例一行一行的语句。那为什么测试用例还有一些配置呢？前面我们讲了测试套件文件有配置表，这个用例它自己也有配置表是不是觉得有点奇怪？我们刚讲了，如果是我们在测试套件上面 Settings 表里面有一些配置表，那用例里面里面也有它自己的配置表，它俩的有效范围是什么？因为我们测试用例本身自己也有一些独特的配置，如果我们定义在上面的话（Settings里面），这个配置就是所有用例的都用到刚才的那个配置。如果我定义在测试用例本身自己的用例里面的话，那它的有效范围只是在这个测试用例里面，而其它的测试用例是用不到这个配置的。

总结 配置表配置的有效范围是整个测试套件文件，也就是这个里面的所有用例，而用例的配置它的范围只在它自己。

那我们怎么配置格式是什么？比如说我们这里有个简单的例子 [Documentation] ，加个 [] 括号，首先大家看下它的位置。所有的配置名都在放第二列，也就是前面要有两个以上的空格。而且都要用方括号括起来，这样可以和关键字区分开来，它用方括号括起来之后大家可以看到这是一行 [Documentation] 的配置，我们还可以加一些 Tag ，比如说刚刚讲的这个里面。

image.png

这也是其中的一个匹配。后面会详细的讲有哪些常用的配置。

• 用例配置部分
  [Documentation] 该用例的文字说明、[Tags] 该用例的标签、[Setup]，[Teardown]该用例的初始化和清除操作、[Template] 声明该用例是模板关键字驱动的。本用例只包含测试数据、[Timeout] 该用例超时时间。

刚说了测试用例分为配置部分和主体部分，看完了配置部分，我们来看一下主体部分。主体部分也就是我们这个测试用例具体的步骤，我们用例的主体部分主要是由关键字组成，关键字决定了每一行做什么内容，这个关键字怎么来的呢？我们之前也讲了，它最主要的来源就是测试库，其实就是我们 python 的模块，通常对应了 python 的函数或者类的方法。还有一些库是我们自己提供，还有一些测试库是第三方提供的，还有一些是 Robot 自己提供的。比如这个例子里面：

*** Settings ***
Library           SeleniumLibrary

*** Test Cases ***
百度搜索
    Open Browser    http://www.baidu.com    chrome
    Set Selenium Implicit Wait    5
    Input Text    id=kw    宋曲\n
    ${firstRet}=    Get Text    id=1
    Should Contain    ${firstRet}    宋曲

Open Browser 就是由 SeleniumLibrary 提供的，Should Contain 就是 Robot 里面 BuiltIn 提供的，如果我们测试的场景没有现成的第三方库可以用，通常我们就自己开发，这个也是我们实际项目中经常做的一些事情