ドキュメントAEM 6.4Forms ガイド

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • User
CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

ロガーユーティリティを設定して、HTML5 forms のログの作成を開始できます。 ロガーユーティリティには様々なレベルがあり、必要に応じてレベルを設定できます。 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

この方法を使用すると、特定のリクエストのログを生成できます。 リクエストパラメーターの名前は ログ. ログ 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
TRACE
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 レベル：TRACE
NOTE
各ログカテゴリ a(xfa)、b(xfaView) および c(xfaPerf) のデフォルトのログレベルは 2(ERROR) です。 したがって、ログ設定の場合は次のようになります。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. を検索してクリックします。 モバイルForms設定.

  3. 前の節で説明したように、「 Debug Options 」テキストボックスにログ設定を入力します。次に例を示します。 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
a6ebf046-2b8b-4543-bd46-42a0d77792da