ride关键字的使用

一、工程、测试套和案例

为了方便管理测试案例，我们在创建测试案例时，必须知道这条案例是属于哪个产品（即项目），以及这个案例按照自己测试团队的要求，是要放在哪个测试套下，方便团队的管理和协作，具体的在项目中进行使用，这里不多说哈~
project：工程
suit：测试套
testcase：测试案例

二、小案例

1. 创建项目、创建套、创建案例（不进行详细步骤，可以去网上搜）

2. 编写代码
   

3. 执行程序：勾选需要执行的案例，确认执行配置为"robot"，点击Start
   

4. 查看测试执行报告
   
   
   备注：
   1、如果案例执行成功，则会案例会显示为绿色，执行失败，则为红色，还会展示执行成功案例数、执行失败案例数；
   2、如果在Arguments配置了有效的文件夹路径，则可以去对应文件夹查看log（执行日志）

三、关键字调用

1.调用导入库的关键字

在RF上，经常会用到导入的库（RF内置库或第三方库），可以通过按键F5或工具栏的[Tools]–>[Search Keywords]查看可以使用的关键字

1. 导入相关库
RF工具默认加载BuiltIn库，其他内置库或第三方库要自己导入，才能使用
导入方法：
以导入String库为例，选择案例所在测试套suit，在Edit页面中，点击Library，在弹出的窗口中，输入String，点击OK，若导入成功，则在Library模块列表中看到呈现黑色字体的库，若导入失败，则呈现为红色字体

2. 调用导入库的关键字
如下图：

代码：

*** Settings ***
Library           String

*** Test Cases ***
RFImportLibraryTestCase
 ${a}    Set Variable    hEllo,123woRLD!
 ${b}    Convert To Upper Case    ${a}
 log    ${a}
 log    ${b}

说明：
RFImportLibraryTestCase一共使用了3个关键字：Set Variable、Convert To Upper Case和log这3个，其中，Set Variable和log属于BuiltIn这个库，Convert To Upper Case是属于String库的关键字（可以使用Search Keywords【按键F5】进行确定）

3. 执行结果

2.调用用户关键字

1、用户关键字，就是自己写的，用于指定方式进行处理的操作，调用导入库不能满足这方面需求，主要用于测试产品的一些特殊处理情况或封装业务流程。相当于我自己碗里的菜就只有那几样，想吃别的菜怎么办？当然是自己做啦（或者拜托其他人做也行，嘿嘿）
2、用户关键字可以从2个位置进行编写：RF层、python层

以下按照如下例子进行讲解：
例子：在执行案例（testcase）时，需要将某个数值进行如下处理：字母全部大写，再连接“, hello world”

RF层

1. 创建用户关键字
   
   

2. 编写关键字
   

3. 调用关键字
   
   整体代码如下：

*** Settings ***
Library           String

*** Test Cases ***
RFUserKeywordTestCase
    ${value}    Set Variable    1aE3fe3
    ${value_change}    RFUserKeyword    ${value}
    Log    ${value_change}

*** Keywords ***
RFUserKeyword
    [Arguments]    ${val}
    ${temp}    Convert To Upper Case    ${val}
    ${temp_1}    Set Variable    ${temp}, hello world
    [Return]    ${temp_1}

5. 执行结果
   

Python层

1. 创建python脚本文件，编写代码
   PythonOperates.py

#!/usr/bin/python3

def pyUserKeyword(value=''):
   temp = value
   temp_1 = temp.upper()
   temp_2 = temp_1 + ', hello world'
   return temp_2

2. 设置python脚本文件能被python读取并加载
   该步骤类似于你去超市上厕所，总有指示牌告诉你怎么走，这个步骤就是让python能够找到你的文件，并加载你的脚本文件）

常用方法：
（1）存放到python的site-packages下；
（2）在site-packages下配置.pth文件，.pth文件里增加路径；
（3）在系统环境变量中配置（一般不推荐）

方法一：存放到python的site-packages下
python的库文件一般存放在site-packages下，所以python是一定会去site-packages目录寻找脚本文件（具体原因后面有空再讲）

RF导入python脚本，导入成功的话，可以通过Search Keywords查看导入的脚本文件中有哪些关键字可以使用


方法二：在site-packages下配置.pth文件，.pth文件里增加python脚本存放路径；


RF导入python脚本文件

3. RF调用关键字
   

*** Test Cases ***
PyUserKeywordTestCase
    ${value}    Set Variable    1aE3fe3
    ${value_change}    Py User Keyword    ${value}
    Log    ${value_change}

5. 执行结果