Mappage de champs standard et personnalisés sur un objet standard

Remarque

Vous souhaitez apprendre en français ? Dans ce badge, les validations de défi pratique Trailhead se font en anglais. Les traductions sont fournies entre parenthèses à titre de référence. Dans votre Trailhead Playground, veillez (1) à définir les États-Unis comme région, (2) à sélectionner l’anglais comme langue, et (3) à copier et coller uniquement les valeurs en anglais. Suivez les instructions ici.

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

Préparation à l’importation de champs standard et personnalisés

Commencez par les champs que No More Homelessness (NMH) souhaite importer dans les enregistrements de contact : Email Opt-out (Désinscription des e-mails) et Preferred Language (Langue préférée).

Le champ Email Opt-out (Désinscription des e-mails) est un champ Salesforce standard, mais il n’est pas inclus par défaut dans l’objet NPSP Data Import (Importation de données NPSP). Le champ Langue préférée (Preferred language) n’est pas un champ Salesforce ou NPSP standard. Vous devrez donc ajouter ce champ personnalisé à l’objet Contact et le mapper à l’objet NPSP Data Import (Importation de données NPSP) dans votre Trailhead Playground.

Souvenez-vous du processus : vous devez créer les champs personnalisés, créer le champ intermédiaire correspondant sur l’objet NPSP Data Import (Importation de données NPSP), puis connecter l’ensemble. C’est ce que vous faites dans cette étape.

Un diagramme de processus avec les étapes de création des champs cibles, de création des champs intermédiaires et de connexion des champs intermédiaires et cibles mises en évidence

Création du champ personnalisé sur l’objet Contact

Tout d’abord, créez le champ personnalisé Preferred language (Langue préférée). Cependant, avant de créer ce champ en lui-même, créez un ensemble de valeurs de liste de sélection globale. Vous employez les mêmes valeurs de liste de sélection pour trois champs personnalisés. Par conséquent, la création d’un ensemble de valeurs de liste de sélection globale vous fera gagner du temps et garantira que les champs sont mis à jour uniformément si vous devez ajouter des valeurs à l’avenir.

Cliquez sur l’icône de configuration en forme d’engrenage () et sélectionnez Setup (Configuration).
Saisissez Picklist (Liste de sélection) dans la zone Quick Find (Recherche rapide), puis sélectionnez Picklist Value Sets (Ensembles de valeurs de liste de sélection).
À côté de l’en-tête Global Value Sets (Ensembles de valeurs globales), cliquez sur New (Nouveau).
Dans le champ Label (Étiquette), saisissez Preferred Language (Langue préférée).
Dans le champ Nom, saisissez Preferred_Language (Langue_préférée). (ce champ devrait être renseigné automatiquement).
Saisissez les valeurs suivantes, une par ligne :
```
English
Spanish
Tagalog
Vietnamese
```
Cliquez sur Save (Enregistrer).

Maintenant que cet ensemble de valeurs de liste de sélection est créé, créez le champ.

Cliquez sur Object Manager (Gestionnaire d’objet) dans la barre de navigation Settings (Paramètres).
Recherchez et sélectionnez Contact.
Cliquez sur Fields & Relationships (Champs et relations) dans le panneau de gauche.
Cliquez sur New (Nouveau).
Sélectionnez Picklist (Liste de sélection), puis cliquez sur Next (Suivant).
Saisissez les valeurs suivantes :

Dans Field Label (Étiquette du champ), saisissez Preferred Language (Langue préférée).
Dans Values (Valeurs), laissez l’option Use global picklist value set (Utiliser un ensemble de valeurs de liste de sélection globale) sélectionnée, puis choisissez l’option Preferred Language (Langue préférée) dans la liste de sélection.
Preferred_Language (Langue_préférée) devrait être renseigné automatiquement dans Field Name (Nom du champ).

Conservez les autres valeurs par défaut, puis cliquez sur Next (Suivant).
Sur l’écran suivant, cliquez sur Next (Suivant), puis sur Save (Enregistrer).

Si vous souhaitez obtenir davantage d’informations et d’instructions sur la création de champs personnalisés, consultez le module Champs personnalisés : Aperçu sur Trailhead.

Pour vérifier que l’enregistrement de contact a été correctement mis à jour, cliquez sur le bouton de l’outil App Launcher (Lanceur d’application) ( Icône de l’outil App Launcher (Lanceur d’application) ), recherchez et sélectionnez Contacts (Contacts), et sélectionnez un contact pour afficher le champ. Il devrait apparaître dans l’onglet Details (Détails) de la section Contact Details (Détails du contact).

Le champ Preferred Language (Langue préférée) au sein d’un enregistrement de contact

Sur l’enregistrement de contact, vous pouvez également voir le champ standard Email Opt-out (Désinscription des e-mails) dans la section Contact Information (Informations de contact).

Création de champs correspondants au sein de l’objet NPSP Data Import (Importation de données NPSP)

Maintenant que les champs Preferred Language (Langue préférée) et E-mail Opt-out (Désinscription des e-mails) existent au sein de l’objet Contact, vous devez créer des champs correspondants (vos champs intermédiaires) au sein de l’objet NPSP Data Import (Importation de données NPSP). Vous devrez créer ces champs pour les enregistrements Contact 1 et Contact 2 de l’objet NPSP Data Import (Importation de données NPSP) si vous souhaitez importer ces champs pour les deux membres d’un foyer.

Tout d’abord, créez le champ NPSP Data Import (Importation de données NPSP) pour Preferred Language (Langue préférée).

Accédez à Setup (Configuration).
Cliquez sur Object Manager (Gestionnaire d’objet).
Recherchez et sélectionnez NPSP Data Import (Importation de données NPSP).
Cliquez sur Fields & Relationships (Champs et relations).
Cliquez sur New (Nouveau).
Sélectionnez Picklist (Liste de sélection), puis cliquez sur Next (Suivant). Le champ NPSP Data Import (Importation de données NPSP) doit être du même type que le champ cible, même si vous contournez cette règle dans un instant.
Saisissez les valeurs suivantes :

Dans Field Label (Étiquette du champ), saisissez Contact1 Preferred Language (Langue préférée du Contact1).
Dans Values (Valeurs), laissez l’option Use global picklist value set (Utiliser un ensemble de valeurs de liste de sélection globale) sélectionnée, puis choisissez l’option Preferred Language (Langue préférée) dans la liste de sélection.
Contact1_Preferred_Language (Désinscription_e-mails_Contact1) devrait être automatiquement renseigné dans Field Name (Nom du champ).

Conservez les autres valeurs par défaut, puis cliquez sur Next (Suivant).
Sur l’écran suivant, cliquez sur Next (Suivant), puis sur Save & New (Enregistrer et nouveau).
Répétez l’opération pour créer le même champ pour Contact2 Preferred Language (Langue préférée du Contact2), puis cliquez sur Save (Enregistrer) à la fin du processus avant de continuer.

Créez maintenant le champ de l’objet NPSP Data Import (Importation de données NPSP) pour Email Opt-out (Désinscription des e-mails). Voici l’exception à la règle que vous venez d’apprendre : si votre champ cible est une case à cocher, vous devez sélectionner une liste de sélection comportant les valeurs True (Vrai) et False (Faux) pour gagner en flexibilité. Dans vos données d’importation, True (Vrai) signifierait « sélectionné », False (Faux) signifierait « déselectionné », et la présence d’une valeur vide laisserait la case inchangée lors de la mise à jour d’enregistrements.

Dans l’enregistrement NPSP Data Import (Importation de données NPSP) au sein de l’outil Object Manager (Gestionnaire d’objet), cliquez sur Fields & Relationship (Champs et relations).
Cliquez sur New (Nouveau).
Sélectionnez Picklist (Liste de sélection), puis cliquez sur Next (Suivant).
Saisissez les valeurs suivantes :

Dans Field Label (Étiquette du champ), saisissez Contact1 Email Opt Out (Désinscription des e-mails du Contact1).
Dans Values (Valeurs), sélectionnez Enter values, with each value separated by a new line (Saisissez des valeurs, chacune séparée par une nouvelle ligne). Dans la zone de saisie, saisissez les valeurs suivantes :
```
True
False
```
Contact1_Email_Opt_Out (Désinscription_e-mails_Contact1) devrait être automatiquement renseigné dans Field Name (Nom du champ).

Cliquez sur Next (Suivant).
Sur l’écran suivant, cliquez sur Next (Suivant), puis sur Save & New (Enregistrer et nouveau).
Répétez les mêmes étapes pour créer un champ pour Contact2 Email Opt Out (Désinscription des e-mails du Contact2), puis cliquez sur Save (Enregistrer) à la fin du processus.

Conseil

Lorsque vous créez vos propres champs sur l’objet NPSP Data Import (Importation de données NPSP) dans l’organisation Salesforce de votre organisation sans but lucratif, nommez-les de la manière qui convient à votre organisation, sauf s’il s’agit d’un champ Unique ID (ID unique). Nous vous suggérons de choisir une étiquette qui indique clairement à quel enregistrement ce champ correspond.

Vous avez créé tous les champs de préproduction dont vous avez besoin au sein de l’objet NPSP Data Import (Importation de données NPSP). Maintenant, placez-les sur les présentations de page.

Dans l’enregistrement NPSP Data Import (Importation de données NPSP) au sein de l’outil Object Manager (Gestionnaire d’objet), cliquez sur Page Layouts (Présentations de page).
Cliquez sur Data Import Layout (Présentation Importation de données).
Faites défiler la page jusqu’à la zone Information (Informations). Vous pouvez constater que les nouveaux champs y ont été ajoutés par défaut.
Cliquez sur le champ Contact1 Preferred Language (Langue préférée du Contact1) et faites-le glisser sous Contact1 Title (Titre du Contact1) dans la zone Contact1 Information (Informations sur le Contact1).
Cliquez sur le champ Contact1 Email Opt Out (Désinscription des e-mails du Contact1) et faites-le glisser au-dessus de Contact1 Email Opt Out (E-mail personnel du Contact1) dans la zone Contact1 Information (Informations sur le Contact1).
Déplacez les champs Contact2 Preferred Language (Langue préférée du Contact2) et Contact2 Email Opt Out (Désinscription des e-mails du Contact2) dans les emplacements correspondants de la zone Contact2 Information (Informations sur le Contact2).
Cliquez sur Save (Enregistrer).

Vous êtes maintenant prêt à mapper les champs de préproduction de l’objet NPSP Data Import (Importation de données NPSP) avec les champs cibles de l’objet Contact.

Activation de la fonctionnalité Advanced Mapping (Mappage avancé)

Commencez par vous assurer que la fonctionnalité Advanced Mapping (Mappage avancé) est activée.

Cliquez sur l’outil App Launcher (Lanceur d’application) (), puis recherchez et sélectionnez NPSP Settings (Paramètres NPSP) (le chargement peut prendre un certain temps).
Cliquez sur System Tools (Outils système), puis sur Advanced Mapping for Data Import & Gift Entry (Mappage avancé pour Importation de données et Saisie de dons).
Faites basculer Advanced Mapping (Mappage avancé) sur Enabled (Activé).

La page se chargera et le message suivant s’affichera : « Deployment in progress. You can leave this page. The page will reload when deployment is finished. » (« Déploiement en cours. Vous pouvez quitter cette page. La page se rechargera une fois le déploiement terminé »). Ce processus peut prendre une minute ou deux, alors profitez-en pour prendre quelques profondes respirations.

Si Advanced Mapping (Mappage avancé) est déjà activé dans votre propre organisation Salesforce, ne le désactivez pas. Laissez le paramètre tel quel. Le fait de le désactiver puis de le réactiver dupliquera les métadonnées de mappage de champ, et il est difficile de revenir en arrière.

Une fois la page rechargée, cliquez sur Configure Advanced Mapping (Configurer le mappage avancé).

Mappage des nouveaux champs

Après avoir cliqué sur Configure Advanced Mapping (Configurer le mappage avancé), vous verrez une liste de groupes d’objets, qui sont des collections de mappages de champs qui indiquent à l’outil NPSP Data Importer (Importateur de données NPSP) quels objets (contacts, comptes, etc.) doivent être créés ou mis à jour. Il existe déjà des groupes d’objets pour Contact1 et Contact2.

Tout d’abord, ajoutez le mappage de champs correspondant au champ Preferred Language (Langue préférée).

Recherchez la ligne Contact 1 et cliquez sur le bouton de menu (), puis sur View Field Mappings (Afficher les mappages de champs).
Vous êtes maintenant sur la page Field Mappings (Mappages de champs) de Contact 1 Group (Groupe Contact 1). Cliquez sur Create New Field Mapping (Créer un mappage de champs personnalisé).
Dans la zone de recherche Field Label (Étiquette du champ) de la section Source (NPSP Data Import Object) (Source [Objet Importation de données NPSP]), recherchez et sélectionnez Contact1 Preferred Language (Contact1_Preferred_Language__c) (Langue préférée du Contact1 [Langue_préférée_Contact1__c]).
Dans la zone de recherche Field Label (Étiquette du champ) de la section Target (Contact 1 Object) (Cible [Objet Contact 1]), recherchez et sélectionnez Preferred Language (Preferred_Language__c) (Langue préférée [Langue_préférée__c]).
Cliquez sur Save (Enregistrer), puis actualisez la page.

Une fois la page rechargée, vous êtes de nouveau sur la liste Object Groups (Groupes d’objets). Ensuite, créez un mappage de champs pour le champ E-mail Opt-out (Désinscription des e-mails) pour Contact 1.

Recherchez la ligne Contact 1 et cliquez sur View Field Mappings (Afficher les mappages de champs) sous le bouton de menu ().
Sur la page Contact 1 Group Field Mappings (Mappages de champs du groupe Contact 1), cliquez sur Create New Field Mapping (Créer un mappage de champs personnalisé).
Dans la zone de recherche Field Label (Étiquette du champ) de la section Source (NPSP Data Import Object) (Source [Objet Importation de données NPSP]), recherchez et sélectionnez Contact1 Email Opt Out (Contact1_Email_Opt_Out__c) (Désinscription des e-mails du Contact1 [Désinscription_e-mails_Contact1]).
Dans la zone de recherche Field Label (Étiquette du champ) de la section Target (Contact 1 Object) (Cible [Objet Contact 1]), recherchez et sélectionnez Email Opt Out (HasOptedOutOfEmail) (Désinscription des e-mails [DésinscritionDesE-mails]).
Cliquez sur Save (Enregistrer).

Vous devriez recevoir un message indiquant que la mise à jour a réussi. Vos champs pour Contact 1 sont maintenant mappés.

Cliquez maintenant sur Back to Object Group (Revenir au groupe d’objets) en haut à gauche pour accéder à la liste Object Groups (Groupes d’objets). Recherchez la ligne Contact 2, cliquez sur le bouton de menu (), puis sur View Field Mappings (Afficher les mappages de champs). Répétez les étapes ci-dessus pour mapper Contact2 Email Opt Out (Contact2_Email_Opt_Out__c) (Désinscription des e-mails du Contact2 [Désinscription_e-mails_Contact2__c]) et Contact2 Preferred Language (Contact2_Preferred_Language__c) (Langue préférée du Contact2 [Langue_préférée_Contact2__c]) avec le champ cible correspondant de l’enregistrement de contact.

Prochaine étape : la préparation des données

Maintenant que les champs cibles et de préproduction sont configurés et que les mappages sont créés, vous disposez dans Salesforce de tout ce dont vous avez besoin pour commencer à importer vos données.

Dans l’étape suivante, vous modifiez le modèle d’importation et réalisez un test d’importation pour vérifier que ce que vous avez fait fonctionne.

Avant de poursuivre, si vous avez suivi les étapes ci-dessus, sélectionnez le Trailhead Playground que vous avez utilisé pour ce projet et cliquez sur Verify (Vérifier).