사용자 지정 에셋 선택기는 AEM 유니버설 편집기의 복합 다중 필드에서 지원되지 않습니다.

이 문서에서는 Adobe Experience Manager(AEM) 유니버설 편집기의 복합 다중 필드 컨테이너 내에서 사용할 때 사용자 지정 에셋 선택기 필드가 올바르게 작동하지 않는 현재 제한 사항에 대해 설명합니다. 이 비헤이비어를 방지하려면 지원되는 필드 유형 또는 대체 구성 요소 디자인을 사용하십시오.

설명 description

환경

Adobe Experience Manager(AEM) 유니버설 편집기/문서 작성(모든 버전)

문제/증상

  • 사용자 지정 자산 선택기 구성 요소(예: custom-asset-namespace:custom-asset)는 복합 다중 필드 컨테이너(multi: true이(가) 있는 컨테이너 구성 요소) 내에 배치되면 예상대로 작동하지 않습니다.

  • 사용자 지정 에셋 선택기는 독립 실행형 필드로 올바르게 작동하지만 복합 다중 필드 내에 중첩된 경우 제대로 렌더링되거나 작동하지 않습니다.

  • 명시적인 오류 메시지는 나타나지 않을 수 있지만, 에셋 선택 및 값 바인딩이 중첩된 컨텍스트에서 의도한 대로 작동하지 않습니다.

    구성 요소 모델 정의 예:

    code language-none
    {
      "component": "container",
      "name": "saleImages",
      "label": "Sale images",
      "multi": true,
      "fields": [
        {
          "component": "text",
          "name": "saleName",
          "label": "Sale name",
          "valueType": "string"
        },
        {
          "component": "custom-asset-namespace:custom-asset",
          "name": "SaleImage",
          "label": "Sale image",
          "description": "This image will be used for any sale that doesn't have a specific image defined.",
          "configUrl": "/content/dam/image.config.json",
          "required": true
        }
      ]
    }
    

해결 방법 resolution

  1. 단순 필드 형식(예: text, reference, aem-content)만 유니버설 편집기에서 multi: true에 사용할 수 있도록 공식적으로 지원되는지 확인하십시오. 유니버설 편집기 필드 형식을 참조하세요. 참고:

    • valueType: array(복합 다중 필드)이 포함된 컨테이너 구성 요소는 현재 모든 필드 형식에 대한 유니버설 편집기 속성 레일에서 지원되지 않습니다.
    • 구성 요소 모델 설명서에서는 복합 다중 필드를 고급 패턴으로 설명하고 일부 사용자 지정 또는 확장 필드 형식과의 호환성을 보장하지는 않습니다.
    • 고급 복합 필드 패턴에 대한 향후 지원을 위해 유니버설 편집기 릴리스 정보 및 설명서 모니터링.
  2. 구성 가능한 에셋 선택기 확장을 단일 필드(필드당 하나의 에셋 값)로 사용합니다. 참고:

    • 확장 프로그램은 복합 다중 필드 내에서 중첩 또는 반복적으로 사용하지 않고 단일 필드로 사용하도록 설계 및 테스트됩니다.
    • saleImages/item0/SaleImage과(와) 같은 중첩 데이터 구조에 대한 지원은 현재 구현되거나 문서화되지 않았습니다.
  3. 공식 지원이 문서화될 때까지 범용 편집기의 복합 다중 필드 컨테이너 내에 사용자 지정 자산 선택기 필드를 배치하지 마십시오.

  4. 이 기능이 중요한 경우 AEM 제품 피드백 채널을 통해 기능 요청을 제출하십시오.

  5. 복합 다중 필드와 사용자 지정 에셋 선택기 확장 프로그램은 중첩된 필드 처리 및 확장 호환성의 제한 사항으로 인해 현재 범용 편집기에서 함께 지원되지 않습니다.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles