HTML5 フォーム内でのログの有効化 enable-logging-for-html-forms

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

サーバーサイドのログの設定 configuring-server-side-logging

次の手順を実行して、サーバー側のログを設定します。

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

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

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

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

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

    note note
    NOTE
    HTML5 Forms ログディレクトリ内にログを生成する場合は、ファイル名の前に …/logs/ を追加します。
  4. ロガー ​を HTMLFormsPerfLogger に変更します。「保存」をクリックします。

クライアントログの設定 configuring-client-logging

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

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

リクエストパラメーターの使用によるログの有効化 enabling-logging-using-request-parameter

この方法を使用して、特定のリクエストに対するログを生成できます。リクエストパラメーター名は 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>.

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

ログの宛先 log-destination

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

ログレベル log-levels

ログレベル
説明
0
オフ
1
重大
2
エラー
3
警告
4
情報
5
デバッグ
6
トレース
7
すべて

ロガーカテゴリ logger-categories

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

ログの設定 log-configuration

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

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

次に例を示します。

ログの設定
説明
2-a4-b5-c6
保存場所:サーバー
xfa レベル:情報
xfaView レベル:デバッグ
xfaPerf レベル:トレース
NOTE
a(xfa)、b(xfaView)、および c(xfaPerf)のそれぞれのログカテゴリに対するデフォルトログレベルは 2(エラー)です。そのため、ログ設定 2-b6 では、異なるカテゴリのログレベルは:
a(xfa):2(デフォルトレベルのエラー)
b(xfaView):6(ユーザー指定トレース)
a(xfaPerf):2(デフォルトレベルのエラー)

Configuration Manager の使用によるログの有効化 enabling-logging-using-configuration-manager

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

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

  2. Mobile Forms の設定 ​を探してクリックします。

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

    Forms 設定

    Forms 設定

ログのアップロード uploading-logs

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

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

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

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

  2. Apache Sling Logging Logger Configuration」をクリックします。ダイアログボックスが表示されます。

    logconfig-1

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

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

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2