從指令行執行測試或排程

您可以從 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

下一步

在執行測試或排程之後，您可能想要匯出結果。如需相關資訊，請參閱自動匯出報告計數器。

意見