적응형 양식 핵심 구성 요소에 규칙 추가 adaptive-forms-rule-editor

이 문서에는 다음 적응형 Forms 핵심 구성 요소의 최신 규칙 편집기 기능이 포함되어 있습니다.

  • When-else 기능을 사용하여 중첩된 조건 구현 지원
  • 필드를 포함한 패널 및 양식의 유효성 검사 또는 재설정
  • 사용자 정의 함수 내에서 let 및 arrow 함수(ES10 지원)와 같은 최신 JavaScript 기능을 지원합니다.

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

규칙 편집기는 규칙을 작성하는 직관적이고 간단한 사용자 인터페이스를 제공합니다. 규칙 편집기는 모든 사용자를 위한 시각적 편집기를 제공합니다. 규칙을 사용하여 적응형 양식 개체에 대해 수행하는 몇 가지 주요 작업은 다음과 같습니다.

  • 개체 표시 또는 숨기기
  • 오브젝트 활성화 또는 비활성화
  • 오브젝트의 값 설정
  • 오브젝트 값의 유효성 검사
  • 오브젝트의 값을 계산하는 함수 실행
  • 양식 데이터 모델(FDM) 서비스 호출 및 작업 수행
  • 오브젝트의 속성 설정

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

규칙 이해 understanding-a-rule

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

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

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

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

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

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

규칙 편집기의 Show, Hide, Enable, Disable, Set Value Of 및 Validate 규칙 유형은 action-condition 규칙 구문을 적용합니다. 기본적으로 표시에 대한 대체 작업은 숨기기이고 활성화에 대한 대체 작업은 비활성화이며 그 반대입니다. 기본 대체 작업은 변경할 수 없습니다.

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

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

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

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

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

    따라서 필드 B(조건을 평가하는 개체)에 규칙을 작성하는 경우 condition-action 구문 또는 When 규칙 유형을 사용하십시오. 마찬가지로 필드 A에서 action-condition 구문 또는 Show or Hide 규칙 유형을 사용하십시오.

  • 한 가지 조건을 기반으로 여러 작업을 수행해야 하는 경우가 있습니다. 이러한 경우 condition-action 구문을 사용하는 것이 좋습니다. 이 구문에서는 한 번 조건을 평가하고 여러 작업 문을 지정할 수 있습니다.

    예를 들어, 사용자가 필드 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

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

When 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:

Action 2 on Object B;
AND
Action 3 on Object C;

Else, do the following:

Action 2 on Object C;
_

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

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

다중 값에 옵션 표시

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

값 지우기

NOTE
규칙 유형이 단일 수준 then-else 문만 지원하는 경우.

When에 여러 필드가 허용됨 allowed-multiple-fields

When 조건에서는 규칙이 적용되는 필드 외에 다른 필드를 추가할 수 있습니다.

예를 들어 When 규칙 유형을 사용하여 서로 다른 양식 객체에 대한 조건을 평가하고 작업을 수행할 수 있습니다.

When:

(Object A Condition 1)

AND/OR

(Object B Condtion 2)

Then, do the following:

Action 1 on Object A

_

When 에서 여러 필드 허용됨

When 조건 기능에서 허용된 여러 필드를 사용하는 동안 고려 사항

조건 기능의 허용된 여러 필드에 문제가 발생하는 경우 문제 해결 단계를 다음과 같이 수행하십시오.

  1. 편집 모드로 양식을 엽니다.
  2. 콘텐츠 브라우저를 열고 적응형 양식의 안내서 컨테이너 구성 요소를 선택합니다.
  3. 안내서 컨테이너 속성 안내서 속성 아이콘을 클릭합니다. 적응형 양식 컨테이너 대화 상자가 열립니다.
  4. 완료 를 클릭하고 대화 상자를 다시 저장합니다.

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

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

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

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

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

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

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

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

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

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

  • 표시(부울)
  • label.value (문자열)
  • label.visible (부울)
  • 설명(문자열)
  • 활성화됨(부울)
  • readOnly(부울)
  • 필수(부울)
  • screenReaderText(문자열)
  • 유효(부울)
  • errorMessage(문자열)
  • 기본값(숫자, 문자열, 날짜)
  • enumNames(String[])
  • chartType (String)

예를 들어, 단추를 클릭할 때 텍스트 상자를 표시하는 규칙을 정의할 수 있습니다. 사용자 지정 함수, 양식 개체, 개체 속성 또는 서비스 출력을 사용하여 규칙을 정의할 수 있습니다.

속성 설정

사용자 지정 함수를 기반으로 규칙을 정의하려면 드롭다운 목록에서 함수 출력 ​을(를) 선택한 다음 함수 탭에서 사용자 지정 함수를 드래그 앤 드롭합니다. 조건 작업이 충족되면 텍스트 입력 상자가 표시됩니다.

양식 개체를 기반으로 규칙을 정의하려면 드롭다운 목록에서 양식 개체 ​를 선택하고 양식 개체 탭에서 양식 개체를 끌어서 놓습니다. 조건 작업이 충족되면 텍스트 입력 상자가 적응형 양식에 표시됩니다.

개체 속성을 기반으로 속성 설정 규칙을 사용하면 적응형 양식에 포함된 다른 개체 속성을 기반으로 적응형 양식에 텍스트 입력 상자가 표시되도록 할 수 있습니다.

다음 그림은 적응형 양식에서 텍스트 상자의 숨김이나 표시를 기반으로 확인란을 동적으로 활성화하는 예를 보여 줍니다.

개체 속성

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

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

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

Reset 폼이나 지정한 개체를 다시 설정합니다.

유효성 검사 폼 또는 지정된 개체의 유효성을 검사합니다.

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

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

함수 출력 미리 정의된 함수 또는 사용자 지정 함수를 기반으로 규칙을 정의합니다.

이동 다른 응용 Forms, 이미지 또는 문서 조각과 같은 다른 에셋 또는 외부 URL로 이동합니다.

이벤트 발송 미리 정의된 조건이나 이벤트를 기반으로 특정 작업이나 동작을 트리거합니다.

값 설정 set-value-of

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

Set Value Of 규칙 형식은 패널 및 도구 모음 단추와 같은 모든 양식 개체에 사용할 수 없습니다. 표준 규칙 값 설정(Set Value Of rule)의 구조는 다음과 같습니다.

개체 A의 값을 다음으로 설정:

(문자열 ABC) 또는
(객체 C의 객체 등록 정보 X) 또는
(함수의 값) 또는
(수학 표현식의 값) OR
(데이터모델 서비스의 출력값)

다음과 같은 경우(선택 사항):

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

다음 예제에서는 as TrueQuestion2 값을 선택하고 ascorrectResult 값을 설정합니다.

값 웹 서비스 설정

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

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

스크립트 유효성 검사

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

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

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

  1. 작성 모드에서 적응형 양식을 엽니다.

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

    create-rules

    선택한 양식 객체에 대한 기존 규칙이 이 뷰에 나열됩니다. 기존 규칙 관리에 대한 자세한 내용은 규칙 관리를 참조하십시오.

  3. 새 규칙을 작성하려면 만들기 ​를 선택하십시오. 규칙 편집기 사용자 인터페이스의 시각적 편집기는 규칙 편집기를 처음 실행할 때 기본적으로 열립니다.

    규칙 편집기 UI

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

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

규칙 편집기를 시작한 적응형 양식 개체의 제목과 현재 선택된 규칙 유형을 표시합니다. 위의 예에서 규칙 편집기는 질문 1이라는 적응형 양식 객체에서 시작되며 선택한 규칙 유형은 때입니다.

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

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

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

하나 이상의 유효한 규칙이 적용된 양식 개체는 녹색 점으로 표시됩니다. 양식 객체에 적용된 규칙 중 하나라도 유효하지 않으면 양식 객체가 노란색 점으로 표시됩니다.

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

일부 함수 목록이 그림에 표시됩니다.

함수 탭

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

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

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

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

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

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

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

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

완료 단추를 사용하여 규칙을 저장합니다. 불완전한 규칙을 저장할 수 있습니다. 그러나 불완전한 것은 잘못된 것이며 실행되지 않습니다. 양식 개체에 저장된 규칙은 다음에 동일한 양식 개체에서 규칙 편집기 실행 때 나열됩니다. 해당 보기에서 기존 규칙을 관리 할 수 있습니다. 자세한 내용은 규칙🔗 관리를 참조하세요.

취소​ 버튼는 ​규칙에 대한 모든 변경 사항을 무시하고 규칙 편집기 닫습니다.

규칙 작성 write-rules

시각적 규칙 편집기를 사용하여 규칙을 작성할 수 있습니다

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

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

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

Create-rule-example

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

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

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

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

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

    write-rules-visual-editor-1

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

    선택한 객체를 변경하거나 수정할 수 없지만 아래 표시된 대로 규칙 드롭다운을 사용하여 다른 규칙 유형을 선택할 수 있습니다. 다른 객체에 규칙을 작성하려면 취소를 선택하여 규칙 편집기를 종료하고 원하는 양식 객체에서 규칙을 다시 시작합니다.

  2. 상태 선택 드롭다운을 선택하고 이(가) 다음과 같음 ​을(를) 선택합니다. 문자열 입력 필드가 나타납니다.

    write-rules-visual-editor-2

  3. 규칙의 문자열 입력 필드에서 드롭다운 메뉴에서 기혼 ​을(를) 선택합니다.

    write-rules-visual-editor-4

    조건을 When Marital Status is equal to Married(으)로 정의했습니다. 그런 다음 이 조건이 True인 경우 수행할 작업을 정의합니다.

  4. Then 문의 작업 선택 드롭다운에서 표시 ​를 선택합니다.

    write-rules-visual-editor-5

  5. 개체 놓기 또는 여기를 선택 필드의 양식 개체 탭에서 배우자 급여 필드를 드래그 앤 드롭하십시오. 또는 드롭 개체 또는 여기를 선택 필드를 선택하고 양식의 모든 양식 개체가 나열된 팝업 메뉴에서 배우자 급여 필드를 선택합니다.

    write-rules-visual-editor-6

    그런 다음 이 조건이 False인 경우 수행할 작업을 정의합니다.

  6. 혼인 상태를 싱글로 선택하는 경우 기타 섹션 추가 ​를 클릭하여 배우자 급여 필드에 다른 조건을 추가합니다.

    when-else

  7. Else 문의 작업 선택 드롭다운에서 숨기기 ​를 선택합니다.
    when-else

  8. 개체 놓기 또는 여기를 선택 필드의 양식 개체 탭에서 배우자 급여 필드를 드래그 앤 드롭하십시오. 또는 드롭 개체 또는 여기를 선택 필드를 선택하고 양식의 모든 양식 개체가 나열된 팝업 메뉴에서 배우자 급여 필드를 선택합니다.
    when-else

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

    write-rules-visual-editor-7

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

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

write-rules-visual-editor-9

  1. 다음으로, 총 급여의 50%인 대출 자격 금액을 계산하는 규칙을 작성하여 대출 자격 필드에 표시합니다. 이 결과를 얻으려면 대출 자격 필드에 값 설정 규칙을 만드십시오.

    작성 모드에서 대출 자격 필드를 선택하고 편집 규칙 을 선택합니다. 그런 다음 만들기 ​를 선택하여 규칙 편집기를 시작합니다.

  2. 규칙 드롭다운에서 값 설정 규칙을 선택합니다.

    write-rules-visual-editor-10

  3. 옵션 선택 ​을 선택하고 수학 식 ​을 선택합니다. 수학 표현식을 작성할 필드가 열립니다.

    write-rules-visual-editor-11

  4. 표현식 필드에서:

    • Forms 개체 탭에서 첫 번째 놓기 개체에 있는 ​​급여​​ 필드를 선택하거나 끌어서 놓거나 여기 필드를 선택합니다.

    • 연산자 선택 필드에서 더하기 ​을(를) 선택합니다.

    • Forms 개체 탭에서 다른 개체 놓기 또는 여기를 선택 필드의 배우자 급여 필드를 선택하거나 끌어서 놓습니다.

    write-rules-visual-editor-12

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

    write-rules-visual-editor-13

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

    write-rules-visual-편집기-14

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

    다음, True를 반환할 때 표현식이 실행되는 조건을 만듭니다.

  6. 조건​ 추가를 선택하여 When 문을 추가합니다.

    write-rules-visual-편집기-15

    When 문에서:

    • Forms 개체 탭에서 첫 번째 개체를 놓거나 여기를 선택 필드의 결혼 상태 필드를 선택하거나 끌어서 놓습니다.

    • 연산자 선택 필드에서 이(가) ​과(와) 같습니다.

    • 다른 개체 삭제에서 String을 선택하거나 여기를 선택 필드를 선택하고 문자열 입력 필드에 결혼됨 ​을(를) 지정합니다.

    규칙이 최종적으로 규칙 편집기에 다음과 같이 표시됩니다. write-rules-visual-편집기-16

  7. 완료 ​를 선택합니다. 규칙을 저장합니다.

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

    write-rules-visual-editor-17

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

write-rules-visual-editor-18

혼합 규칙을 작성하여 배우자 임금 필드의 가시성을 통제하고 결혼 상태가 기혼인 경우 기타 조건을 사용하여 대출 자격을 계산할 수 있습니다.

write-rules-visual-editor-19

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

함수 출력 ​에 나열된 합계 ​와 같은 기본 함수 외에 규칙 편집기에서 사용자 지정 함수를 사용할 수도 있습니다. 규칙 편집기는 스크립트 및 사용자 지정 함수에 대한 JavaScript ECMAScript 2019 구문을 지원합니다. 사용자 지정 함수 만들기에 대한 지침은 적응형 Forms의 사용자 지정 함수 문서를 참조하십시오.

규칙 관리 manage-rules

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

목록 규칙

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

  • 확장/축소: 규칙 목록의 콘텐츠 열에 규칙 콘텐츠가 표시됩니다. 전체 규칙 콘텐츠가 기본 보기에 표시되지 않으면 expand-rule-content 을(를) 선택하여 확장하십시오.

  • 순서 바꾸기: 만든 새 규칙이 규칙 목록의 맨 아래에 스택되어 있습니다. 규칙은 위에서 아래로 실행됩니다. 맨 위에 있는 규칙이 먼저 실행되고 같은 유형의 다른 규칙이 실행됩니다. 예를 들어, 위에서부터 각각 첫 번째, 두 번째, 세 번째 및 네 번째 위치에 When, Show, Enable 및 When 규칙이 있는 경우 맨 위에 있는 When 규칙이 먼저 실행되고 네 번째 위치에 있는 When 규칙이 실행됩니다. 그런 다음 표시 및 활성화 규칙이 실행됩니다.
    정렬 규칙 을(를) 탭하여 규칙의 순서를 변경하거나 목록에서 원하는 순서로 드래그 앤 드롭할 수 있습니다.

  • 편집: 규칙을 편집하려면 규칙 제목 옆에 있는 확인란을 선택하십시오. 규칙을 편집하고 삭제하는 옵션이 나타납니다. 편집 ​을 선택하여 규칙 편집기 에서 선택한 규칙을 엽니다.

  • 삭제: 규칙을 삭제하려면 규칙을 선택하고 삭제 ​를 선택합니다.

  • 활성화/비활성화: 규칙 사용을 일시 중지해야 하는 경우 하나 이상의 규칙을 선택하고 [작업] 도구 모음에서 비활성화 ​를 선택하여 비활성화할 수 있습니다. 규칙이 비활성화되어 있으면 런타임에 실행되지 않습니다. 비활성화된 규칙을 활성화하려면 해당 규칙을 선택하고 작업 도구 모음에서 활성화 를 선택할 수 있습니다. 규칙의 상태 열에는 규칙의 활성화 여부가 표시됩니다.

규칙 사용 안 함

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

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

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

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

    규칙 복사

    기존 규칙 관리에 대한 자세한 내용은 규칙 관리를 참조하십시오.

  2. 규칙 제목 옆에 있는 확인란을 선택하면 규칙을 관리하는 옵션이 나타납니다. 복사 ​를 선택합니다.

    copyrule2

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

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

중첩된 표현식 nestedexpressions

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

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

복합 식

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

드래그 앤 드롭

날짜 표현식 조건 dateexpression

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

다음은 주택에 대한 모기지가 이미 있는 경우 정적 텍스트 개체를 표시하는 예제 조건으로, 사용자 날짜 필드를 채워 나타냅니다.

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

날짜 식 조건

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

날짜 식 조건이 충족됨

숫자 비교 조건 number-comparison-conditions

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

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

숫자 비교 조건

사용자가 현재 거주 주소에서 36개월 미만 거주한다고 표시하면 양식에 더 많은 거주 증명을 요청할 수 있다는 알림이 표시됩니다.

더 많은 증명을 요청함

규칙 예 example

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

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

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

Example-invoke-services

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

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

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

  • 라디오 단추, 기존 Geometrixx 고객입니까?: 예 및 아니요 옵션을 제공합니다. 예 값은 0 ​이고 아니요 값은 1 ​입니다.

  • 고객 ID를 지정하는 텍스트 필드 Geometrixx 고객 ID ​입니다.

이 동작을 구현하기 위해 라디오 단추에 When 규칙을 작성할 때 시각적 규칙 편집기에 다음과 같이 규칙이 나타납니다.

When-rule-example

시각적 편집기의 규칙

예제 규칙에서 When 섹션의 문은 True를 반환하는 경우 Then 섹션에 지정된 작업을 실행하는 조건입니다.

규칙에서 함수 출력 사용 using-a-function-output-in-a-rule

구매 주문 양식에는 사용자가 주문을 작성하는 다음 표가 있습니다. 이 표에서:

  • 첫 번째 행은 반복 가능하므로 사용자는 여러 제품을 주문하고 다른 수량을 지정할 수 있습니다. 요소 이름은 Row1입니다.
  • 반복 가능 행의 제품 수량 열에 있는 셀의 제목은 수량입니다. 이 셀의 요소 이름은 productquantity입니다.
  • 테이블의 두 번째 행은 반복될 수 없으며 이 행의 제품 수량 열에 있는 셀 제목은 총 수량입니다.

Example-function-table

A. 행1 B. 수량 C. 총 수량

이제 모든 제품에 대해 제품 수량 열에 지정된 수량을 추가하고 총 수량 셀에 합계를 표시합니다. 아래와 같이 총 수량 셀에 규칙 값 설정을 작성하면 이 합계를 달성할 수 있습니다.

Example-function-output

시각적 편집기의 규칙

표현식을 사용하여 필드 값 확인 validating-a-field-value-using-expression

앞의 예제에서 설명한 구매 주문 양식에서는 사용자가 가격이 더 비싼 제품을 두 개 이상 주문하지 못하도록 10000. 이 유효성 검사를 수행하려면 아래와 같이 유효성 검사 규칙을 작성할 수 있습니다.

Example-validate
시각적 편집기의 규칙

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2