HTML5 フォーム のデバッグ

このドキュメントにはさまざまなトラブルシューティングのシナリオが含まれています。各シナリオにつき、問題をトラブルシューティングするためにいくつかの手順が提供されています。次の手順を実行し、引き続き問題が発生する場合は、ロガーを設定してエラーや警告のログを取得し、確認します。HTML5 フォームのロギングについて詳しくは、HTML5 フォームのログの生成を参照してください。

問題：フォームをレンダリングすると、org.apache.sling.api.SlingException 例外ページが表示される

例外詳細で、「caused by」という語句を検索します。

推定原因は、URL にある 1 つ以上のパラメーターが間違っていることです。

次のパラーメーターを確認します。

パラメーター 説明
テンプレート テンプレートのファイル名
contentRoot テンプレートと関連リソースが存在するパス
dataRef テンプレートと結合されているデータファイルの絶対パス。
注意：パスはデータファイルの絶対パスを定義します。
データ テンプレートと結合される UTF-8 でエンコードされたデータバイト。

問題：フォームをレンダリングできない（エラーメッセージが表示される）

  1. 指定したパラメーターが正しいことを確認します。パラメーター関する詳しい情報については、パラメーターのレンダリングを参照してください。

  2. https://<server>:<port>/crx/packmgr/index.jsp で CRX パッケージマネージャーにログインし、以下のパッケージが正しくインストールされているかどうか確認します。

    • adobe-lc-forms-content-pkg-<version>.zip
    • adobe-lc-forms-runtime-pkg-<version>.zip

  3. https://<server>:<port>/system/console/bundles で CQ web コンソール（Felix コンソール）にログインします。

    次のバンドルのステータスが「アクティブ」であることを確認します。

    • scala-lang.bundle [osgi]

    （com.adobe.livecyclescala-lang.bundle）

    • Adobe XFA Forms Renderer

    （com.adobe.livecycle.adobe-lc-forms-core）

    • Adobe XFA Forms LC Connector

    （com.adobe.livecycle.adobe-lc-forms-lc-connector）

問題：フォームがスタイルなしでレンダリングされる

  1. お使いのブラウザーで、開発ツール​を開きます。profile.css が存在することを確認します。

  2. profile.css ファイルが存在しない場合は、https://<server>:<port>/crx/de で CRX DE にログインします。

  3. 左のフォルダー階層で、/etc/clientlibs/fd/xfaforms/ に移動します。フォルダーにリストされている css.txt ファイルを開きます。

    • プロファイル
    • runtime
    • scrollnav
    • ツールバー
    • xfalib

  4. css.txt 内に記載されているファイルが /libs/fd/xfaforms/clientlibs/xfalib/css の CRX DE lite 内に存在することを確認します。

    #base=css
application.css
dialog.css
datepicker.css
scribble.css
listboxwidget.css

  5. これらのファイルがない場合、adobe-lc-forms-runtime-pkg-<version>.zip パッケージを再びインストールします。

問題：予期しないエラーが発生した

  1. フォームの URL にクエリーパラメーター「debugClientLibs」を追加し、その値を「true」に設定します（例：https://<サーバー>:<ポート>/content/xfaforms/profiles/test.html?contentRoot=<パス>&template=<xdp ファイル名>&log=1-a9-b9-c9&debugClientLibs=true）

  2. Chrome のようなデスクトップブラウザーでデベロッパーツール／Console に移動します。

  3. ログを開いて、エラーのタイプを特定します。ログの詳細については、「HTML5 フォームのログ」を参照してください。

  4. デベロッパーツール／Console に移動します。スタックトレースを使用して、エラーを起こしているコードを探します。エラーをデバッグして問題を解決します。

    メモ

    スクリプティングの失敗の場合は、フォームの PDF レンダリングでも問題が発生するかを確認します。発生する場合は、フォームスクリプティングのロジックに問題があります。

問題：フォームを送信できない

  1. AEM サーバーにアクセスする権限を持っていること、およびサーバーに接続されていることを確認します。
  2. パラメーター submitUrl が正しいことを確認します。
  3. 1-a5-b5-c5 をデバッグオプションとして使用し、HTML5 フォームのログに記載されている通りにクライアントサイドログを有効にします。次に、フォームをレンダリングし、送信をクリックします。ブラウザーのデバッグコンソールを開き、エラーがあるかどうかを確認します。
  4. 「HTML5 フォームのログ」に記載されている通りに、サーバーログを見つけます。サーバーログで送信の際にエラーが発生したかを確認します。

問題：ローカライズされたエラーメッセージが表示されない

  1. デスクトップブラウザーで、追加のクエリーパラメーター debugClientLibs=true でフォームをレンダリングしてから、デベロッパーツール／Resources に移動して、I18N.css のファイルの存在を確認します。

  2. ファイルが存在しない場合は、https://<サーバー>:<ポート>/crx/de で CRX DE にログインします。

  3. 左のフォルダー階層で /libs/fd/xfaforms/clientlibs/I18N に移動し、次のファイルとフォルダーが存在することを確認します。

    • Namespace.js
    • LogMessages.js
    • 言語用のフォルダー

  4. 上記のファイルまたはフォルダーで存在しないものがある場合は、adobe-lc-forms-runtime-pkg-<version>.zip パッケージを再びインストールします。

  5. ロケールの名前と同じ名前のフォルダ-に移動し、そのコンテンツを確認します。フォルダーには次のファイルが含まれている必要があります。

    • I18N.js
    • js.txt

  6. js.txt のコンテンツを確認して、次のエントリがあることを確かめます。

    ../Namespace.js
I18N.js
../LogMessages.js

問題：画像が表示されない

  1. 画像 URL が正しいことを確認します。

  2. ブラウザーがこのタイプの画像をサポートしているかどうかを確認します。

  3. 例外詳細で、「caused by」という語句を検索します。

    推定原因は、URL にある 1 つ以上のパラメーターが間違っていることです。

    次のパラーメーターを確認します。
    ステップテキスト

パラメーター 説明
テンプレート テンプレートのファイル名
contentRoot テンプレートと関連リソースが存在するパス
dataRef テンプレートと結合されているデータファイルの絶対パス。
注意：パスはデータファイルの絶対パスを定義します。
データ テンプレートと結合される UTF-8 でエンコードされたデータバイト。

  1. デスクトップブラウザーで、デベロッパーツール／Resources に移動します。

    画像が表示されるか、左側で「Frames」を確認します。

このページ