既知の問題 - Mobile Add-in

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

このトピックの内容：

はじめに

プロキシ・サーバの使用

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

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

  Apache の設定例：

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

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

OpenText Functional Testing Lab への接続

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

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

複数の OpenText Functional Testing Lab ワークスペース

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

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

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

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

先頭に戻る

一般

テキスト認識

• モバイル・デバイス用のテキスト認識では，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）

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

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

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

先頭に戻る

モバイル・アプリのスパイと強調表示

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

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

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

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

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

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

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

• 次のシナリオでは，テスト・オブジェクトがオブジェクト・リポジトリ内で強調表示されないことがあります。

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

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

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

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

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

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

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

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

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

先頭に戻る

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

先頭に戻る

OpenText Functional Testing Lab を使用したテストの実行

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

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

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

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

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

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

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

• 実行結果

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

もう一度テストを実行する前に，OpenText Functional Testing 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 テスト

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

Functional Testing Lab for Mobile and Web Browser アプリの使用

OpenText Functional Testing Lab での Chrome エミュレータの使用

Shadow DOM のサポート

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

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

先頭に戻る

OpenText Application Quality Management および BPT

Business Process Testing と OpenText Functional Testing Lab

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

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

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

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

  Browser(XXX).Navigate "XXX"

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

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

  例：

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

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

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

先頭に戻る

特定のタイプのアプリ

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

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

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

例：

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

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

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

Flutter ベースのアプリ

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

サポートされている Flutter SDK バージョンの詳細，および Flutter アプリの準備とアップロードのガイドラインについては，OpenText Functional Testing 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	

OpenText Functional Testing Lab を使用した SAP Fiori アプリのテスト

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

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

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

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

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

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

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

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

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

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

先頭に戻る

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

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

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

• ActiveScreen。

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

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

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

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

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

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

• 低レベルの記録

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

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

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

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

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

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

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

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

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

• 仮想オブジェクト

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

• WebVideo および WebAudio.Play

先頭に戻る