HTML5 フォームのデバッグ debugging-html-forms

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

管理者
ユーザー
開発者

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

問題：フォームをレンダリングすると、org.apache.sling.api.SlingException 例外ページが表示される problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page

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

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

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

パラメーター

説明

テンプレート

テンプレートのファイル名

contentRoot

テンプレートと関連リソースが存在するパス

dataRef

テンプレートと結合されているデータファイルの絶対パス。
メモ：パスはデータファイルの絶対パスを定義します。

データ

テンプレートと結合される UTF-8 でエンコードされたデータバイト。

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

指定したパラメーターが正しいことを確認します。パラメーター関する詳しい情報については、パラメーターのレンダリングを参照してください。
https://<server>:<port>/crx/packmgr/index.jsp で CRX パッケージマネージャーにログインし、以下のパッケージが正しくインストールされているかどうか確認します。
- adobe-lc-forms-content-pkg-<version>.zip
- adobe-lc-forms-runtime-pkg-<version>.zip
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）

問題：フォームがスタイルなしでレンダリングされる problem-form-renders-without-styles

お使いのブラウザーで、開発ツール を開きます。profile.css が存在することを確認します。
profile.css ファイルが存在しない場合は、https://<server>:<port>/crx/de で CRX DE にログインします。
左のフォルダー階層で、/etc/clientlibs/fd/xfaforms/ に移動します。フォルダーにリストされている css.txt ファイルを開きます。
- プロファイル
- runtime
- scrollnav
- ツールバー
- xfalib

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

code language-css
`#base=css application.css dialog.css datepicker.css scribble.css listboxwidget.css`

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

問題：予期しないエラーが発生した problem-unexpected-error-encountered

フォームの URL にクエリーパラメーター「debugClientLibs」を追加し、その値を「true」に設定します（例：https://<サーバー>:<ポート>/content/xfaforms/profiles/test.html?contentRoot=<パス>&template=<xdp ファイル名>&log=1-a9-b9-c9&debugClientLibs=true）
Chrome のようなデスクトップブラウザーでデベロッパーツール／コンソールに移動します。
ログを開いて、エラーのタイプを特定します。ログについて詳しくは、HTML5 フォームのログを参照してください。

デベロッパーツール／コンソールに移動します。スタックトレースを使用して、エラーの原因となっているコードを探します。エラーをデバッグして問題を解決します。

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

問題：フォームを送信できない problem-unable-to-submit-the-form

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

問題：ローカライズされたエラーメッセージが表示されない problem-localized-error-messages-do-not-display

デスクトップブラウザーで、追加のクエリパラメーター debugClientLibs=true でフォームをレンダリングしてから、デベロッパーツール／リソースに移動して、I18N.css のファイルの存在を確認します。
ファイルが存在しない場合は、https://<サーバー>:<ポート>/crx/de で CRX DE にログインします。
左のフォルダー階層で /libs/fd/xfaforms/clientlibs/I18N に移動し、次のファイルとフォルダーが存在することを確認します。
- Namespace.js
- LogMessages.js
- 言語用のフォルダー
上記のファイルまたはフォルダーで存在しないものがある場合は、adobe-lc-forms-runtime-pkg-<version>.zip パッケージを再度インストールします。
ロケールの名前と同じ名前のフォルダーに移動し、そのコンテンツを確認します。フォルダーには次のファイルが含まれている必要があります。
- I18N.js
- js.txt

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

code language-javascript
`../Namespace.js I18N.js ../LogMessages.js`

問題：画像が表示されない problem-image-not-showing-up

画像 URL が正しいことを確認します。
ブラウザーがこのタイプの画像をサポートしているかどうかを確認します。
例外詳細で、「caused by」という語句を検索します。

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

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