Bug Report Manager

注: 特定のデバイスに存在する機能のみを表示するには、下の SmartDocs バーから 1 つまたは複数のフィルタを選択します。

言語に関する注: 入力フィールドには、英語のみを入力できます。

StageNow - 5.3

概要

Bug Report Manager (BugReportMgr) は、Zebra モバイル コンピュータで認識された問題に関連する時間、日付、ユーザー入力、および関連する技術データを、標準の Android バグ報告メカニズムに基づいて報告するためのフレームワークを提供します。バグ レポートは、プログラムを用いて意図的にトリガをかけることも、デバイスの開発者オプションを有効にせず [電源オフ] メニューのボタンを使用して手動でトリガをかけることもできます。バグ レポート ファイルは、デバイス フラッシュ (固定または取り外し可能) に、使用できるメモリ量が許す限り保存できます。ローカル ストレージに加えて、指定された電子メール アドレスにレポートを送信したり、Zebra Cloud にアップロードしたりすることもできます。

注記: Bug Report Manager は、Android 10 Q 以降を実行しているデバイスでは使用できません。BugReportMgr CSP は現在は非推奨となっており、拡張されることはありません。

主な機能

  • バグ レポートの処理をデフォルト (Android) またはカスタム (Zebra) に設定する
  • アプリが予期せずクラッシュした場合に、バグ レポートまたは Android システム ログを自動的にキャプチャする
  • アプリが反応しなくなった場合に、バグ レポートまたは Android システム ログを自動的にキャプチャする
  • 追加情報を収集するためのデバイスユーザー アンケートを提示する
  • 利用可能なフラッシュに、バグ レポート ファイルを何件でも保存可能
  • オーディオをキャプチャしてバグ レポートに添付する
  • バグ レポートに対して意図的な「サイレント」トリガをかける
  • デバイスでの有効化/無効化:
    • [電源オフ] メニューからバグ レポートを生成
    • バグ レポートのスクリーンショットを取得
    • 意図的にバグ レポートのトリガをかける
    • レポートをフラッシュ メモリに保存
    • 指定した電子メール アドレスにレポートを送信
    • レポートを Zebra Cloud にアップロード

セキュリティの警告

  • バグ レポートの共有は、信頼できるユーザーおよびアプリのみに限定する必要があります。ここにはアプリの使用状況、場所、およびシステム ログからのその他のデータが含まれており、機密性の高い情報である可能性があります。
  • バグ レポートの電子メール送信は、エンドツーエンド配信が、すべて安全な環境内で行われている場合にのみ使用してください。バグ レポートを電子メールで送信すると、本来なら非公開の受信者に見せてはいけないような機密性の高いアプリケーション データが開示されるため、セキュリティとプライバシに影響が生じる可能性があります。

バグ レポートについて

重要事項:

  • バグレポートは、bugreport-YYYY-MM-DD-HH-MM-SS.zip というファイルに保存されます。
  • ユーザーが FileNameTextBox パラメータ を通じて「エラー名」を入力すると、その名前がレポート名の末尾に追加され「bugreport-YYYY-MM-DD-HH-MM-SS-Error_name.zip」のような名前になります。
  • FileNameTextBox パラメータに入力したテキストは、バグ レポート内でユーザーが入力したデータを含むファイルの名前になります。
  • バグ レポートには、標準の Android バグ レポート (.txt) とスクリーンショット (.png) ファイルが含まれています。
  • バグ レポートは、ブロードキャスト メッセージを使用してサイレントに (ユーザー ダイアログなしで) トリガすることができます。com.symbol.mxmf.intent.START_FOR_BUG_REPORT.
  • USB デバッグが有効になっているデバイスでは、[設定] パネルからバグ レポートをサイレントにトリガすることもできます。

img Zebra のバグ レポート (「browser-crash」と呼ばれます) は、ユーザーが生成した入力ファイルを Android.txt および .png バグ レポート ファイルに追加します。

ユーザー ダイアログについて

Bug Report Manager の付加価値の中にダイアログがあります。このダイアログでは、バグが発生したデバイス ユーザーから情報を収集でき、多くの場合これが不具合の根本原因を調べるための貴重な情報になります。バグ レポートが生成されると「アンケート」が表示されます。このアンケートは、報告されている不具合の原因と思われるアクティビティについて、デバイス ユーザーから関連情報を収集するような形式に組織内で設計できます。ユーザーが入力したデータは、bugreport.zip 内の別のテキスト ファイルに保存されます。ダイアログの作成は累積的に行われます。必要な質問をすべて行い、必要なデータがすべて収集されるまで、ユーザー入力フィールド (テキスト ボックス) とフィールド ラベルをいくつでも追加できます。

img デバイス ユーザーに対するユーザー ダイアログまたは「アンケート」の例

注: 適切な操作を確実に行えるよう、新規ダイアログはそれぞれ[ClearDialog] アクションから開始し、[LayoutEnd] アクションで終了する必要があります。

FileNameTextBox

FileNameTextBox は、報告されているバグの「エラー名」をユーザーに提供するように求めることができます。このオプション機能は、大量のファイルを扱う管理者のバグ レポートの識別と整理に役立ちます。このフィールドに入力されたテキストはバグ レポートのファイル名に追加され (日付と時刻の後に)、ユーザーが入力したデータを保存するレポートの zip ファイル内のファイル名になります。このフィールドにスペースを入力するとアンダースコアに変換され、その他のテキスト以外の文字は削除されます。ユーザーが空白のままにすると「no_user_entry」が表示されます。

テキスト ボックス、ラベル、便利な「ヒント」の文を表示したユーザー ダイアログ ボックスの例。

ラベル

ラベルは静的なテキスト フィールドで、すぐ下にある空白のテキスト ボックスに情報を入力するための質問や指示を記入するために使用されます。たとえば、クラッシュの原因となったアクティビティをキャプチャする場合、テキスト フィールドの上にあるラベルに「エラーが発生する直前に何をしていましたか?」などと表示します。ダイアログにはラベルをいくつでも追加できます。

テキスト ボックス

テキスト ボックスは、ユーザーが質問への回答や説明を入力するための空白のフィールドです。管理者はテキスト ボックスに「ヒント」テキストを挿入し、ユーザーが必要事項を入力する際にガイドする (「どのアプリを使用していましたか?」など) ことができるようになります。ヒント テキストは空白だったテキスト フィールドに表示され (上に示すように)、ユーザーが入力を開始すると消えます。

注: 生成されるバグ レポートで、ヒント テキストは、ユーザーがそのフィールドに入力したデータのラベルになるため、ヒント テキストを慎重に検討することが重要です。たとえば、「あなたのお名前」などのヒントはユーザーにとって自然に理解しやすいものですが、レポートを読む人には「バグの報告者」の方が良いかもしれません。これはユーザーにとっても役に立ちます。

注: 適切な操作を確実に行えるよう、新規ダイアログはそれぞれ [ClearDialog] アクションから開始し、[LayoutEnd] アクションで終了する必要があります。

バグ レポートの処理

これは、デバイス上にある Zebra Bug Reporting のオン/オフ スイッチです。有効にすると (オプション 2)、Zebra Bug Reporting を使用してバグ レポートを生成、保存、および転送し、必要に応じてデバイス ユーザーから提供された情報をレポートに補足します。このパラメータを無効にすると (オプション 1)、デバイスは Android のバグ報告機能を使用します。

セキュリティの警告: バグ レポートにはアプリの使用状況、場所、およびシステム ログからのその他のデータが含まれており、機密性の高い情報である可能性があります。共有は、信頼できるユーザーおよびアプリのみに限定する必要があります。

パラメータ名: BugReportProfile

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 old Android のバグ報告機能を使用するようにデバイスを設定します。

MX: 6.3+

Android API: 23+
2 new バグの報告と処理に Zebra Bug Report Manager を使用するようにデバイスを設定します。

MX: 6.3+

Android API: 23+

ANR エラー アクション

アプリが応答を停止したときにエラー レポートをキャプチャするかどうか、およびどのタイプのレポート (Bug Report/logcat) をキャプチャするかを制御します。バグ レポートには、上記の「概要」セクションで説明した情報が含まれています。Android システム ログ (取得に使用したコマンドの名前を取って「logcat」と呼ばれることもあります) には、クラッシュ時に実行されていたアプリによって書き込まれたシステム メッセージ、スタック トレース、およびログ情報が保存されます。

セキュリティの警告: バグ レポートにはアプリの使用状況、場所、およびシステム ログからのその他のデータが含まれており、機密性の高い情報である可能性があります。共有は、信頼できるユーザーおよびアプリのみに限定する必要があります。

パラメータ名: ANRErrAction

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 8.0+

Android API: 26+
1 NoCapture アプリが応答を停止したときに何もキャプチャしないようにデバイスを設定します。

MX: 8.0+

Android API: 26+
2 CaptureBR アプリが応答を停止したときにバグ レポートをキャプチャするようにデバイスを設定します。

MX: 8.0+

Android API: 26+
3 CaptureLogcat アプリが応答を停止したときに「logcat」をキャプチャするようにデバイスを設定します。

MX: 8.0+

Android API: 26+

予期しないエラー アクション

アプリが予期せずクラッシュしたときに (ANR 以外) エラー レポートをキャプチャするかどうか、およびどのタイプのレポート (Bug Report/logcat) をキャプチャするかを制御します。バグ レポートには、上記の「概要」セクションで説明した情報が含まれています。Android システム ログ (取得に使用したコマンドの名前を取って「logcat」と呼ばれることもあります) には、クラッシュ時に実行されていたアプリによって書き込まれたシステム メッセージ、スタック トレース、およびログ情報が保存されます。

セキュリティの警告: バグ レポートにはアプリの使用状況、場所、およびシステム ログからのその他のデータが含まれており、機密性の高い情報である可能性があります。共有は、信頼できるユーザーおよびアプリのみに限定する必要があります。

パラメータ名: UnexpectedErrAction

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によってデバイスの設定は変更されません。以前に選択した設定はすべて保持されます。

MX: 8.0+

Android API: 26+
1 NoCapture アプリが予期せずクラッシュしたときに何もキャプチャしないようにデバイスを設定します。

MX: 8.0+

Android API: 26+
2 CaptureBR アプリが予期せずクラッシュしたときにバグ レポートをキャプチャするようにデバイスを設定します。

MX: 8.0+

Android API: 26+
3 CaptureLogcat アプリが予期せずクラッシュしたときに「logcat」をキャプチャするようにデバイスを設定します。

MX: 8.0+

Android API: 26+

バグ レポート ボタンの表示/非表示

Android の [電源オフ] メニューに [バグレポートの取得] というラベルの付いたボタンが表示されるかどうかを制御します。このメニューは、デバイスの電源キーを長押しすると表示されます。この機能を使用して生成されたバグ レポートは、BugReportProfile パラメータで指定された処理設定を使用して、保存または送信されます。注: [バグ レポートを取得する] 機能は、設定パネルからオン/オフを切り替えることができ、サイレントに (ユーザー ダイアログなしで) 実行することもできます。

[電源オフ] メニューの機能の大半は、Power Key Manager で制御されます。

パラメータ名: EnableBRInPwrMenu

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 true [電源オフ] メニューの [バグ レポートを取得する] ボタンを表示します。

MX: 6.3+

Android API: 23+
2 false [電源オフ] メニューの [バグ レポートを取得する] ボタンを非表示にします。

MX: 6.3+

Android API: 23+

ストレージの有効化/無効化

デバイスのフラッシュ メモリにバグ レポートを保存するかどうかを入力するために使用されます。有効にすると、バグ レポートは BugReportFilePath パラメータで指定した場所に保存されます。警告: このパラメータが [False] に設定されている場合、バグ レポートはデバイス ユーザーがアクセスできる領域には保存されません。

セキュリティの警告: バグ レポートにはアプリの使用状況、場所、およびシステム ログからのその他のデータが含まれており、機密性の高い情報である可能性があります。共有は、信頼できるユーザーおよびアプリのみに限定する必要があります。

次の場合に表示: BugReportProfile パラメータが [新規] に設定されている場合

パラメータ名: StorageEnable

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 false バグ レポートがデバイスに保存されないようにします。

MX: 6.3+

Android API: 23+
2 true バグ レポートをデバイスに保存できるようにします。

MX: 6.3+

Android API: 23+

ストレージ パス

StorageEnable パラメータを使用してデバイス ストレージが有効化されている場合に、バグ レポートのストレージ パスを入力するために使用します。固定ストレージとリムーバブル ストレージがサポートされていますが、指定するパスは Bug Report Manager の実行時に有効なパスでなければなりません。パスが指定されていない場合、バグ レポートはすべての Zebra デバイスの有効なパスである /storage/sdcard0/BugReports/ に保存されます。

パラメータ値入力ルール:

  • 有効なストレージ パスを含む 1 文字以上の文字列

次の場合に表示: StorageEnable パラメータが [True] に設定されている場合

パラメータ名: BugReportFilePath

要件:

  • MX: 6.3+
  • Android API: 23+

ストレージ設定の有効期限

デバイス上のストレージ設定の変更がデフォルト設定 (無効) に戻るまでの日数を入力するために使用されます。テスト、トラブルシューティング、その他の目的で一時的な設定を行うために使用します。

パラメータ値入力ルール:

  • 設定の「残り日数」を示す文字列 (最低 1 日)
  • 「0」を設定すると無期限になります

次の場合に表示: StorageEnable パラメータが [True] に設定されている場合

パラメータ名: StorageTTL

要件:

  • MX: 8.1+

電子メールの有効化/無効化

バグ レポートを電子メールで送信するかどうかを制御します。有効にすると、バグ レポートは、下記の関連パラメータで指定された電子メール送信者アカウントと受信者アドレスを使用して送信されます。

セキュリティの警告: このオプションを有効にすると、本来なら非公開の受信者に見せてはいけないような機密性の高いアプリケーション データが開示されるため、セキュリティとプライバシに影響が生じる可能性があります。このオプションは、エンドツーエンド配信が、すべて安全な環境内 (プライベート ネットワークで運用されているプライベート電子メール システムなど) で直接行われている場合にのみ使用してください。

パラメータ名: EmailEnable

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 false Bug Report Manager がバグ レポートを電子メールで送信しないようにします。

MX: 6.3+

Android API: 23+
2 true Bug Report Manager がバグ レポートを電子メールで送信するように設定します (上記のセキュリティの警告を参照)。

MX: 6.3+

Android API: 23+

送信者の電子メール アドレス

バグ レポートの送信元になる電子メール アドレスを入力するために使用されます。EmailSendersPassword パラメータで指定したパスワードに対応するアドレスにする必要があります。一般に、これはレポート送信用に作成された汎用アカウントにして、大量の展開、管理、保守のタスクを簡素化できるようにします。

パラメータ値入力ルール:

  • 送信者の電子メール アドレスを含む文字列

次の場合に表示: EmailEnable パラメータが [True] に設定されている場合

パラメータ名: EmailSendersID

要件:

  • MX: 6.3+
  • Android API: 23+

送信者の電子メール パスワード

バグ レポートを送信する電子メール アカウントのパスワードを入力するために使用します。EmailSendersID パラメータで指定したアドレスに対応するパスワードを使用する必要があります。

パラメータ値入力ルール:

  • 電子メール送信者のパスワードを含む 1 文字以上の文字列

次の場合に表示: EmailEnable パラメータが [True] に設定されている場合

パラメータ名: EmailSendersPassword

要件:

  • MX: 6.3+
  • Android API: 23+

送信者の電子メール サーバー

EmailSendersID パラメータで指定された送信者アカウントの電子メール サーバーを入力するために使用されます。

パラメータ値入力ルール:

  • 電子メール送信者アカウントのホスト名を含む文字列

次の場合に表示: EmailEnable パラメータが [True] に設定されている場合

パラメータ名: EmailSMTPHost

要件:

  • MX: 6.3+
  • Android API: 23+

サーバーの SMTP ポート

EmailSendersID パラメータで指定された送信者の電子メール サーバーで使用される SMTP ポートを入力するために使用されます。

パラメータ値入力ルール:

  • 送信者の電子メール サーバーが使用するポートを含む文字列

次の場合に表示: EmailEnable パラメータが [True] に設定されている場合

パラメータ名: EmailSMTPPort

要件:

  • MX: 6.3+
  • Android API: 23+

電子メール設定の有効期限

電子メール レポート設定の変更がデフォルト設定 (無効) に戻るまでの日数を入力するために使用されます。トラブルシューティング、その他の目的で一時的な設定を行うために使用します。注: 有効期限が切れると、電子メール アドレスと関連する設定が消去され、電子メールの配信が停止します。

パラメータ値入力ルール:

  • 設定の「残り日数」を示す文字列 (最低 1 日)
  • 「0」を設定すると無期限になります

次の場合に表示: EmailEnable パラメータが [True] に設定されている場合

パラメータ名: EmailTTL

要件:

  • MX: 8.1+

受信者の電子メール

バグ レポートを受信する電子メール アドレスを入力するために使用されます。

パラメータ値入力ルール:

  • 有効な電子メール アドレスを含む文字列

次の場合に表示: EmailEnable パラメータが [True] に設定されている場合

パラメータ名: EmailSendTo

要件:

  • MX: 6.3+
  • Android API: 23+

意図的なレポートの有効化/無効化

意図的にバグ レポートをトリガできるようにするかどうかを制御します。デフォルトで有効になっています。バグ レポートは、ブロードキャスト メッセージ com.symbol.mxmf.intent.START_FOR_BUG_REPORT を使用してサイレントに (ユーザー ダイアログなしで) トリガされます。

パラメータ名: EnableIntent

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 7.0+

Android API: 24+
1 true バグ レポートを意図的にトリガできるようにします。

MX: 7.0+

Android API: 24+
2 false バグ レポートを意図的にトリガできないようにします。

MX: 7.0+

Android API: 24+

スクリーンショットの有効化/無効化

バグ レポートとともにスクリーンショットを取得して保存するかどうかを制御します。デフォルトで有効になっています。

パラメータ名: EnableScreenshot

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 7.0+

Android API: 24+
1 true 各バグ レポートでスクリーンショットを取得して保存できるようにします。

MX: 7.0+

Android API: 24+
2 false バグ レポートでスクリーンショットを取得しないようにします。

MX: 7.0+

Android API: 24+

クラウド ストレージの有効化/無効化

Zebra Cloud にバグ レポートをアップロードするかどうかを制御します。この機能を有効にすると、Zebra Cloud への転送が完了するまで、データはデバイスのプライベート領域に一時的に保存されます。この事前転送データが、ユーザーやサードパーティ アプリで利用可能になるタイミングはありません。

セキュリティの警告: バグ レポートにはアプリの使用状況、場所、およびシステム ログからのその他のデータが含まれており、機密性の高い情報である可能性があります。共有は、信頼できるユーザーおよびアプリのみに限定する必要があります。

パラメータ名: CloudEnable

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 false バグ レポートが Zebra Cloud にアップロードされないようにします。

MX: 6.3+

Android API: 23+
2 true バグ レポートは Zebra Cloud にアップロードされます。

MX: 6.3+

Android API: 23+

クラウド設定の有効期限

クラウド ストレージ設定の変更がデフォルト設定 (無効) に戻るまでの日数を入力するために使用されます。トラブルシューティング、その他の目的で一時的な設定を行うために使用します。

パラメータ値入力ルール:

  • 設定の「残り日数」を示す文字列 (最低 1 日)
  • 「0」を設定すると無期限になります

次の場合に表示: CloudEnable パラメータが [True] に設定されている場合

パラメータ名: CloudTTL

要件:

  • MX: 8.1+

ダイアログ アクション

ユーザー ダイアログに表示するフィールドのタイプを選択するために使用します。これは、バグ レポートが生成されるたびにユーザーに表示される「アンケート」です。このようなダイアログは、報告されている不具合の原因となった可能性のあるユーザー アクティビティに関する情報の収集に役立ちます。ダイアログの作成は累積的に行われます。必要な質問をすべて行い、必要なデータがすべて収集されるまで、ユーザー入力フィールド (テキスト ボックス) とフィールド ラベルをいくつでも追加できます。これらのフィールドの使用方法とデバイス上での表示方法についての詳細は、上記の「概要」セクションを参照してください。

注: 適切な操作を確実に行えるよう、新規ダイアログはそれぞれ [ClearDialog] アクションから開始し、[LayoutEnd] アクションで終了する必要があります。

パラメータ名: DialogAction

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) では、Bug Report Manager のデバイス上での設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 ClearDialog 新しいダイアログ ボックス レイアウトの開始を示します。

MX: 6.3+

Android API: 23+
2 AddErrorNameTextBox バグ名を提供するテキスト ボックスを追加します。これはバグ レポートのファイル名の末尾に追加され、レポート内部でユーザーが入力したデータを含むファイルの名前になります。

MX: 6.3+

Android API: 23+
3 AddLabel テキスト ボックスにデータを入力する際に、質問や指示を行うための静的テキスト フィールド (オプション)。

MX: 6.3+

Android API: 23+
4 AddTextBox 報告されているバグに関する情報をデバイス ユーザーが入力するための、空白のテキスト ボックスを追加します。

MX: 6.3+

Android API: 23+
6 AddVoiceRecordButton バグ レポートに添付するメッセージを作成するために、音声キャプチャ機能を有効にするボタンを表示します。

MX: 6.3+

Android API: 23+
7 LayoutEnd ダイアログ ボックス レイアウトの終了を通知します。

MX: 6.3+

Android API: 23+

エラー名

報告するバグの名前をユーザーが入力できるようにします。ここに入力されたテキストはバグ レポートのファイル名に追加され (日付と時刻の後に)、ユーザーが入力したデータを含むレポートの zip ファイル内のファイル名になります。このフィールドにスペースを入力するとアンダースコアに変換され、その他のテキスト以外の文字は削除されます。ユーザーが空白のままにすると「no_user_entry」が表示されます。

パラメータ値入力ルール:

  • 問題と名前に使用する 1 文字以上の文字列

次の場合に表示: DialogAction パラメータが [AddErrorNameTextBox (2)] に設定されている場合

パラメータ名: FileNameTextBox

要件:

  • MX: 6.3+
  • Android API: 23+

テキストフィールド ラベル

空白のフィールドに情報を入力する際に、デバイス ユーザーに質問や説明を行う 1 個または複数の静的テキスト フィールドを表示するために使用します。たとえば、クラッシュの原因となったアクティビティをキャプチャする場合、テキスト フィールドの上にあるラベルに「エラーが発生する直前の操作を簡単に説明してください」などと表示します。

パラメータ値入力ルール:

  • 問題とラベルに使用する 1 文字以上の文字列

次の場合に表示: DialogAction パラメータが [AddLabel (3)] に設定されている場合

パラメータ名: ラベル

要件:

  • MX: 6.3+
  • Android API: 23+

テキスト ボックス

報告されている問題を説明するために、ユーザーが入力した内容を取得するための、1 つまたは複数の空白のテキスト フィールドを追加するために使用します。管理者はテキスト ボックスに「ヒント」テキストを挿入し、ユーザーが必要事項を入力する際にガイドする (「使用していたアプリ」など) ことができるようになります。ヒント テキストは空白だったテキスト フィールドに表示され、ユーザーが入力を開始すると消えます。生成されるバグ レポートで、ヒント テキストは、ユーザーがそのフィールドに入力したデータのラベルになります。

パラメータ値入力ルール:

  • 報告される問題の説明を含む 1 文字以上の文字列

次の場合に表示: DialogAction パラメータが [True] に設定されている場合

パラメータ名: AddTextBox

要件:

  • MX: 6.3+
  • Android API: 23+

ダイアログ タイムアウトの設定

ユーザーが生成したバグ レポート情報収集用のダイアログが非アクティブのまま 60 秒間 (デフォルト値) 経過した後、または DialogTimeout パラメータで指定したカスタム時間間隔が経過した後に、ダイアログを自動的に閉じるかどうかを制御します。ユーザーが操作しなかったためにダイアログが閉じられた場合、ファイル名の末尾に「no_user_entry」が付加されたバグ レポートが生成されます。その時点でテキスト ボックスに収集されていたデータはすべて保持されます。

パラメータ名: SetDialogTimeout

オプション 名前 説明注記 要件
0 なし この値 (またはこのパラメータが XML に存在しないこと) によって、Bug Report Manager の設定は何も変更されません。以前に選択された設定がすべて保持されます。

MX: 6.3+

Android API: 23+
1 true ダイアログのタイムアウトをカスタム値に設定できるようにします。

MX: 6.3+

Android API: 23+

ダイアログ タイムアウト

ユーザー ダイアログのタイムアウト間隔 (ms 単位) を入力するために使用されます。その時間が経過した後、ダイアログは自動的に閉じられ、ユーザーが [送信] ボタンを押した場合と同じようにバグ レポートが送信されます。この時点でテキスト ボックスに収集されていたデータはすべて保持されます。デフォルトのタイムアウトは 60 秒 (60000ms) で、ユーザーがダイアログで何か操作をするたびにリセットされます。

パラメータ値入力ルール:

  • タイムアウト間隔 (ms 単位) を含む 1 文字以上の文字列

次の場合に表示: SetDialogTimeout パラメータが [True] に設定されている場合

パラメータ名: DialogTimeout

要件:

  • MX: 6.3+
  • Android API: 23+

例

Zebra Bug Reporting 有効化、バグ レポートのボタンを表示、レポートをフラッシュに保存


<wap-provisioningdoc>
    <characteristic type="BugReportMgr" version="6.3" >
        <parm name="BugReportProfile" value="new"/>
        <parm name="EnableBRInPwrMenu" value="True"/>
        <characteristic type="DialogDetails">
            <parm name="DialogAction" value="none"/>
        </characteristic>
        <characteristic type="StorageDetails">
            <parm name="StorageEnable" value="True"/>
            <parm name="BugReportFilePath" value="/storage/sdcard0/BugReports/"/>
        </characteristic>
        <characteristic type="EmailDetails">
            <parm name="EmailEnable" value="none"/>
        </characteristic>
        <characteristic type="CloudDetails">
            <parm name="CloudEnable" value="none"/>
        </characteristic>
            <parm name="SetDialogTimeout" value="none"/>
    </characteristic>
</wap-provisioningdoc>

Zebra Bug Reporting 有効化、バグ レポートのボタンを表示、レポートを電子メールで送信


<wap-provisioningdoc>
    <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="new"/>
            <parm name="EnableBRInPwrMenu" value="True"/>
        <characteristic type="DialogDetails">
            <parm name="DialogAction" value="none"/>
        </characteristic>
        <characteristic type="StorageDetails">
            <parm name="StorageEnable" value="none"/>
        </characteristic>
        <characteristic type="EmailDetails">
            <parm name="EmailEnable" value="True"/>
            <parm name="EmailSendTo" value="BugReportRecipient@domain.com"/>
            <parm name="EmailSendersID" value="BugReportSenderAccount@domain.com"/>
            <parm name="EmailSendersPassword" value="Bug_report_acct_password"/>
            <parm name="EmailSMTPHost" value="smtp.domain.com"/>
            <parm name="EmailSMTPPort" value="25"/>
        </characteristic>
        <characteristic type="CloudDetails">
            <parm name="CloudEnable" value="none"/>
        </characteristic>
            <parm name="SetDialogTimeout" value="none"/>
    </characteristic>
    </wap-provisioningdoc>

Zebra Bug Reporting 有効化、バグ レポートのボタンを表示、レポートを Zebra Cloud にアップロード


<wap-provisioningdoc>
<characteristic type="BugReportMgr" version="6.3" >
    <parm name="BugReportProfile" value="new"/>
    <parm name="EnableBRInPwrMenu" value="True"/>
    <characteristic type="DialogDetails">
        <parm name="DialogAction" value="none"/>
    </characteristic>
    <characteristic type="StorageDetails">
        <parm name="StorageEnable" value="none"/>
    </characteristic>
    <characteristic type="EmailDetails">
        <parm name="EmailEnable" value="none"/>
    </characteristic>
    <characteristic type="CloudDetails">
        <parm name="CloudEnable" value="True"/>
    </characteristic>
        <parm name="SetDialogTimeout" value="none"/>
</characteristic>
</wap-provisioningdoc>

[ファイル名]、[ラベル]、[エラーの説明; 音声録音] ボタンのテキスト ボックスを含むダイアログを作成

        
        <wap-provisioningdoc>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="ClearDialog"/>
            </characteristic>
        </characteristic>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="AddErrorNameTextBox"/>
                <parm name="FileNameTextBox" value="Name for this error"/>
            </characteristic>
        </characteristic>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="AddLabel"/>
                <parm name="Label" value="Activity just before the error:"/>
            </characteristic>
        </characteristic>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="AddTextBox"/>
                <parm name="TextBox" value="Description of the error"/>
            </characteristic>
        </characteristic>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="AddVoiceRecordButton"/>
            </characteristic>
        </characteristic>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="LayoutEnd"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

Zebra Bug Reporting 有効化、バグ レポートのボタンを表示、フラッシュに保存、電子メールで送信、[ファイル名] および [エラーの説明] テキスト ボックスを含むダイアログを作成

        
<wap-provisioningdoc>
    <characteristic type="BugReportMgr" version="6.3" >
        <parm name="BugReportProfile" value="new"/>
        <parm name="EnableBRInPwrMenu" value="True"/>
        <characteristic type="DialogDetails">
            <parm name="DialogAction" value="none"/>
        </characteristic>
        <characteristic type="StorageDetails">
            <parm name="StorageEnable" value="True"/>
            <parm name="BugReportFilePath" value="/storage/sdcard0/BugReports/"/>
        </characteristic>
        <characteristic type="EmailDetails">
            <parm name="EmailEnable" value="True"/>
            <parm name="EmailSendTo" value="BugReportRecipient@domain.com"/>
            <parm name="EmailSendersID" value="BugReportSenderAccount@domain.com"/>
            <parm name="EmailSendersPassword" value="Bug_report_acct_passw0rd"/>
            <parm name="EmailSMTPHost" value="smtp.domain.com"/>
            <parm name="EmailSMTPPort" value="25"/>
        </characteristic>
        <characteristic type="CloudDetails">
            <parm name="CloudEnable" value="none"/>
        </characteristic>
            <parm name="SetDialogTimeout" value="none"/>
    </characteristic>
        <characteristic type="BugReportMgr" version="6.3" >
            <parm name="BugReportProfile" value="none"/>
            <parm name="EnableBRInPwrMenu" value="none"/>
            <characteristic type="DialogDetails">
                <parm name="DialogAction" value="ClearDialog"/>
            </characteristic>
        </characteristic>
    <characteristic type="BugReportMgr" version="6.3" >
        <parm name="BugReportProfile" value="none"/>
        <parm name="EnableBRInPwrMenu" value="none"/>
        <characteristic type="DialogDetails">
            <parm name="DialogAction" value="AddErrorNameTextBox"/>
            <parm name="FileNameTextBox" value="Name for this error"/>
        </characteristic>
    </characteristic>
    <characteristic type="BugReportMgr" version="6.3" >
        <parm name="BugReportProfile" value="none"/>
        <parm name="EnableBRInPwrMenu" value="none"/>
        <characteristic type="DialogDetails">
            <parm name="DialogAction" value="AddTextBox"/>
            <parm name="TextBox" value="Description of the error"/>
        </characteristic>
    </characteristic>
    <characteristic type="BugReportMgr" version="6.3" >
        <parm name="BugReportProfile" value="none"/>
        <parm name="EnableBRInPwrMenu" value="none"/>
        <characteristic type="DialogDetails">
            <parm name="DialogAction" value="LayoutEnd"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>