メインコンテンツへスキップ

アプリケーションと環境の設定

Molly Exten
  • 更新

アプリケーションと環境は、mablでの自動テスト戦略の基盤を築きます。それらの動作について詳しく知るには、アプリケーションと環境の概要の記事をご覧ください。

mablのアプリケーションと環境を設定する準備ができたら、続きをお読みください。

new_app_page_ja.png

[アプリケーション] ページ

mabl CLIとmabl APIからプログラムで環境変数を管理することもできます。

アプリケーションを作成する

テスト環境設定 > アプリケーションに移動します。+ アプリケーションを作成ボタンをクリックして、新しいアプリケーションページを表示します。

[新規アプリケーション] ページで、以下の値を設定します。

[保存] をクリックして、アプリケーションを作成します。

アプリケーションの編集

アプリケーションの名前や設定を編集するには、テスト環境設定 > アプリケーションに移動し、アプリケーションの詳細ページを開いて、編集用の鉛筆アイコンをクリックしてください。

Webアプリケーションでは、以下を設定できます。

設定 説明
カスタムテストID属性 data-testidやdata-cyなどの専用のテスト属性を標準のDOM属性よりも優先し、UIレイアウトの変更に対する要素ロケーターの安定性を高めます。
テキスト入力の動作 mablが入力フィールドにテキストを入力する方法を制御します。標準的な入力フィールドでは「set value」のままにしてください。mablが1文字ずつ入力する方がWebアプリでうまく動作する場合は、「文字を1文字ずつ送信」に切り替えます。
操作可能性チェック mablがアプリ内の操作可能でない要素（無効化されている、非表示である、他の要素に遮られている、または安定していない要素など）をクリックするかどうかを制御します。オフにすると、対象の要素が操作可能でない場合にクリックステップが失敗します。
JavaScriptフォールバッククリック ネイティブクリックが失敗した場合のmablの動作を制御します。JavaScriptでクリックを実行するか、要素がクリックできなかった理由を示して失敗させるかを選択できます。

変更が反映されるタイミング:

  • テキスト入力の動作と操作可能性チェックの変更は、新しいステップのデフォルト設定として適用されます。既存のステップは、Trainerで手動で更新しない限り、現在の設定を維持します。
  • カスタムテストID属性の変更を要素の検索モデルに反映するには、ステップのトレーニングまたは再トレーニングが必要です。
  • JavaScriptフォールバッククリックの変更は、過去および今後のすべてのクリックステップに対して、実行時に即座に適用されます。

URLとビルドファイルを追加

mabl では、アプリケーションと環境の組み合わせに関連付けられたベースURLやモバイルビルドファイルのことをアプリケーションターゲットと呼びます。

アプリケーションに関連付けられているベースURLやモバイルビルドを編集するには、テスト環境設定 > アプリケーションに移動し、更新したいアプリケーションをクリックします。アプリケーションの詳細ページから、新しいターゲットの追加や既存のターゲットの編集ができます。

app_details_page_ja.png

アプリケーションの詳細ページ

新しいターゲットを追加するには:

  1. + ターゲットを追加をクリックします。
  2. ターゲットに関連付けたい環境を選択してください。
  3. ベースURLを入力するか、アップロード済みのビルドファイルを選択してください。

新しいアプリケーションにWebアプリのURLがある場合、mablは2つのデフォルトプランを作成します。

  • Visit home page - アプリケーションのURLを4時間ごとおよびデプロイ時に訪問する基本的なスモークテストです。
  • リンククローラー - あなたのアプリを週に一度クロールして、リンク切れやエラーをチェックするプランです。
add_target_ja.png

新しいアプリケーションターゲットの追加

URLの検証

新しいWebアプリケーションURLを追加すると、そのURLがパブリックインターネットからアクセスできるかどうかの確認が行われます。

url_validation_ja.png

URLの検証

URLがパブリックインターネット経由でアクセスできない場合、このバリデーションチェックは失敗します。URLはそのまま保存し、プライベートネットワークのテストには以下のいずれかの方法を設定してください。

mabl リンクではURLの検証はサポートされていません

mabl リンクを設定した後でも、このバリデーションチェックは引き続き失敗します。ただし、エージェントが正しく構成されていれば、テストは正常にアプリケーションへ接続されます。

複数のアプリケーションのURL

同じアプリケーションのビルドが複数実行されていて、内容がほぼ同じ場合、その環境のアプリケーションに複数のURLをアプリケーションターゲットとして追加できます。

複数のURLを追加することは、次のような場合に役立ちます。

  • プレビュー環境でPRのたびに新しいアプリケーションを起動しているが、アプリケーションをホストするURLの数が限られている場合。
  • アプリケーションを異なるリージョンごとに異なるURL（例：https://dev.sandbox.ja.com や https://dev.sandbox.en.com）でデプロイしますが、アプリケーション自体は本質的に同じです。

環境の作成

新しい環境を作成するには、新しいアプリケーションを作成する際に追加するか、テスト環境設定 > 環境に移動して**+ 環境を作成**ボタンをクリックしてください。

[新しい環境] ページで、環境の名前を設定します。また、以下のオプションも設定できます。

[保存] をクリックして、環境を作成します。

環境の編集

環境の名前や設定を編集するには、テスト環境設定 > 環境に移動し、環境の詳細ページを開いて編集用の鉛筆アイコンをクリックしてください。

必要に応じて環境設定を更新し、保存してください。

関連記事