HTML5 フォーム内でのログの有効化

最終更新日: 2022-06-14
  • トピック:
  • Mobile Forms
    このトピックの詳細を表示
  • 作成対象:
  • User

ロガーユーティリティを設定することで、HTML5フォームでログの作成を開始することができます。ロガーユーティリティにはいくつかのレベルがあり、要件に応じてレベルを設定することができます。HTML5フォームは、サーバーコンポーネントとクライアントコンポーネントから構成されています。両方のコンポーネントに対してログを設定できます。

サーバー側のログの設定

次の手順を実行して、サーバーサイドログを構成します。

  1. https://'[server]:[port]'/system/console/configMgr に移動します。Apace Sling ロギングロガー設定 オプションを探して開きます。ダイアログボックスが表示されます。

    Apace Sling ロギングのロガー設定オプションのダイアログボックス

    Apace Sling ロギングロガー設定オプション

  2. ログレベル​を​デバッグ​に変更します。

  3. ログファイル​のパスと名前を指定します。

    メモ

    HTML5 Forms ログディレクトリ内にログを生成する場合は、ファイル名の前に …/logs/ を追加します。

  4. ロガー​を HTMLFormsPerfLogger に変更します。「保存」をクリックします。

クライアントロギングの設定

次の方法により、HTML5 フォームのクライアント側のロギングを有効にできます。

  • log という名前の要求パラメーターの使用
  • CQ Configuration Manager の使用

要求パラメーターの使用によるログの有効化

この方法を使用して、特定の要求に対するログを生成できます。リクエストパラメーター名は log です。ログ URL は次のとおりです。

https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<path of the folder containing form xdp>&template=<name of the xdp>&log=<log configuration>.

ログの設定はログレベルとロガーカテゴリで構成されています。

ログの宛先

ログの宛先 説明
1 ログはブラウザーのコンソールに送信されます。
2 ログはクライアント側の JavaScript オブジェクトに収集され、サーバーにポストできます。
3 両方の上記のオプション

ログのレベル

ログレベル 説明
0 オフ
1 FATAL
2 エラー
3 警告
4 情報
5 デバッグ
6 TRACE
7 ALL

ロガーカテゴリ

ログカテゴリ 説明
a xfa (スクリプティングエンジン関連ログ)
b xfaView (レイアウトエンジン関連ログ)
c xfaPerf (パフォーマンス関連ログ)

ログの設定

ログ URL では、ログ設定クエリーの文字列パラメーターは次のとおりに定義します。

{destination}-{a level}-{b level}-{c level}

次に例を示します。

ログの設定 詳細
2-a4-b5-c6
保存場所:Server
xfa レベル:INFO
xfaView レベル:DEBUG
xfaPerf レベル: TRACE
メモ

a(xfa)、b(xfaView)、および c(xfaPerf)のそれぞれのログカテゴリに対するデフォルトログレベルは 2(エラー)です。そのため、ログ設定 2-b6 では、異なるカテゴリのログレベルは:
a(xfa):2(デフォルトレベルのエラー)
b(xfaView):6(ユーザー指定トレース)
a(xfaPerf):2(デフォルトレベルのエラー)

Configuration Manager の使用によるログの有効化

ログを有効化するために Configuration Manager を使用すると、ログが再び無効化されるまで、すべてのレンダリング要求に対してログが生成されます。

  1. CQ Configuration Manager に https://'[server]:[port]'/system/console/configMgr でログインし、管理者の資格情報でログインしてください。

  2. 「LC Forms Configurations」​を探してクリックします。

  3. 「Debug Options」テキストボックスで、前のセクションで説明されたとおりにログ設定を入力します。例:2-a4-b5-c6

    Forms 設定

    Forms 設定

ログのアップロード

宛先が 1 として設定されている場合、すべてのクライアントスクリプトのログメッセージはコンソールに送信されます。管理者がサーバーログと供にこれらのログを必要とする場合は、出力先レベルを 2 に設定します。このレベルでは、すべてのログはクライアント側の JS オブジェクトに収集されて、フォームがデフォルトプロファイルでレンダリングされる場合、ツールバーの​既存のフィールドのハイライト​ボタンの左に​ログを送信​ボタンが表示されます。ユーザーがリンクをクリックすると、収集されたすべてのログはサーバーに投稿され、サーバー上の設定されたエラーログファイルに記録されます。

デフォルトでは、すべての情報が /crx-repository/logs/ ディレクトリに保存されている error.log ファイルに追加されます。

ログファイルの場所と名前を変更するには、次の操作を実行します。

  1. 管理者として「 Configuration Manager」にログインします。Configuration Manager のデフォルトの URL は、https://'[server]:[port]'/system/console/configMgr です。

  2. 「Apace Sling ロギングロガー設定」​をクリックします。ダイアログボックスが表示されます。

    logconfig-1

  3. ログレベル​をデバッグに変更します。

  4. ログファイル​のパスと名前を指定します。

    メモ

    他のログファイルが保存されている同じディレクトリにログを作成するには、Log Files プロパティで …/logs/<filename> を指定します。

  5. Logger を HTMLFormsPerfLogger に変更し、「保存」をクリックします。

このページ