적응형 양식 규칙 편집기 adaptive-forms-rule-editor

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

주제:

작성 대상:

사용자
개발자

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

버전

문서 링크

AEM as a Cloud Service

여기 클릭

AEM 6.5

이 문서

개요 overview

Adobe Experience Manager Forms의 규칙 편집기 기능을 사용하여 Forms 비즈니스 사용자 및 개발자는 적응형 양식 개체에 대한 규칙을 작성할 수 있습니다. 이러한 규칙은 양식에 대한 사전 설정 조건, 사용자 입력 및 사용자 작업을 기반으로 양식 개체에서 트리거하는 작업을 정의합니다. 정확성과 속도를 보장하는 양식 채우기 환경을 더욱 간소화하는 데 도움이 됩니다.

규칙 편집기는 규칙을 작성하는 직관적이고 간단한 사용자 인터페이스를 제공합니다. 규칙 편집기는 모든 사용자를 위한 시각적 편집기를 제공합니다. 또한 양식 고급 사용자를 위해서만 규칙과 스크립트를 작성하는 데 규칙 편집기편집기 코드 제공합니다.

규칙 편집기는 AEM 6.1 Forms 및 이전 릴리스의 스크립팅 기능을 대체합니다. 그러나 기존 스크립트는 새 규칙 편집기에서 유지됩니다. 규칙 편집기에서 기존 스크립트를 사용한 작업에 대한 자세한 내용은 규칙 편집기가 기존 스크립트에 미치는 영향을 참조하십시오.

forms-power-users 그룹에 추가된 사용자는 새 스크립트를 만들고 기존 스크립트를 편집할 수 있습니다. forms-users 그룹의 사용자는 스크립트를 사용할 수 있지만 스크립트를 만들거나 편집할 수는 없습니다.

규칙 이해 understanding-a-rule

규칙은 작업과 조건의 조합입니다. 규칙 편집기에서 작업에는 폼의 개체 값 숨기기, 표시, 활성화, 비활성화 또는 계산과 같은 활동이 포함됩니다. 조건은 양식 객체의 상태, 값 또는 속성에 대한 검사 및 작업을 수행하여 평가되는 부울 표현식입니다. 조건을 평가하여 반환된 값(True 또는 False)을 기반으로 작업이 수행됩니다.

규칙 편집기는 규칙을 작성하는 데 도움이 되는 시기, 표시, 숨기기, 활성화, 비활성화, 값 설정 및 유효성 검사와 같은 사전 정의된 규칙 유형 집합을 제공합니다. 각 규칙 유형을 사용하면 규칙에서 조건 및 작업을 정의할 수 있습니다. 이 문서에서는 각 규칙 유형에 대해 자세히 설명합니다.

규칙은 일반적으로 다음 구문 중 하나를 따릅니다.

Condition-Action 이 구문에서는 규칙이 먼저 조건을 정의한 다음 트리거할 작업을 정의합니다. 이 구문은 프로그래밍 언어의 if-then 문과 비슷합니다.

규칙 편집기에서 When 규칙 유형은 조건-작업 구문을 적용합니다.

Action-Condition 이 구문에서는 규칙이 먼저 트리거할 작업을 정의한 다음 평가 조건을 정의합니다. 이 구문의 또 다른 변형은 action-condition-alternate 매크로 함수이며, 이 매크로 함수는 조건이 False를 반환하는 경우 트리거할 대체 매크로 함수도 정의합니다.

규칙 편집기의 규칙 유형 표시, 숨기기, 활성화, 비활성화, 값 설정 및 유효성 검사는 작업 조건 규칙 구성을 적용합니다. 기본적으로 표시에 대한 대체 작업은 숨기기이고 활성화에 대한 대체 작업은 비활성화이며, 반대로 입니다. 기본 대체 작업은 변경할 수 없습니다.

NOTE

규칙 편집기에서 정의하는 조건 및 작업을 포함한 사용 가능한 규칙 유형은 규칙을 만드는 양식 객체의 유형에 따라 다릅니다. 규칙 편집기에는 특정 양식 객체 유형에 대한 조건 및 작업 문을 작성하기 위한 유효한 규칙 유형 및 옵션만 표시됩니다. 예를 들어 패널 객체에 대한 규칙 유형 유효성 검사, 값 설정, 활성화 및 비활성화는 표시되지 않습니다.

규칙 편집기에서 사용할 수 있는 규칙 유형에 대한 자세한 내용은 규칙 편집기에서 사용 가능한 규칙 유형을 참조하십시오.

규칙 구성 선택 지침 guidelines-for-choosing-a-rule-construct

모든 규칙 구문을 사용하여 대부분의 사용 사례를 달성할 수 있지만, 다음은 한 구문을 다른 구문보다 선택하는 몇 가지 지침입니다. 규칙 편집기에서 사용 가능한 규칙에 대한 자세한 내용은 규칙 편집기에서 사용 가능한 규칙 유형을 참조하십시오.

규칙을 작성할 때 일반적으로 경험하는 규칙은 규칙을 작성하는 객체의 컨텍스트에서 생각하는 것입니다. 필드 A에서 사용자가 지정하는 값에 따라 필드 B를 숨기거나 표시하려고 한다고 가정합니다. 이 경우 필드 A에서 조건을 평가하고 반환되는 값을 기반으로 필드 B에서 작업을 트리거합니다.

따라서 필드 B(조건을 평가하는 객체)에 규칙을 작성하는 경우 조건-작업 구문 또는 시기 규칙 유형을 사용합니다. 마찬가지로 필드 A에서 작업 조건 구문 또는 표시 또는 숨기기 규칙 유형을 사용합니다.
한 가지 조건을 기반으로 여러 작업을 수행해야 하는 경우가 있습니다. 이러한 경우 조건-작업 구문을 사용하는 것이 좋습니다. 이 구문에서는 한 번 조건을 평가하고 여러 작업 문을 지정할 수 있습니다.

예를 들어, 사용자가 필드 A에 지정한 값을 확인하는 조건에 따라 필드 B, C 및 D를 숨기려면 조건-작업 구문 또는 필드 A에 규칙 유형을 입력할 때 하나의 규칙을 작성하고 필드 B, C 및 D의 가시성을 제어하는 작업을 지정합니다. 그렇지 않으면 필드 B, C 및 D에 세 개의 별도 규칙이 필요합니다. 여기서 각 규칙은 조건을 확인하고 해당 필드를 표시하거나 숨깁니다. 이 예제에서는 3개의 객체에 대한 규칙 유형 표시 또는 숨기기보다 When 규칙 유형을 하나의 객체에 작성하는 것이 더 효율적입니다.
여러 조건을 기반으로 작업을 트리거하려면 작업 조건 구문을 사용하는 것이 좋습니다. 예를 들어 필드 B, C 및 D의 조건을 평가하여 필드 A를 표시하거나 숨기려면 필드 A에서 규칙 유형 표시 또는 숨기기를 사용합니다.
규칙에 한 조건에 대한 한 가지 작업이 포함된 경우 조건-작업 또는 작업 조건 구문을 사용합니다.
규칙이 조건을 확인하고 필드에 값을 제공하거나 필드를 종료할 때 즉시 작업을 수행하는 경우 조건이 평가되는 필드에 조건-작업 구문 또는 When 규칙 유형이 있는 규칙을 작성하는 것이 좋습니다.
사용자가 When 규칙이 적용되는 객체의 값을 변경할 때 When 규칙의 조건이 평가됩니다. 그러나 값을 미리 채우는 경우처럼 서버측에서 값이 변경될 때 작업을 트리거하려면 필드가 초기화될 때 작업을 트리거하는 When 규칙을 작성하는 것이 좋습니다.
드롭다운, 라디오 단추 또는 확인란 개체에 대한 규칙을 작성할 때 양식에 있는 이러한 양식 개체의 옵션 또는 값이 규칙 편집기에 미리 채워집니다.

규칙 편집기에서 사용 가능한 연산자 유형 및 이벤트 available-operator-types-and-events-in-rule-editor

규칙 편집기는 규칙을 만들 수 있는 다음과 같은 논리 연산자 및 이벤트를 제공합니다.

이(가) 과(와) 같음
이(가) 과(와) 같지 않습니다.
다음으로 시작
다음으로 끝남
포함
비어 있음
비어 있지 않음
선택함: 사용자가 확인란, 드롭다운, 라디오 단추에 대한 특정 옵션을 선택하면 true를 반환합니다.
초기화됨(이벤트): 브라우저에서 양식 개체가 렌더링될 때 true를 반환합니다.
Is Changed (event): 사용자가 양식 개체에 대해 입력한 값 또는 선택한 옵션을 변경하면 true를 반환합니다.

규칙 편집기에서 사용 가능한 규칙 유형 available-rule-types-in-rule-editor

규칙 편집기는 규칙을 작성하는 데 사용할 수 있는 사전 정의된 규칙 유형 집합을 제공합니다. 각 규칙 유형을 자세히 살펴보겠습니다. 규칙 편집기에서 규칙을 작성하는 방법에 대한 자세한 내용은 규칙 작성을 참조하십시오.

http 화이트보드 whenruletype

When 규칙 형식은 condition-action-alternate action 규칙 구문을 따르거나 경우에 따라 condition-action 구문을 따릅니다. 이 규칙 유형에서는 먼저 평가 조건을 지정한 다음 조건이 충족될 경우 트리거할 작업을 지정합니다( True). When 규칙 유형을 사용하는 동안 여러 AND 및 OR 연산자를 사용하여 중첩 표현식을🔗 만들 수 있습니다.

When 규칙 유형을 사용하면 양식 개체에 대한 조건을 평가하고 하나 이상의 개체에 대해 작업을 수행할 수 있습니다.

간단히 말해서 일반적인 When 규칙 구조는 다음과 같습니다.

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

개체 B에 대한 작업 2;
및
개체 C에 대한 작업 3;

라디오 버튼이나 목록과 같은 다중 값 구성 요소가 있는 경우 해당 구성 요소에 대한 규칙을 만드는 동안 해당 옵션이 자동으로 검색되어 규칙 작성자에게 제공됩니다. 옵션 값을 다시 입력할 필요는 없습니다.

예를 들어, 목록에는 빨강, 파랑, 녹색 및 노랑의 네 가지 옵션이 있습니다. 규칙을 만드는 동안 옵션(라디오 버튼)이 자동으로 검색되어 규칙 작성자는 다음과 같이 사용할 수 있습니다.

multivaluefcDisplaysOptions

When 규칙 작성 중에 값 지우기 작업을 트리거할 수 있습니다. 작업의 값 지우기 지정된 개체의 값을 지웁니다. When 문에서 Clear 값 를 옵션으로 사용하면 여러 필드가 있는 복잡한 조건을 만들 수 있습니다.

clearvalueof

숨기기 지정한 개체를 숨깁니다.

표시 지정한 개체를 표시합니다.

사용 지정한 개체를 사용합니다.

사용 안 함 지정한 개체를 사용하지 않습니다.

서비스 호출 양식 데이터 모델에 구성된 서비스를 호출합니다. 서비스 호출 작업을 선택하면 필드가 나타납니다. 필드를 탭하면 AEM 인스턴스의 모든 양식 데이터 모델에 구성된 모든 서비스가 표시됩니다. 양식 데이터 모델 서비스를 선택하면 양식 개체를 지정된 서비스에 대한 입력 및 출력 매개 변수와 매핑할 수 있는 추가 필드가 나타납니다. 양식 데이터 모델 서비스를 호출하기 위한 예제 규칙 을 참조하십시오.

양식 데이터 모델 서비스 외에 웹 서비스를 호출할 직접 WSDL URL을 지정할 수 있습니다. 그러나 양식 데이터 모델 서비스에는 많은 이점과 서비스를 호출하는 데 권장되는 방법이 있습니다.

양식 데이터 모델에서 서비스를 구성하는 방법에 대한 자세한 내용은 AEM Forms 데이터 통합을 참조하십시오.

값 설정 지정한 개체의 값을 계산하고 설정합니다. 개체 값을 문자열, 다른 개체의 값, 수학 식이나 함수를 사용하여 계산된 값, 개체의 속성 값 또는 구성된 양식 데이터 모델 서비스의 출력 값으로 설정할 수 있습니다. 웹 서비스 옵션을 선택하면 AEM 인스턴스의 모든 양식 데이터 모델에 구성된 모든 서비스가 표시됩니다. 양식 데이터 모델 서비스를 선택하면 양식 개체를 지정된 서비스에 대한 입력 및 출력 매개 변수와 매핑할 수 있는 추가 필드가 나타납니다.

양식 데이터 모델에서 서비스를 구성하는 방법에 대한 자세한 내용은 AEM Forms 데이터 통합을 참조하십시오.

속성 설정 규칙 유형을 사용하면 조건 작업을 기반으로 지정된 개체의 속성 값을 설정할 수 있습니다. 속성을 다음 중 하나로 설정할 수 있습니다.

표시(부울)
dorExclusion(부울)
chartType (String)
제목(문자열)
활성화됨(부울)
필수(부울)
validationsDisabled(부울)
validateExpMessage(문자열)
값(숫자, 문자열, 날짜)
항목(목록)
유효(부울)
errorMessage(문자열)

적응형 양식에 동적으로 확인란을 추가하는 규칙을 정의할 수 있습니다. 사용자 지정 함수, 양식 개체 또는 개체 속성을 사용하여 규칙을 정의할 수 있습니다.

속성 설정

사용자 지정 함수를 기반으로 규칙을 정의하려면 드롭다운 목록에서 함수 출력 을(를) 선택한 다음 함수 탭에서 사용자 지정 함수를 드래그 앤 드롭합니다. 조건 작업이 충족되면 사용자 지정 함수에 정의된 확인란 수가 적응형 양식에 추가됩니다.

양식 개체를 기반으로 규칙을 정의하려면 드롭다운 목록에서 양식 개체 를 선택하고 양식 개체 탭에서 양식 개체를 끌어서 놓습니다. 조건 작업이 충족되면 양식 개체에 정의된 확인란 수가 적응형 양식에 추가됩니다.

개체 속성을 기반으로 속성 설정 규칙을 사용하면 적응형 양식에 포함된 다른 개체 속성을 기반으로 적응형 양식의 확인란 수를 추가할 수 있습니다.

다음 그림은 적응형 양식의 드롭다운 목록 수에 따라 확인란을 동적으로 추가하는 예를 보여 줍니다.

개체 속성

값 지우기 지정한 개체의 값을 지웁니다.

포커스 설정 지정한 개체에 포커스를 설정합니다.

양식 저장 에서 양식을 저장합니다.

Forms 제출 양식을 제출합니다.

양식 재설정 양식을 재설정합니다.

양식 유효성 검사 에서 양식의 유효성을 검사합니다.

인스턴스 추가 지정한 반복 가능한 패널 또는 테이블 행의 인스턴스를 추가합니다.

인스턴스 제거 지정한 반복 가능한 패널 또는 테이블 행의 인스턴스를 제거합니다.

이동 다른 대화형 통신, 적응형 양식, 이미지 또는 문서 조각과 같은 기타 에셋 또는 외부 URL로 이동합니다. 자세한 내용은 대화형 통신에 추가 단추를 참조하십시오.

값 설정 set-value-of

Set Value of 규칙 형식을 사용하면 지정된 조건을 충족하는지 여부에 따라 양식 개체의 값을 설정할 수 있습니다. 값은 다른 개체의 값, 리터럴 문자열, 수학적 식이나 함수에서 파생된 값, 다른 개체의 속성 값 또는 양식 데이터 모델 서비스의 출력으로 설정할 수 있습니다. 마찬가지로 구성 요소, 문자열, 속성 또는 함수나 수학 표현식에서 파생된 값에 대한 조건을 확인할 수 있습니다.

규칙 유형의 값 설정 은 패널 및 도구 모음 버튼과 같은 일부 양식 객체에 사용할 수 없습니다. 표준 규칙 세트 값의 구조는 다음과 같습니다.

개체 A의 값을 다음으로 설정합니다.

(문자열 ABC) 또는
(객체 C의 객체 속성 X) 또는
(함수의 값) 또는
(수학 표현식의 값) 또는
(데이터 모델 서비스 또는 웹 서비스의 출력 값);

시기(선택 사항):

(조건 1 및 조건 2 및 조건 3)은 TRUE입니다.

다음 예제에서는 dependentid 필드의 값을 입력으로 취하여 Relation 필드의 값을 getDependent 양식 데이터 모델 서비스의 Relation 인수의 출력으로 설정합니다.

set-value-web-service

양식 데이터 모델 서비스를 사용한 값 설정 규칙의 예

NOTE

또한 규칙 값 설정을 사용하여 양식 데이터 모델 서비스 또는 웹 서비스의 출력에서 드롭다운 목록 구성 요소의 모든 값을 채울 수 있습니다. 그러나 선택한 출력 인수가 배열형인지 확인하십시오. 배열에 반환된 모든 값은 지정된 드롭다운 목록에서 사용할 수 있게 됩니다.

표시 show

Show 규칙 유형을 사용하면 조건 충족 여부에 따라 양식 개체를 표시하거나 숨기는 규칙을 작성할 수 있습니다. 또한 Show 규칙 유형은 조건이 충족되지 않거나 False을(를) 반환하는 경우 Hide 작업을 트리거합니다.

일반적인 표시 규칙은 다음과 같이 구성됩니다.

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

숨기기 hide

Show 규칙 형식과 마찬가지로 Hide 규칙 형식을 사용하여 조건 충족 여부에 따라 양식 개체를 표시하거나 숨길 수 있습니다. 조건이 충족되지 않거나 False을(를) 반환하는 경우 Hide 규칙 유형도 Show 작업을 트리거합니다.

일반적인 숨기기 규칙은 다음과 같이 구성됩니다.

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

활성화 enable

Enable 규칙 유형을 사용하면 조건 충족 여부에 따라 양식 개체를 활성화하거나 비활성화할 수 있습니다. 또한 Enable 규칙 유형은 조건이 충족되지 않거나 False을 반환하는 경우 Disable 작업을 트리거합니다.

일반적인 Enable 규칙은 다음과 같이 구성됩니다.

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

비활성화 disable

Enable 규칙 유형과 유사한 Disable 규칙 유형을 사용하면 조건 충족 여부에 따라 양식 개체를 활성화하거나 비활성화할 수 있습니다. 또한 Disable 규칙 유형은 조건이 충족되지 않거나 False을(를) 반환하는 경우 Enable 작업을 트리거합니다.

일반적인 비활성화 규칙은 다음과 같이 구성됩니다.

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

유효성 검사 validate

Validate 규칙 형식은 식을 사용하여 필드의 값을 확인합니다. 예를들어, 이름을 지정하는 텍스트 상자에 특수 문자나 숫자가 들어 있지 않은지 확인하는 식을 작성할 수 있습니다.

일반적인 유효성 검사 규칙은 다음과 같이 구성됩니다.

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

NOTE

지정된 값이 유효성 검사 규칙을 준수하지 않으면 사용자에게 유효성 검사 메시지를 표시할 수 있습니다. 사이드바의 구성 요소 속성에서 스크립트 유효성 검사 메시지 필드에 메시지를 지정할 수 있습니다.

스크립트 유효성 검사

옵션 설정 setoptionsof

옵션 설정 규칙 유형을 사용하면 적응형 양식에 동적으로 확인란을 추가하는 규칙을 정의할 수 있습니다. 양식 데이터 모델 또는 사용자 지정 함수를 사용하여 규칙을 정의할 수 있습니다.

사용자 지정 함수를 기반으로 규칙을 정의하려면 드롭다운 목록에서 함수 출력 을(를) 선택한 다음 함수 탭에서 사용자 지정 함수를 드래그 앤 드롭합니다. 사용자 지정 함수에 정의된 확인란 수가 적응형 양식에 추가됩니다.

사용자 지정 함수

사용자 지정 함수를 만들려면 규칙 편집기의 사용자 지정 함수를 참조하십시오.

양식 데이터 모델을 기반으로 규칙을 정의하려면 다음을 수행합니다.

드롭다운 목록에서 서비스 출력 을 선택합니다.
데이터 모델 개체를 선택합니다.
표시 값 드롭다운 목록에서 데이터 모델 개체 속성을 선택하십시오. 적응형 양식의 확인란 수는 데이터베이스의 해당 속성에 대해 정의된 인스턴스 수에서 파생됩니다.
값 저장 드롭다운 목록에서 데이터 모델 개체 속성을 선택하십시오.

FDM 설정 옵션

규칙 편집기 사용자 인터페이스 이해 understanding-the-rule-editor-user-interface

규칙 편집기는 규칙을 작성하고 관리할 수 있는 포괄적이면서도 간단한 사용자 인터페이스를 제공합니다. 작성 모드의 적응형 양식 내에서 규칙 편집기 사용자 인터페이스를 시작할 수 있습니다.

규칙 편집기 사용자 인터페이스를 시작하려면 다음을 수행합니다.

작성 모드에서 적응형 양식을 엽니다.
규칙을 작성할 양식 개체를 선택하고 구성 요소 도구 모음에서 을(를) 선택합니다. 규칙 편집기 사용자 인터페이스가 나타납니다.

선택한 양식 객체에 대한 기존 규칙이 이 뷰에 나열됩니다. 기존 규칙 관리에 대한 자세한 내용은 규칙 관리를 참조하십시오.
새 규칙을 작성하려면 만들기 를 선택하십시오. 규칙 편집기 사용자 인터페이스의 시각적 편집기는 규칙 편집기를 처음 실행할 때 기본적으로 열립니다.

규칙 편집기 UI의 각 구성 요소를 자세히 살펴보겠습니다.

A. 구성 요소 규칙 표시 a-component-rule-display

규칙 편집기를 시작한 적응형 양식 개체의 제목과 현재 선택된 규칙 유형을 표시합니다. 위의 예에서 규칙 편집기는 급여 라는 적응형 양식 객체에서 시작되며 선택한 규칙 유형은 다음과 같습니다.

B. 양식 개체 및 함수 b-form-objects-and-functions-br

규칙 편집기 사용자 인터페이스의 왼쪽 창에는 두 개의 탭, 즉 Forms 개체 및 함수 가 있습니다.

양식 개체 탭에는 적응형 양식에 포함된 모든 개체의 계층 보기가 표시됩니다. 객체의 제목과 유형이 표시됩니다. 규칙을 작성할 때 양식 개체를 규칙 편집기로 드래그 앤 드롭할 수 있습니다. 규칙 만들거나 편집하는 동안 개체 또는 함수를 자리 표시자로 끌어다 놓으면 자리 표시자는 자동으로 적절한 값 유형을 사용합니다.

하나 이상의 유효한 규칙이 적용된 양식 개체는 녹색 점으로 표시됩니다. 양식 개체에 적용된 규칙이 잘못된 경우 양식 개체는 노란색 점으로 표시됩니다.

함수 탭에는 Sum Of, Min Of, Max Of, Average Of, Number Of 및 Validate Form과 같은 기본 제공 함수 집합이 포함되어 있습니다. 이러한 함수를 사용하여 반복 가능한 패널 및 테이블 행의 값을 계산하고 규칙을 작성할 때 작업 및 조건문에 사용할 수 있습니다. 그러나 사용자 지정 함수를 만들 수도 있습니다.

함수 탭

NOTE

Forms 개체 및 함수 탭에서 개체 및 함수 이름과 제목에 대해 텍스트 검색을 수행할 수 있습니다.

양식 객체의 왼쪽 트리에서 양식 객체를 선택하여 각 객체에 적용된 규칙을 표시할 수 있습니다. 다양한 양식 객체의 규칙을 탐색할 수 있을 뿐만 아니라 양식 객체 간에 규칙을 복사하여 붙여넣을 수도 있습니다. 자세한 내용은 규칙 복사-붙여넣기를 참조하십시오.

C. 양식 개체 및 함수 전환 c-form-objects-and-functions-toggle-br

전환 단추를 누르면 양식 개체 및 함수 창이 전환됩니다.

D. 시각적 규칙 편집기 d-visual-rule-editor

시각적 규칙 편집기는 규칙 편집기 사용자 인터페이스의 시각적 편집기 모드에서 규칙을 작성하는 영역입니다. 규칙 유형을 선택하고 그에 따라 조건 및 작업을 정의할 수 있습니다. 규칙에서 조건 및 작업을 정의할 때 양식 개체 및 함수 창에서 양식 개체 및 함수를 드래그 앤 드롭할 수 있습니다.

시각적 규칙 편집기 사용에 대한 자세한 내용은 규칙 쓰기를 참조하십시오.

E. 시각적 코드 편집기 전환기 e-visual-code-editors-switcher

forms-power-users 그룹의 사용자는 코드 편집기에 액세스할 수 있습니다. 다른 사용자의 경우 코드 편집기를 사용할 수 없습니다. 권한이 있는 경우 규칙 편집기의 비주얼 편집기 모드에서 코드 편집기 모드로 전환하고, 반대로 규칙 편집기 바로 위에 있는 전환기를 사용할 수 있습니다. 규칙 편집기를 처음 실행하면 시각적 편집기 모드로 열립니다. 시각적 편집기 모드에서 규칙을 작성하거나 코드 편집기 모드로 전환하여 규칙 스크립트를 작성할 수 있습니다. 그러나 규칙을 수정하거나 코드 편집기에서 규칙을 작성하는 경우 코드 편집기를 지우지 않으면 해당 규칙에 대한 시각적 편집기로 다시 전환할 수 없습니다.

AEM Forms은 규칙을 작성하는 데 마지막으로 사용한 규칙 편집기 모드를 추적합니다. 다음에 규칙 편집기를 실행하면 해당 모드로 열립니다. 그러나 기본 모드를 구성하여 지정된 모드에서 규칙 편집기를 열 수도 있습니다. 방법은 다음과 같습니다.

https://[host]:[port]/system/console/configMgr의 AEM 웹 콘솔로 이동합니다.
적응형 양식 및 대화형 통신 웹 채널 구성 을 편집하려면 클릭하세요.
규칙 편집기의 기본 모드 드롭다운에서 시각적 편집기 또는 코드 편집기 를 선택합니다.
저장 을 클릭합니다.

F. 완료 및 취소 단추 f-done-and-cancel-buttons

완료 단추를 사용하여 규칙을 저장합니다. 불완전한 규칙을 저장할 수 있습니다. 그러나 미완료는 유효하지 않으며 실행되지 않습니다. 다음에 동일한 양식 객체에서 규칙 편집기를 실행하면 양식 객체에 저장된 규칙이 나열됩니다. 해당 보기에서 기존 규칙을 관리할 수 있습니다. 자세한 내용은 규칙 관리를 참조하십시오.

취소 단추를 사용하면 규칙에 대한 모든 변경 내용이 취소되고 규칙 편집기가 닫힙니다.

규칙 작성 write-rules

시각적 규칙 편집기 또는 코드 편집기를 사용하여 규칙을 작성할 수 있습니다. 규칙 편집기를 처음 실행하면 시각적 편집기 모드로 열립니다. 코드 편집기 모드로 전환하고 규칙을 작성할 수 있습니다. 그러나 코드 편집기에서 규칙을 작성하거나 수정하는 경우 코드 편집기를 지우지 않으면 해당 규칙에 대한 시각적 편집기로 전환할 수 없습니다. 다음에 규칙 편집기를 실행하면 마지막으로 규칙을 만들 때 사용한 모드로 열립니다.

먼저 시각적 편집기를 사용하여 규칙을 작성하는 방법을 살펴보겠습니다.

시각적 편집기 사용 using-visual-editor

다음 예제 양식을 사용하여 시각적 편집기에서 규칙을 만드는 방법을 살펴보겠습니다.

create-rule-example

예제 대출 신청서의 대출 요건 섹션에서는 신청자가 결혼 여부, 급여 및 기혼인 경우 배우자의 급여를 지정해야 합니다. 사용자 입력을 기반으로 규칙이 대출 자격 금액을 계산하고 대출 자격 필드에 표시합니다. 다음 규칙을 적용하여 시나리오를 구현합니다.

[배우자 임금] 필드는 [결혼 상태]가 [기혼]인 경우에만 표시됩니다.
대출 가능 금액은 총 급여의 50%입니다.

규칙을 작성하려면 다음 단계를 수행하십시오.

먼저 혼인 상태 라디오 버튼에 대해 사용자가 선택한 옵션에 따라 배우자 임금 필드의 가시성을 제어하는 규칙을 작성합니다.

작성 모드에서 대출 신청 양식을 엽니다. 결혼 상태 구성 요소를 선택하고 을 선택합니다. 그런 다음 만들기 를 선택하여 규칙 편집기를 시작합니다.

규칙 편집기를 실행하면 기본적으로 시기 규칙이 선택됩니다. 또한 규칙 편집기를 시작한 양식 개체(이 경우 결혼 상태)는 When 문에 지정됩니다.

선택한 객체를 변경하거나 수정할 수 없지만 아래 표시된 대로 규칙 드롭다운을 사용하여 다른 규칙 유형을 선택할 수 있습니다. 다른 객체에 규칙을 작성하려면 취소를 선택하여 규칙 편집기를 종료하고 원하는 양식 객체에서 규칙을 다시 시작합니다.
상태 선택 드롭다운을 선택하고 이(가) 다음과 같음 을(를) 선택합니다. 문자열 입력 필드가 나타납니다.

결혼 상태 라디오 단추에서 결혼됨 및 단일 옵션이 각각 0 및 1 값으로 할당됩니다. 아래 표시된 대로 라디오 버튼 편집 대화 상자의 제목 탭에서 할당된 값을 확인할 수 있습니다.
규칙의 문자열 입력 필드에서 0 을(를) 지정합니다.

조건을 When Marital Status is equal to Married(으)로 정의했습니다. 그런 다음 이 조건이 True인 경우 수행할 작업을 정의합니다.
Then 문의 작업 선택 드롭다운에서 표시 를 선택합니다.
개체 놓기 또는 여기를 선택 필드의 양식 개체 탭에서 배우자 급여 필드를 드래그 앤 드롭하십시오. 또는 드롭 개체 또는 여기를 선택 필드를 선택하고 양식의 모든 양식 개체가 나열된 팝업 메뉴에서 배우자 급여 필드를 선택합니다.

규칙은 규칙 편집기에 다음과 같이 표시됩니다.

완료 를 선택하여 규칙을 저장합니다.

혼인 상태가 미혼인 경우 배우자 임금 필드를 숨기도록 다른 규칙을 정의하려면 단계 1 - 5를 반복합니다. 규칙은 규칙 편집기에 다음과 같이 표시됩니다.

write-rules-visual-editor-8

note note
NOTE
또는 [혼인 상태] 필드의 [시기 규칙] 두 개가 아니라 [배우자 임금] 필드에 하나의 표시 규칙을 작성하여 동일한 동작을 구현할 수 있습니다.

write-rules-visual-editor-9

다음으로, 총 급여의 50%인 대출 자격 금액을 계산하는 규칙을 작성하여 대출 자격 필드에 표시합니다. 이를 위해 대출 자격 필드에 값 설정 규칙을 만듭니다.

작성 모드에서 대출 자격 필드를 선택하고 을 선택합니다. 그런 다음 만들기 를 선택하여 규칙 편집기를 시작합니다.
규칙 드롭다운에서 값 설정 규칙을 선택합니다.
옵션 선택 을 선택하고 수학 식 을 선택합니다. 수학 표현식을 작성할 필드가 열립니다.
표현식 필드에서:
- Forms 개체 탭에서 첫 번째 놓기 개체에 있는 급여 필드를 선택하거나 끌어서 놓거나 여기 필드를 선택합니다.
- 연산자 선택 필드에서 더하기 을(를) 선택합니다.
- Forms 개체 탭에서 다른 개체 놓기 또는 여기를 선택 필드의 배우자 급여 필드를 선택하거나 끌어서 놓습니다.

그런 다음 식 필드 주위의 강조 표시된 영역에서 을 선택하고 식 확장 을 선택합니다.

write-rules-visual-editor-13

확장 식 필드의 연산자 선택 필드에서 나누기 를 선택하고 옵션 선택 필드에서 숫자 를 선택합니다. 그런 다음 숫자 필드에 2 을(를) 지정합니다.

write-rules-visual-editor-14

note note
NOTE
옵션 선택 필드에서 구성 요소, 함수, 수학 표현식 및 등록 정보 값을 사용하여 복잡한 표현식을 생성할 수 있습니다.

그런 다음 조건을 만들어 True를 반환하면 표현식이 실행됩니다.

When 문을 추가하려면 조건 추가 를 선택하십시오.

When 문에서:
- Forms 개체 탭에서 첫 번째 개체를 놓거나 여기를 선택 필드의 결혼 상태 필드를 선택하거나 끌어서 놓습니다.
- 연산자 선택 필드에서 i 이(가) 과(와) 같도록 선택합니다.
- 다른 개체 삭제에서 String을 선택하거나 여기를 선택 필드를 선택하고 문자열 입력 필드에 결혼됨 을(를) 지정합니다.
규칙이 최종적으로 규칙 편집기에 다음과 같이 표시됩니다.

완료 를 선택하여 규칙을 저장합니다.
혼인 상태가 싱글인 경우 대출 자격을 계산하는 다른 규칙을 정의하려면 단계 7 - 12를 반복합니다. 규칙은 규칙 편집기에 다음과 같이 표시됩니다.

NOTE

또는, 값 설정 규칙을 사용하여 배우자 임금 필드를 표시-숨기기 위해 생성한 시기 규칙에서 대출 자격을 계산할 수 있습니다. 혼인 상태가 싱글인 경우 결합된 결과 규칙은 규칙 편집기에 다음과 같이 표시됩니다.

마찬가지로 혼합 규칙을 작성하여 배우자 임금 필드의 가시성을 통제하고 혼인 상태가 기혼인 경우 대출 자격을 계산할 수 있습니다.

write-rules-visual-editor-18

코드 편집기 사용 using-code-editor

forms-power-users 그룹에 추가된 사용자는 코드 편집기를 사용할 수 있습니다. 규칙 편집기는 시각적 편집기를 사용하여 만든 모든 규칙에 대해 JavaScript 코드를 자동으로 생성합니다. 시각적 편집기에서 코드 편집기로 전환하여 생성된 코드를 볼 수 있습니다. 그러나 코드 편집기에서 규칙 코드를 수정하면 비주얼 편집기로 다시 전환할 수 없습니다. 시각적 편집기가 아닌 코드 편집기에서 규칙을 작성하려는 경우 코드 편집기에서 규칙을 새로 작성할 수 있습니다. 시각적 코드 편집기 전환기는 두 모드 간을 전환하는 데 도움이 됩니다.

코드 편집기 JavaScript은 적응형 양식의 표현식 언어입니다. 모든 표현식은 유효한 JavaScript 표현식이며 적응형 양식 스크립팅 모델 API를 사용합니다. 이 표현식은 특정 유형의 값을 반환합니다. 적응형 양식 클래스, 이벤트, 개체 및 공용 API의 전체 목록에 대해서는 적응형 양식에 대한 JavaScript 라이브러리 API 참조를 참조하십시오.

코드 편집기에서 규칙을 작성하는 방법에 대한 자세한 내용은 적응형 양식 표현식을 참조하십시오.

규칙 편집기에서 JavaScript 코드를 작성하는 동안 다음 시각적 큐를 사용하여 구조와 구문을 개선합니다.

구문 하이라이트
자동 들여쓰기
양식 개체, 함수 및 해당 속성에 대한 힌트 및 제안
양식 구성 요소 이름 및 일반적인 JavaScript 함수 자동 완성

javascriptTruleeditor

규칙 편집기의 사용자 정의 함수 custom-functions

함수 출력 아래에 나열된 Sum of 과(와) 같은 기본 함수 외에도 자주 필요한 사용자 지정 함수를 작성할 수 있습니다. 작성한 함수에는 그 위에 있는 jsdoc이(가) 있어야 합니다.

함께 jsdoc이(가) 필요합니다.

사용자 지정 구성 및 설명을 원하는 경우.
JavaScript,에서 함수를 선언하는 방법에는 여러 가지가 있으며 주석을 사용하면 함수를 추적할 수 있습니다.

자세한 내용은 usejsdoc.org을(를) 참조하십시오.

지원되는 jsdoc개 태그:

비공개
구문: @private
비공개 함수는 사용자 지정 함수로 포함되지 않습니다.
이름
구문: @name funcName <Function Name>
또는 ,을(를) 사용할 수 있습니다. @function funcName <Function Name> 또는 @func funcName <Function Name>.
funcName은(는) 함수 이름입니다(공백은 허용되지 않음).
<Function Name>은(는) 함수의 표시 이름입니다.
구성원
구문: @memberof namespace
네임스페이스를 함수에 연결합니다.
매개 변수
구문: @param {type} name <Parameter Description>
또는 다음을 사용할 수 있습니다. @argument {type} name <Parameter Description> 또는 @arg {type} name <Parameter Description>.
함수에서 사용하는 매개 변수를 표시합니다. 함수는 여러 매개 변수 태그를 가질 수 있으며, 발생 순서로 각 매개 변수에 대해 하나의 태그가 있습니다.
{type}은(는) 매개 변수 형식을 나타냅니다. 허용되는 매개 변수 유형은 다음과 같습니다.
1. 문자열
2. 숫자
3. 부울
4. 범위
범위는 적응형 양식의 참조 필드에 사용됩니다. 폼에서 소극적 로드를 사용하는 경우 scope을(를) 사용하여 해당 필드에 액세스할 수 있습니다. 필드가 로드될 때 또는 필드가 전역으로 표시될 때 필드에 액세스할 수 있습니다.

다른 모든 매개변수 유형은 위의 한 가지 유형에 따라 분류됩니다. 지원되지 않습니다. 위의 유형 중 하나를 선택해야 합니다. 유형은 대/소문자를 구분하지 않습니다. name 매개 변수에는 공백을 사용할 수 없습니다. <Parameter Descrption> <parameter> can have multiple words. </parameter>
반환 형식
구문: @return {type}
또는 @returns {type}을(를) 사용할 수 있습니다.
함수 목적 등 함수에 대한 정보를 추가합니다.
{type}은(는) 함수의 반환 형식을 나타냅니다. 허용되는 반환 유형은 다음과 같습니다.
1. 문자열
2. 숫자
3. 부울
다른 모든 반환 유형은 위의 한 가지 유형에 따라 분류됩니다. 지원되지 않습니다. 위의 유형 중 하나를 선택해야 합니다. 반환 유형은 대/소문자를 구분하지 않습니다.

이
구문: @this currentComponent

규칙@this 작성된 적응형 양식 구성 요소를 참조하려면 AEM을 사용하십시오.

다음 예제는 필드 값을 기반으로 합니다. 다음 예에서 규칙은 양식의 필드를 숨깁니다. this.value의 this 부분이 규칙이 작성된 기본 적응형 양식 구성 요소를 참조합니다.

code language-none

code language-none
`/** * @function myTestFunction * @this currentComponent * @param {scope} scope in which code inside function will be executed. */ myTestFunction = function (scope) { if(this.value == "O"){ scope.age.visible = true; } else { scope.age.visible = false; } }`

   /**
   * @function myTestFunction
   * @this currentComponent
   * @param {scope} scope in which code inside function will be executed.
   */
   myTestFunction = function (scope) {
      if(this.value == "O"){
            scope.age.visible = true;
      } else {
         scope.age.visible = false;
      }
   }

NOTE

사용자 지정 함수 이전의 댓글은 요약에 사용됩니다. 요약은 태그가 발견될 때까지 여러 줄로 확장할 수 있습니다. 규칙 빌더에서 간단한 설명을 보려면 크기를 하나로 제한하십시오.

규칙 편집기에서 사용자 지정 함수를 사용할 수도 있습니다. 사용자 지정 함수 만들기에 대한 지침은 적응형 Forms의 사용자 지정 함수 문서를 참조하십시오.

규칙 관리 manage-rules

양식 개체에 대한 기존 규칙은 개체를 선택하고 을(를) 선택하면 나열됩니다. 제목을 보고 규칙 요약을 미리 볼 수 있습니다. 또한 UI를 사용하여 전체 규칙 요약을 확장 및 보고, 규칙 순서를 변경하고, 규칙을 편집하고, 규칙을 삭제할 수 있습니다.

list-rules

규칙에 대해 다음 작업을 수행할 수 있습니다.

확장/축소: 규칙 목록의 콘텐츠 열에 규칙 콘텐츠가 표시됩니다. 전체 규칙 콘텐츠가 기본 보기에 표시되지 않으면 을(를) 선택하여 확장하십시오.
순서 바꾸기: 만든 새 규칙이 규칙 목록의 맨 아래에 스택되어 있습니다. 규칙은 위에서 아래로 실행됩니다. 맨 위에 있는 규칙이 먼저 실행되고 같은 유형의 다른 규칙이 실행됩니다. 예를 들어, 위에서부터 각각 첫 번째, 두 번째, 세 번째 및 네 번째 위치에 When, Show, Enable 및 When 규칙이 있는 경우 맨 위에 있는 When 규칙이 먼저 실행되고 네 번째 위치에 있는 When 규칙이 실행됩니다. 그런 다음 표시 및 활성화 규칙이 실행됩니다.
을(를) 탭하여 규칙의 순서를 변경하거나 목록에서 원하는 순서로 드래그 앤 드롭할 수 있습니다.
편집: 규칙을 편집하려면 규칙 제목 옆에 있는 확인란을 선택하십시오. 규칙을 편집하고 삭제할 수 있는 추가 옵션이 나타납니다. 규칙을 만드는 데 사용된 모드에 따라 선택한 규칙을 시각적 또는 코드 편집기 모드에서 규칙 편집기에서 열려면 편집 을 선택하십시오.
삭제: 규칙을 삭제하려면 규칙을 선택하고 삭제 를 선택합니다.
사용/사용 안 함: 규칙 사용을 일시 중단해야 할 수 있습니다. 하나 이상의 규칙을 선택하고 작업 도구 모음에서 비활성화 를 선택하여 비활성화할 수 있습니다. 규칙이 비활성화되어 있으면 런타임에 실행되지 않습니다. 비활성화된 규칙을 활성화하려면 해당 규칙을 선택하고 작업 도구 모음에서 활성화 를 선택할 수 있습니다. 규칙의 상태 열에는 규칙의 활성화 여부가 표시됩니다.

disablerule

규칙 복사/붙여넣기 copy-paste-rules

한 필드에서 유사한 다른 필드로 규칙을 복사하여 붙여넣으면 시간을 절약할 수 있습니다.

규칙을 복사하여 붙여넣으려면 다음을 수행합니다.

규칙을 복사할 양식 개체를 선택하고 구성 요소 도구 모음에서 을(를) 선택합니다. 양식 객체가 선택되고 기존 규칙이 나타나는 규칙 편집기 사용자 인터페이스가 나타납니다.

기존 규칙 관리에 대한 자세한 내용은 규칙 관리를 참조하십시오.
규칙 제목 옆에 있는 확인란을 선택합니다. 규칙을 관리하는 추가 옵션이 표시됩니다. 복사 를 선택합니다.

규칙을 붙여넣을 다른 양식 개체를 선택하고 붙여넣기 를 선택합니다. 또한 규칙을 편집하여 변경할 수 있습니다.

note note
NOTE
해당 양식 객체가 복사된 규칙의 이벤트를 지원하는 경우에만 다른 양식 객체에 규칙을 붙여넣을 수 있습니다. 예를 들어 버튼은 클릭 이벤트를 지원합니다. 클릭 이벤트가 있는 규칙을 단추에는 붙여넣을 수 있지만 확인란에는 붙여넣을 수 없습니다.

완료 를 선택하여 규칙을 저장합니다.

중첩된 표현식 nestedexpressions

규칙 편집기를 사용하면 여러 AND 및 OR 연산자를 사용하여 중첩된 규칙을 만들 수 있습니다. 규칙에서 여러 AND 및 OR 연산자를 혼합할 수 있습니다.

다음은 필수 조건이 충족될 때 자녀 양육권 자격에 대한 메시지를 사용자에게 표시하는 중첩된 규칙의 예입니다.

complexexpression

규칙 내에서 조건을 드래그 앤 드롭하여 편집할 수도 있습니다. 조건 전에 핸들( )을 선택하고 마우스로 가리킵니다. 포인터가 아래 표시된 대로 손 기호로 바뀌면 규칙을 규칙 내의 아무 곳에나 드래그하여 놓습니다. 규칙 구조가 변경됩니다.

드래그 앤 드롭

날짜 표현식 조건 dateexpression

규칙 편집기를 사용하면 날짜 비교를 사용하여 조건을 만들 수 있습니다.

다음은 주택에 대한 담보대출이 이미 실행된 경우 정적 텍스트 객체를 표시하는 예제 조건입니다. 이 조건은 사용자가 날짜 필드를 채워 나타냅니다.

사용자가 채운 부동산의 담보 대출 일자가 과거인 경우 적응형 양식에 소득 계산에 대한 메모가 표시됩니다. 다음 규칙은 사용자가 입력한 날짜와 현재 날짜를 비교하며 사용자가 입력한 날짜가 현재 날짜보다 이전인 경우 양식에 텍스트 메시지(소득)가 표시됩니다.

dateexpressioncondition

채워진 일자가 현재 일자보다 이전인 경우 양식에 다음과 같은 텍스트 메시지(수입)가 표시됩니다.

dateexpressionconditionmet

숫자 비교 조건 number-comparison-conditions

규칙 편집기를 사용하면 두 숫자를 비교하는 조건을 만들 수 있습니다.

다음은 지원자가 현재 주소에 있는 개월 수가 36개월 미만인 경우 정적 텍스트 객체를 표시하는 예제 조건입니다.

numbercomparisoncondition

사용자가 현재 거주 주소에서 36개월 미만 거주했음을 나타내는 경우 양식에 추가 거주 증명을 요청할 수 있다는 알림이 표시됩니다.

additionalproofrequested

규칙 편집기가 기존 스크립트에 미치는 영향 impact-of-rule-editor-on-existing-scripts

AEM 6.1 Forms 기능 팩 1 이전 AEM Forms 버전에서 양식 작성자 및 개발자는 적응형 양식에 동적 동작을 추가하기 위해 구성 요소 편집 대화 상자의 스크립트 탭에서 표현식을 작성하는 데 사용되었습니다. 이제 스크립트 탭이 규칙 편집기로 대체되었습니다.

스크립트 탭에서 작성해야 하는 모든 스크립트 또는 표현식은 규칙 편집기에서 사용할 수 있습니다. 시각적 편집기에서 이러한 스크립트를 보거나 편집할 수 없지만 forms-power-users 그룹의 일부인 경우 코드 편집기에서 스크립트를 편집할 수 있습니다.

규칙 예 example

양식 데이터 모델 서비스 호출 invoke

대출 금액, 재직 기간 및 신청자의 신용 점수를 입력하고 EMI 금액 및 이자율을 포함한 대출 플랜을 반환하는 웹 서비스 GetInterestRates을(를) 고려하십시오. 웹 서비스를 데이터 소스로 사용하여 양식 데이터 모델을 만듭니다. 양식 모델에 데이터 모델 개체 및 get 서비스를 추가합니다. 이 서비스는 양식 데이터 모델의 서비스 탭에 나타납니다. 그런 다음 데이터 모델 객체의 필드를 포함하는 적응형 양식을 만들어 대출 금액, 기간 및 신용 점수에 대한 사용자 입력을 캡처합니다. 웹 서비스를 트리거하는 단추를 추가하여 계획 세부 정보를 가져옵니다. 해당 필드에 출력이 채워집니다.

다음 규칙은 예제 시나리오를 수행하기 위해 서비스 호출 작업을 구성하는 방법을 보여 줍니다.

example-invoke-services

적응형 양식 규칙을 사용하여 양식 데이터 모델 서비스 호출

NOTE

입력이 배열 유형인 경우 배열을 지원하는 필드가 출력 드롭다운 섹션에 표시됩니다.

When 규칙을 사용하여 여러 작업 트리거 triggering-multiple-actions-using-the-when-rule

대출 신청 양식에서 대출 신청자가 기존 고객인지 여부를 캡처하려고 합니다. 사용자가 제공하는 정보를 기반으로 고객 ID 필드가 표시되거나 숨겨져야 합니다. 또한 사용자가 기존 고객인 경우 고객 ID 필드에 포커스를 설정할 수 있습니다. 대출 신청 양식에는 다음과 같은 구성 요소가 있습니다.