既知の問題 - Mobile Add-in

このトピックには，Mobile Add-in を使用する際のトラブルシューティングと制限事項の情報が記載されています。

このトピックの内容：

はじめに

プロキシ・サーバの使用

• WebSocket プロトコルをサポートするプロキシ・サーバのみがサポートされます。Apache サーバの場合は，バージョン 2.4 以降を使用してください。

• プロキシ・サーバが使用するポートでは，基本認証が許可されている必要があります。

  Apache の設定例：

  ###forward basic authentication###
  ProxyRequests on
  AllowCONNECT 8108 8080 80 7002 443 8443

• URL からメディア・ファイルをアップロードするときに，カメラまたはビデオ・シミュレーション・ウィンドウにセンサ・シミュレーション・ステップのメディア・ファイルが表示されない場合は，UFT One の［オプション］ダイアログの［Digital Lab］表示枠（［ツール］＞［オプション］＞［GUI テスト］タブ＞［Digital Lab］ノード）でプロキシ設定を構成してください。

Digital Lab への接続

ライセンスの問題または Digital Lab サーバからのタイムアウトが原因で，UFT One または Digital Lab セッションのいずれかが無効な場合，［オプション］ダイアログの［Digital Lab］表示枠で［接続テスト］をクリックすると，操作がタイムアウトします。

回避策：必要に応じて UFT One と Digital Lab を終了し，正しい製品のライセンスが正しくインストールされていることを確認します。次に，UFT One と Digital Lab に再接続します。

複数の Digital Lab ワークスペース

モバイル・アプリの選択と複数のワークスペースの操作に，次の既知の問題があります。

• UFT One の［記録と実行環境設定］ダイアログからは，特定のアプリのアップロード番号の選択がサポートされていません。代わりに，Digital Lab ウィザードからアプリとアップロード・カウンタを選択してください。

• 同じアプリが，共有アセットにアップロードされ，別のワークスペースにもアップロードされている場合，［記録と実行環境設定］ダイアログで最新のアプリ・アップロード・バージョンを選択すると，その中の最新バージョンが，ワークスペース名でタグ付けされて使用されます。

• 同じアプリが複数のワークスペースにアップロードされ，UFT One でワークスペースまたはアプリのアップロード番号が指定されていない場合，アプリの最新のアップロード番号が，システム上のすべてのワークスペースで使用されます。

先頭に戻る

一般

UFT One のテキスト認識と Digital Lab

• モバイル・デバイス用の UFT One テキスト認識では，Tesseract OCR テキスト認識エンジンがサポートされません。

• OCR は，画質品質が 100% に設定されている場合にのみサポートされます。

ワイルドカード

WebUtil.LaunchBrowser ステップでワイルドカードを使用してデバイスのあいまい検索を実行する場合は，オペレーティング・システムも指定する必要があります。

たとえば，次のステップではエラーが発生することがあります。

WebUtil.LaunchBrowser "MOBILE_SAFARI","iPhone","",""

エラーを防ぐには，オペレーティング・システムを指定します。たとえば，次のようにします。

WebUtil.LaunchBrowser "MOBILE_SAFARI","iPhone","","iOS"

センサ・シミュレーションの操作

• ドラッグ・アンド・ドロップ・アクションを使用してメディア・ファイルを SimulateCamera または SimulateVideo 操作にアップロードする処理は，サポートされていません。

• SimulateCamera または SimulateVideo メソッドに必要な指定ファイルがテスト・ステップで正しくない場合，リモート・アクセス・ウィンドウには，操作が正しく実行されていることや，ステップが失敗または成功したことが示されません。

  回避策：テスト結果でステップの詳細を確認します。

ローカライズ

Amazon Web Services（AWS）

Digital Lab と UFT One を AWS で使用している場合，次の既知の問題があります。

• AWS で実行される単一のテストで，複数のデバイスはサポートされません。

• モバイル・デバイスでの Web アプリケーションのビジネス・プロセス・テストの実行は，Amazon Web Services 上のデバイスではサポートされていません。

先頭に戻る

Digital Lab によるスパイと強調表示

• オブジェクト・スパイを使用しているときに，オブジェクトにカーソルを合わせてそのプロパティを表示する操作はサポートされていません。代わりにそのオブジェクトをクリックして，プロパティを表示してください。

• 低速の Web サイトでは，最初のスパイ・アクションでパフォーマンスの低いデバイスに「device:device」が表示されます。

  回避策：connector.properties の「MAX_JS_ENGINE_READY_CHECK_RETRIES」を 300 に増やして，UFT のタイムアウト時間を 1 分に増やします。

• ネイティブ・ブラウザと MC ブラウザの場合：オブジェクト・スパイを Web オブジェクトのBack，Forward，Refresh，および URL ボックスに対して使用しているときに，UFT が Browser.page.xx ではなく Device.app.xx を生成します。

  回避策：コードを手動で変更します。

• MC ブラウザとネイティブ・ブラウザの両方を使用して Browser テスト・オブジェクトを強調表示すると，位置のずれが発生します。

• オブジェクト・リポジトリからオブジェクトを強調表示するときに，標準設定以外の認識プロパティは，値が正しくなければ無視されます。これにより，UFT One はアプリケーションのコントロールを強調表示できます。

• 次のような場合は，UFT One がオブジェクト・リポジトリでテスト・オブジェクトを強調表示しないことがあります。

  シナリオ	回避策
  これが，UFT One のインストール後の最初の編集セッションである。	［記録と実行環境設定］ダイアログ・ボックスの［モバイル］タブで，関連するデバイスとアプリケーションを定義します。次に，記録セッションを開始および停止します。
  これが，［オプション］ダイアログ・ボックスで出荷時の標準設定に戻した後の最初の編集セッションである。	［記録と実行環境設定］ダイアログ・ボックスの［モバイル］タブで，関連するデバイスとアプリケーションを定義します。次に，記録セッションを開始および停止します。
  ［記録と実行環境設定］ダイアログ・ボックスの［モバイル］タブが空であり，デバイスもアプリケーションも選択されていない。	［記録と実行環境設定］ダイアログ・ボックスの［モバイル］タブで，関連するデバイスとアプリケーションを定義します。次に，記録セッションを開始および停止します。
  リモート・アクセス・ウィンドウに，［記録と実行環境設定］ダイアログ・ボックスの［モバイル］タブで定義されているデバイスとは異なるデバイスが表示される。	次のいずれかを実行します。 ［記録と実行環境設定］ダイアログ・ボックスの［モバイル］タブで，関連するデバイスとアプリケーションを定義します。次に，記録セッションを開始および停止します。 Device テスト・オブジェクトの記述で ID プロパティを，リモート・アクセス・ウィンドウで開いているデバイスの値に設定します。

• オブジェクトの記述プロパティについて，そのプロパティ名の最初または最後にスペースが含まれている場合，UFT One および Digital Lab はオブジェクトを強調表示できません。

  回避策：次のいずれかを実行します。

  • UFT Oneのオブジェクト・リポジトリのオブジェクト記述からこのプロパティを削除します

  • プロパティの正規表現「.*」を追加します

• Web テストを扱っているときに，モバイル以外の最適化ページでは，iOS デバイスのスパイはサポートされていません。

• （Mobile Web アプリケーションの Web ページからの）証明書関連のダイアログでの記録と強調表示はサポートされていません。

  回避策：記述的プログラミングを使用するステップを追加して，テストの証明書ダイアログでユーザ・アクションを識別して実行します。

  さらに，テストを実行する前に，テストを実行しているデバイスに必要な証明書を手動でインストールする必要があります。

先頭に戻る

モバイル・デバイスでの記録

先頭に戻る

Digital Lab を使用した UFT One テストの実行

このセクションには，次の問題が含まれています。

• デバイスの選択とブラウザの起動

• ［デバイス機能］タブと［特定のデバイス］タブの切り替え

• テスト実行での複数のデバイス

• テスト実行でのデバイス・フィルタ：複数のデバイスのテスト

• テスト実行でのデバイス・フィルタ：フィルタの変更

• テスト実行でのデバイス・フィルタ：異なるデバイス・フィルタを持つ複数のステップ

• 実行結果

• デバイス・ログ
• ビジュアル関係識別子ステップ
• 指紋シミュレーション

デバイスの選択とブラウザの起動

エラーを回避するため，デバイスをロックし，同じデバイスでブラウザを起動するために使用するメソッドが，［記録と実行環境設定］とテスト・ステップで整合していることを確認してください。

詳細については，『UFT One Object Model Reference』の LaunchBrowser および LaunchMobileBrowserWithID メソッドのドキュメントを参照してください。

［デバイス機能］タブと［特定のデバイス］タブの切り替え

UFT One で［記録と実行環境設定］を構成しているときに，［デバイス機能］タブと［特定のデバイス］タブを切り替えてから，［Digital Labで開く］ボタンをクリックして Digital Lab ウィザードを開くと，Digital Lab ウィザードが［デバイス機能］タブを開くことがあります。

回避策：次のいずれかを実行します。

• ［特定のデバイス］タブが開いた状態で，［OK］をクリックして，［記録と実行環境設定］タブを閉じます。次に，［記録と実行環境設定］ダイアログ・ボックスを再度開き，［Digital Labで開く］ボタンをクリックして［Digital Lab］タブを開きます。

• UFT One の［記録と実行環境設定］ダイアログ・ボックスの［特定のデバイス］タブで，特定のデバイスを選択します

テスト実行での複数のデバイス

複数のデバイスで MobileWebView テスト・オブジェクトを使用してテストを実行すると，予期しない問題が発生する可能性があります。

その場合は，テスト・オブジェクトから accessibilityid 記述プロパティを削除して，テストを再実行してください。

テスト実行でのデバイス・フィルタ：複数のデバイスのテスト

テスト内の複数のステップが記述プロパティによって定義された同じデバイス・フィルタ条件を使用していて，Digital Lab に接続されているデバイスでそのフィルタ条件に一致するものが複数ある場合，該当するすべてのステップは，テストの最初のステップで使用されたデバイスと同じデバイスを使用します。

特定のステップで別のデバイスを使用するには，そのステップのフィルタを変更します。

テスト実行でのデバイス・フィルタ：フィルタの変更

デバイス・フィルタが記述プロパティによって定義されていて，テストをもう一度実行する前にそのプロパティを変更した場合，デバイスは最初の実行からロックされたままになっており，2 回目のテスト実行は失敗します。

もう一度テストを実行する前に，Digital Lab でデバイスのロックを解除してください。

テスト実行でのデバイス・フィルタ：異なるデバイス・フィルタを持つ複数のステップ

テスト内の個々のステップが，ステップごとに異なるデバイス・フィルタを使用していて，デバイス・フィルタが競合しない（同じデバイスが各フィルタに一致する）場合に，

• 一致するデバイスが複数接続している場合：ステップごとに別々のデバイスが選択されます。
• 一致するデバイスが 1 つしか接続されていない場合：そのデバイスが 2 回目に選択されるときに，テストは失敗します。

同じデバイスを使用するには，関連するすべてのステップでプロパティが一致するようにフィルタを変更します。

たとえば，次の両方のステップのフィルタに一致する接続デバイスが 1 つのみの場合，テストは 2 つ目のステップで失敗します。

Device("osversion:=8.4","ostype:=iOS").App("name:=MC Browser","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "AAA"

Device("ostype:=iOS").App("name:=MC Browser","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "BBB"

ステップを次のように変更して，テストを実行します。

Device("ostype:=iOS").App("name:=MC Browser","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "AAA"

Device("ostype:=iOS").App("name:=MC Browser","identifier:=com.hp.HPMobileWebBrowserINJ").MobileEdit("nativeclass:=UITextField","mcindex:=0","ispassword:=False","class:=Input","accessibilityid:=url").Set "BBB"

実行結果

デバイス・ログ

［デバイス メトリクス］で［ログ］オプションをオフにして記録を開始し，記録を停止した後で，同じオプションを選択して記録を再開した場合，（［デバイスオプション］パネルの）［デバイスログのダウンロード］ボタンが使用できません。

回避策：リモート・アクセス・ウィンドウの［更新］ボタンを押します。

ビジュアル関係識別子ステップ

テストの最初のステップが，ビジュアル関係識別子（VRI）を使用してオブジェクトが識別する場合，アプリの起動，インストール，または再起動は，別の方法でそれが実行されるように定義されていても実行されません。

回避策：VRI を使用してテスト・オブジェクトを識別する前に，アプリが起動，インストール，または再起動されるようにしてください。

指紋シミュレーション

失敗した指紋シミュレーションのステップ結果は，アプリの設定済みの動作に応じて表示が異なる場合があります。

先頭に戻る

Web テスト

モバイル・デバイスのネイティブ・ブラウザ

UFT Oneでの MC Browser アプリの使用

Digital Lab での Chrome エミュレータの使用

Shadow DOM のサポート

Shadow Dom Web アプリおよび iOS デバイスでのモバイル・テストの実行は，次の場合にのみサポートされます。

• iOS バージョン 11 以降
• Chrome バージョン 56 以降の Android

先頭に戻る

ALM および BPT

ALM と Digital Lab の操作

Business Process Testing と Digital Lab

• ［キャプチャ］ツールバーの使用はサポートされていません。

• ビジネス・プロセス・テストを記録する場合，記録中に［停止］ボタンを押すと，記録を再開できません。

• ホーム画面から Mobile Web アプリを起動して記録を開始した場合，記録されるべきステップがないときでも，ページで実行された操作が記録されます。

  ステップは，次の構文を使用して記録しています。

  Browser(XXX).Navigate "XXX"

• ［Web］または［モバイル］タブで定義された設定を使用して複数のアプリケーション領域を次々に作成すると，前のアプリケーション領域からの情報が保持されます。その設定値クリアし，後に続くアプリケーション領域の詳細を最初から定義してください。

• BPT は，単一のテストまたはフローで，複数のアプリケーション領域をサポートしていません。

  例：

  それぞれに別々のアプリケーション領域を定義して，次のコンポーネントをテストまたはフローに追加します。

  コンポーネント 1 / アプリケーション領域 1	iOS デバイス AMB アプリ
  コンポーネント 2 / アプリケーション領域 2	Android デバイス UiCatalog アプリ

  この場合，テストの実行中に，UFT One は 2 番目のデバイス（Android）にインストールする正しいアプリを見つけることができません。

先頭に戻る

特定のタイプのアプリ

ネイティブ・アプリの操作

UFT One は，ネイティブ・ブラウザまたは MC ブラウザを使用しているときに，ネイティブ日付ピッカなどのネイティブ・モバイル・コントロールでステップを記録または実行できません。

回避策：ネイティブ・モバイル・コントロールをオブジェクト・リポジトリに手動で追加してから，コントロールを操作するステップを手動で追加します。

例：

1. 日付ピッカ・コントロールをスパイし，対応する WebEdit オブジェクトをオブジェクト・リポジトリに追加します。

2. それから，次のようなステップをテストに追加します。

   Browser("Reservations").Page("Your Reservation").WebEdit("check-in-date").Click

Flutter ベースのアプリ

UFT One は，Google Flutter SDK を使用して構築された Android または iOS のパッケージ・アプリのテストを記録し，実行できます。次のオブジェクト・タイプがサポートされています。MobileButton，MobileCheckBox，MobileEdit，MobileLabel，MobileObject，MobileTabStrip。

サポートされている Flutter SDK バージョンの詳細，および Flutter アプリの準備とアップロードのガイドラインについては，Digital Lab ヘルプセンターを参照してください。

次のメソッドは，Flutter ベースのアプリケーションではサポートされていません。SetSecure，Select，ChildObjects，MobileEdit.Set，MobileLabel.Set，MobileObject.SetFocus。

iOS のネイティブ・パッケージ・アプリと ChildObjects メソッド

ChildObject ステップが iOS のネイティブ・パッケージ・アプリで実行されるときに（Device().App().MobileObject().childobjects()），MobileObject が見つからない場合，このステップは，テストしている現在のページ上のすべての子オブジェクトを返します。

ハイブリッド・アプリの操作

ハイブリッド・アプリケーションのテスト時に，次の機能はサポートされていません。

• アクセシビリティ・チェックポイント

• モバイル最適化

  以下は，モバイル用に最適化された Web ページでのみサポートされています。

  • ビットマップ・チェックポイント
  • テキスト領域チェックポイントおよび出力値
• ActiveScreen
• ナビゲートして学習
• ［オブジェクトの認識］ダイアログ・ボックスでのオブジェクトの認識プロパティのカスタマイズ
• デスクトップ・ブラウザで記録されるテストとコンポーネント
• Web ファイルおよび frameset オブジェクト

特定のハイブリッド・アプリで，「このテストは古いバージョンの UFT で作成されているため，別の JavaScript エンジンが必要です」というエラーが発行されることがあります。

これが発生する可能性があるのは，アプリが別のアプリまたはホームから起動される場合です。

回避策：アプリをテスト・ツールで起動します。記録を停止し，アプリを再起動しますが，再インストールはしないでください。記録を再開します。または，次の Javascript コードを使用することもできます。

その他の制限：

非パッケージ・アプリの操作

オブジェクト記述フィルタ - 例

Set oDesc = Description.Create()
	oDesc("class").Value = "Button"

Set Buttons = Device("Device").App("UICatalog_2").ChildObjects(oDesc)
               
NumberOfButtons = Labels.Count()

For i = 0 To NumberOfButtons - 1
	Buttons(i).Tap
Next	

Digital Lab を使用した SAP Fiori アプリのテスト

テストがデスクトップ・バージョンの Fiori アプリケーション用に作成されている場合は，モバイル・バージョンで正しく実行されるように変更することが必要な場合があります。

さらに，デバイスごとに解像度が異なると，オブジェクトのプロパティと動作に違いが生じることがあります。複数のデバイスをサポートするには，テスト・スクリプトを手動で編集することが必要な場合があります。

次のバージョンの Microsoft Edge ブラウザがサポートされています。

• SAP Fiori：バージョン 1.44 および 1.52（再生のみ）
• SAPUI5：バージョン 1.44（再生のみ）

特定の SAP オブジェクトおよびメソッド

SAP Fiori アプリでの標準チェックポイントと出力値

記録済みのテストに標準のチェックポイントと出力値を挿入し，Fiori モバイル・アプリケーションで標準のチェックポイントと出力値のステップを実行する場合は，テスト・オブジェクトが Digital Lab リモート・アクセス・ウィンドウに完全に表示されている必要があります。

これが関係するのは，テストの記録時ではなく，テストの編集時です。

Fiori 1.6x クライアントのフリーズ

リモート・アクセス・ディスプレイでは，Android FLAG_SECURE ウィンドウ・フラグを使用するアプリがサポートされません。詳細については，WindowManager.LayoutParams.html を参照してください。このようなアプリを Digital Lab で使用するには，このフラグを削除する必要があります。詳細については，Digital Lab ヘルプを参照してください。

先頭に戻る

サポートされていない機能，テスト・オブジェクト，およびメソッド

UFT One Mobile Add-in は，モバイル・アプリケーションでのステップの記録と実行のみをサポートします。

モバイル・オブジェクトを操作する場合，次の UFT One 機能はサポートされていないか，部分的にしかサポートされていません。

• ActiveScreen。

• ［オブジェクトの認識］ダイアログ・ボックスの補足プロパティ。

• Device.SetOrientation メソッド：LandscapeRight および Portrait パラメータのみがサポートされています。

• モバイル・オブジェクトの Exist プロパティ：オブジェクトが見つからず，ユーザが標準設定のタイムアウト値または 30 秒を超えるタイムアウト値を使用している場合（UFT 14.01 以前に適用）。

  回避策：30 秒未満のタイムアウト値を追加します。たとえば，次のようにします。

  Device("Device").App("UICatalog").MobileList("list").Exist(3)

• Insight は，画像品質が 100% に設定されている場合にのみサポートされます。

  これらの条件下でも Insight が正しく機能しない場合は，代わりに AI ベースのテストをモバイル・アプリケーションに使用してみてください。 UFT One での AI ベースのテストを参照してください。

• LaunchBrowser：Browser 引数のみが必須ですが，エラーを防ぐには，このメソッドに対して他の引数を 1 つ以上定義する必要があります。詳細については，UFT ヘルプセンターの『Object Model Reference』にある LaunchBrowser のドキュメントを参照してください。

• ローカル・システム・モニタ：この代わりに，［記録と実行環境設定］ダイアログ・ボックスで，モバイル・バイタルを収集するよう UFT One に指示できます。すると，そのデータが実行結果の［ローカル システム モニタ］表示枠に表示されます。

• 低レベルの記録

• メンテナンス実行モード：ハイブリッド・アプリケーションでのみサポートされます。

• MobileCalendar ステップに Set メソッドを追加するには（MobileStepper.Set），エディタで手動で追加する必要があります。

• MobileStepper オブジェクトのタップ（MobileStepper.Tap メソッド）

• ナビゲートして学習（親テスト・オブジェクトの子をオブジェクト・リポジトリに追加することを含む）。

• 回復シナリオ：次のトリガ・イベントと回復操作は，モバイルではサポートされていません。

  トリガ・イベント	ポップアップ・ウィンドウ オブジェクトの状態 アプリケーションのクラッシュ
  回復操作	［キーボードまたはマウス操作］＞［押すボタンのラベルを指定する］ アプリケーション・プロセスの終了

• Simulation メソッド（SetFingerprintSimulation，SimulteCamera，SimulateFingerprint，SimulateVideo メソッドなど）は，スクリプトの最初のステップとしてサポートされていません。エラーを回避するには，これらのステップの前に Launch ステップを手動で追加します。

• スマート認識：ハイブリッド・アプリケーションでのみサポートされます。

• 更新実行モード：チェックポイントと出力値を更新するためのオプションのみがサポートされます。ハイブリッド・アプリケーションでのみサポートされます。

• 仮想オブジェクト

• Visual Relations Identifiers（VRI）：複数のリモート・ウィンドウが開いているか，ハイブリッド・アプリの Web テストで使用される場合。

• WebVideo および WebAudio.Play

先頭に戻る

以前のバージョンの UFT One で作成されたテスト

• UFT 12.51 より前に作成されたテスト
• UFT 12.02 パッチ 1 以前で作成されたテスト
• 1.51 より前のバージョンの Mobile Center で作成されたテスト

UFT 12.51 より前に作成されたテスト

UFT 12.51 より前のハイブリッド・アプリケーションで作成されたテストの場合は，チェックポイントと出力値に対して，text，isEnabled，および isFocused プロパティのみがサポートされます。

さらに，アプリに対してステップを実行する前に UFT One によってアプリが確実に再インストールまたは再起動されるようにする必要があります。

次の方法で実行できます。

• ［記録と実行環境設定］を使用します（GUI テストの場合）。

• App.Launch メソッドを使用するステップを追加します。詳細については，UFT One ヘルプセンター内の『Object Model Reference』の「Mobile」セクションを参照してください。

UFT 12.02 パッチ 1 以前で作成されたテスト

UFT 12.02 パッチ 1 以前で作成されたテストでオブジェクト・リポジトリを操作する場合，次のコマンドはサポートされません。

• アプリケーション内で強調表示

• リポジトリの中で検索

代わりに，アプリケーションからテスト・オブジェクトの記述を更新します（テスト・オブジェクトを選択し，［アプリケーションから更新］をクリックします）。

MobileLabel テスト・オブジェクトの記述をアプリケーションから更新するには，それを MobileList テスト・オブジェクトに置き換えます。

該当するテスト・ステップで，MobileLabel.MakeVisible と MobileLabel.Tap を含むステップを MobileList.Select <インデックス> を含む単一のステップに置き換えます。

たとえば，次のステップは，

Device("Device").App("UICatalog").MobileLabel("ListViewActivity").MakeVisible
Device("Device").App("UICatalog").MobileLabel("ListViewActivity").Tap

次のように置き換えます。

Device("Device").App("UICatalog").MobileList("list").Select 5

1.51 より前のバージョンの Mobile Center で作成されたテスト

1.51 より前のバージョンの Mobile Center を使用して作成されたハイブリッド・アプリケーションのステップが含まれているテストは，バージョン 2.01 以降ではサポートされません。

先頭に戻る