ATgo 概観

ATgo とは

ATgo とは次世代 WEB システム（UI/API）テスト自動化 RPA（Robotic Process Automation）です。

主に WEB システムのブラウザバリデーションテスト、レグレッションテストに特化したシステム開発効率化ソリューションです。マルチプラットフォーム対応、Windows、Mac はもちろん、スマホ iOS、Android にも対応しております。

ATgo 利用の流れ

1. スクリプト作成
   高度なプログラミング経験が不要、Web システムに対する操作を簡単なスクリプトとして自動的に記録されます。
   編集が必要な場合は、ATgo の IDE(統合開発環境)で記録されたスクリプトを簡単に編集できます。

2. 自動実証
   作成したスクリプトは、各種のテストを繰り返し再生できます。再生と同時に、エビデンスが自動的に取得されます。

3. 結果検証
   結果検証は、自動的に実施できます。

機能一覧

サポート対象テスト機能は UI テストと API テストの２種類があります。機能の概要は以下で説明します。

UI テストの機能

※ 基本機能のご利用は永久無料です。
※ プレミアム機能も 1 ヵ月の適用期間を提供しております。無料期間を経過した後、ライセンスのご購入が必要になります。
※ オプション機能は別途相談。

API テストの機能

※ プレミアム機能も 1 ヵ月の適用期間を提供しております。無料期間を経過した後、ライセンスのご購入が必要になります。
※ オプション機能は別途相談。

対応範囲

ATgo 起動

ATgo の起動

Windows でご利用の場合

実行環境

• Windows 10 日本語 (CPU Intel Core i3 2GHz 以上 メモリ 2G 以上 解像度 1366 x 768 以上)
• MicroSoft Office 2016 以上 日本語
• ディスプレイの拡大縮小とレイアウトを100%に設定

ATgo の起動

ファイル［ATgo.bat］をダブルクリックして、ATgo を起動します。
※ Windowsでファイル名拡張子が非表示の場合、起動ファイル名は[ATgo]になります。
※ WindowsのバッチファイルからATgoを呼び出す場合、[付録十二：ATgoをCUIモードで起動する方法]をご参照ください。

※ ATgoは多重起動ができません。
※ ATgoの実行中、テストに無関係な操作はお控えください。また、PC画面がロックかスリープ状態にならないようにご注意ください。

MacOS でご利用の場合

実行環境

• MacOS 10.15+ 64bit 日本語 (CPU Intel Core i5 1.6GHz 以上 メモリ 4G 以上 解像度 1366 x 768 以上)
• MicroSoft Office 2016 以上 日本語

初回の環境設定

1. 下記のコマンドを実行します。
   sudo spctl --master-disable
   
   

2. セキュリティとプライバシーを設定します。
   
   
   
   

   アクセシビリティに下記のアプリを追加します。
   
   ※上図の④をクッリクした後、ATgoパッケージの解凍フォルダ/jre/mac64/bin/javaを選択してください。
   ※ATgoパッケージフォルダの名前が変更され、場所が移動した際は、アクセシビリティに上記のjavaアプリを再度追加する必要があります。

3. ATgoの実行権限を付与します。
   MacOSのターミナルで下記のコマンドを実行します。

   cd ATgoパッケージの解凍フォルダ
   chmod 775 ./ATgo.sh
   chmod -R 775 ./jre
   

   

ATgo の起動

MacOS セキュリティポリシーのため、ATgo を初めて起動するときは、次の「１」と「２」の設定が必要です。２回目以降は「３」だけ必要になります。

1. ATgoを起動します。
   MacOSのターミナルで下記のコマンドを実行します。

   cd ATgoパッケージの解凍フォルダ
   ./ATgo.sh
   

   
   ※ ATgoは多重起動できません。
   ※ ATgo 実行中、テストに無関係な操作はお控えください。PC画面がロックかスリープ状態にならないようにご注意ください。

MacOS権限ダイアログの対応手順

1. ATgoを起動する時、「"java"で任意のアプリケーションからキー操作を受け取ろうとしています。」のダイアログが表示される場合、
   
   
   下記の設定をします。
   
   

2. テストを実施する時、「"java"でこのコンピュータの画面を記録しようとしています。」のダイアログが表示される場合、
   
   
   下記の設定をします。
   
   

ライセンスの登録

1. ATgoを起動し、上のメニューバーの[ヘルプ]から[ライセンス管理]を選択します。

2. ポップアップされたウインドウから[ライセンス登録]を選択します。

3. 登録するライセンスの種類を選択、必要事項を入力し「登録」ボタンを押します。
   

ローカルライセンス登録

通知されたライセンスキーをテキストボックス内にコピーして「登録」ボタンを押します。

サーバライセンス登録

IPアドレス・ポート番号・端末認証パスワードを入力し、「登録」ボタンを押します。

ATgo の GUI

※ トレースログ、エラーメッセージをコンソールに出力してあります。実行状況を確認する際は、コンソールへのご注目をお勧めいたします。

UI テスト

環境設定

ブラウザをリモートオートメーションするため、ブラウザの設定を行っておく必要があります。テスト要件に合わせるように設定してください。

Windows で利用の場合

ディスプレイの拡大縮小とレイアウトを100%に設定することが必要です。

IE ブラウザをご利用の場合

IEの設定手順

ATgoはIEブラウザを制御するため、次の手順を実行してください。

1. Internet Explorerを起動し、右上の「ツール」をクリックし、表示されたメニューから[拡大]を 100%に設定してください。
   
2. [インターネットオプション]をクリックします。
   
3. [セキュリティ]タブをクリックし、[セキュリティ設定を表示または変更するゾーンを選択してください]ボックスの中のゾーンを順次選んで、[保護モードを有効にする]のチェックをすべて外してください。
   
   
   
   
4. [詳細設定]タブをクリックし、[拡張保護モードを有効にする＊]のチェックを外し、[OK]をクリックします。
   
5. WindowsレジストリのInternet Explorer下でキーを新規することが必要ため、次の手順通りに操作してください。
   ATgoパッケージ解凍フォルダ中［depend/IEReg.bat］ファイルをダブルクリックしてください。
   ※ システム環境により、[IEReg.bat]は[IEReg]を表示する場合もあります。
   ※管理者権限が必要です。
   

※ 上記の操作後、PCのセキュリティ設定が変更されてしまいましたので、ATgoを使用完了後、セキュリティ環境回復ご希望の方は「IE設定の回復手順」をご参照ください。
※ IEブラウザ自体の原因により、自動テストする時、動作が不安定な場合があります。対策方法は「付録八：IEブラウザが動作不安定場合の対策方法」をご参照ください。

IE設定の回復手順

1. Internet Explorerを起動し、右上の「ツール」をクリックし、[インターネットオプション]をクリックします。
   
2. [セキュリティ]タブをクリックし、右下の「すべてのゾーンを既定のレベルにリセットする」をクリックしてください。
   
3. ATgoパッケージ解凍フォルダ中［depend/IEUnReg.bat］ファイルをダブルクリックしてください。
   ※ システム環境により、[IEUnReg.bat]は[IEUnReg]を表示する場合もあります。
   ※管理者権限が必要です。
   

Edge ブラウザをご利用の場合

Edgeを起動し、以下の通り画面を 100%に設定してください。

Chrome ブラウザをご利用の場合

Chromeを起動し、以下の通り画面を 100%に設定してください。

Firefox ブラウザをご利用の場合

Firefoxを起動し、以下の通り画面を 100%に設定してください。

プロキシ環境設定が必要な場合

ATgoのUIテスト部分のプロキシの設定手順は、Windows環境と同様ですので、Windowsのコントロールパネルで設定してくだい。手順は下記通りです。

MacOS で利用の場合

safari ブラウザをご利用の場合

1. Safariを起動します。
2. メニューバーから[Safari]をクリックし、[環境設定]をクリックします。
   
3. [詳細]タブの中の[メニューバーに“開発”メニューを表示]にチェックを外してください。
   
4. [Web サイト]タブの中の[ページの拡大/縮小]を選択し、右下の[これ以外の Web サイトでのディフォルト設定]を 100%に設定してください。
   
5. Safariのメニューバーから[開発]をクリックし、[リモートオートメーションを許可]を付けてください。
   
   ※ 上記の操作後、Safariのセキュリティ設定が変更されてしまいましたので、ATgoを使用完了後、セキュリティ環境回復ご希望の方はSafariの[リモートオートメーションを許可]を外してください。

プロキシをご利用の場合

ATgoのUIテスト部分のプロキシの設定手順は、MacOS環境と同様です。手順は下記通りです。

1. MacOSの「システム環境設定」を選択し、「ネットワーク」をクリックします。
   

2. 使用中のネットワークを選択し、「詳細」をクリックします。
   

3. 「プロキシ」タブをクリックし、プロキシを設定してください。
   
   

レコーディング(IEモード)機能をご利用の場合

レコーディング(IEモード)機能の設定手順

ATgoパッケージ解凍フォルダ中［depend/IERecorderReg.bat］ファイルをダブルクリックしてください。
※ システム環境により、[IERecorderReg.bat]は[IERecorderReg]を表示する場合もあります。
※管理者権限が必要です。

※ 上記の操作後、PCのセキュリティ設定が変更されてしまいましたので、ATgoを使用完了後、セキュリティ環境回復ご希望の方は「レコーディング(IEモード)機能の設定回復手順」にご参照ください。

レコーディング(IEモード)機能の設定回復手順

ATgoパッケージ解凍フォルダ中［depend/IERecorderUnReg.bat］ファイルをダブルクリックしてください。
※ システム環境により、[IERecorderUnReg.bat]は[IERecorderUnReg]を表示する場合もあります。
※管理者権限が必要です。

UIテストの前提知識

プロジェクトの構成

ATgoのプロジェクトツリーの構造を下図に示します。

３種類の基本的なファイルが含まれています。

• script ファイル
  テストの動作を記載するファイルです。 例えば、上図では、ログイン画面の操作が[ログイン.script]に記録されています。

• scenario ファイル
  テスト実施の基本単位です。複数のscriptファイルを呼び出すことが可能です。
  例えば、上図では、[テスト1.scenario]ファイルが3つのscriptファイルを呼び出し、ログイン、試験の申込、ログアウトというシナリオを実施します。

• xlsx ファイル
  テストの入力データを記載するファイルです。xlsxファイルはオプションのファイルであり、画面入力データとスクリプトを分離したい場合利用できます。
  例えば、上図では、試験申込み画面の入力データが[試験申込み.xlsx]に記載されています。

  上記の３種類のファイルの関係を下図に示します。
  

プロジェクト内の他のファイルの役割は以下の通りです。

UI テストのコマンド

コマンド紹介

ATgo では、ブラウザ、データベース、FTP、デスクトップ、スマホ、システムに関する各種コマンドを提供しております。

スクリプトの新規を説明する前に、よく使われるコマンドを示しておきます。以下に示すのは、スクリプトを作成するのに最もよく使われるコマンドです。

• OpenURL
  指定した URL を使ってページを開きます
• Click_ById
  ID で指定した Web ページの要素のクリック操作を実行します
• Click_ByName
  Name で指定した Web ページの要素のクリック操作を実行します
• Click_ByClass
  Class で指定した Web ページの要素のクリック操作を実行します
• Click_ByXpath
  Xpath で指定した Web ページの要素のクリック操作を実行します
• Input_ById
  ID で指定した Web ページの要素に値を入力操作を実行します
• Input_ByName
  Name で指定した Web ページの要素に値を入力操作を実行します
• Input_ByClass
  Class で指定した Web ページの要素に値を入力操作を実行します
• Input_ByXPath
  Xpath で指定した Web ページの要素に値を入力操作を実行します
• Input_Select_ById
  ID で指定した select 要素に指定した項目を選択操作を実行します
• Wait
  指定した時間で待ちます
• Evidence_Comment
  エビデンスの EXCEL にコマンドを追加します
• Evidence_BrowserScreen
  画面の可視エリアをスクリーンショットして、エビデンスの EXCEL シートへに貼付けます

※ すべてのコマンドの説明について、[付録一：UI テストコマンドの説明]をご参照ください。

コマンドの構文

ATgo のコマンドは下のように構成されます。

※ 「|」は区切り記号として使用されます。コマンド内容に「|」を含む場合、「\|」でご利用ください。

スクリプト作成

ATgo には二種類のスクリプト作成方法を提供しております。一つは初心者向けの[レコーディングブラウザ]、もう一つは開発経験者向けの[スクリプトエディタ]です。

• レコーディングブラウザ
  ユーザのブラウザ操作を自動的に script ファイルに記録します。
  
  ※ レコーディング機能で作成されたほとんどのスクリプトが自動再生できますが、スクリプト作成の支援ツールとしては、作成されたスクリプトが再生する時、偶に動作失敗になる可能性もあります。その場合は手動改修してください。
  ※ レコーディングブラウザのトップメニューにある「設定」で、レコーディング関係のオプション設定ができます。詳細については、「付録五：レコーディングオプション設定の説明」をご参照ください。

• スクリプトエディタ
  レコーディングブラウザ記録できないハイレベルのコマンドを追加できます。例えば、画面のスクリーンショット収集、データベース、FTP 操作など。

レコーディングブラウザで自動作成

説明するために、デモサイトの「試験申込み」を用意しております。URLは https://atgo.rgsis.com/demo/exam/
このサイトは三つの画面がありますので、これから三つのscriptファイルを一つずつ作成します。

• ログイン.script
• 試験申込み.script
• ログアウト.script

プロジェクト新規

1. [ファイル]下の[新規]の[UI テスト新規]をクリックし、作業フォルダー（中身は空白）を選択して、UI テストプロジェクトを新規します。
   

2. 下記のようなUIテストプロジェクトが作成されます。
   

3. [スクリプト1.script]ファイルを削除します。
   

4. 下記のように、[ログイン][試験申込み][ログアウト]三つのscriptファイルを新規します。
   ※スクリプト名はEXCEL形式エビデンスのファイル名とシート名に使います。
   ※スクリプト名には下記の文字は使えません。

   \ / : * ? " < > |
   

   ※スクリプト名には下記の文字が含まれている場合、特殊文字を削除したスクリプト名をシート名に使います。

   [ ] ' ： ￥ ／ ？ ＊ ［ ］ ’
   

   ※スクリプト名は31文字以上の場合、超える部分を削除して、シート名に使います。
   

レコーディングブラウザを起動

1. 「レコーディング」ブラウザを起動します。
   
   ※ ATgoでは三つのレコーディングブラウザを提供しております。機能はほぼ同じですが、ターゲットは違います。
   • レコーディング(Chromeモード)：Chromiumエンジンベースで実装、モダンWebシステム向けです。
   • レコーディング(IEモード)：IEエンジンベースで実装、旧Webシステム向けです。
   • レコーディング(Chromeプラグインモード)：Google Chromeプラグインとして機能します。
     ※ レコーディング(Chromeプラグインモード)については、[付録二十二：レコーディング(Chromeプラグインモード)の説明]をご参照ください。

ログイン.scriptの作成

1. ログイン.scriptをダブルクリックしてください。
   

2. [レコーディングブラウザ]のアドレスバーに下記のURL を入力して、キーボードの[Enter]を押します。
   https://atgo.rgsis.com/demo/exam/
   ※ ページのロードが完了した後、スクリプトのレコーディングをスタートします。
   

3. 「メールアドレス」の入力欄をクリックし、メニューがポップアップされます。 [Input]をクリックし、[Input_ById]をクリックした後、そのままで「test@test.com」を入力してください。
   
   

4. 「パスワード」の入力欄をクリックし、メニューがポップアップされます。
   [Input]をクリックし、[Input_ById]をクリックした後、そのままで「test」を入力してください。
   
   

5. 「ログイン」ボタンをクリックし、メニューがポップアップされ、[Click]をクリックし、[Click_ById]をクリックします。
   

試験申込み.scriptの作成

1. 試験申込み.scriptをダブルクリックしてください。
   

2. 「姓」下の入力欄をクリックし、メニューがポップアップされます。
   [Input]をクリックし、[Input_ById]をクリックした後、そのままで「六元素」を入力してください。
   同じく、「名」下の入力欄に[太郎]を入力してください。
   
   
   
   

3. 「申込み試験一覧」下のプールダウンセレクトボックスをクリックし、[C#試験]を選択します。
   

4. 「男性」左側のラジオボタンをクリックし、メニューがポップアップされます。 [Input]をクリックし、[Input_Radio_ByName_UseValue]をクリックします。
   

5. 「希望受験日」下の三つのプールダウンセレクトボックスをそれぞれクリックし、[2020年]、[5月]、[10日]を選択します。
   
   
   

6. [進学や能力証明に必要]の文字、または左側のチェックボックスをクリックし、メニューがポップアップされます。
   [Click]をクリックし、[Click_ById]をクリックします。
   

7. 「クーポン」下の入力欄をクリックし、メニューがポップアップされます。
   [Input]をクリックし、[Input_ById]をクリックした後、そのままで「EX2020」を入力します。
   
   

8. 「申込み」ボタンをクリックし、メニューがポップアップされます。
   [Click]をクリックし、[Click_ById]をクリックします。
   

ログアウト.scriptの作成

1. ログアウト.scriptをダブルクリックしてください。
   

2. 「ログアウト」ボタンをクリックし、メニューがポップアップされます。
   [Click]をクリックし、[Click_ById]をクリックします。
   

3. レコーディングが終わりました。[レコーディングブラウザ]を閉じます。

テスト1.scenarioの作成

以上の三つのscriptファイルを呼び出すために、scenarioファイルを作成します。

1. 「テスト1.scenario」をダブルクリックしてください。
2. 下記のコマンドを入力します。
   
   ※ 実施する時、スクリプトファイル内の_PROJECT_ROOT_は、自動的に[開いたプロジェクトのルートパス]に識別できます。

スクリプトエディタで手動作成

スクリプトエディタにコマンドの手入力よりスクリプトを作成します。
コマンド入力するとき、便利な[コマンド入力補完メニュー]と [UI テストコマンドパネル]を用意しております。

1. コマンド入力補完メニュー
   エビデンスに関するコマンドを追加したい場合、先頭文字[evi]を入力した後、コマンド入力補完のメニューが下図のように表示されます。
   例えば、[Evidence_Comment]コマンドを選択し、キーボードの[Enter]を押したら、[Evidence_Comment]コマンドが自動的に補完します。
   
   必要なパラメータを追記して、コマンドラインが完成します。例えば、[Evidence_Comment]の右側に[=試験申込み画面]を入力し、キーボードの[Enter]を押します。
   

2. UI テストコマンドパネル
   コマンドが分からない場合、UI テストコマンドパネルのコマンド説明を参照してコマンドを決めてください。
   例えば、エビデンスに関するコマンドを探す場合、ATgo の右側にある[UI テストコマンド]パネルに、[エビデンス]をクリックし、関連するコマンド一覧が表示されます。コマンドにマウスオンしたら、コマンド名、説明、書き方、サンプルが一目に表れます。内容よりコマンドを選択し、左クリックでエディターにドラッグすると、コマンドがエディターに自動的に入力されます。
   
   

   申込み完了画面のエビデンスを取得するため、下記のコマンドを追加してください。
   

   スクリプトが書き終わったら、 [保存]ボタンをクリックし、スクリプトを保存してください。
   

スクリプト再生

実行環境設定

1. [config.settings]ファイルをダブルクリックしてください。ブラウザ関するパラメータ値を下記のように改修します。
   
   
   ※ 基本的に下記のパラメータをテスト環境に合わせて修正する必要です。

   • platform
     OS の種類
   • browser_type
     ブラウザの種類
     ※ ie, edge, edgenew, chrome, firefox, firefox esr, edge_ie_mode, safari(MacOSのみ)を指定できます。
     ※ edge_ie_modeを指定した場合は[msedge.exe]のファイルパスも指定する必要があります。詳細は[付録十九：EdgeのIEモード]をご参照ください。
   • excel_version
     エビデンス出力のExcelバージョン
     ※ Excel2013及び前のバージョンのみが設定必要になります。

   ※ すべてのパラメータの説明について、[付録二：UIテスト設定ファイルの説明]をご参照ください。
   ※ IEブラウザが自体の原因より、動作が不安定な場合があります。対策方法は「付録九：IEブラウザが動作不安定場合の対策方法」にご参照ください。
   ※ スクリプトを長時間継続して再生した後、ブラウザが自体メモリ不足の原因より、動作ができない場合があります。この場合は、スクリプトの実行時間を短くし、または定期的にブラウザを再起動で対応できます。

再生

1. ATgo 左側の scenario ファイルをダブルクリックして、エディターのタブページを開いて、ツールバーの[実行]ボタンを押します。
   
   ※複数のシナリオを一括実行したい場合、ツールバーの[全て実行]ボタンを押します。
   
2. スクリプトが自動的に実行されます。コンソールにトレースログを出力してあり、実行状況を確認できます。
   

エビデンス

スクリプト実行完了した後、[output]フォルダーにエビデンスフォルダ[evidence]、検証フォルダ[inspection]が下図のように作成されます。
実行中のスクリーンショット画像、DB データ、FTP ログ、自動検証レポートなどの成果物の格納場所です。

[output]フォルダの構成は下図のとおりです。

1. エビデンスファイル
   
   ※ settingsファイルに[evidence_path]パラメータを設定し、保存先を指定することが可能です。
2. 結果検証するためデータ
   

デバッグ

ブレイクポイント設定

1. スクリプトの実行時にエラーが発生場合、一般的なプログラム開発 IDE と同様で、デバッグしてエラーを排除することができます。
   下図の通り、行先頭の空白をダブルクリックし、ブレイクポイントの設定や削除ができます。
   

デバッグ

1. 例で説明します。ATgo 左側の script ファイルをダブルクリックし、エディターのタブページが開かれます。次にツールバーの[デバッグ開始]ボタンを押します。
   
2. スクリプトがブレイクポイントまで実行する時、実行が一時停止されます。
   
3. 一時停止の状態で、[ステップ]ボタンをクリックすれば、ステップごとにデバッグできます。
   [継続]ボタンをクリックすると、スクリプトが続いて実行されます。

結果検証

検証データの作成

1. 手作業で確認された[検証データ]は[期待検証データ]として利用できます。下図のように、確認された[検証データフォルダ]をプロジェクトのルートディレクトリにある[expect]フォルダにコピーします。
   

2. 後続のテスト実行で[output]フォルダに出力した[検証データ]が[実測検証データ]と呼ばれます。結果検証機能を利用し、実測検証データを期待検証データと自動的に比較し、差異レポートを自動生成することができます。 新旧[検証データ]を比較することにより、再生結果の合否を判断します。

新旧検証

※ 新旧比較の前提として、実行環境が同様しなければいけません。OS の種類、ブラウザの種類、ブラウザのバージョン、高さ、幅、解像度など。
※ カーソルの有無で、新旧比較で不一致が生じる場合、[付録十一：文字カーソルの点滅速度の設定]をご参照ください。

1. ATgoツールバーの[UIテスト結果検証]ボタンをクリックし、結果検証パネルが表示されます。[期待検証データ]と[実測検証データ]を選択します。

• 期待検証データ
  プロジェクトのルートディレクトリの下の[expect]フォルダに比較したい[検証データフォルダ]を選択します。ここでは[テスト1]のフォルダを選択します。

• 実測検証データ
  プロジェクトのルートディレクトリの下の[output]フォルダに比較したい[実測検証データフォルダ]を選択します。

• ブロックサイズ
  ブロックサイズが小さければ小さいほど、比較結果の精度が高くなるが、より時間かかります。

• 色閾値
  色閾値が小さければ小さいほど、比較結果の精度が高くなるが、より時間かかります。

  

2. [検証]ボタンをクリックします。
3. レポートを確認します。
   
   
   

画像比較範囲の指定

検証対象としたくない情報（時間、日付など）がある場合、比較範囲除外することができます。
画像を部分的に比較したい場合、比較範囲指定することもできます。

上例の新旧比較で、「日付」の差分を無視することが可能です。

1. [期待検証データ]の格納されているフォルダに、「define.xml」ファイルを開く。
   ※ define.xml ファイルを[定義ファイル]と呼ばれます。
   
   ※ 各パラメータの説明は下記になります。

   • x：範囲の左上隅の開始点の X 座標。
   • y：範囲の左上隅の開始点の Y 座標。
   • width：範囲の幅。
   • height：範囲の高さ。

2. Windows の「ペイント」ツールを利用し、範囲指定用パラメータを取得が可能です。
   以下のように、除外する部分のパラメータを取得できます。
   
   

3. 修正後の「define.xml」は、以下のような感じです。
   

4. 変更した後、もう一回検証すると、差分がなくなります。

※ 修正必要なのは、[期待検証データ]の「define.xml」のみ、[実測検証データ]の「define.xml」が修正不要です。
※ 範囲指定は、一画像が一度のみ使用が可能です。
※ 範囲除外は、一画像が複数回が使用可能です。
※ 組み合わせ使用も可能です。

テキストファイルの比較

[UIテスト結果検証]機能を使うことで、html・csvなどのテキストファイルの比較が可能です。
※テキストにマスクをかけ、比較検証の対象から除外することもできます。

下記のシナリオを例として、テキストファイル比較機能の利用方法を説明します。

1. 1回目のスクリプト実行を行います。生成された検証データを「expect」フォルダへコピーします。

2. 再度スクリプトを実行します。生成された検証データを[実測検証データ]として、[UIテスト結果検証機能]を使い、1の操作によって生成された[期待検証データ]との比較を行います。

3. 検証結果レポートを確認したところ、差分があることが分かりました。検証の対象範囲から該当範囲を除外したい場合、4以降の操作を行います。

4. [期待検証データ]が格納されている「expect」フォルダ内の「define.xml」を開き、maskタグを使って除外範囲の指定を行います。
   このとき、[mask regex=""]と記述することで、正規表現を用いた範囲の指定が可能になります。
   ※maskタグは複数指定することができます。
   

5．4の操作の後、再度検証を行うと差分が消えていることが分かります。

PDFの比較

[UIテスト結果検証]機能を使うことで、PDFの比較が可能です。
※検証対象に含めたくない情報を除外することも可能です。

下記のシナリオを例として、PDF比較機能の利用方法を説明します。

1. 1回目のスクリプト実行を行います。生成された検証データを「expect」フォルダへコピーします。

2. 再度スクリプトを実行します。生成された検証データを[実測検証データ]として、[UIテスト結果検証機能]を使い、1の操作によって生成された[期待検証データ]との比較を行います。

3. 検証結果レポートを確認したところ、差分があることが分かりました。検証の対象範囲から該当範囲を除外したい場合、4以降の操作を行います。

4. [期待検証データ]が格納されている「expect」フォルダ内の「define.xml」を開き、比較範囲の指定を行います。
   画像比較範囲の指定と同様、Windowsの「ペイント」ツールを活用することで対象部分のパラメータを取得できます。
   このとき、パラメータはpdfからではなく、検証の結果出力された期待値の画像から取得できる点に注意してください。
   
   
   

   ※特定のページに対して範囲を指定・除外したい場合、「pageNo="ページ番号"」を設定してください。
   ※「pageNo=""」の場合、範囲の変更が全てのページに適用されます。

5. 4の操作の後、再度検証を行うと差分が消えていることが分かります。

データ分離より再生

データ分離機能によって、テストデータとテストスクリプトの分離を実現できます。
[試験申込み_外部データを利用するテスト.script]スクリプトと[試験申込み_外部データを利用するテスト.xlsx]データファイルを例として、機能説明します。

外部データ作成

UIテストサンプルの[試験申込み_外部データ利用]を例として、外部データの使用方法を説明します。

1. [ファイル]下の[新規]の[UIテストサンプル(試験申込み_外部データ利用)]をクリックして、作業フォルダー（中身：空白）を選択します。
   
2. [テスト1.scenario]ファイルをダブルクリックし、開きます。次は、外部データの指定と繰り返しグループについて説明します。
   

外部データの指定

RunScriptの第二引数は、外部データファイルのパスと実行番号を指定できます。 構文構成は以下の通りです。

RunScript=scriptファイルの絶対パス|外部データファイルの絶対パス:データ番号  

「データ番号」の指定方法は以下の例で説明します。
① 1：番号1のデータのみを実行する
② 2,3：番号2、3のデータを実行する
③ 1-4：番号1、2、3、4のデータを順次に実行する
④ 3-1：番号3、2、1のデータを順次に実行する
⑤ 1-2,3,6-10：番号1、2、3、6、7、8、9、10のデータを実行する
⑥ 1-4,2,5-10：番号1、2、3、4、2、5、6、7、8、9、10のデータを実行する
※ データ番号を記入しない場合は全て有効なデータを実行する

繰り返しグループ

[繰り返しグループ]機能を利用して、複数のRunScriptコマンドをまとめて、繰り返し実行することが可能です。コマンド[LoopGroup_Start]と[LoopGroup_End]を使って、繰り返しグループを指定できます。

上図のscenarioファイルの実行順序は以下のようになります。

RunScript=_PROJECT_ROOT_\script\ログイン.script|_PROJECT_ROOT_\data\ログイン.xlsx:1  
RunScript=_PROJECT_ROOT_\script\試験申込み.script|_PROJECT_ROOT_\data\試験申込み.xlsx:1  
RunScript=_PROJECT_ROOT_\script\ログアウト.script  
RunScript=_PROJECT_ROOT_\script\ログイン.script|_PROJECT_ROOT_\data\ログイン.xlsx:2  
RunScript=_PROJECT_ROOT_\script\試験申込み.script|_PROJECT_ROOT_\data\試験申込み.xlsx:2  
RunScript=_PROJECT_ROOT_\script\ログアウト.script  
RunScript=_PROJECT_ROOT_\script\ログイン.script|_PROJECT_ROOT_\data\ログイン.xlsx:3  
RunScript=_PROJECT_ROOT_\script\試験申込み.script|_PROJECT_ROOT_\data\試験申込み.xlsx:3  
RunScript=_PROJECT_ROOT_\script\ログアウト.script  

※ 繰り返し回数は、[繰り返しグループ]範囲内の外部データを指定した最初のRunScriptコマンドで指定します。上記の例の繰り返し回数は3回です。
※[缲り回しグループ]を利用し、色々な実行状況がありますので、「付録七：繰り返しグループの実例」をご覧ください。

「script\試験申込み.script」ファイルをダブルクリックし、開きます。 下図に、両端に[{{]と[}}]がつけている文字列は「データ名」です。
※ 画面の「入力項目」だけではなく、scriptファイルに「=」の右側の任意のパラメータは、[{{]と[}}]が付けられます。

・データ名
scriptファイルで[{{}}]を使用して「データ名」を指定します。スクリプト再生する時、指定した「データ名」で[外部データファイル]にそのデータ名に対応する値を検索し、スクリプトに読み込まれます。
※同一script内の「データ名」を重複しないように設定してください。

「data\試験申込み.xlsx」ファイルをダブルクリックし、開きます。

データの入力形式とファンクションを説明します。
① [データ番号]列（列A）：データ番号を設定できます。

• [データ番号]はデータのIDとして、必須な入力項目です。
• 1からの半角数字のみを記入してください。
• 番号は重複不可です。
• 上記以外の値を記入すると、無効データになります。

② [コメント]列（列B）：コメントをご自由に記入してください。
③ [データ]列（列C～）：scriptファイルの[姓]、[名]、[試験種類]と[性別]などの両端に[{{]と[}}]を付けたデータ名が自動的に青色セールに記入されます。

• 青色部分のデータ名のタイトルは変更可能です。
• スクリプトの可変値使用順の通りにデータ内容を設定します。

※ 「_SKIP_」をデータとして外部データファイルに入力すれば、そのデータが配置されている行のコマンドを実行しなく、直接にスキップします。

※ATgoは外部データファイルのプロトタイプを自動的に生成することができます。生成された外部データファイルはプロジェクトのルートディレクトリにある[data]フォルダに保存されます。自動生成の手順が下図の通りです。

外部データ再生

[テスト1.scenario]を選択し、[実行]ボタンをクリックして再生します。

再生後の出力フォルダは下図の通りです。

UI テストのその他のサンプル

DB テーブルの操作

1. settings ファイルのデータベースに関する環境を設定します。
   

2. script ファイルに、データベース操作の SQL コマンドを追加します。
   

3. 結果検証機能にて、DB データの新旧比較も可能です。比較する時、検証データ中での[define.xml]で正規表現で特定内容を対象外にする可能です。
   例えば、[2019-10-10]の日付を対象外にする
   
   ※ 複数の mask タグを指定できます。

FTP の操作

1. settings ファイルの FTP に関する環境を設定します。
   

2. script ファイルに、FTP 操作に関するコマンドを追加します。
   

3. 結果検証機能にて、FTP ログの新旧比較も可能です。比較する時、検証データ中での[define.xml]で正規表現で特定内容を対象外にする可能です。
   例えば、[2019-10-10]の日付を対象外にする
   
   ※ 複数の mask タグを指定できます。

変数

変数機能とは、一般的な開発言語と同様に、一時的にデータ格納が可能です。
例として、画面上の文字列を格納し、後のコマンドでパラメータ値として利用可能です。下記は変数のサンプルになります。

※ 変数のライフサイクルはグローバルであり、1回実行すれば、全てのスクリプト中で有効になります。

モバイルビュー

モバイルビューとは、PCのChromeブラウザでスマホ画面をテストが可能です。

1. メニューバーの[レコーディング]ボタンをクリックし、スマホモードを選択します。Web画面を操作し、スクリプトが自動的に作成されます。
   
   
2. config.settingsに下記のパラメータを設定します。
   
   
3. このスクリプトがモバイルビューで再生できます。
   
   
   

待機処理

待機処理とは、指定した時刻まで、または指定した要素が変化するまでスクリプトの実行を待機することです。
※ 待機処理関連のコマンド一覧は[付録一：UIテストコマンドの説明]をご参照してください。

1. [UI テストレコーディングブラウザ]のアドレスバーにテスト画面の URL を入力して、キーボードの[Enter]を押して、ページのロードが完了した後でスクリプトのレコーディングをスタートします。
   例えば、下記の画面をレコーディングする場合。
   URL： https://www.ag-grid.com/example.php
2. [Data Size]右側のプルダウンメニューをクリックし、[100000 Rows, 22 Cols]を選択します。
   
   
3. プルダウンメニュー右側がロードのアイコンが現れます。そのアイコンをクリックして、メニューがポップアップされます。[WaitFor]をクリックし、[WaitForElementNotPresent]をクリックします。
   ※ このコマンドで、100000件のデータがすべてロードされるまで待機します。
   
   
4. ブラウザで任意の場所をクリックし、メニューがポップアップされます。[Evidence]をクリックし、[Evidence_BrowserScreen]をクリックします。
   ポップアップされた入力欄に[100000Rows]を入力して、[OK]をクリックします。
   
   
5. スクリプトが自動的にエディターで作成されます。
   
   
6. スクリプトを再生して、エビデンス画像をチェックします。その画像は100000件のデータをすべてロードされた後に取得したスクリーンショットです。
   
   
   ※ 待機処理のタイムアウト時間は、config.settingsのbrowser_wait_timeoutで設定可能です。

アサーション

アサーションとは、スクリプト再生した動作結果が期待しているものと一致しているかどうかを検証することです。下記はアサーションのサンプルです。
※ アサーション関連のコマンド一覧は[付録一：UIテストコマンドの説明]をご参照ください。

検証結果が不一致の場合、コンソールでエラーが出て、実行が終了になります。
※ アサーションの結果をレポートとして出力する機能は開発する予定です。

ブラウザバリデーションテストの対応手法

ブラウザバリデーションテストとは、作成したWebアプリケーションがサポート対象の各ブラウザで動作を確認することです。

ブラウザによってレンダリング方式が変わりますので、スクリプトが同じであても、ブラウザ間の動作も違います。特にAngular等モダンWEBアプリケーションの場合は、複雑な画面要素のインデックスがブラウザごとに若干変わることもあります。

ブラウザバリデーションを実施する場合、最初疎通できたスクリプトを、ほかのブラウザ上で動作確認する必要があります。動作が異なる場合、スクリプトをコピーしてブラウザに合わせて修正します。

API テスト

API リクエスト、レスポンス検証を実装するスクリプトを用いて、API テストをバッチ的に実行します。

APIテストの前提知識

ツールの構成

下記の図のように、API 自動テストツールは下記の3種類のファイルがあります。

• feature形式スクリプト
  APIの呼び出し、レスポンスの検証などのコマンドを記載します。
  拡張子は feature となります。
• xlsx形式スクリプト
  APIの呼び出し、レスポンスの検証などのコマンドを記載します。
  feature形式スクリプトへ変換できます。
  拡張子は xlsx となります。
• データファイル
  スクリプトファイルに使った可変値の名及び値を記載します。
  拡張子は csv となります。

REST APIテスト

スクリプトの構文

スクリプトは Feature、Background、Scenario 三つの部分で構成します。

• Feature
  スクリプトの始まりとなることです。
  ※キーワード後に Feature 名は設定必須です。

• Background
  Scenario の前に、Scenario に使う共通変数を設定することです。
  その中に、ドメインという共通変数は設定必須となり、変数名は[url]です。

• Scenario
  API の呼び出し、検証の一連な動作を定義することです。一つのシナリオケースと相当します。複数のシナリオケースをテストする場合、複数の[Scenario]を並行に定義します。
  ※キーワード後に Scenario 名は設定必須です。

APIの呼び出し、レスポンスの検証を定義するため、特定なコマンドを利用する必要があります。
最も利用頻繁なコマンド：Given、When、Then、And を説明します。その他利用可能なコマンドは[付録四：APIテストキーワードの説明]をご参照ください。

• Given
  API をリクエストするため、必要な URL パス、リクエストヘッダー、リクエストボディを用意することです。
• When
  When method で HTTP メソッドを設定することです。
• Then
  API をリクエストして返した情報に対して検証内容を定義することです。検証対象として、HTTP ステータス、レスポンスボディの Json データなどは可能です。
• And
  Given、When、Then の中に、複数の定義内容を並行定義するキーです。

スクリプト作成

APIテストスクリプトの作成方法は二つあります。
一つ目はATgoが提供したExcel形式の動作記載ファイルで動作を定義し、実行可能なfeatureファイルに変換します。
二つ目は直接にエディターでfeatureファイルを書きます。
※ データ損失を避けるために、Excelから変換したfeatureファイルは直接に編集しないようにご注意ください。

Excelで作成

1. [ファイル]下の[新規]の[REST APIテスト新規]をクリックして、作業フォルダー（中身：空白）を選択します。
   
   

2. [シナリオ.xlsx]ファイルを開いて、動作を定義します。
   ※ 記入方法は[付録十四：APIテスト動作定義Excelファイルの記入方法]をご参照ください。
   

3. 記入した内容を保存し、[シナリオ.xlsx]を閉じます。
   ATgoツール左側のプロジェクトツリーの[シナリオ.xlsx]を右クリックし、[APIテストFeatureに変換]をクリックし、実行可能なfeatureファイル[シナリオ.feature]に変換します。
   ※ [シナリオ.feature]が既に存在している場合は、新しい内容に上書きされます。データ損失発生しないように、ご注意ください。
   
   

エディターで作成

1. [ファイル]下の[新規]の[REST APIテスト新規]をクリックして、作業フォルダー（中身：空白）を選択します。
   
   

2. [シナリオ1.feature]ファイルをダブルクリックして、開いたエディターに下記のコードをエディターにコピーしてください。

   # スクリプト名の設定
   Feature: シナリオ1
       
       # 共通処理： 各種設定
       Background: 
           # ドメインの設定
           * url 'https://atgo.rgsis.com/api/'
           # プロキシの設定
           # * configure proxy = { uri: 'http://my.proxy.host:8080', username: 'user', password: 'pwd' }
               
       # テストケース名の設定
       Scenario: 1-1 本作成のテスト
               # APIアドレスの設定
               Given path '/books'
               # リクエストのBodyの設定
               And request {'bookname' : '自動テスト入門', 'barcode': '1923055029001', 'price': 2200}  
               # 送信メソッドの設定
               When method POST
               # リスポンスコードの検証
               Then status 200
               # リスポンスのBodyの検証
               And match response == {'id' : 1, 'status' : 'OK'}
   

   ※ プロキシをご利用の場合、上記スクリプトの「* configure proxy」で設定してください。（前の「#」を削除することが必要です。）
   

3. [保存]ボタンをクリックし、スクリプトを保存します。

スクリプト再生

1. featureファイルを開いたまま、ツールバーの[実行]ボタンを押します。
   
2. [コンソール]に異常情報を出力したかどうかを確認します。
   

結果出力

スクリプト実行完了した後、[output]フォルダーにエビデンスフォルダ[evidence]、レポートフォルダ[report]が下図のように作成されます。

1. エビデンスファイル
   
2. レポート
   
   ※ EXCEL レポートはテストケースとして提出する可能です。
   ※ cucumber-html-reports/report_*.html レポートは詳細レポートです。エラー発生の時、デバッグ資料として利用することが可能です。
   ※ surefire-reports/timeline.html は性能評価のインプット資料として利用することが可能です。

サンプル説明

[ファイル]下の[新規]の[REST APIテストサンプル]をクリックして、作業フォルダー（中身：空白）を選択します。

個別 API テスト

サンプルファイル：[02_個別APIテスト.feature]

シナリオテスト

サンプルファイル：[03_シナリオテスト.feature]

レスポンス検証

サンプルファイル：[04_レスポンス検証.feature]

データ分離より再生

サンプルファイル：[05_外部データより再生.feature]

JWT認証

サンプルファイル：[06_JWT認証.feature]

手動テストツール

ATgo では、[Featureスクリプト]よりの自動テストの他には、[Restful API クライアント]よりの手動テスト機能を提供しております。手順は以下の通りです。

1. [Restful API クライアント]ツール起動
   ATgo メニューバーの[Restful API クライアント]ボタンをクリックします。
   
2. クライアント表示画面に、リクエスト情報を入力して、送信ボタンを押して、レスポンスを返されます。
   
   上図の ① ～ ⑧ ：
   ① HTTP メソッド
   GET/POST/PUT/PATCH/DELETE のどちらを選ぶ。
   ② API の URL パス
   テスト対象 API の URL を入力する。
   ③ ～ ⑥ リクエスト情報
   リクエストパラメータ、認証情報、ヘッダー情報、ボディにテストに必要な部分を設定する。
   図の例は Json 形式のボディデータだけを設定する。
   ⑦ 送信ボタン
   送信ボタンをクリックして API を呼び出す。
   ⑧ レスポンス表示域
   HTTP ステータス、レスポンスデータ形式、実行時間、レスポンスヘッダー、レスポンスボディなどを表示する。
3. 返した情報をもとに、予想通りであるかどうかを検証します。

gRPC APIテスト

スクリプトの構文

スクリプトは Feature、Background、Scenario 三つの部分で構成します。

• Feature
  スクリプトの始まりとなることです。
  ※キーワード後に Feature 名は設定必須です。

• Background
  Scenario の前に、Scenario に使う共通変数を設定することです。
  その中に、GrpcClientをインポートして、URIを指定したclientという共通変数は設定必須となり。

• Scenario
  メソッドの呼び出し、レスポンスの検証の一連な動作を定義することです。一つのシナリオケースと相当します。複数のシナリオケースをテストする場合、複数の[Scenario]を並行に定義します。
  ※キーワード後に Scenario 名は設定必須です。

  • メソッドの呼び出し
    client.call('パッケージ名.サービス名/メソッド名',ペイロード)

    # 経度と緯度により、位置情報を獲得
    * def response = client.call('routeguide.RouteGuide/GetFeature', "[{'latitude': 407838351, 'longitude': -746143763}]")
    

  • レスポンス処理
    JSONとして解析する：　def response = JSON.parse(response)
    コンソールに出力する：　print(response)
  • レスポンス検証

    # フル検証1
    * match response[0] == {"name":"Patriots Path, Mendham, NJ 07945, USA","location":{"latitude":407838351,"longitude":-746143763}}
    
    # フル検証2        
    * match response[0].name == 'Patriots Path, Mendham, NJ 07945, USA'
    * match response[0].location.latitude == 407838351
    * match response[0].location.longitude == -746143763
    
    # 一部検証
    * match response[0] contains {"name":"Patriots Path, Mendham, NJ 07945, USA"}
    
    # 複雑検証
    * assert response[0].point_count==2 && response[0].distance>60000
    

スクリプト作成

1. [ファイル]下の[新規]の[gRPC APIテスト新規]の[protoファイルインポート]をクリックして、[protoファイルインポート]のウィンドウが開かれます。
   
2. [protoファイルパス]と[新規プロジェクトの保存先]（中身は空白）を選択し、[完了]ボタンを押します。
   
3. xlsx形式のスクリプト、データファイルなどが自動的に生成されます。
   
4. [route_guide.xlsx]を開き、[ベースURL]と[テスト内容説明]を記入します。
   そして、テストしたいメソッドの行を[有効]に設定し、他の行を[無効]に設定します。
   記入完了後に、[route_guide.xlsx]を閉じます。
   
5. [route_guide.xlsx]を右クリックし、[APIテストFeatureに変換]をクリックします。
   feature形式のスクリプトが自動的に生成されます。
   
   
6. スクリプトに書いているデータファイルを開き、データを追加します。
   
   

スクリプト再生

1. featureファイルを開いたまま、ツールバーの[実行]ボタンを押します。
   
2. [コンソール]に異常情報を出力したかどうかを確認します。
   

結果出力

スクリプト実行完了した後、[output]フォルダーにエビデンスフォルダ[evidence]、レポートフォルダ[report]が下図のように作成されます。

1. エビデンスファイル
   
2. レポート
   
   ※ EXCEL レポートはテストケースとして提出する可能です。
   ※ cucumber-html-reports/report_*.html レポートは詳細レポートです。エラー発生の時、デバッグ資料として利用する可能です。
   ※ surefire-reports/timeline.html は性能評価のインプット資料として利用する可能です。

付録一：UIテストコマンドの説明

※山括弧<>内は必須引数で、角括弧[]内はオプション引数です。

付録二：UIテスト設定ファイルの説明

付録三：UIテストのキーコード

三種類のキーコードを対応しました。

1. 文字列
   任意の文字列を送信できます。

   Browser_SendKeys=This is a demo  
   Browser_SendKeys=こんにちは  
   SendKeys=This is a demo  
   SendKeys=こんにちは  
   

2. シングルの機能キー
   シングルの機能キーを送信できます。

   Browser_SendKeys={DOWN}  
   Browser_SendKeys={UP}  
   SendKeys={DOWN}  
   SendKeys={UP}  
   

   ※ 下記の機能キーを対応しました。

   キーコード	説明
   {BACKSPACE}	backspaceキー
   {DELETE}	deleteキー
   {TAB}	tabキー
   {UP}	upキー
   {DOWN}	downキー
   {LEFT}	leftキー
   {RIGHT}	rightキー
   {HOME}	homeキー
   {END}	endキー
   {ENTER}	enterキー
   {ESC}	escキー
   {INSERT}	insertキー
   {PGDN}	pgdnキー
   {PGUP}	pgupキー
   {PRTSC}	print screenキー
   {NUMLOCK}	numlockキー
   {SCROLLLOCK}	scrolllockキー
   {CAPSLOCK}	capslockキー
   {ADD}	addキー
   {SUBTRACT}	subtractキー
   {MULTIPLY}	multiplyキー
   {DIVIDE}	divideキー
   {COMMAND}	MacOSのcommandキー
   {WINDOWS}	Windowsのwindowsキー
   {CONTEXT}	Windowsのアプリケーションキー
   {SPACE}	spaceキー
   {F1}から{F12}まで	F1からF12までのファンクションキー
   {A}から{Z}まで	AからZまでのアルファベットキー

3. ショートカットキー
   ショートカットキーは一つの制御キーと一つの機能キーの組み合わせです。

   Browser_SendKeys=^{A}
   Browser_SendKeys=^{S}
   SendKeys=^{A}
   SendKeys=^{S}
   

   ※ 下記の制御キーを対応しました。

   キーコード	説明
   +	shift
   ^	ctrl
   %	alt
   ~	enter

付録四：APIテストキーワードの説明

付録五：レコーディングオプション設定の説明

レコーディングオプションの設定はレコーディングブラウザのトップメニューにある「設定」で行えます。

付録六：CSVデータをXLSXに変換する方法

[07_外部データを利用するテスト.csv]を例として、XLSXにの変換方法を説明します。

1. [ファイル]下の[新規]の[UIテスト新規(サンプル付き)]をクリックして、作業フォルダー[Lesson]（中身：空白）を選択します。
   

2. 旧CSVデータファイルの[07_外部データを利用するテスト.csv]をEXCELで開き、開けたデータシートの全部データをコピーします。
   
   ※ CSVファイルが文字化けした場合は先に正しく表示される文字コードを転換してください。
   ※ 日付データがある場合は、表示したいフォーマットを先に設定してください。

3. [07_外部データを利用するテスト.xlsx]のファイルをダブルクリックして開きます。
   

4. [データシート_FormatV1]シート黄色部分以外のデータを全部削除します。
   

5. 青色部分の一列目（セルC2）を右クリックします。
   [貼り付けのオプション]の二番目のボタンをクリックします。
   

6. 貼り付けたデータが順番にセットされます。
   

7. [データ番号]列に番号を記入します。
   

8. [07_外部データを利用するテスト.xlsx]を保存して、データ変換が完了します。

付録七：繰り返しグループの実例

[繰り返しグループ]の具体的な使い方を次の例で説明します。

1. 繰り返しグループの正しい使い方１

   RunScript=_PROJECT_ROOT_\script\ログイン.script  
   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:1-3  
   LoopGroup_End  
   RunScript=_PROJECT_ROOT_\script\ログアウト.script 
   

   実行順序は

   RunScript=_PROJECT_ROOT_\script\ログイン.script
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:1
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:2
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:3
   RunScript=_PROJECT_ROOT_\script\ログアウト.script
   

2. 繰り返しグループの正しい使い方２

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3 
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4-6  
   LoopGroup_End  
   

   実行順序は

   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:5
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:6
   

3. 繰り返しグループの正しい使い方３

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4  
   LoopGroup_End  
   グループの繰り返し回数が３回であるため、業務Bは番号４のデータを使って三回実行します。 
   

   実行順序は

   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4
   

4. 繰り返しグループの正しい使い方４

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx  
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx  
   LoopGroup_End 
   

   業務Bと業務Cはデータ番号を指定していないため、業務Aが指定したデータ番号を使います。

   実行順序は

   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:1
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx:1
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:2
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx:2
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:3
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx:3
   

5. 繰り返しグループの正しい使い方５

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務C.script  
   LoopGroup_End  
   

   実行順序は

   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:1
   RunScript=_PROJECT_ROOT_\script\業務C.script
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:2
   RunScript=_PROJECT_ROOT_\script\業務C.script
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:3
   RunScript=_PROJECT_ROOT_\script\業務C.script
   

6. 繰り返しグループの正しい使い方６

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4-6  
   LoopGroup_End  
   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx:2,3  
   RunScript=_PROJECT_ROOT_\script\業務D.script|_PROJECT_ROOT_\data\業務D.xlsx:1,4  
   LoopGroup_End  
   

   同じscenarioファイルで複数の繰り返しグループを使用できます。

   実行順序は

   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:5
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:6
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務D.script|_PROJECT_ROOT_\data\業務D.xlsx:1
   RunScript=_PROJECT_ROOT_\script\業務C.script|_PROJECT_ROOT_\data\業務C.xlsx:3  
   RunScript=_PROJECT_ROOT_\script\業務D.script|_PROJECT_ROOT_\data\業務D.xlsx:4
   

7. 繰り返しグループの正しい使い方７

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script  
   LoopGroup_End  
   

   データ番号を指定しない場合、外部データファイルにあるすべてのデータを利用して再生します。

   実行順序は

   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:2  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:3  
   ...
   

8. 繰り返しグループの誤った使い方１

   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4,5  
   LoopGroup_End  
   

   業務Aが三つのデータ番号が指定しましたので、業務Aと業務Bをグループっとして三回繰り返し実行するべきですが、業務Bが二つのデータ番号だけ指定しました。

9. 繰り返しグループの誤った使い方２

   LoopGroup_Start
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:1-3  
   LoopGroup_Start  
   RunScript=_PROJECT_ROOT_\script\業務A.script|_PROJECT_ROOT_\data\業務A.xlsx:4-6  
   RunScript=_PROJECT_ROOT_\script\業務B.script|_PROJECT_ROOT_\data\業務B.xlsx:4-6  
   LoopGroup_End  
   LoopGroup_End 
   

   繰り返しグループは入れ子にすることができません。[LoopGroup_Start]と[LoopGroup_End]をペアにしてください。

付録八：IEブラウザが動作不安定場合の対策方法

1. IEブラウザの[インターネットオプション]の画面を表示します。
   
   

2. ［詳細設定］タブをクリックし、［リセット］ボタンをクリックします。
   ［個人設定を削除する］にチェックを入れ、［リセット］ボタンをクリックします。
   
   

3. ［GPUレンダリングでなく、ソフトウェアレンダリングを使用する］にチェックを入れて、[OK]ボタンをクリックします。
   

4. [3.1.1. Windows で利用の場合]に記述した「ディスプレイの拡大縮小とレイアウトを100%に設定すること」が必要ですので、確認してください。

5. 動作中のブラウザ画面が他のウインドウに覆われた場合、動作中のブラウザウィンドウを最前面にしてください。

付録九：ブラウザのバージョン番号を確認する方法

1. Chrome ブラウザのバージョン番号を確認する方法
   
   
2. Edge ブラウザのバージョン番号を確認する方法
   
   
3. IE ブラウザのバージョン番号を確認する方法
   
   
4. Firefox ブラウザのバージョン番号を確認する方法
   
   
5. MacOS Safari ブラウザのバージョン番号を確認する方法
   
   

付録十：IEでロカールのHTMLを開く場合の設定

1. IEブラウザの[インターネットオプション]の画面を表示します。
   
   

2. ［詳細設定］タブをクリックし、[マイコンピューターのファイルでのアクティブコンテンツの実行を許可する] チェックボックスをオンにします。
   
   

付録十一：文字カーソルの点滅速度の設定

文字カーソルが点滅するため、入力欄がフォーカスされた状態で取ったスクリーンショットは、カーソルが表示される可能性も、表示されない可能性もあります。カーソルの有無で、新旧画像を検証する時差分が生じることもあります。
そのため、必要であれば、カーソルの点滅を回避することもできます。
Windowsで文字カーソルの点滅速度の設定方法は以下のようになります。

1. [コントロール パネル]を開きます。
   
   
2. [カテゴリ]をクリックし、[大きいアイコン]をクリックします。
   
   
3. [キーボード]をクリックします。
   
   
4. [カーソルの点滅速度]欄のつまみを一番左に動かし、カーソルの点滅をなしにする。そして、[適用]をクリックします。
   
   

付録十二：ATgoをCUIモードで起動する方法

ATgoのCUIモードを利用して、バッチファイルとタスクスケジューラなどからATgoを起動してテストを実施することが可能です。

構文

UIテスト

1. 単一のシナリオを実行する場合の構文
   ATgoCUI.bat <--project=プロジェクトフォルダー> <--run=単一のシナリオ> [--settings=設定ファイル] [--doInspection=true/false] [--expectedInspectionData=期待検証データフォルダー]
   ※「ATgoCUI.bat」はATgoパッケージの直下にあります。
2. 複数のシナリオを実行する場合の構文
   ATgoCUI.bat <--project=プロジェクトフォルダー> [--executionOrder=複数のシナリオの実行順番] [--settings=設定ファイル] [--doInspection=true/false] [--expectedInspectionData=期待検証データフォルダー]
   ※「ATgoCUI.bat」はATgoパッケージの直下にあります。

• --project
  プロジェクトフォルダーのフルパスを指定します。
• --run
  シナリオのファイル名を指定します。
  ※指定必須ではありません。
  ※指定しない場合、プロジェクトフォルダー直下にある全てのシナリオを名前順で実行します。
  ※シナリオファイルの拡張子は「scenario」です。
• --executionOrder
  複数のシナリオのファイル名を含むリストを指定します。リストの順番でシナリオを実行します。
  ※指定必須ではありません。
  ※「--run」が指定されていない場合のみ有効です。
  ※コンマ(,)でシナリオのファイル名を区切って、角括弧([])で囲みます。
  ※シナリオのファイル名がコンマを含む場合、ファイル名の両端に「\"」を付けてください。
• --settings
  設定ファイルのファイル名を指定します。
  ※指定必須ではありません。
  ※既定値は「config.settings」です。
  ※設定ファイルの拡張子は「settings」です。
• --doInspection
  テスト実行完了後に、自動的に結果検証を行うかどうかを指定します。
  ※指定必須ではありません。
  ※既定値はfalseです。
• --expectedInspectionData
  期待検証データフォルダーのパスを指定します。
  ※指定必須ではありません。
  ※既定値は「プロジェクトフォルダー\expect」です。
  ※絶対パスと相対パス両方指定できます。相対パスの場合は、プロジェクトフォルダーを基準にします。
• --license
  ATgoライセンスキーが記述されたテキストファイルのパスを指定します。
  ※指定必須ではありません。
• --licenseHost
  ATgoライセンスサーバに接続するIPアドレス、またはホスト名を指定します。
  ※指定必須ではありません。
• --licensePort
  ATgoライセンスサーバに接続する際のポート番号を指定します。
  ※指定必須ではありません。
• --licensePw
  ATgoライセンスサーバに接続する際のパスワードを指定します。管理者サイトの「端末認証パスワード変更」から変更可能です。
  ※指定必須ではありません。
• --ignoreComparisonError
  新旧比較を行う際に発生したエラーを無視するかどうかを指定します。
  ※指定必須ではありません。
  ※既定値はfalseです。

APIテスト

1. 単一のスクリプトを実行する場合の構文
   ATgoCUI.bat <--project=プロジェクトフォルダー>　<--run=単一のスクリプト>
   ※「ATgoCUI.bat」はATgoパッケージの直下にあります。
2. 複数のスクリプトを実行する場合の構文
   ATgoCUI.bat <--project=プロジェクトフォルダー> [--executionOrder=複数のスクリプトの実行順番]
   ※「ATgoCUI.bat」はATgoパッケージの直下にあります。

• --project
  プロジェクトフォルダーのフルパスを指定します。
• --run
  スクリプトのファイル名を指定します。
  ※指定必須ではありません。
  ※指定しない場合、プロジェクトフォルダー直下にある全てのスクリプトを名前順で実行します。
  ※スクリプトの拡張子は「feature」です。
• --executionOrder
  複数のスクリプトのファイル名を含むリストを指定します。リストの順番でスクリプトを実行します。
  ※指定必須ではありません。
  ※「--run」が指定されていない場合のみ有効です。
  ※コンマ(,)でスクリプトのファイル名を区切って、角括弧([])で囲みます。
  ※スクリプトのファイル名がコンマを含む場合、ファイル名の両端に「\"」を付けてください。
• --license
  ATgoライセンスキーを含むテキストファイルのパスを指定します。
  ※指定必須ではありません。

バッチファイルからの起動

下記はバッチファイルのサンプルです。

複数シナリオの一括実行

@rem テストプロジェクト直下の全てのシナリオを名前順で実行する
call D:\ATgoV8.3.1_Win64\ATgoCUI.bat --project=D:\テストプロジェクト
@rem 指定した実行順番でシナリオを実行する
call D:\ATgoV8.3.1_Win64\ATgoCUI.bat --project=D:\テストプロジェクト --executionOrder="[テスト1.scenario,テスト3.scenario,テスト2.scenario]"

複数ブラウザでのテスト実施

@rem IEでテストを実施する
call D:\ATgoV8.3.1_Win64\ATgoCUI.bat --project=D:\テストプロジェクト --settings=config_ie.settings
@rem Edgeでテストを実施する
call D:\ATgoV8.3.1_Win64\ATgoCUI.bat --project=D:\テストプロジェクト --settings=config_edge.settings
@rem Chromeでテストを実施する
call D:\ATgoV8.3.1_Win64\ATgoCUI.bat --project=D:\テストプロジェクト --settings=config_chrome.settings
@rem Firefoxでテストを実施する
call D:\ATgoV8.3.1_Win64\ATgoCUI.bat --project=D:\テストプロジェクト --settings=config_firefox.settings

※上記の四つの設定ファイルは全て「config.settings」をコピーして作成されたものです。
※「config_ie.settings」に「browser_type=ie」を設定します。
※「config_edge.settings」に「browser_type=edgenew」を設定します。
※「config_chrome.settings」に「browser_type=chrome」を設定します。
※「config_firefox.settings」に「browser_type=firefox」を設定します。
※ATgoのCUIモードを利用する場合のみ、設定ファイルの名前変更・指定が可能です。

タスクスケジューラからの起動

付録十三：Salesforceレコーディングの対応範囲と注意事項

対応環境

対応範囲

注意事項

1. ATgoは携帯電話のSMSを読み取ることができないため、Salesforceログイン時にSMS認証をオフにすることがおすすめです。

2. Lightning画面のスクリプトをレコーディング場合は、レコーディング機能をご利用ください。
   

3. Web画面上のキーボード「TAB」「UP」「DOWN」「ENTER」などの動作をレコーディングできないため、マウスを操作してください。

4. DateTimePickerなどのコンポーネントは、テキストで直接に入力してください。
   

5. レコーディング中は、シナリオと関係ない動作を操作しないでください。
   例：レコーディング時、シナリオが「カレンダー」タブに関連していない場合は、「カレンダー」タブを操作しないでください。
   

6. アイテム新規した後ランダムに生成された番号などを取得したい場合は、専用コマンド[SFL_Var_ElementText_ByXpath_UseLabel]をご利用ください。

   コマンド

   説明

   SFL_Var_ElementText_ByXpath_UseLabel=<%%ラベル名%%>|<要素のXpath>

   Xpathで指定した文字列を含む要素内のテキストを取得して変数に格納する ※ Salesforce Lightning画面レコーディング専用コマンドです。 ※ Xpathはラベル名により生成されます。

   レコーディング手順は以下の通りです。
   ① テキスト取得したい要素をクリックし、メニューがポップアップされます。[SFL_Variable]の[SFL_Var_ElementText_ByXpath_UseLabel] をクリックします。
   
   ② 入力ダイアログがポップアップされます。ラベル名を入力し、[OK]ボタンを押します。そして、コマンドが記録されます。
   
   
   ③ ラベルがない、または入力したラベル名が間違えた場合、入力した文字列が変数名として使用するのみです。Xpathの生成とは関係ありません。
   
   

7. ファイルのアップロード操作はレコーディングできないため、Input_File_ByXpathの書き方を参照し、手動でコマンドを書いてください。

利用前提

Lightning画面のレコーディング利用前提

Lightning画面のHTML要素のIDは画面表示する度に、動的生成されるため、毎回変わりますので、HTML要素のIDが使えなくなり、相対Xpathを利用してHTML要素を識別するようになっています。
Salesforceバージョンアップ時に、画面HTMLのレイアウト（タグ名、タグの階層、タグのテキストなど）が変更される場合、生成されたXpathも変わるため、スクリプトが再生できなくなる可能性があります。
下記の「引取先名」入力動作を例として説明します。

レコーディング機能を利用し、下記のようなスクリプトが生成されます。

例えば、Salesforceバージョンアップ時に、タグ名が

//div[normalize-space(string())="取引先名*"]/following::input