Problèmes d'enregistrement et d'activation
Le composant ne s'enregistre pas
Symptôme
Les modifications ne sont pas enregistrées ou une erreur apparaît lors du clic sur le bouton Enregistrer.
Causes et solutions courantes
1. Champs obligatoires manquants
Vérifier : Le nom du composant et les autres propriétés requises doivent être remplis.
Solution:
Assurez-vous que le composant a un nom unique
Vérifiez que toutes les propriétés obligatoires sont configurées
Recherchez des indicateurs d'erreur rouges dans le constructeur
2. Configuration invalide
Vérifier : Les valeurs des propriétés peuvent contenir des erreurs de syntaxe.
Solution:
Consultez le message d'erreur pour le champ spécifique
Vérifiez la syntaxe SOQL dans les configurations de source de données
Vérifiez que les noms d'API des champs sont corrects
Testez les requêtes d'abord dans la Console du développeur
3. Limites de l'API Metadata
Vérifier : Le composant peut être trop volumineux ou trop complexe.
Comprendre les limites de Salesforce:
Les composants dynamiques sont stockés en tant qu'enregistrements de Custom Metadata dans Salesforce avec une structure bien conçue :
Architecture de stockage des composants:
Champ de définition du composant (JSON) : Stocke la structure du composant
Champ de structure de requête : Stocke les configurations des sources de données
Champ de structure de style : Stocke le CSS et les règles de style
Champ de structure d'interaction : Stocke les actions et la logique des événements
Chaque champ est un champ de texte long avec une limite de 131 072 caractères.
Pourquoi les limites de taille sont rarement atteintes:
Avec des champs dédiés pour chaque aspect du composant, il faudrait un composant extrêmement grand et complexe pour dépasser les limites :
Des milliers d'éléments imbriqués
Des centaines de sources de données
Des quantités massives de CSS personnalisé
Des chaînes d'interaction extrêmement complexes
Problèmes plus courants (non liés à la taille):
L'erreur « trop volumineux ou trop complexe » n'est souvent pas réellement liée aux limites de taille, mais plutôt à :
Timeout de l'API Metadata - Salesforce interrompt l'opération d'enregistrement (pas que le composant soit trop volumineux)
Conflits de déploiement simultanés - Une autre opération metadata bloque l'enregistrement
Problèmes de performance de l'organisation - Dégradation générale des performances de Salesforce
Signes d'avertissement réels:
Opérations d'enregistrement prenant régulièrement plus de 30 secondes
Erreurs de timeout lors de l'enregistrement (pas des erreurs « dépasse la taille »)
Échecs intermittents qui réussissent lors d'une nouvelle tentative
Solutions réelles:
Si vous voyez de véritables erreurs de timeout :
Attendez et réessayez (résout souvent automatiquement)
Vérifiez les déploiements simultanés
Essayez pendant les heures creuses
Contactez le support si l'échec est constant
Si le composant est réellement trop complexe :
Vous verrez une erreur spécifique « dépasse la taille maximale »
Ceci est extrêmement rare avec l'architecture actuelle
Scindez en plusieurs composants uniquement si le message d'erreur l'indique spécifiquement
Bonne pratique:
Ne simplifiez pas de manière préventive les composants en raison de préoccupations de taille. L'architecture gère bien la complexité. Simplifiez uniquement si vous rencontrez des erreurs mentionnant spécifiquement la taille ou si les opérations d'enregistrement expirent systématiquement
4. Conflits de déploiement simultanés
Vérifier : Les composants dynamiques sont enregistrés en tant que custom metadata dans Salesforce. Si un autre déploiement ou une autre opération metadata a lieu simultanément, cela peut bloquer l'opération d'enregistrement.
Solution:
Attendez quelques minutes et réessayez d'enregistrer
Vérifiez Configuration > Statut des déploiements pour les déploiements actifs
Évitez d'enregistrer pendant les déploiements ou versions programmés
Coordonnez-vous avec les administrateurs si des conflits fréquents se produisent
Remarque : Les gros composants peuvent mettre 30 à 60 secondes à s'enregistrer - soyez patient et ne cliquez pas plusieurs fois sur Enregistrer
Scénarios courants qui causent des conflits :
Jeux de modifications en cours de déploiement
Installations ou mises à niveau de packages gérés
Autres composants dynamiques enregistrés par différents utilisateurs
Opérations de l'API Metadata en cours (par ex., depuis VS Code, workbench)
Automatisations programmées déployant des metadata
5. Problèmes de navigateur
Vérifier : Le cache du navigateur ou une extension peut interférer.
Solution:
Videz le cache du navigateur
Désactivez les extensions du navigateur
Essayez un navigateur différent
Vérifiez la console du navigateur pour les erreurs JavaScript (F12)
Le composant n'apparaît pas sur la page Lightning
Symptôme
Le composant dynamique est créé mais n'apparaît pas dans la liste des composants du Lightning App Builder.
Causes et solutions courantes
1. Composant non activé
Vérifier : Les composants doivent être activés avant utilisation.
Solution:
Ouvrez le composant dans le constructeur de composants dynamiques
Cliquez sur le bouton « Activer »
Attendez la confirmation d'activation
Actualisez le Lightning App Builder
2. Utilisation d'un mauvais composant de pont
Vérifier : Pour les pages Lightning, utilisez le composant de pont « AX - Dynamic Component ».
Solution:
Dans le Lightning App Builder, trouvez « AX - Dynamic Component »
Faites-le glisser sur la page
Dans le menu déroulant Nom du composant, sélectionnez votre composant dynamique créé
Configurez l'affichage en carte si nécessaire
3. Le nom du composant n'apparaît pas dans le menu déroulant
Vérifier : Le composant peut ne pas être entièrement activé ou enregistré.
Solution:
Vérifiez que le composant apparaît comme « Actif » dans l'application Dynamic Components
Essayez de désactiver puis de réactiver le composant
Actualisez complètement votre navigateur (Ctrl+Maj+R ou Cmd+Maj+R)
Vérifiez que le composant a été enregistré avec succès avant l'activation
Mis à jour
Ce contenu vous a-t-il été utile ?