YouTube ChannelSchedule a CallSubscribe for Updates

Processus de déploiement

Aperçu

Cette page explique comment les composants dynamiques Avonni sont stockés dans Salesforce et comment vous pouvez facilement les déployer entre vos différents environnements Salesforce (par ex., d'un Sandbox vers la Production, ou entre des organisations de développeurs).

L’un des principaux avantages des composants dynamiques Avonni est leur portabilité. Parce qu’ils sont construits et stockés nativement sur la plateforme Salesforce, déplacer vos composants personnalisés entre des organisations est simple à l’aide des outils de déploiement standard de Salesforce.

Comment les composants dynamiques sont stockés

Lorsque vous créez et enregistrez un composant dynamique dans l’Avonni Component Builder, sa définition complète est stockée en tant que enregistrement dans un type de métadonnées personnalisées (CMDT) spécifique fourni par le package géré Avonni.

Où vit le code de votre composant

Considérez cet enregistrement de métadonnées personnalisées comme le code source et la structure de votre composant dynamique — tout, depuis la mise en page et les sources de données jusqu’aux règles de visibilité et aux interactions, est encodé dans ces métadonnées. C’est essentiellement l’endroit où votre composant dynamique « vit ».

Par exemple, si vous créez un composant nommé « Tableau de bord Compte », il sera stocké en tant qu’enregistrement unique au sein du CMDT Avonni Dynamic Component (par ex., avonnidc__Dynamic_Component__mdt).

L’utilisation des CMDT pour le stockage est ce qui rend les composants Avonni hautement portables et compatibles avec l’infrastructure de déploiement native de Salesforce.

Flux de déploiement

Le processus typique de déploiement des composants dynamiques suit les meilleures pratiques standard de Salesforce :

  1. Construire et tester Créez et configurez votre composant dynamique dans une organisation source (telle qu’un Sandbox), puis testez-le minutieusement. N’oubliez pas de Enregistrer et Activer le dans l’Avonni Component Builder.

  2. Identifier les composants Déterminez quels enregistrements CMDT spécifiques (c.-à-d. définitions de composants) doivent être déployés.

  3. Choisir un outil de déploiement Sélectionnez parmi des outils tels que Change Sets, Salesforce DX (SFDX), Ant, ou des solutions tierces comme Gearset ou Copado.

  4. Inclure les enregistrements CMDT Ajoutez les enregistrements CMDT nécessaires à votre package de déploiement. Ces enregistrements seront listés sous le nom du CMDT (généralement quelque chose comme avonnidc__Dynamic_Component__mdt—confirmez ceci dans votre org).

  5. Déployer Déployez les métadonnées en utilisant l’outil choisi.

  6. Vérifier et configurer dans l’organisation cible

    • Confirmez que les enregistrements CMDT ont été correctement déployés.\n- Ouvrez l’ application Avonni Components dans l’organisation cible pour localiser vos composants déployés.\n- Activez-les dans le builder s’ils apparaissent à l’état « Brouillon ».\n- Utilisez le Lightning App Builder pour les placer sur des pages Lightning

Utilisation des outils de déploiement courants

Change Sets

  1. Créer un Change Set sortant.

  2. Sous Type de composant, choisissez Type de métadonnées personnalisées.

  3. Ajoutez les enregistrements CMDT spécifiques pour vos composants dynamiques.

  4. Incluez tous les composants dépendants (par ex., classes Apex, Flows, champs référencés).

  5. Téléversez et déployez le Change Set vers votre organisation cible.

Salesforce DX (SFDX)

  • Assurez-vous que votre fichier package.xml manifeste inclut le type de métadonnées Custom Metadata pour les composants dynamiques Avonni. Il ressemblera à ceci (vérifiez le nom exact Avonni_Dynamic_Component__mdt dans votre org)

<types>
    <members>*</members>
    <name>CustomMetadata</name>
</types>
<types>
    <members>Avonni_Dynamic_Component__mdt.*</members>
    <name>CustomObject</name>
</types>

(Remarque : les enregistrements CMDT sont souvent récupérés/déployés via le type de métadonnées CustomObject dans package.xml) Alternativement, ou pour plus de granularité, vous pouvez référencer les enregistrements spécifiques au sein de l’entrée CustomMetadata si vous ne souhaitez déployer que des composants spécifiques.

  • Utilisez les commandes SFDX (sf project retrieve start / sf project deploy start) pour récupérer les enregistrements CMDT de l’organisation source et les déployer dans l’organisation cible.

Outils tiers

Des outils comme Gearset et Copado prennent entièrement en charge le déploiement des CMDT. Sélectionnez les enregistrements CMDT Avonni appropriés et suivez le flux de déploiement de votre outil.

Considérations importantes

  • Activation dans l’organisation cible : Les composants déployés arrivent souvent à l’état « Brouillon » dans l’organisation cible. Vous devrez probablement les ouvrir dans l’Avonni Component Builder de l’organisation cible et Activer les activer avant de les ajouter aux pages Lightning.

  • Dépendances : Assurez-vous que tous les composants sous-jacents dont dépend votre composant dynamique (objets personnalisés, champs, classes Apex appelées par des interactions, Flows, etc.) sont également inclus dans votre déploiement ou existent déjà dans l’organisation cible.

  • Autorisations et licences : Vérifiez que les utilisateurs et les administrateurs de l’organisation cible disposent des licences Avonni et des jeux d’autorisations nécessaires pour utiliser le builder et visualiser les composants déployés.

  • Mises à jour du package géré : Assurez-vous que les organisations source et cible sont sur la même version (ou une version compatible) du package géré Avonni Dynamic Components avant de déployer les définitions de composants.

En résumé

Les composants dynamiques Avonni sont stockés en tant qu’enregistrements de type de métadonnées personnalisées — essentiellement le « code » et la « structure » de vos composants. Cette conception permet un déploiement facile à l’aide des outils natifs Salesforce et des outils tiers. En traitant vos composants comme des actifs de métadonnées, vous pouvez gérer leur cycle de vie à travers plusieurs environnements avec rapidité et précision.

Conseils de déploiement de la communauté

Vous déployez des composants dynamiques pour la première fois ? Rejoignez notre groupe Community Trailblazer où des administrateurs expérimentés partagent :

  • Scripts d’automatisation de déploiement et modèles package.xml

  • Meilleures pratiques pour les change sets spécifiques aux composants dynamiques

  • Configurations de pipeline CI/CD pour les équipes utilisant Salesforce DX

  • Conseils de dépannage pour les problèmes de déploiement courants (états d’activation, dépendances, incompatibilités de version)

  • Stratégies de déploiement d’entreprise pour gérer les composants à travers plusieurs organisations

De nombreux membres de la communauté ont documenté leurs flux de déploiement et sont heureux d’aider à résoudre des problèmes. Que vous déployiez votre premier composant ou construisiez un pipeline DevOps complet, vous trouverez des informations utiles auprès de personnes qui ont déjà résolu ces défis.

Rejoignez la communauté | Contactez le support : [email protected]

Mis à jour

Ce contenu vous a-t-il été utile ?