사전 설정을 사용하여 구성요소 자동 구성
구성요소 사전 설정을 사용하여 호환되는 페이지에서 구성요소를 자동으로 구성합니다.
구성요소 사전 설정을 사용하여 미리 정의된 구성 값과 이벤트 매핑을 구성요소에 적용합니다. UI 빌더 페이지 템플릿에는 사전 설정이 구성요소 구성 값을 정의하는 데 사용하는 컨트롤러가 포함되어 있습니다.
사전 설정은 사전 구축된 구성을 구성요소 속성 및 이벤트 핸들러에 적용하며 특정 구성요소에만 사용할 수 있습니다. 이는 일반적으로 기록 페이지에 포함된 필드로 양식 구성요소를 구성하는 것과 같은 구성요소에 대한 일반적인 사용 사례를 기반으로 합니다.
사전 설정을 적용하면 즉시 작동하도록 구성 요소가 자동으로 구성되므로 페이지 작성자의 페이지 생성 및 유지 관리가 간소화됩니다.
사전 설정은 페이지 작성자에게 다음과 같은 이점을 제공합니다.
- 구성요소에 대한 복잡한 데이터 및 이벤트 바인딩 처리
- 페이지 외부에 정의되므로 소유 및 유지관리 비용 절감
구성 창에서 선택한 구성요소에 사전 설정을 적용할지 아니면 수동으로 구성할지 선택할 수 있습니다. 기본 사전 설정은 페이지가 템플릿에서 생성되거나 사전 설정에 필요한 컨트롤러가 이미 페이지에 추가된 경우 구성요소에 자동으로 적용됩니다. 사전 설정이 적용되면 사전 설정으로 구성된 모든 속성 또는 이벤트가 읽기 전용으로 표시됩니다.
사전 설정으로 구성된 값을 재정의할 수 있지만, 재정의할 때 구성요소 구성 및 유지관리에 대한 소유권이 사용자에게 있습니다.
데이터 및 이벤트 바인딩
사전 설정에는 다음에 대한 바인딩이 포함될 수 있습니다.
- 컨트롤러 출력 속성(@data)
- 이벤트 페이로드(@payload)
- 세션 컨텍스트(@context.session)
- 복잡한 수식(클라이언트 변환)
사전 설정에는 컨트롤러의 처리된 이벤트에 대한 이벤트 매핑도 포함될 수 있습니다. 자세한 내용은 UI 빌더 페이지에서 작업 관리(고급 기능) 문서를 참조하십시오.
컨트롤러
사전 설정은 컨트롤러를 사용하여 구성요소를 데이터 및 이벤트 매핑에 연결합니다. 사전 설정에 필요한 컨트롤러가 아직 페이지에 없는 경우 사전 설정은 컨트롤러의 필수 속성을 구성하라는 메시지를 표시하고 컨트롤러를 추가합니다. 컨트롤러가 페이지에 추가되면 컨트롤러와 연결된 사전 설정이 있는 구성 요소가 구성 요소 목록에서 강조 표시됩니다. 자세한 내용은 컨트롤러를 UI 빌더 사용하여 페이지에 데이터 바인딩(고급 기능) 문서를 참조하십시오.
구성요소 사전 설정 선택
페이지에 구성요소를 추가할 때 구성요소 사전 설정을 선택합니다.
시작하기 전에
필요한 역할: admin
프로시저
-
녹색으로 강조 표시된 구성요소를 페이지에 추가합니다.
녹색으로 강조 표시된 구성요소에는 사용 가능한 사전 설정이 있습니다.
-
구성요소가 기본 사전 설정으로 자동으로 구성됩니다.
- 옵션:
구성 패널의 목록에서 다른 사전 설정을 선택합니다.
제거를 선택하여 사전 설정을 사용하지 않도록 구성요소를 구성할 수 있습니다.
- 계속을 선택하여 기존 사전 설정을 바꿉니다.
구성요소 사전 설정 재정의
구성요소 사전 설정을 재정의하여 사용자 지정 값을 입력합니다.
시작하기 전에
필요한 역할: admin
프로시저
-
사전 설정이 있는 구성요소를 선택합니다.
-
저장을 선택합니다.
결과
구성 패널에는 필드에 사용자 지정 값이 표시됩니다.
구성요소 재설정
구성요소 사전 설정을 기본값으로 재설정합니다.
시작하기 전에
필요한 역할: admin
프로시저
-
컨텐츠 트리에서 재설정할 구성요소를 선택합니다.
-
구성 패널에서 구성요소 이름을 선택합니다.
-
구성요소 재설정을 클릭합니다.
결과
구성요소 사전 설정이 기본값으로 재설정됩니다.