[AEM Forms]{class="badge positive" title="AEM Forms에 적용됩니다)."}
대화형 통신 편집기에서 바인딩되지 않은 변수 구성 요소
1. 소개
대화형 통신(IC) 편집기의 바인딩되지 않은 변수 구성 요소를 사용하면 값이 외부 데이터 모델 또는 스키마 노드에 연결되지 않은 필드를 배치할 수 있습니다. 대신 이 값은 스크립팅, 규칙 기반 계산 또는 정적 기본값을 통해 제공되므로 바인딩된 데이터 소스에서 직접 제공되지 않는 계산 또는 중간 표시 값이 필요할 때마다 이 구성 요소를 올바르게 선택할 수 있습니다.
바인딩되지 않은 변수는 양식 데이터 모델에 연결되어 있지 않으므로 디자인 타임 및 런타임에 값을 완벽하게 작성할 수 있습니다. 이 필드를 사용하여 계산된 합계, 동적으로 생성된 참조 번호, 중간 공식 결과 또는 규칙 엔진이 생성하는 기타 모든 값을 표시할 수 있습니다.
구성 요소는 네 가지 데이터 형식 Text, Numeric, Date 및 Date/Time을(를) 모두 지원하며 활성 데이터 형식은 적용할 표시 패턴 구문과 그림 절 기호를 결정합니다.
2. 표시 패턴
텍스트 상자, 숫자 필드, 날짜 필드 및 날짜/시간 필드 구성 요소에 사용할 수 있는 것과 동일한 표시 패턴 컨트롤을 사용하여 속성 패널에서 바인딩되지 않은 변수 필드에 표시 패턴을(를) 할당할 수 있습니다. 이를 통해 캔버스 미리 보기 및 생성된 출력에서 계산 또는 참조된 값의 형식을 표시할 수 있습니다.
구성된 패턴은 캔버스 미리 보기에 즉시 반영되며 저장 및 다시 로드 주기 동안 유지됩니다.
표시 패턴 구성
- 디자인 캔버스에서 바인딩되지 않은 변수 구성 요소를 선택합니다.
- 속성 패널을 엽니다.
- 표시 패턴 섹션에서 미리 정의된 패턴을 선택하거나 사용자 지정 그림 절을 입력하십시오.
- 캔버스에서 서식이 지정된 값을 미리 봅니다.
올바른 패턴 선택
바인딩되지 않은 변수에는 데이터 형식이 포함될 수 있으므로 사용하는 그림 절 구문은 필드의 구성된 데이터 형식과 일치해야 합니다.
YYYY-MM-DD 또는 YYYY-MM-DDTHH:MM)을 준수해야 합니다. 이 형식을 따르지 않는 값은 표시 패턴이 적용되지 않은 상태로 표시됩니다.3. 속성
바인딩되지 않은 변수 구성 요소는 다른 필드 구성 요소와 공통된 속성 집합을 공유하며, 한 가지 주요 차이점은 데이터 소스 또는 대화형 통신 조각에 대한 외부 데이터 바인딩 옵션을 지원합니다.
3.1 기본 필드
-
이름: 변수의 고유 식별자입니다. IC 내의 규칙, 스크립트 및 표현식에서 참조하는 데 사용됩니다.
-
데이터 형식: 이 변수에 포함된 값의 형식을 지정합니다. Text, Numeric, Date 또는 Date/Time. 선택한 데이터 유형에 따라 적용되는 표시 패턴 구문과 값의 유효성 검사 방법이 결정됩니다.
-
캡션: 캔버스에서 필드 옆에 표시되는 레이블(예: “계산된 합계” 또는 “참조 번호”).
-
값: 필드에 표시되는 기본 또는 계산된 값입니다. 대부분의 경우 수동으로 입력하지 않고 규칙 편집기 또는 스크립트를 사용하여 프로그래밍 방식으로 설정됩니다.
-
예약: 계산된 값을 사용할 수 없을 때 표시되는 대체 값으로서, 빈 필드를 사용할 수 없는 인쇄 전용 또는 읽기 전용 출력에 유용합니다.
-
모양: 필드 컨테이너에 대한 시각적 스타일 사전 설정(없음, 실선 상자 또는 밑줄)입니다.
3.2 타이포그래피
표시된 값의 스타일을 제어합니다.
-
글꼴 변형: 주변 내용과 일치하도록 글꼴 모음, 두께(보통, 굵게) 및 스타일(기울임꼴)을 선택합니다.
-
글꼴 크기: 일반적으로 기본적으로 10pt로 설정됩니다. 나머지 통신과 시각적 일관성을 유지하려면 조정하십시오.
3.3 위치
캔버스에서 구성 요소의 배치를 정의합니다.
-
X 및 Y 좌표: 정확한 가로 및 세로 위치를 설정합니다.
-
너비 및 높이: 인접한 요소와 정렬하려면 밀리미터 단위로 치수를 지정하십시오.
3.4 이익
구성 요소 경계 주위의 간격을 정의합니다.
-
상단(위)
-
아래쪽(아래쪽)
-
왼쪽
-
오른쪽
3.5 모양
필드 컨테이너의 스타일을 지정합니다.
-
필드의 채우기: 배경색입니다.
-
스트로크: 필드 주위의 테두리에 다음 옵션을 사용할 수 있습니다.
-
너비: 테두리 두께입니다.
-
스타일: 단색, 파선 또는 점선.
-
Edge: 모서리가 둥글거나 날카롭습니다.
-
3.6 유무
런타임 시 가시성 제어:
-
표시: 필드가 표시되고 레이아웃 공간을 차지합니다.
-
숨김(공간 유지): 필드는 보이지 않지만 레이아웃 공간은 유지되므로 규칙 편집기를 사용하여 동적으로 가시성을 전환할 때 유용합니다.
4. 사용량
표시하려는 값이 다음과 같은 경우 바인딩되지 않은 변수 사용:
-
규칙 또는 스크립트로 계산 — 예: 실행 합계, 세금 계산 또는 다른 필드 값에서 파생된 할인 금액.
-
프로그래밍 방식으로 생성됨 — 예: 백엔드 로직에 의해 런타임에 지정된 참조 번호 또는 추적 코드.
-
데이터 모델에서 사용할 수 없음 - 예를 들어 화면에 의미가 있지만 스키마 필드로 존재하지 않는 중간 결과입니다.
-
조건부로 표시 — 특정 조건이 충족될 때만 계산된 메시지 또는 값을 표시합니다. 규칙 편집기를 사용하여 가시성과 값을 함께 설정합니다.
바인딩되지 않은 변수를 하위 양식, 레이아웃 컨테이너 내에 배치하거나 디자인 캔버스에 직접 배치할 수 있습니다. 이를 규칙 편집기와 결합하여 IC의 다른 바인딩된 필드를 기반으로 해당 값을 계산하는 표현식을 작성합니다.
5. 모범 사례
-
계산된 값을 사용할 수 없는 경우 인쇄 출력 및 읽기 전용 미리 보기에 빈 필드가 표시되지 않도록 의미 있는 예약 값을 설정합니다.
-
데이터 형식을 출력에 일치 — 통화 금액을 계산하는 경우 데이터 형식을 숫자로 설정하고 숫자 표시 패턴을 적용합니다. 날짜를 계산하는 경우 날짜를 날짜로 설정하고 ISO 8601 입력을 확인합니다.
-
캡션 지우기 사용 — 값이 계산되며 레이블에서 직접 인식할 수 없으므로 설명 캡션(예: “소계(계산됨)”)은 검토자와 최종 사용자 모두에게 혼동을 방지합니다.
-
모델에 속하는 데이터에 대해 바인딩되지 않은 변수를 과도하게 사용하지 마십시오 - 값을 양식 데이터 모델에 적절하게 추가할 수 있는 경우 표준 필드를 바인딩하는 것이 좋습니다. 실제로 일시적 또는 파생적 값에 대해 바인딩되지 않은 변수를 예약합니다.
-
표현식 작성 — 바인딩되지 않은 각 변수가 계산하는 내용을 설명하는 주석을 규칙 편집기에 추가하면 나중에 IC를 편집할 때 논리를 유지할 수 있습니다.
추가 참조
- 텍스트 상자 구성 요소 — 텍스트 값의 패턴 구문 표시
- 숫자 필드 구성 요소 — 숫자 및 통화 값의 패턴 구문 표시
- 날짜 필드 구성 요소 — 날짜의 패턴 구문 표시
- 날짜/시간 필드 구성 요소 — 결합된 날짜 및 시간 값에 대한 패턴 구문 표시
- 대화형 통신 편집기에서 규칙 편집기 사용 — 식을 작성하여 계산하고 바인딩되지 않은 변수에 값을 할당합니다
- 대화형 통신 편집기에서 데이터 바인딩 구성