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

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

주제:

작성 대상:

관리자
사용자
개발자

이 문서에는 몇 가지 문제 해결 시나리오가 포함되어 있습니다. 각 시나리오에 대해 문제를 해결하기 위한 몇 가지 단계가 제공됩니다. 다음 단계를 수행하고 문제가 지속되면 로그를 가져오고 오류/경고를 검토하도록 로거를 구성합니다. 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-form

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

다음 번들의 상태가 "활성"인지 확인하십시오.
- scala-lang.bundle [osgi]
(com.adobe.livecyclecala-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://<server>:<port>/crx/de에서 CRX DE에 로그인합니다.
왼쪽의 폴더 계층에서 /etc/clientlibs/fd/xfaforms/ 로 이동합니다. 폴더에 나열된 css.txt 파일을 엽니다.
- 프로필
- 런타임
- 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://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<some path>&template=<xdp 파일 이름>&log=1-a9-b9-c9&debugClientLibs=true).
chrome과 같은 데스크탑 브라우저에서 개발자 도구 > 콘솔로 이동합니다.
로그를 열어 오류 유형을 식별합니다. 로그에 대한 자세한 내용은 HTML 5 양식에 대한 로그를 참조하십시오.

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

note note
NOTE
스크립팅에 실패한 경우 양식의 PDF 렌디션에서도 동일한 문제가 발생하는지 확인하십시오. 그렇다면 양식 스크립팅 논리에 문제가 있습니다.

문제: 양식을 제출할 수 없음 problem-unable-to-submit-the-form

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

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

데스크톱 브라우저에서 추가 쿼리 매개 변수 debugClientLibs=true 을(를) 사용하여 양식을 렌더링한 다음 개발자 도구 > 리소스로 이동하여 I18N.css 파일을 확인하십시오.
파일을 사용할 수 없는 경우 https://<server>:<port>/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이 올바른지 확인합니다.
브라우저가 이 유형의 이미지를 지원하는지 확인하십시오.
예외 세부 정보에서 에 의해 발생한 단어를 검색합니다.

가능한 이유는 URL에 있는 하나 이상의 매개 변수가 올바르지 않기 때문입니다.

다음 매개 변수를 확인하십시오.
단계 텍스트