XDP 기반 적응형 양식에서 XFA 지원 xfa-support-in-xdp-based-adaptive-forms

소개 introduction

새 적응형 양식 만들기또는 AEM Sites 페이지에 적응형 양식 추가작업을 할 때 현대적이고 확장 가능한 데이터 캡처 핵심 구성 요소를 사용하는 것이 좋습니다. 이러한 구성 요소는 적응형 양식 만들기 작업이 대폭 개선되어 우수한 사용자 경험을 보장할 수 있게 되었음을 나타냅니다. 이 문서에서는 기초 구성 요소를 사용하여 적응형 양식을 작성하는 이전 접근법에 대해 설명합니다.

적응형 양식은 다음을 포함하여 XDP 파일에 정의된 다양한 XFA 이벤트, 속성, 스크립트 및 유효성 검사를 지원합니다.

  • XDP 파일의 이벤트에 정의된 스크립트 실행.
  • XDP 파일의 필드에 대한 기본값 및 동작 속성 캡처
  • XDP 파일에 정의된 유효성 검사 스크립트 실행.

XDP 파일을 기반으로 적응형 양식을 만들면 양식 작성 UI에서 속성, 이벤트 및 유효성 검사가 자동으로 채워집니다. 그러나 양식 작성자는 이러한 요소 중 일부를 재정의하여 대체 경험을 만들 수 있습니다.

이 문서에서는 적응형 양식에서 지원되는 XFA 이벤트, 속성 및 유효성 검사를 나열하고 적응형 양식에서 이를 재정의하는 방법에 대해 설명합니다.

적응형 양식에서 지원되는 XFA 요소 및 해당 매핑 supported-xfa-elements-and-their-mapping-in-adaptive-forms-br

필드 fields

XDP 파일을 사용하여 적응형 양식을 만들 때 XFA 필드를 적응형 양식으로 드래그 앤 드롭할 수 있습니다. 다음 표에는 XFA 필드가 적응형 양식 필드에 매핑되는 방법이 나와 있습니다.

XFA 필드 또는 컨테이너
해당 적응형 양식 구성 요소
버튼
버튼
체크 상자
체크 상자
목록 상자
드롭다운 목록
날짜/시간 필드
날짜 선택기
서명 낙서
낙서 서명
숫자 필드
숫자 상자
십진수 필드
숫자 상자
텍스트 필드
텍스트 상자
암호 필드
암호 상자
이미지
이미지
텍스트
텍스트
하위 양식
패널
영역(그룹)
패널
하위 양식 집합
패널

속성 properties

다음 표에서는 XDP 파일에 정의된 다양한 XFA 스크립트가 적응형 양식에서 작동하는 방식을 캡처합니다.

XFA 구성 요소 속성
적응형 양식의 해당 동작
somExpression
적응형 양식의 바인드 참조(bindRef) 속성에 매핑됩니다.
현재 상태
적응형 양식의 표시 속성에 매핑됩니다. Visibility 표현식을 사용하여 재정의할 수 있습니다.
액세스
적응형 양식의 활성화된 속성에 매핑됩니다. Access 식을 사용하여 재정의할 수 있습니다.
접근성: 역할
적응형 양식의 역할 속성에 매핑됩니다.
액세스 가능성: speakPriority
적응형 양식의 speakPriority 속성에 매핑됩니다.
접근성: speakText
적응형 양식의 사용자 지정 접근성 텍스트에 매핑됩니다.
접근성: 툴팁
적응형 양식의 짧은 설명 속성에 매핑됩니다.
캡션 (모든 필드 유형)
적응형 양식의 제목 속성에 매핑됩니다.
displayFormat (모든 필드 유형)
적응형 양식의 표시 패턴에 매핑됩니다.
rawValue (모든 필드 유형)
적응형 양식의 값 속성에 매핑됩니다.
개 항목 (목록 상자, 확인란)
적응형 양식의 옵션 속성에 매핑됩니다. Options 표현식을 사용하여 재정의할 수 있습니다.
maxChar (텍스트 필드)
적응형 양식의 최대 문자 허용 속성에 매핑됩니다.
여러 행 (텍스트 필드)
적응형 양식의 여러 줄 허용 속성에 매핑됩니다.
FracDigit (숫자 필드, 십진수 필드)
적응형 양식의 Frac 자릿수 속성에 매핑됩니다.
리드 숫자 (숫자 필드, 십진수 필드)
적응형 양식의 잠재 고객 수 속성에 매핑됩니다.
다중 선택 (목록 상자)
적응형 양식의 다중 선택 허용 속성에 매핑됩니다.

스크립트 scripts

다음 표에서는 XDP 파일에 정의된 다양한 XFA 스크립트가 적응형 양식에서 작동하는 방식을 캡처합니다.

XFA 스크립트 이벤트
적응형 양식의 해당 동작
초기화
이 스크립트는 런타임에 실행되며 적응형 양식에서 재정의할 수 없습니다.
계산
적응형 양식의 계산 표현식에 매핑됩니다.
유효성 검사
적응형 양식의 유효성 검사 표현식에 매핑됩니다.
validationState
이 스크립트는 런타임에 실행되며 적응형 양식에서 재정의할 수 없습니다.
종료
이 스크립트는 런타임에 실행되며 적응형 양식에서 재정의할 수 없습니다.
클릭(단추 필드)
단추의 Click 표현식에 매핑됩니다.
서버측 스크립트 지원
이 스크립트는 런타임에 실행되며 적응형 양식에서 재정의할 수 없습니다.
웹 서비스 지원
이 스크립트는 런타임에 실행되며 적응형 양식에서 재정의할 수 없습니다.
변경(스크리블 필드, 라디오 단추, 확인란)
이 스크립트는 런타임에 실행되며 적응형 양식에서 재정의할 수 없습니다.

유효성 검사 validations

다음 표에서는 XFA 유효성 검사가 적응형 양식의 유효성 검사에 매핑되는 방법을 캡처합니다.

XFA 유효성 검사
적응형 양식의 해당 유효성 검사
유효성 검사 패턴(formatTest)
validatePictureSection
유효성 검사 패턴 메시지(formatTestMessage)
validatePictureMessage
필수(nullTest)
필수
빈 메시지(nullTestMessage)
mandatoryMessage
스크립트 유효성 검사(scriptTest)
validateExp
유효성 검사 스크립트 메시지(scriptTestMessage)
validateMessage
NOTE
적응형 양식 라디오 단추와 XFA 확인 단추에 바인딩된 확인란 그룹에 대한 필수 속성을 재정의할 수 없습니다.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2