핵심 구성 요소 기반 적응형 양식의 규칙 편집기에서 사용 가능한 연산자 유형 및 이벤트

AEM Forms as a Cloud에서 규칙 편집기에는 복잡한 조건 및 작업을 쉽게 정의하고 실행할 수 있는 다양한 연산자 유형 및 이벤트가 포함되어 있습니다.

적응형 양식의 규칙 편집기에서 사용할 수 있는 연산자 유형은 정확한 조건을 구성하는 강력한 프레임워크를 제공합니다. 이를 통해 데이터를 조작하고 계산을 수행하며 논리적이고 일관성 있는 방식으로 여러 조건을 결합할 수 있습니다. 값을 비교하든, 산술 연산을 수행하든, 문자열을 조작하든 상관없이 이러한 연산자는 규칙이 유연하고 강력한지 확인합니다.

규칙 편집기의 이벤트는 규칙을 활성화하는 트리거 역할을 합니다. 특정 조건이 충족될 때 발생하는 특정 작업을 정의합니다. 다양한 유형의 이벤트를 활용함으로써 사용자 상호 작용, 예약 시간, 데이터 변경, 시스템 상태 등 다양한 시나리오에 대한 응답을 자동화할 수 있습니다. 이러한 트리거를 지정하는 기능을 통해 특정 요구 사항에 맞는 동적 및 반응형 규칙을 만들 수 있습니다.

사용 가능한 연산자 유형 및 이벤트를 이해하고 사용하면 규칙 편집기의 잠재력을 최대한 활용하여 고유한 요구 사항에 맞는 효율적이고 효과적인 규칙을 만들고 전반적인 시스템 기능을 개선할 수 있습니다.

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

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

  • 이(가) ​과(와) 같음 - 양식 개체가 지정된 값과 일치하는지 확인합니다.
  • 같지 않음 - 양식 개체가 지정된 값과 일치하지 않는지 확인합니다.
  • 다음으로 시작 – 양식 개체가 지정된 문자열로 시작하는지 확인합니다.
  • 다음으로 끝남 – 양식 개체가 지정된 문자열로 끝나는지 확인합니다.
  • 포함 – 양식 개체에 지정된 하위 문자열이 포함되어 있는지 확인합니다.
  • 포함 하지 않음 – 양식 개체에 지정된 하위 문자열이 포함되어 있지 않은지 확인합니다.
  • 비어 있음 – 양식 개체가 비어 있거나 제공되지 않았는지 확인합니다.
  • Is Not Empty – 양식 개체가 있고 비어 있지 않은지 확인합니다.
  • 선택함 - 사용자가 특정 확인란, 드롭다운 또는 라디오 버튼 옵션을 선택하면 true를 반환합니다.
  • 초기화됨(이벤트) - 양식 개체가 브라우저에서 렌더링될 때 true를 반환합니다.
  • Is Changed (event) - 사용자가 양식 개체의 값이나 선택을 수정할 때 true를 반환합니다.
  • 클릭됨(이벤트) - 사용자가 단추와 같은 양식 개체를 클릭하면 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
`개체 C에 대한 작업 3;

Else, do the following:

Action 2 on Object C;
_

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

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

다중 값에 옵션 표시

When 규칙을 작성하는 동안 값 지우기 작업을 트리거할 수 있습니다. [값 지우기] 작업을 수행하면 지정된 객체의 값이 지워집니다. When 문에서 Clear Value를 옵션으로 사용하면 여러 필드가 있는 복잡한 조건을 만들 수 있습니다. Else 문을 추가하여 조건을 추가할 수 있습니다

값 지우기

NOTE
규칙 유형이 단일 레벨 then-else 문만 지원하는 경우.
경우에 허용되는 여러 필드 allowed-multiple-fields

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

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

시기:

(객체 A 조건 1)

및/또는

(오브젝트 B 조건 2)

그런 다음 다음을 수행합니다.

개체 A에 대한 작업 1

_

When 에서 여러 필드 허용됨

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

  • 규칙 편집기에서 이 기능을 사용하려면 핵심 구성 요소가 버전 3.0.14 이상으로 설정되어 있는지 확인하십시오.
  • When 조건 내의 다른 필드에 규칙이 적용되면 해당 필드 중 하나만 변경되더라도 규칙이 트리거됩니다.
  • AND 규칙에 대한 When 조건에서만 여러 필드를 추가할 수 있습니다. OR 규칙에는 사용할 수 없습니다.
NOTE
단추 클릭이 포함된 여러 조건을 추가하려면 단추 클릭 이벤트가 첫 번째 조건으로 배치되었는지 확인하십시오. 예를 들어 When button is clicked AND text input equals '5'은(는) 유효하지만 When text input equals '5' AND button is clicked은(는) 지원되지 않습니다.

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

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

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

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

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

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

서비스 호출 양식 데이터 모델(FDM)에 구성된 서비스를 호출합니다. 서비스 호출 작업을 선택하면 필드가 나타납니다. 필드를 탭하면 Experience Manager 인스턴스의 모든 양식 데이터 모델(FDM)에 구성된 모든 서비스가 표시됩니다. 양식 데이터 모델 서비스를 선택하면 양식 개체를 지정된 서비스에 대한 입력 매개 변수와 매핑할 수 있는 필드가 더 많이 나타납니다. 지정된 서비스에 대한 이벤트 페이로드 옵션을 통해 출력 매개 변수를 매핑할 수 있습니다. 규칙 편집기를 사용하여 서비스 호출 작업의 성공 및 실패 응답을 처리하는 규칙을 만들 수도 있습니다.

NOTE
Invoke 서비스에 대해 자세히 알아보려면 여기를 클릭하십시오.

양식 데이터 모델(FDM) 서비스 호출에 대한 규칙 예를 참조하십시오.

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

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

Set value of 지정된 개체의 값을 계산하고 설정합니다. 개체 값을 문자열, 다른 개체의 값, 수학 식이나 함수를 사용하여 계산된 값, 개체의 속성 값 또는 구성된 양식 데이터 모델 서비스의 출력 값으로 설정할 수 있습니다. 웹 서비스 옵션을 선택하면 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입니다.

다음 예제에서는 Question2의 값을 True(으)로 선택하고 Result의 값을 correct(으)로 설정합니다.

Set-value-web-service

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

표시 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 규칙 유형은 조건이 충족되지 않거나 반환 False되는 경우 Disable 작업을 트리거합니다.

일반적인 Enable 규칙 구조는 다음과 같습니다.

Enable Object A;

When:

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

Else:

Disable Object A;

비활성화 disable

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

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

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

스크립트 유효성 검사

패널 간 탐색

패널 간 탐색 규칙 유형을 사용하면 양식의 서로 다른 패널 간에 포커스를 이동할 수 있습니다. 예를 들어 다음 패널로 포커스를 이동하는 표현식을 만들 수 있습니다.

포커스를 다음 패널로 이동하기 위한 일반적인 패널 간 이동 규칙은 다음과 같이 구성됩니다.

Navigate among the panels

Shift focus to the next item Object A;

When:

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

마찬가지로 포커스를 이전 패널로 전환하기 위한 패널 간 탐색 규칙을 쓸 수 있습니다.

Navigate among the panels

Shift focus to the previous item Object A;

When:

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

패널에서 탐색할 규칙을 만드는 방법에 대한 자세한 내용을 보려면 여기를 클릭하십시오.

비동기 함수 호출

이는 프리릴리스 기능이고 프리릴리스 채널을 통해 액세스할 수 있습니다.

비동기 함수 호출 규칙 유형을 사용하면 비동기 함수를 실행할 수 있습니다. 이를 통해 기본 실행 스레드와 독립적으로 작동하는 함수 호출을 시작할 수 있으므로 비동기 함수가 완료될 때까지 기다리지 않고 다른 프로세스가 계속 실행될 수 있습니다.

비동기 함수를 실행하기 위한 일반적인 비동기 함수 호출 규칙 구조는 다음과 같습니다.

When:

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

Async Function call

[Callback Function];

시각적 규칙 편집기에서 비동기 함수 호출을 사용하는 방법에 대한 자세한 내용은 규칙 편집기에서 비동기 함수 호출 사용 문서를 참조하십시오.

다음 단계

이제 핵심 구성 요소를 기반으로 하는 적응형 양식에 대한 규칙 편집기의 다양한 예제를 살펴보겠습니다.

추가 참조

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab