III. アプリ設定. 5

パート2：スタジオによるテストスクリプトの作成. 12

A. モバイルによるテストスクリプトの作成. 12

I. 前提条件の作成. 12

II. テストスクリプトの新規作成. 16

III. 複数のデバイスで1つのアクションのミラーリング. 40

IV. 測定定規. 42

パート3：テスター4.0でのスクリプト実行. 43

A. モバイル用のテストスクリプト実行. 43

I. プロジェクトの実行可能ファイルの設定. 43

II. スクリプト実行・テスト結果確認. 44

III. テストスクリプトのインポート・エクスポート. 59

パート1：はじめに

ATOMP：ユーザーはテストスクリプトを作成し、複数のデバイスでテストを自動的に実行できます。

スタジオ:ユーザーのデバイス操作に基づき、テストスクリプトを自動的に生成するのに役立ちます。

A. モバイルによるATOMP使用の開始

I.基本概要

手順1：プロジェクトの新規追加（テスター4.0）

https://tester40.atomp.io/へログインします。
ダッシュボードが表示されたら、「プロジェクト追加」をクリックします。
新しいプロジェクトの名前を入力し、タイプを設定します。
「プロジェクト新規作成」ボタンをクリックし、新しいプロジェクトの作成を完成させます。

タイプが共通の場合

II. アプリのインストールと再起動

デバイス選択画面にて、ユーザーは1つまたは両方を選択できます。

デバイスへのアプリのインストール：テスター4.0画面で、ユーザーがAPKとIPAをインストールしてからこの項目をクリックすると、アプリケーションがデバイスに自動的にインストールされます。
実行中のアプリのリセット：ユーザーがこの項目を選択すると、テストされたアプリがホーム画面にリセットされます。

1. WEB_VIEW

デバイス選択画面にて、ユーザーは、NATIVE_APPまたはWEB_VIEWを選択してテストスクリプトを作成できます。

iOS用WEB_VIEW：「アプリ設定を選択してください」テキストボックスでWEB_VIEWを選択します。

テストタイプがWEB_VIEWとして選択した後、対応するデバイスを選択します。その時、ストリーミング画面でスタジオ画面がサファリを開いた状態で表示されます。

スタジオ画面にて、「ウェブ」→「ナビゲーション」をクリックして、メニューの右側にあるURLに移動することで、テスト対象のURLを開けます。URL取得のポップアップが表示されたら、テキストボックスにURLを入力して、「アクション実行」ボタンをクリックします。（URLを開く手順を保存するには、事前に記録する必要があります）。

デバイスがWEB_VIEWに切り替わらない場合、ユーザーはデバイスファームに移動し、WEB_VIEWに切り替える正しいデバイスを選択して、「Webインスペクター」を有効にします。

Android用WEB_VIEW：「アプリ設定を選択してください」テキストボックスで、NATIVE_APPを選択してください。

テストタイプがNATIVE_APPとして選択した後、ユーザーは対応するデバイスを選択します。スタジオ画面がNATIVE_APPで表示されます。WEB_VIEWに切り替えるには、まず、「デバイス」→「アンドロイドのアクティビティ」→ 「アクティビティ開始」をクリックして、Chromeを開きます。「アクティビティ開始」ポップアップが表示された後、「アプリパッケージ」と「アプリのアクティビティ」に入力して「アクション実行」ボタンをクリックします（URLを開く手順を保存するには、事前に記録する必要があります）。
・アプリパッケージ: com.android.chrome
・アプリのアクティビティ : com.google.android.apps.chrome.Main

Chromeを開いた後、ユーザーはスタジオ画面で「内容変更」をクリックしてWEB_VIEWに切り替えます。その時、内容変更のポップアップが表示され、WEB_VIEW項目をクリックして変更します。

2. NATIVE_APP

***「パート2：モバイルによるテストスクリプトの作成」の「A.スタジオによるテストスクリプトの作成」をご参照ください。

3. WEB_VIEW (iOS)によるテストスクリプトの作成

手順1：デバイスをWEB_VIEWとして選択します。

手順2：テスト対象のURLを開きます。

手順3：WEB_VIEWを使用してテストスクリプトを作成する場合、ストリーミング画面ではNATIVE_APPによりテストスクリプトを作成した場合と異なってエレメントが強調表示されません。そのため、ユーザーはソースコードでエレメントを検索するか、ウェブサイトを調べてからスタジオでソースを検索する必要があります。

手順3.1：属性のテキストボックスにテキストを入力してエレメントを検索します。

手順3.2：テストしたウェブで検査し、クリックしたいエレメントのIDまたはxpathをコピーします。

手順4：エレメントが見つかった後、ユーザーは通常通り、スタジオでのアクションを使用してテストスクリプトを作成します。（「パート2：スタジオによるテストスクリプトの作成」をご参照ください。）

*** WEB_VIEWを使ってAndroidでテストスクリプトを作成することは、iOSで作成したことに似ています。

パート2：スタジオによるテストスクリプトの作成

A. モバイルによるテストスクリプトの作成

I. 前提条件の作成

前提条件は、同じ前提条件を持つ複数のスクリプトに使用できます。以下の手順に従って実施してください。

手順1： 「テストの前提条件管理」ボタンをクリックします。

手順2： 「前提条件追加」ボタンをクリックします。

手順3：前提条件の作成を開始するためにデバイスを選択します。

手順4：親の前提条件を選択します。（該当する場合）

手順5：「スクリプト記録」ボタンをクリックし、前提条件の手順を作成する記録モードに切り替えます。

前提条件を選択した後、「スクリプトプレビュー」ボタンが表示されます。「スクリプトプレビュー」ボタンを選択し、前提条件を実行します。（手順 10、11 に従ってください）

手順6：デバイスストリーミング画面からエレメントを選択し、アクションを実行します。

手順7：実行対象の適切なアクションを選択し、実行された手順がその下に記録されます。

手順8：「停止」ボタンをクリックし、「スクリプトプレビュー」]ボタンが有効になります。

手順9：「スクリプトプレビュー」ボタンをクリックし、作成されたすべての手順を表示・試行します。

手順10：「すべて実行」ボタンをクリックし、全ての前提条件を実行します。

手順11：「スクリプト実行」ボタンをクリックし、記録された手順を1つずつ実行します。スクリプト実行後、デバイスストリーミング画面には、記録された手順が実行されることを直接確認できます。手順のステータスは、各手順の最後に表示されます。

手順12：「戻る」ボタンをクリックすると、「スクリプト作成」画面が表示されます。次に、「保存］ボタンをクリックします。

手順13：「前提条件を名前を付けて保存」ポップアップが表示され、保存したい前提条件の情報を入力します。入力後、「保存」ボタンをクリックすると、この前提条件が「前提条件管理」画面に保存されます。

II. テストスクリプトの新規作成

スクリプト作成画面は以下の手順で表示されます。「テストスクリプトマネジメント」項目をクリックし、「ATOMPスタジオによる作成」ボタンをクリックし、任意のデバイスを選択します。

1. CSVファイルのアップロード（必要の場合）

ユーザーは、2行のデータ（キーと値のペア）を含むCSVファイルをアップロードし、それらのペアを ATOMPスタジオ内の変数として使用できます。

「事前定義のアクション」タブから、「CSV外部入力」の「拡大」ボタンをクリックし、CSVファイルをアップロードする「アップロード」ボタンをクリックします。

CSVファイルのフォーマットは以下の通りです。（A列：変数名、B列：値）

CSVファイルのアップロード後、ユーザーはテストスクリプトを作成する時、任意のテキストボックスに「$+変数名」と入力することで、これらの変数を使用できます。

2. 「記録」モードへの切り替え

テストスクリプトの作成を開始するために、「スクリプト記録」ボタンまたは目のアイコンをクリックすることで、「記録」モードに切り替える必要があります。以下は記録モードのサンプルになります。

ユーザーは画面のエレメント（アイコン、ボタン、テキストなど）を選択し、アクションを実行できます。

3. 前提条件の選択

手順1: スクリプト作成画面にて「新規追加」ボタンをクリックします。

手順2: プロジェクトの前提条件リストから1つ又はそれ以上の前提条件を選択します。

➪ スクリプト実行時、選択した前提条件が上から下の順番に実行されます。選択済みの前提条件リストは以下のように表示されます。

4. テスト手順の作成

手順1：「エレメント選択」モードに切り替えます（アイコンクリック）。

手順2：ストリーミング画面で１つのエレメントを選択します。

手順3：手順 2 で選択したエレメントで実行したいアクションを選択します。

選択したエレメントがアイコンまたはボタンの場合、使用可能なアクションはタップ、ダブルタップ、長押しです。
選択したエレメントがテキスト入力ボックスの場合、「キー送信」ボタンをクリックしてエレメントにテキストを入力します。

手順4：アクションが「キー送信」の場合、ユーザーが文字を入力するためのポップアップが表示されます。

→1つのアクションを実行した後、ツールはそのアクションのテストスクリプトを自動的に生成し、手順として表示します（下の図をご参照ください）。

5. 期待値の作成

手順1：ストリーミング画面で確認対象のエレメントを選択します。

手順2：「プロパティ」ボックスには、選択したエレメントのプロパティが表示されます。そこでプロパティを選択し、期待値を作成します。

画面のUIを確認したい場合は、「期待値」列内のカメラアイコンを選択し、今後の比較の参考として画面をキャプチャします。

AIビジュアルチェックを使用したい場合は、アイコンを選択して、ビジュアルイメージを比較するAIビジュアルチェックの期待結果を追加します。これにより、テストの精度を高め、工数を軽減できます。AIビジュアルチェックは、将来のテストのための視覚的な参照として画面をキャプチャし、リグレッションテスト時に、実際の画面がキャプチャ画面と異なる場合にお知らせします。

マウスをドラッグして、どれが動的データか確定し、それが目視比較で除外されます。その後、「OK」ボタンをクリックして期待結果を保存するか、アイコンをクリックして選択済みのデータ領域を削除します。

2. パート1に従って、「期待結果」の画像参照のリンクをクリックして、選択済みのデータを再表示するか、編集することもできます。AIビジュアルチェックの期待結果を削除する場合は、アイコンをクリックします。

ユーザーはテスター4.0 の「テスト結果」ページでエビデンスを見ることができます。

システムは、期待結果を確認する時にエレメントの画像を比較することもサポートします。以下の手順に従って実施してください。

ストリーミング画面のエレメントをクリックしますàカスタムプロパティのテキスト「画像」の横にある「+」ボタンをクリックします。

そうすると、「画像比較」ポップアップが表示されます。ポップアップには2つのオプションがあります。
・画像のアップロード：画像（JPG、JPEG、PNG形式）のアップロードを許可します。
・現在画像の使用：現在のスクリーンショットを自動的にキャプチャし、エレメントの位置に基づいて、そのエレメントの画像を自動的にトリミングできるようにします。

オプション1：画像のアップロード

まず、「画像アップロード」タブをクリックしてから画像ファイルを選択し、「OK」をクリックします。画像を選択するとその画像がATOMストレージにアップロードされます。既存の画像がある場合は、新しくアップロードされた画像が古い画像に置き換わります。→アップロード後、追加された期待結果＜エレメント＞は＜アップロードされた画像のファイル名＞と同じように表示されます。

オプション2：現在画像の使用

ボタンをクリックして現在のエレメントの画像を参照として使用し、「OK」ボタンをクリックします。画像は期待結果として使用されます。

6. IF – THEN – ELSE 機能

手順1：「IF」ブロックを追加します。

「事前定義のアクション」タブにて、拡大用の「コマンド」メニューをクリックします。
「条件」サブメニューを拡大します。
「IF文」をクリックしてスクリプトにIFブロックを追加します。

➪その後、新しいブロックが記録されたスクリプトセクションに表示されます。

1) にカーソルを合わせて、メニューを開きます。

「条件追加」をクリックして現在の「IF」ブロックに新しい条件を追加し、上記のように入力フォームが開かれます。
- 「サブ-IFの追加」をクリックし、現在のブロックに「サブ-IF」ブロックを追加します。
- 「ELSE IFの追加」をクリックし、現在の「IF」ブロックの後に「ELSE IF」ブロックを追加します。
- 「ELSEの追加」をクリックし、現在の「IF」ブロックの後に「ELSE」ブロックを追加します。
- 「ブロック削除」をクリックし、現在のブロックを削除します。「IF」ブロックを削除すると、それに属するすべての「ELSE IF」および「ELSE」ブロックも削除されます。アクションが実行される前に確定する必要があります。

2) をクリックし、現在のブロックでの作業を停止します。

3) をクリックし、現在のブロックでの作業を停止し、をクリックしてブロックで作業をします。（ブロックをピン留め／ピン留め解除）。

4) 条件を削除します。

5) 条件を編集します。

6) 論理演算子（ブロックに2つ以上の条件がある場合に使用します。）

7) 比較操作を行うエレメントです。

8) エレメントのプロパティ（条件を保存するために指定する必要があります）

9) オペレーター

10) 比較する値（デフォルトはエレメントのプロパティ値）

11) クリックして条件を保存します。

12) クリックして条件の入力をキャンセルします。

13) ブロックアクション（条件が満たされた場合に実行されます）IF – THEN –ELSE関数のユースケースについて

IF – THEN –ELSE関数のユースケースについて

比較操作を行うためにエレメントまたはプロパティを選択せずに条件を追加すると、次のようなメッセージが表示され、ユーザーがエレメントとプロパティを指定するまで条件は保存されません。

すべての「IF」 – 「ELSE IF」ブロック条件を削除すると、ブロック条件が空であることをユーザーに知らせる次の通知が表示されます。

1つの条件を含まない「IF」 – 「ELSE IF」ブロックで作業している場合、スクリプトは記録されず、以下の通知が表示されます。

「IF」 – 「ELSE IF」ブロック内の条件が空であるスクリプトを保存しようとすると、スクリプトは保存されず、次のようなエラーメッセージが通知されます。

IF – THEN –ELSE関数でのスクリプトプレビュー

条件を満たさないすべての「IF」、「ELSE IF」、「ELSE」ブロックは無視され、上記のようなエラーメッセージが表示されます。
「IF」 – 「ELSE IF」ブロック内の条件が空であるスクリプトをプレビューすると、条件が空のブロックでスクリプトが中断します。

7. テスター4.0でエビデンスを取得するための手順選択の機能

手順1：テスター4.0で実行する時にエビデンス取得を対象とする手順の（テストスクリプトの最後の列にある）チェックボックスにチェックを入れます。

手順2：スプリントが完了した後、「エビデンスダウンロード」ボタンをクリックし、手順1でチェックマークを付けたエビデンスを取得します。

ユーザーはテスター4.0 の「テスト結果」ページでエビデンスを見ることができます。

8. スクリプトクローンの機能

手順1：

1つのテスト手順をクローンするにはクローン対象の1つのテスト手順をクリックし、右マウスで、「クローン」を選択します。

いくつかのテスト手順をクローンするには、

テスト手順が連続している場合：最初または最後のテスト手順をクリックし、クローンを対象とするすべてのテスト手順にマウスオーバーして右マウスで「クローン」を選択します。

テスト手順が連続していない場合：任意のテスト手順をクリックし、Ctrlキーを押しながら他のテスト手順をクリックし、右マウスで「クローン」を選択します。

手順2：

前にクローンまたは後ろにクローン対象の手順1つを選択します。

前にクローンまたは後ろにクローン対象のテスト手順1つをクリックし、右マウスで、「前にクローン」または「後ろにクローン」を選択します。

前にクローンまたは後ろにクローン対象のいくつかの手順を選択します。

テスト手順が連続している場合：最初または最後のテスト手順をクリックし、クローンを対象とするすべてのテスト手順にマウスオーバーして右マウスで「前にクローン」または「後ろにクローン」を選択します

テスト手順が連続していない場合：任意のテスト手順をクリックし、Ctrlキーを押しながら他のテスト手順をクリックし、右マウスで「前にクローン」または「後ろにクローン」を選択します。

9. スクリプトプレビュー

手順1：「停止」ボタンをクリックし、テストスクリプトの記録を終了します。

手順2： 「スクリプトプレビュー」ボタンをクリックすると、使用可能な任意のデバイスから作成したスクリプトをプレビューできます。

この画面から、ユーザーは「デバイス選択」ボタンをクリックして他のデバイスからスクリプトをプレビューできます。デバイス選択画面が表示されます。（スクリプトを作成するために選択されたデバイスは、プレビュー用のデフォルトとして選択されます。）

→デバイスを選択した後、ボタンをクリックしてスクリプトのプレビューを開始します。

10. スクリプト保存

手順1：「スクリプト保存」ボタンをクリックすると、ダイアログが表示されます。

手順2：スクリプトの参照IDと説明を入力します。

手順3：「テストスクリプト保存」ボタンをクリックします。

➪ 保存されたテストスクリプトは、テスター4.0でのテストスクリプトマネジメント画面に表示されます。

11. スクリプト編集

ユーザーは、次の手順に従って、作成されたスクリプトを編集できます。

手順1：テストスクリプトマネジメント画面で、編集したいスクリプトの「編集」アイコンを選択した後、デバイス選択画面が表示されます。通常のスクリプト作成と同様にデバイス選択を行います。

手順2：デバイスが選択された後、スクリプト作成画面が表示され、ユーザーは通常通りにスクリプトを編集できます。その後、ユーザーは以下の2方法でスクリプトを保存できます。

既存のスクリプトに保存する方法
新しいスクリプトを名前を付けて保存する方法

III. 複数のデバイスで1つのアクションのミラーリング

手順1：ミラーアイコンをクリックすると、利用可能なデバイス一覧のポップアップが表示されます。

手順2：メインデバイスのアクションをミラーリングするデバイスを選択します。

ミラーデバイスを選択した後、全てのミラーデバイスのストリーミングが表示されます。

ユーザーのメインデバイスでのアクションは、ミラーデバイスでも実行されます。

手順3：タブバーからスクリーンショットのアイコンをクリックし、全デバイスでのエビデンスをキャプチャしす。

→全てのデバイスのスクリーンショットが表示されます。（メインデバイスとミラーデバイスの両方）

手順4：各画像の下にあるアイコンをクリックすると、スクリーンショットがクリップボードにコピーされます。

手順5：「ダウンロード」ボタンをクリックすると、全てのデバイスでのエビデンス（スクリーンショット）がダウンロードされます。

IV. 測定定規

本機能は、UIとXD間の差異比較の生産性を向上させるためのものである。

本機能を使用するには、次の手順をご実行ください。

手順1：ナビゲーションバーの「定規」アイコンをクリックして、測定画面を開きます。

手順2：エレメントの位置・サイズを測定したい場合は「定規」タブをクリックし、カラーコードを測定したい場合は「カラー」タブをクリックしてください。

・「定規」タブ

エレメントをピン留めするために、「測定」ボタンをクリックしてから、ストリーミング画面またはソースリストから任意のエレメントをクリックします。

・「カラー」タブ

エレメントをピン留めするために、「フィルター」ボタンをクリックしてから、ストリーミング画面またはソースリストから任意のエレメントをクリックします。

パート3：テスター4.0でのスクリプト実行

A. モバイル用のテストスクリプト実行

I. プロジェクトの実行可能ファイルの設定

テストスクリプトを実行する前に、アプリケーションの実行可能ファイル（APK又はIPA）を設定することができます。

手順1： プロジェクト詳細画面からIPAまたはAPKファイルをアップロードするオプションを選択します。

手順2： ファイルをアップロードします。

手順3： パッケージ名を入力します。

手順4： 「保存」ボタンをクリックします。

II. スクリプト実行・テスト結果確認

1. 今すぐ実行

手順1：「今すぐテストスクリプト実行」ボタンをクリックすると、「テストスクリプト実行」ポップアップが表示されます。

手順2：デバイスを選択し（「テストスクリプト実行」ポップアップで、1以上のAndroidデバイスを選択します）、「次へ」ボタンをクリックします。

手順3：同じポップアップで表示されるAndroidテストスクリプト一覧から実行したいテストスクリプトを1件以上選択し、「次へ」ボタンをクリックします。

その後、iOSのデバイス、テストスクリプトを手順2、3と同じように選択できます。

手順4：テスト言語を選択します。

ジョブ名を入力し、テスト言語を選択します。
「今すぐテストスクリプト実行」をクリックします。

手順5：実行中テストスクリプトを確認します（手順2で選択したデバイス名と数が表示されます。デバイス名の横にある「表示」ボタンをクリックすると、該当デバイスのストリーミング画面を表示できます）。

手順6：テストスクリプトが実行された後、テストレポートが「プロジェクト詳細」画面に表示されます。詳細を確認するには、一覧から各テストレポートをクリックしてください。

2. スケジュールによるテストスクリプト実行

手順1：「スケジュールジョブ追加」ボタンをクリックします。

➪ 「今すぐ実行」機能と同様に、デバイス及びテストスクリプトを選択するポップアップが表示されます。

手順2：テストスクリプトを自動的に実行するスケジュール（時刻、曜日）を設定します。

ジョブ名を入力します。
テスト言語を選択します。
テストスクリプト実行時間設定（時刻と曜日を含む）
「テストスケジュール追加」ボタンをクリックします。

➪ スケジュール追加後、設定した時間になったら、指定されたテストスクリプトが自動的に実行され、そのテストレポートも保存されます。

3. テスト結果確認

テストスクリプトが実行された後、テストレポートが「プロジェクト詳細」画面に表示されます。

詳細を確認するには、一覧から各テストレポートをクリックしてください。

結果には、合格と不合格の2種類があります。

合格：スクリプトは機能し、スクリプトエラーが発生せず、テストスクリプトは期待どおりの結果を返しました。

不合格：スクリプトエラーまたは入力エラーが発生しテスター4.0から結果が取得できませんでした。または、スクリプトエラーはありませんが、テスター4.0は期待とは異なる結果を返しました。結果が不合格の場合、システムはエラーの詳細とエラー手順を表示します。

ユーザーがAIを使用してテストスクリプトで期待結果を確認する場合、警告結果が追加で得られます。スクリプトは機能し、スクリプトエラーがなく、AIは結果を返します（入力エラーは返しません）が、AIの結果は何かが間違っているということです。具体的には、エレメントの画像比較関数はFALSEを返します。結果が警告の場合、ユーザーは結果を確認する必要があります。

具体的には、エレメントの画像比較関数はFALSEを返します。結果が警告の場合、ユーザーは結果を確認する必要があります。

AIは2枚のスクリーンショットを比較する時に、2枚の画像の同様比率を示し、値は0～100％になります。

テスター4.0では、しきい値レベルを定義して、このレベルを下回っている場合に問題と見なされるようにします。例えば、しきい値の設定が95％の場合、次のようになります。