사전 설정을 사용하여 구성요소 자동 구성

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분
  • 구성요소 사전 설정을 사용하여 호환되는 페이지의 구성요소를 자동으로 구성합니다.

    구성요소 사전 설정을 사용하여 사전 정의된 구성 값과 이벤트 매핑을 구성요소에 적용합니다. UI 빌더 페이지 템플릿에는 사전 설정에서 구성요소 구성 값을 정의하는 데 사용하는 컨트롤러가 포함되어 있습니다.

    사전 설정은 구성요소 속성 및 이벤트 핸들러에 사전 구축된 구성을 적용하며 특정 구성요소에만 사용할 수 있습니다. 이는 일반적으로 기록 페이지에 포함되는 필드로 양식 구성요소를 구성하는 등 구성요소에 대한 일반적인 사용 사례를 기반으로 합니다.

    사전 설정을 적용하면 구성요소가 즉시 작동하도록 자동으로 구성되어 페이지 작성자의 페이지 생성 및 유지관리가 간소화됩니다.

    사전 설정은 페이지 작성자에게 다음과 같은 이점을 제공합니다.

    • 복잡한 데이터 처리 및 구성요소에 대한 이벤트 바인딩
    • 페이지 외부에 정의되어 소유 및 유지관리 비용 절감

    구성 창에서 선택한 구성요소에 사전 설정을 적용할지 아니면 수동으로 구성할지 선택할 수 있습니다. 템플릿에서 페이지를 만들거나 사전 설정에 필요한 컨트롤러가 이미 페이지에 추가된 경우 구성요소에 기본 사전 설정이 자동으로 적용됩니다. 사전 설정에 의해 구성된 모든 속성 또는 이벤트는 사전 설정이 적용될 때 읽기 전용으로 표시됩니다.

    사전 설정으로 구성된 값을 재정의할 수 있지만 이렇게 하면 구성요소 구성 및 유지 관리의 소유권을 갖게 됩니다.

    하위 페이지는 컨트롤러를 상속하지 않으며 의 사전 설정을 Yokohama사용할 수 없습니다.
    그림 1. 구성요소에 적용되는 사전 설정
    사전 설정으로 구성된 제목 구성요소 속성입니다.

    데이터 및 이벤트 바인딩

    사전 설정에는 다음에 대한 바인딩이 포함될 수 있습니다.

    • 컨트롤러 출력 속성(@data)
    • 이벤트 페이로드(@payload)
    • 세션 컨텍스트(@context.session)
    • 복잡한 수식(클라이언트 변환)

    사전 설정에는 컨트롤러의 처리된 이벤트에 대한 이벤트 매핑도 포함될 수 있습니다. 자세한 내용은 UI 빌더 페이지에서 작업 관리 문서를 참조하십시오.

    컨트롤러

    사전 설정은 컨트롤러를 사용하여 구성요소를 데이터 및 이벤트 매핑에 연결합니다. 사전 설정에 필요한 컨트롤러가 페이지에 없는 경우 사전 설정에 컨트롤러의 필수 속성을 구성하라는 메시지가 표시되고 컨트롤러가 추가됩니다. 제어기가 페이지에 추가되면 제어기와 연결된 사전 설정이 있는 구성요소가 구성요소 목록에 강조 표시됩니다. 자세한 내용은 컨트롤러를 사용하여 페이지에 데이터 UI 빌더 바인딩(고급 기능) 문서를 참조하십시오.

    그림 2. 사전 설정이 있는 구성요소
    사전 설정 레이블이 강조 표시된 구성요소를 보여주는 구성요소 탭입니다.

    구성요소 사전 설정 선택

    페이지에 구성요소를 추가할 때 구성요소 사전 설정을 선택합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 다음으로 이동 모두 > Now Experience 프레임워크 > UI 빌더.
    2. 를 선택하여 작업할 경험을 열거나 경험을 생성합니다. 작성 > 경험.
      경험 생성에 대한 자세한 내용은 을 참조하십시오 에서 사용자가 애플리케이션과 상호 작용하는 방법 구성 UI 빌더 .
    3. 페이지 또는 페이지 변형을 만들거나 엽니다.
      UI 빌더에서 페이지를 생성하는 방법에 대한 자세한 내용은 UI 빌더에서 페이지 생성 섹션을 참조하십시오.
    4. 도구 상자를 엽니다.
    5. 페이지에 녹색으로 강조 표시된 구성요소를 추가합니다.

      녹색으로 강조 표시된 구성요소에는 사용 가능한 사전 설정이 있습니다.

      구성요소 라이브러리를 열고 녹색으로 강조 표시된 구성요소를 페이지로 드래그합니다.
    6. 구성요소는 기본 사전 설정을 사용하여 자동으로 구성됩니다.
      기본 구성요소 사전 설정이 사전 설정 드롭다운에 표시됩니다.
    7. 옵션: 구성 패널의 목록에서 다른 사전 설정을 선택합니다.
      제거를 선택하여 사전 설정을 사용하지 않도록 구성 요소를 구성할 수 있습니다.
      1. 계속을 선택하여 기존 사전 설정을 바꿉니다.
      목록에서 다른 사전 설정을 선택하거나 사전 설정을 선택하지 않습니다.
    8. 저장을 클릭합니다.

    구성요소 사전 설정 재정의

    구성요소 사전 설정을 재정의하여 고유한 사용자 지정 값을 입력합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 사전 설정이 있는 구성요소를 선택합니다.
      컨텐츠 트리에서 재정의할 구성요소를 선택합니다.
    2. 구성 패널에서 재정의할 데이터 값을 찾습니다.
    3. 데이터 필드에서 잠금 아이콘을 클릭합니다.
    4. 사전 설정 값을 재정의할 데이터 값을 입력합니다.
    5. 저장을 선택합니다.
      사전 설정된 구성요소 값을 사용자 지정 값으로 재정의합니다.

    결과

    구성 패널에 필드에 사용자 지정 값이 표시됩니다.

    구성요소 재설정

    구성요소 사전 설정을 기본값으로 재설정합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 컨텐츠 트리에서 재설정할 구성요소를 선택합니다.
      컨텐츠 트리에서 재정의할 구성요소를 선택합니다.
    2. 구성 패널에서 구성요소 이름을 선택합니다.
      구성 패널의 구성요소 이름입니다.
    3. 구성요소 재설정을 클릭합니다.
      구성요소 재설정 옵션을 사용하여 구성요소 값을 재설정합니다.
    4. 재설정을 클릭합니다.

    결과

    구성요소 사전 설정이 기본값으로 재설정됩니다.