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

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

サーバー側のログの設定

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

  1. https://[server]:[port]/system/console/configMgr にアクセスします。Apace Sling logging logger configuration​オプションを探して開きます。 ダイアログボックスが表示されます。

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

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

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

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

    メモ

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

  4. Logger を 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 ERROR
1 WARN
4 INFO
5 DEBUG
6 TRACE
7 ALL

ロガーカテゴリ

ログカテゴリ 説明
がない場合、 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 (ユーザー指定TRACE)
a (xfaPerf):2 （デフォルトレベルのエラー）

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

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

  1. https://[server]:[port]/system/console/configMgrでCQ Configuration Managerにログインし、管理者の資格情報を使用してログインします。

  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​に変更し、「保存」をクリックします。

このページ