HTML5 フォーム のデバッグ

注意

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

このドキュメントでは、いくつかのトラブルシューティングシナリオを説明します。 各シナリオで、問題のトラブルシューティングにいくつかの手順を示します。 次の手順に従い、問題が解決しない場合は、ロガーを設定してエラーや警告のログを取得し、確認します。 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 などのデスクトップブラウザーで、デベロッパーツール/コンソールに移動します。

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

  4. 開発者ツール/コンソールに移動します。 スタックトレースを使用して、エラーの原因となっているコードを見つけます。 エラーをデバッグして問題を解決します。

    メモ

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

問題:フォームを送信できません

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

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

  1. 追加のクエリパラメーターでフォームをレンダリング debugClientLibs=true デスクトップブラウザーで、デベロッパーツール/リソースに移動し、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. デスクトップブラウザーで、デベロッパーツール/リソースに移動します。

    画像が表示される場合は、Frames の左側でチェックします。

このページ