テスト結果の読み込み

スクリプト結果

Eggplant Functional records a lot of different forms of run data, such as suite statistics, run history, and log files. これら異なる種類のデータや、そのデータの考えられる使用方法を以下で説明します。

LogFile.txt

LogFile.txtファイルはプレーンテキストのファイルで、スクリプト実行の詳細なログと各ログエントリの行を含みます。ログエントリは次のタブで分離したフィールドを含みます。

• Date and Time.（日付と時刻。） ログエントリの正確な日付と時刻。
• Event Name.（イベント名。） 実行されたコマンドまたはファンクション、あるいは発生したイベントの名前。最後の行で、この値はSuccess（成功）またはFailure（失敗）となります。
• Image Name.（画像名。） このイベントに使用される画像の名前、またはタイプされたテキストです。
• Location.（位置。） The screen location where image hot spot was found; or other information.
• Line Number.（行番号。） ハンドラ内の行番号。
• Handler Name.（ハンドラ名。） このログエントリを作成するハンドラの名前。
• Script Name.（スクリプト名。） ハンドラを含むスクリプトのパス名。

RunHistory.csv

A RunHistory.csv file is a comma-separated text file that summarizes all of the executions of a script, with one line for each execution. このファイルの最初の行は各フィールドを特定します。

• Date Run.（実効日。） 実行した日付と時刻。
• Status.（ステータス。） 実行のステータス。
• Time.（時間。） 実行で経過した時間（期間）。
• # of Errors.（エラー数。） 実行中に発生したエラー数。
• # of Warnings.（警告数。） 実行中にログに記録された警告数。
• # of Exceptions.（例外の数。） 実行中に発生した例外の数。
• Log File.（ログファイル。） 実行のためのLogFile.txtファイルへのフルパス。
• Return Value.（返り値。） 実行しているスクリプトが返す値。
• Error Message.（エラーメッセージ。） 実行の最後のエラーメッセージ、失敗した場合。

このフォーマットは、Excelのようなスプレッドシートを含む多くのプログラムに読み込まれる可能性があります。The second item on each line (Status) is Success or Failure, so simply reading the last line of this file can be a simpler way to find out whether the latest run of a script succeeded, rather than digging into the LogFile.txt file in the individual run folder.

SuiteStatistics.csv

The SuiteStatistics.csv file is another comma-separated-value file, this time with one line for each script that has generated statistics. 各行のフィールドは：

• Script.（スクリプト。） スクリプトの名前
• Last Status.（最終ステータス。） このスクリプトの最新の実行に対するSuccess（成功）またはFailure（失敗）。
• Runs.（実行。） このスクリプトの実行のトータル数。
• Fails.（失敗。） 失敗に終わったスクリプトの実行数。
• First Run.（最初の実行。） このスクリプトが最初に記録された実行の日付と時刻。
• Last Run.（最後の実行。） このスクリプトの最新の実行の日付と時刻。
• Avg Time(Success).（平均時間（成功）。） 成功した場合の、スクリプトの実行に費やした平均の時間の長さ。（失敗した実行は今回は含まれていません。）

レポート結果

The CSV file format is very easy to import into a spreadsheet program, such as Excel. このセクションでは結果を処理する他の方法を幾つか説明します。

• RunWithNewResultsとResult（結果）。 See Running from a Master Script to observe a way to use the RunWithNewResults command and the Result() function to write results to a log.
• ScriptResults() このファンクションはどんなスクリプトにもRunHistory.csvファイルを返します。スクリプトはオープンスイート内になければならず、フルのパス名を指定する必要があります。
• SendMail. Used in conjunction with RunWithNewResults() or the scriptResults() function, SendMail can report the results of a test run by e-mail. Seethe Sendmail Command for more information.
• JSONFormat()およびJSONValue()。これらのファンクションは、テキストデータをJSONとSenseTalkフォーマットの間で変換して、他の処理での結果の通信に使用します。
• XMLRPCFormat()およびXMLRPCValue()。これらのファンクションは、テキストデータをXML-RPCとSenseTalkフォーマットの間で変換して、他の処理での結果の通信に使用します。

SenseTalkをレポートに使用

その他幾つかの結果レポートに有用な機能があります。それはSenseTalk Reference Manual（SenseTalkリファレンスマニュアル）：に記載されています。

• Merge()ファンクション。 このファンクションでHTMLやRTFフォーマットでのレポートのような、テンプレートを使っての高度にフォーマット化された文書を作成できます。
• File-reading and writing.（ファイルの読み込みと書き込み。） The file-reading and writing capabilities of SenseTalk can be used to write results to files on any file system that is mounted on the Eggplant Functional computer, including network mounted drives.
• URL access capabilities.（URLアクセス機能。） これらを使ってウェブインターフェース経由でリモートファイルにアクセスできます。
• Open Socket、Read From SocketおよびWrite To Socketコマンド。 これらのコマンドはスクリプトが直接ネットワーク上の他の実行中のプロセスと通信する事を許可します（ネットワークがソケットインターフェースを備えている場合）。
• Shell()ファンクション。 Shell()ファンクションはスクリプトがUnixコマンドを実行する事を可能にします。テスト結果の値を他のプロセスに送ったりすることもできます。
• DoAppleScriptコマンド。 This command can be used to interact with any AppleScript-able programs on the Eggplant Functional computer or other Mac OS X computers on the network. （Excelスプレッドシートに情報を追加したり、Word文書を生成したりといった使用方法を含みます。）

Viewing Results in Eggplant Manager

Eggplant Manager is the easiest and best way to collect and analyze Eggplant Functional test results.

This test management tool is a browser based application that provides a single point of control for Eggplant Functional suites. これはテストを定義する機能や、複数のテストの同時実行のスケジュール、また結果の集計と解析の中心位置を提供します。

To read more about viewing results in Eggplant Manager, see our documentation on the Eggplant Manager Dashboard and Viewing Test Results.