HTML 5 양식 디버깅 debugging-html-forms

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

주제:
Mobile Forms

작성 대상:

User

CAUTION

AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

이 문서에는 몇 가지 문제 해결 시나리오가 포함되어 있습니다. 각 시나리오에 대해 문제를 해결하는 몇 가지 단계가 제공됩니다. 다음 단계를 수행하고 문제가 지속되면 로거를 구성하여 오류/경고를 가져오고 검토합니다. HTML5 양식 로깅에 대한 자세한 내용은 다음을 참조하십시오 HTML 5 양식에 대한 로그 생성.

문제: 양식을 렌더링할 때 org.apache.sling.api.SlingException 예외 페이지가 표시됩니다 problem-when-rendering-the-form-i-see-org-apache-sling-api-slingexception-exception-page

예외 세부 정보에서 단어를 검색합니다 원인.

가능한 이유는 URL에 있는 하나 이상의 매개 변수가 잘못되었기 때문입니다.

다음 매개 변수를 확인합니다.

매개변수

설명

템플릿

템플릿의 파일 이름입니다

contentRoot

템플릿 및 관련 리소스가 상주하는 경로

dataRef

템플릿에 병합되는 데이터 파일의 절대 경로입니다.
참고: 경로는 데이터 파일의 절대 경로를 정의합니다.

데이터

템플릿과 병합되는 UTF-8 인코딩 데이터 바이트입니다.

문제: 양식을 렌더링할 수 없습니다(오류 메시지가 표시됨). problem-unable-to-render-a-form-an-error-message-is-displayed

지정한 매개 변수가 올바른지 확인합니다. 매개 변수에 대한 자세한 내용은 렌더링 매개 변수.
CRX 패키지 관리자에 로그인(https://)<server>:<port>/crx/packmgr/index.jsp) 다음 패키지가 올바르게 설치되었는지 확인하십시오.
- adobe-lc-forms-content-pkg-<version>.zip
- adobe-lc-forms-runtime-pkg-<version>.zip
https://에서 CQ 웹 콘솔(Felix Console)에 로그인합니다.<server>:<port>/system/console/bundles.

다음 번들의 상태가 "활성"인지 확인합니다.
- scala-lang.bundle [osgi]
(com.adobe.livecyclescala-lang.bundle)
- Adobe XFA Forms 렌더러
(com.adobe.livecycle.adobe-lc-forms-core)
- Adobe XFA Forms LC 커넥터
(com.adobe.livecycle.adobe-lc-forms-lc-connector)

문제: 양식이 스타일 없이 렌더링됩니다. problem-form-renders-without-styles

브라우저에서 을 엽니다. 개발자 도구. profile.css가 사용 가능한지 확인하십시오.
profile.css 파일을 사용할 수 없는 경우 https://에서 CRX DE에 로그인합니다<server>:<port>/crx/de를 입력합니다.
왼쪽의 폴더 계층 구조에서 /etc/clientlibs/fd/xfaforms/ 로 이동합니다. 폴더에 나열된 css.txt 파일을 엽니다.
- 프로필
- 런타임
- 스크롤 탐색
- 도구 모음
- 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://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path="">&template=<name of="" xdp="" file="">&log=1-a9-b9-c9&debugClientLibs=true)
chrome과 같은 데스크탑 브라우저에서 개발자 도구 -> 콘솔로 이동합니다.
로그를 열어 오류 유형을 식별합니다. 로그에 대한 자세한 내용은 HTML5 양식에 대한 로그.

개발자 도구 -> 콘솔로 이동합니다. 스택 추적을 사용하여 오류를 일으키는 코드를 찾습니다. 오류를 디버깅하여 문제를 해결합니다.

note note
NOTE
스크립팅이 실패한 경우 양식의 PDF 변환 중에 동일한 문제가 발생하는지 확인하십시오. yes이면 양식 스크립팅 논리에 문제가 발생합니다.

문제: 양식을 제출할 수 없습니다. problem-unable-to-submit-the-form

AEM 서버에 액세스할 수 있는 권한이 있고 서버에 연결되어 있는지 확인합니다.
submitUrl 매개 변수가 올바른지 확인합니다.
에 언급된 대로 클라이언트 측 로그를 활성화합니다. HTML5 양식에 대한 로그 디버그 옵션을 로 사용 1-a5-b5-c5. 그런 다음 양식을 렌더링하고 제출을 클릭합니다. 브라우저 디버그 콘솔을 열고 오류가 있는지 확인합니다.
에서 언급한 대로 서버 로그를 찾습니다. HTML5 양식에 대한 로그. 전송 중에 서버 로그에 오류가 있는지 확인하십시오.

문제: 현지화된 오류 메시지가 표시되지 않습니다 problem-localized-error-messages-do-not-display

추가 쿼리 매개 변수를 사용하여 양식을 렌더링합니다. debugClientLibs=true 데스크탑 브라우저에서 개발자 도구 -> 리소스로 이동한 후 I18N.css 파일을 확인합니다.
파일을 사용할 수 없는 경우 https://에서 CRX DE에 로그인합니다<server>:<port>/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-none
`../Namespace.js I18N.js ../LogMessages.js`

문제: 이미지가 표시되지 않음 problem-image-not-showing-up

이미지 URL이 올바른지 확인합니다.
브라우저가 이 유형의 이미지를 지원하는지 확인합니다.
예외 세부 정보에서 단어를 검색합니다 원인.

가능한 이유는 URL에 있는 하나 이상의 매개 변수가 잘못되었기 때문입니다.

다음 매개 변수를 확인합니다. 단계 텍스트