DokumentationExperience Cloud KCS

Benutzerdefinierte Asset-Auswahl wird in kombinierten Mehrfachfeldern im universellen Editor von AEM nicht unterstützt

Letzte Aktualisierung: 1. August 2026

In diesem Artikel wird die aktuelle Einschränkung erläutert, bei der ein benutzerdefiniertes Asset-Auswahlfeld nicht richtig funktioniert, wenn es in einem zusammengesetzten Container mit mehreren Feldern im universellen Editor von Adobe Experience Manager (AEM) verwendet wird. Verwenden Sie unterstützte Feldtypen oder alternative Komponentendesigns, um dieses Verhalten zu vermeiden.

Beschreibung description

Umgebung

Universeller Editor von Adobe Experience Manager (AEM)/Dokumenterstellung (alle Versionen)

Problem/Symptome

  • Eine benutzerdefinierte Asset-Auswahlkomponente (z. B. custom-asset-namespace:custom-asset) funktioniert nicht wie erwartet, wenn sie in einem zusammengesetzten Container mit mehreren Feldern (einer Container-Komponente mit multi: true) platziert wird.

  • Die benutzerdefinierte Asset-Auswahl funktioniert ordnungsgemäß als eigenständiges Feld, kann jedoch nicht gerendert werden oder nicht richtig funktionieren, wenn sie in einem zusammengesetzten Mehrfachfeld verschachtelt ist.

  • Es werden möglicherweise keine expliziten Fehlermeldungen angezeigt, aber die Asset-Auswahl und die Wertbindung funktionieren im verschachtelten Kontext nicht wie vorgesehen.

    Beispiel für eine Komponentenmodelldefinition:

    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
    }
  ]
}

Lösung resolution

  1. Vergewissern Sie sich, dass nur einfache Feldtypen (wie text, reference, aem-content) offiziell für die Verwendung mit multi: true im universellen Editor unterstützt werden. Siehe Feldtypen im universellen Editor. Hinweis:

    • Container-Komponenten mit valueType: array (zusammengesetzte Mehrfachfelder) werden derzeit nicht in der Eigenschaftenleiste des universellen Editors für alle Feldtypen unterstützt.
    • In der Dokumentation zum Komponentenmodell werden mehrere zusammengesetzte Felder als erweitertes Muster beschrieben. Außerdem ist keine Kompatibilität mit allen benutzerdefinierten oder Erweiterungsfeldtypen gewährleistet.
    • Überwachen Sie die Versionshinweise und die Dokumentation des universellen Editors für die zukünftige Unterstützung erweiterter zusammengesetzter Feldmuster.

  2. Verwenden Sie die konfigurierbare Asset-Auswahl-Erweiterung als einzelnes Feld (ein Asset-Wert pro Feld). Hinweis:

    • Die Erweiterung ist für die Verwendung als einzelnes Feld konzipiert und getestet, nicht für die verschachtelte oder wiederholte Verwendung in zusammengesetzten Mehrfachfeldern.
    • Die Unterstützung für verschachtelte Datenstrukturen wie saleImages/item0/SaleImage ist derzeit nicht implementiert oder dokumentiert.

  3. Platzieren Sie keine benutzerdefinierten Asset-Auswahlfelder in kombinierten Mehrfeld-Containern im universellen Editor, bis die offizielle Unterstützung dokumentiert ist.

  4. Wenn diese Funktion kritisch ist, senden Sie eine Funktionsanfrage über die AEM-Produkt-Feedback-Kanäle.

  5. Zusammengesetzte Mehrfachfelder und benutzerdefinierte Erweiterungen für die Asset-Auswahl werden derzeit im universellen Editor nicht unterstützt, da Einschränkungen bei der Verarbeitung verschachtelter Felder und der Kompatibilität von Erweiterungen bestehen.

Verwandtes Lesen

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