[AEM Forms]{class="badge positive" title="AEM Forms에 적용됩니다)."}

대화형 통신 편집기에서 바인딩되지 않은 변수 구성 요소

​1. 소개

대화형 통신(IC) 편집기의 바인딩되지 않은 변수 구성 요소를 사용하면 값이 외부 데이터 모델 또는 스키마 노드에 연결되지 않은 필드를 배치할 수 있습니다. 대신 이 값은 스크립팅, 규칙 기반 계산 또는 정적 기본값을 통해 제공되므로 바인딩된 데이터 소스에서 직접 제공되지 않는 계산 또는 중간 표시 값이 필요할 때마다 이 구성 요소를 올바르게 선택할 수 있습니다.

바인딩되지 않은 변수는 양식 데이터 모델에 연결되어 있지 않으므로 디자인 타임 및 런타임에 값을 완벽하게 작성할 수 있습니다. 이 필드를 사용하여 계산된 합계, 동적으로 생성된 참조 번호, 중간 공식 결과 또는 규칙 엔진이 생성하는 기타 모든 값을 표시할 수 있습니다.

구성 요소는 네 가지 데이터 형식 Text, Numeric, DateDate/Time​을(를) 모두 지원하며 활성 데이터 형식은 적용할 표시 패턴 구문과 그림 절 기호를 결정합니다.

​2. 표시 패턴

텍스트 상자, 숫자 필드, 날짜 필드 및 날짜/시간 필드 구성 요소에 사용할 수 있는 것과 동일한 표시 패턴 컨트롤을 사용하여 속성 패널에서 바인딩되지 않은 변수 필드에 표시 패턴​을(를) 할당할 수 있습니다. 이를 통해 캔버스 미리 보기 및 생성된 출력에서 계산 또는 참조된 값의 형식을 표시할 수 있습니다.

구성된 패턴은 캔버스 미리 보기에 즉시 반영되며 저장 및 다시 로드 주기 동안 유지됩니다.

표시 패턴 구성

  1. 디자인 캔버스에서 바인딩되지 않은 변수 구성 요소를 선택합니다.
  2. 속성 패널을 엽니다.
  3. 표시 패턴 섹션에서 미리 정의된 패턴을 선택하거나 사용자 지정 그림 절을 입력하십시오.
  4. 캔버스에서 서식이 지정된 값을 미리 봅니다.

올바른 패턴 선택

바인딩되지 않은 변수에는 데이터 형식이 포함될 수 있으므로 사용하는 그림 절 구문은 필드의 구성된 데이터 형식과 일치해야 합니다.

필드 데이터 유형
패턴 구문
출력 예
참조
텍스트
text{…}
(555) 123-4567
텍스트 상자 — 표시 패턴
숫자
num{…}
$1,234.21
숫자 필드 — 표시 패턴
날짜
date{…}
01/04/2007
날짜 필드 — 표시 패턴
날짜/시간
date{…} time{…}
04/01/2007 14:30
날짜/시간 필드 — 표시 패턴
NOTE
필드의 데이터 형식이 날짜 또는 날짜/시간이면 기본 값은 ISO 8601 형식(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를 편집할 때 논리를 유지할 수 있습니다.

추가 참조

recommendation-more-help
experience-manager-cloud-service-help-main-toc