您可以從 Eclipse 工作區外的指令行執行測試或排程,以自動匯出結果。
開始之前
在 Linux 上執行測試或排程時,需要有 X Windows 伺服器,即使您是從指令行來執行測試或排程也一樣。如需相關資訊,請參閱從 Linux 的指令行執行測試。
註: 從 8.7.0.1 版開始,您可以從 Mac OS X 的指令行執行測試。
關於這項作業
如果要監視測試,您可以從 Web 瀏覽器存取報告。請參閱
從遠端存取報告註: 指令行沒有提供方法來指定用於資源監視的安全儲存體密碼。您必須在工作台提供密碼,並在嘗試從指令行執行排程之前,確定密碼已儲存且持續保存在排程中。
程序
- 如果要從指令行執行測試或排程,請移至包含 cmdline.bat 及 cmdline.sh 檔案的目錄。
在 Windows 作業系統上,這個目錄通常是 productInstallationDirectory/cmdline,例如 C:\Program Files\IBM\SDP\cmdline。 您可以將自動化測試 Script 指向此檔案,以執行測試或排程。
- 發出下列指令:
cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -schedule sched_rel_path -suite suite_rel_path -varfile variable_file_full_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite
{true | false} -quiet -users nn -vmargs JVM_args -exportlog log_full_path -exportstats stats_full_path -exportstatreportlist stats_list -usercomments "any
user comment"
如果值含有空格,請將值括在引號中。如果要查看此指令的線上說明,當您在包含 .bat 檔的目錄中時,請輸入 cmdline -help。
下表說明每一個選項:
選項 |
敘述 |
-workspace |
必要的。Eclipse 工作區的完整路徑。 |
-project |
必要的。相對於工作區的專案路徑,包括檔名。 |
-eclipsehome |
必要的。包含 eclipse.exe 的目錄完整路徑。 |
-plugins |
必要的。包含外掛程式的資料夾完整路徑。一般而言,在 Windows 作業系統上,此資料夾位置是 C:\Program Files\IBM\IBMIMShared\plugins。 |
-schedule |
選用,但您必須指定 -schedule 選項、-suite 選項或 -servicename 選項。
包括要執行之排程的檔名的路徑,相對於專案。 |
-suite |
選用,但您必須指定 -schedule 選項、-suite 選項或 -servicename 選項。
包括要執行之測試的檔名的路徑,相對於專案。 |
-varfile |
選用。包含變數名稱/值配對的 XML 檔完整路徑。 |
-servicename |
選用,但您必須指定 -schedule 選項、-suite 選項或 -servicename 選項。
要執行的服務名稱。不執行效能測試,而是執行變成可用的指定服務。 |
-serviceargs |
選用。傳遞至 -servicename 選項所指定服務的一連串引數。例如,-serviceargs
"-myserviceparm1 myserviceparm1value"。值用引號括住,是因為它們包含空格。 |
-configfile |
選用。包含測試或排程執行之參數的檔案完整路徑。每一個參數必須各佔一行。
如果要建立配置檔,請使用不換行的編輯器。任何參數,不論是必要的或選用的,都可以設定在配置檔中。指令行參數會置換這個檔案中的值。 註: 檔案必須為 UTF-8 格式。請勿在此檔案中使用引號,即使是包含空格的值也一樣。
|
-results |
選用。結果檔的名稱。預設結果檔案是有附加時間戳記的測試或排程名稱。指定相對於專案的資料夾名稱來儲存測試結果。例如,-results
folder/resultname。 |
-overwrite |
選用。決定是否改寫具有相同名稱的結果檔案。預設值 true 表示要改寫結果檔案。 |
-quiet |
選用。當執行或嘗試完成之後,會關閉來自啟動程式的任何訊息輸出,並回到指令 Shell。 |
-users |
選用。置換執行中的虛擬使用者的預設數目。
以排程而言,預設值是在排程編輯器中指定的使用者數目。以測試而言,預設值是一位使用者。
此選項建立一個包含所指定使用者數目之排程的新副本。 |
-vmargs |
選用。要傳入的 Java 虛擬機器引數。例如,-vmargs "-debug
-Xmx512m"。值用引號括住,是因為它們包含空格。 在雲端執行時,必須指定 -vmargs -Dcloudcostconfirm。使用這個引數會顯示執行成本。
|
-exportlog |
選用。其中儲存所匯出之 HTTP 測試日誌的檔案完整路徑。 |
-exportstats |
選用。其中儲存所匯出之統計報告資料的目錄完整路徑。統計報告資料是以逗點區隔值 (CSV) 格式儲存,其檔名是衍生自報告名稱。如果未指定 -exportstatreportlist 選項,則會匯出在「效能測試報告」喜好設定的「匯出報告」頁面上指定的報告。 |
-exportstatreportlist |
選用。使用 -exportstats 選項匯出統計報告資料時,要使用的自訂報告格式檔案(.view 檔案)的絕對路徑清單(以逗點區隔)。此參數置換工作區喜好設定。例如,-exportstatreportlist
c:/customreport.view,c:/customreport2.view。 |
-usercomments |
選用。新增用雙引號括住的文字,以便將它顯示在報告的「使用者意見」列中。 註: 在 Windows 上,如果要以不支援 Unicode 字元的原生語言來新增註解,建議您使用 CommandLine.exe 檔來執行指令。
|
註: - 除非您包括了 -quiet 選項,否則會顯示訊息,指出測試或排程何時啟動及何時完成。
- 發出指令會鎖定工作區。如果要在執行期間檢查測試或排程的進度,請呼叫另一個工作區,並透過該工作區開啟專案。
範例
註: 配置檔必須包含
option=
value 配對的資訊。
雖然在指令行上,包含空格的路徑必須以引號括住,但在配置檔中,請勿以引號含括空格。配置檔範例如下所示:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite
下一步
在執行測試
或排程之後,您可能想要匯出結果。如需相關資訊,請參閱
自動匯出報告計數器。