DocumentationExperience Cloud KCS

Sélecteur de ressources personnalisé non pris en charge dans les champs multiples composites dans l’éditeur universel d’AEM

Dernière mise à jour : 1 août 2026

Cet article explique la limitation actuelle dans laquelle un champ de sélecteur de ressources personnalisé ne fonctionne pas correctement lorsqu’il est utilisé dans un conteneur composite à champs multiples dans l’éditeur universel de Adobe Experience Manager (AEM). Utilisez les types de champ pris en charge ou d’autres conceptions de composant pour éviter ce comportement.

Description description

Environnement

Éditeur universel/création de documents Adobe Experience Manager (AEM) (toutes les versions)

Problème/Symptômes

  • Un composant de sélecteur de ressources personnalisé (par exemple, custom-asset-namespace:custom-asset) ne fonctionne pas comme prévu lorsqu’il est placé dans un conteneur multichamp composite (un composant de conteneur avec multi: true).

  • Le sélecteur de ressources personnalisé fonctionne correctement en tant que champ autonome, mais ne parvient pas à s’afficher ou à fonctionner correctement lorsqu’il est imbriqué dans un champ composite multiple.

  • Aucun message d’erreur explicite peut s’afficher, mais la sélection de ressources et la liaison de valeurs ne fonctionnent pas comme prévu dans le contexte imbriqué.

    Exemple de définition de modèle de composant :

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

Résolution resolution

  1. Vérifiez que seuls les types de champ simples (tels que text, reference, aem-content) sont officiellement pris en charge pour une utilisation avec multi: true dans l’éditeur universel. Voir Types de champs de l’éditeur universel. Remarque :

    • Les composants de conteneur avec valueType: array (multi-champs composites) ne sont actuellement pas pris en charge dans le rail des propriétés de l’éditeur universel pour tous les types de champ.
    • La documentation du modèle de composant décrit les champs multiples composites comme un modèle avancé et ne garantit pas la compatibilité avec tous les types de champs personnalisés ou d’extension.
    • Surveillez les notes de mise à jour et la documentation de l’éditeur universel pour la prise en charge future des modèles de champ composites avancés.

  2. Utilisez l’extension configurable du sélecteur de ressources en tant que champ unique (une valeur de ressource par champ). Remarque :

    • L’extension est conçue et testée pour être utilisée en tant que champ unique, et non pour une utilisation imbriquée ou répétée dans des champs multiples composites.
    • La prise en charge des structures de données imbriquées telles que saleImages/item0/SaleImage n’est actuellement ni implémentée ni documentée.

  3. Évitez de placer des champs personnalisés du sélecteur de ressources dans des conteneurs composites à champs multiples dans l’éditeur universel jusqu’à ce que la prise en charge officielle soit documentée.

  4. Si cette fonctionnalité est essentielle, envoyez une demande de fonctionnalité par le biais des canaux de commentaires sur les produits AEM.

  5. Les extensions composites multi-champs et personnalisées du sélecteur de ressources ne sont actuellement pas prises en charge conjointement dans l’éditeur universel en raison des limitations de la gestion des champs imbriqués et de la compatibilité des extensions.

Lecture connexe

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