Robot Framework - Useful Parameters

指定測試案例

假設我們有A.html、B.html、C.html三種測試案例，但我不想全跑該怎麼辦? 如果只要執行A.html，我們僅需將檔案位置當參數傳入即可:

java -jar robotframework.jar A.html

如果想執行全部的，我們也不需要輸入A.html B.html C.html的方式，只要把資料夾當參數傳入即可:

java -jar robotframework.jar ./

指定輸出目錄 -d

使用相同的測試案例，但不同的瀏覽器如firefox與chrome，預設會將測試結果output.xml、result.html等產生到執行目錄下。我相信妳會非常希望將各別瀏覽器測試結果產生到各別目錄中，這時候可以透過-d的參數。

java -jar robotframework.jar -d firefox test.html

設定變數 -v

使用相同的測試案例，但其中某些要素是不同的情況，例如使用的db、browser。這時可以透過這個參數來設定，讓我們看看下面的範例:

${browserid} | Open Browser | ${LOGIN_URL} | ${BROWSER}

這是開啟瀏覽器的keyword，它需要開啟的URL與BROWSER。其中LOGIN_URL通常都是localhost，而BROWSER的部份可以透-v餵給testcasrs:

# ie
java -jar robotframework.jar -d ie -v BROWSER:ie test.html
# firefox
java -jar robotframework.jar -d firefox -v BROWSER:firefox test.html

設定使用的Library -P

假如有用到external libraies，如DB Library，可以透過這個參數設定使用到的jar檔:

java -jar robotframework.jar -d mysql -P dblibrary-2.0.jar:mysql.jar test_mysql.html

DB Library官網有提供另外一種方式可參考: https://github.com/ThomasJaspers/robotframework-dblibrary/blob/master/sample/startDBLibraryServer.bat。

過濾測試案例

robot提供選擇執行測試案例的功能，包含透過test suite/case name與tag的方式。對於test suite/case的部分，可以透過–test(-t)與–suite(-s)。 以下面這個輸入參數而言，代表要執行當前目錄下的testsuites中，testsuite名稱以Oracle結尾，且testcase名稱以basic或alternative結尾的測試案例。

java -jar robotframework.jar -d report -t *basic -t *alternative -s *Oracle ./

tag的部分透過–include(-i)與–exclude(-e)去過濾testcases。下面這個輸入參數代表著要執行tag為basic且不為alternative的測試案例。 如果要多個tag就使用多個-i or -e參數。

java -jar robotframework.jar -d report -i basic -i install -e alternative ./

如果以一個&或大寫的AND分開，代表是聯集的意思。如下面這個範例，必須要同時有basic與install tag的測試案例才會跑。

java -jar robotframework.jar -d report -i basicANDinstall -e alternative ./

查詢版本 --version

Robot更新還算頻繁，當你不曉得目前的版本號可以透過–version參數查詢:

java -jar robotframework.jar --version

Output:

Robot Framework 2.7.5 (Jython 2.5.2 on java1.6.0_29)

產生報表 rebot

假設output.xml為測試輸出檔，可以透過以下指令產生report.html:

java -jar robotframework.jar rebot output.xml

--removekeywords 與 --flattenkeywords

擷取自robot user guide:

rebot --removekeywords all --output removed.xml output.xml
robot --removekeywords passed --removekeywords for tests.robot
robot --removekeywords name:HugeKeyword --removekeywords name:resource.* tests.robot
robot --removekeywords tag:huge tests.robot

簡單來說，這是決定報表內容是否要能夠展開keyword下的其它keyword，針對不需要太詳細內容的keyword可以採用這方法；但output.xml還是會記著原始內容。

–removekeywords與–flattenkeywords兩者是搭配使用的。舉例來說，我會使用以下方式:

robot --removekeywords passed --flattenkeywords reserve* tests.robot

針對所有passed的測試都不展開，除了reserve開頭的keyword例外。