Importation de données dans 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.

Maintenant que vous avez créé vos champs de préproduction et cibles et que vous les avez liés ensemble grâce à Advanced Mapping (Mappage avancé), il est temps de formater vos données et de les soumettre à l’outil NPSP Data Import (Importation de données NPSP) en suivant le processus adéquat.

Un schéma de processus illustrant les étapes de formatage des données pour l’importation, d’importation dans les champs intermédiaires, de vérification de votre travail et d’importation dans les champs cibles

Ajout de champs au modèle d’importation

Vous devriez maintenant savoir que 99 % du travail lié à une importation de données se fait hors de Salesforce. Nous allons donc maintenant passer par la case feuilles de calcul.

Le personnel de NMH célèbre sa réussite autour d’un écran affichant une feuille de calcul

D’abord, accédez à la page des modèles d’importation de données NPSP dans la documentation et téléchargez le modèle Accounts and Contact Import (Importation de comptes et contacts). Vous pouvez saisir des données dans deux onglets : Import Wizard Template (Modèle de l’assistant d’importation) utilise des étiquettes de champ pour mettre en correspondance les données, tandis que Data Loader Template (Modèle du chargeur de données) emploie des noms d’API à cette fin.

Pour utiliser l’outil Salesforce Data Loader (Chargeur de données Salesforce) ou dataloader.io, vous devez choisir l’onglet Data Loader Template (Modèle du chargeur de données). Pour ce projet, vous utilisez l’outil Data Import Wizard (Assistant d’importation de données) et l’onglet Import Wizard Template (Modèle de l’assistant d’importation). Ouvrez donc cet onglet et commencez à ajouter de nouvelles colonnes.

Ajoutez une nouvelle colonne après Contact1 Last Name (Nom du Contact1) et saisissez Contact1 Preferred Language (Langue préférée du Contact1) dans la ligne d’en-tête.
Ajoutez une autre colonne après la nouvelle colonne Contact1 Preferred Language (Langue préférée du Contact1) et saisissez Contact1 Email Opt Out (Désinscription des e-mails du Contact1) dans la ligne d’en-tête.
Ajoutez une nouvelle colonne après Contact2 Last Name (Nom du Contact2) et saisissez Contact1 Preferred Language (Langue préférée du Contact1) dans la ligne d’en-tête.
Ajoutez une autre colonne après la colonne Contact2 Preferred Language (Langue préférée du Contact2) et saisissez Contact2 Email Opt Out (Désinscription des e-mails du Contact2) dans la ligne d’en-tête.
Supprimez les exemples de données de la première ligne.
Enregistrez le modèle, mais laissez-le ouvert. Vous l’utilisez lors de la prochaine étape.

Création d’enregistrements tests

Il est maintenant temps de saisir des données de test pour voir comment fonctionne l’importation avec vos nouveaux champs et mappages. Créez une copie de la feuille de calcul que vous venez de modifier (en conservant une version avec tous les champs que vous utiliserez dans une étape ultérieure) et saisissez deux lignes de données :

Tout d’abord, saisissez les détails suivants sur une ligne :

Contact1 FirstName (Prénom du Contact1) : Elisa
Contact1 LastName (Nom du Contact1) : Harmon
Contact1 Preferred Language (Langue préférée du Contact1) : English (Anglais)
Contact1 Email Opt Out (Désinscription des e-mails du Contact1) : True (Vrai) (rappelez-vous que dans une liste de sélection qui est représentée par une case à cocher, la valeur True (Vrai) signifie « Coché »).
Contact1 Personal Email (E-mail personnel du Contact1) : elisa@mailinator.com
Contact1 Preferred Email (E-mail préféré du Contact1) : Personal (Personnel)
Contact2 FirstName (Prénom du Contact2) : Bryan
Contact2 LastName (Nom du Contact2) : Harmon
Contact2 Preferred Language (Langue préférée du Contact2) : English (Anglais)
Contact2 Email Opt Out (Désinscription des e-mails du Contact2) : False (Faux)
Contact2 Personal Email (E-mail personnel du Contact1) : bryan@mailinator.com
Contact2 Preferred Email (E-mail préféré du Contact2) : Personal (Personnel)

Ensuite, saisissez les détails suivants sur une autre ligne :

Contact1 FirstName (Prénom du Contact1) : Bill
Contact1 LastName (Nom du Contact1) : Rodriguez
Contact1 Preferred Language (Langue préférée du Contact1) : Tagalog
Contact1 Email Opt (Inscription aux e-mails du Contact1) : False (Faux) (dans une liste de sélection qui est représentée par une case à cocher, la valeur False (Faux) signifie « Non coché »).
Contact1 Personal Email (E-mail personnel du Contact1) : bill@mailinator.com
Contact1 Preferred Email (E-mail préféré du Contact1) : Personal (Personnel)

Vous pouvez, si vous le souhaitez, supprimer toutes les colonnes ne comprenant pas de données pour éviter d’atteindre les limites de données (après cette suppression, il devrait vous rester uniquement les colonnes A à L). Pour ce faire, assurez-vous de travailler à partir d’une copie de votre modèle, car plus tard dans ce projet, vous aurez besoin du modèle complet qui inclut de nouveaux champs ainsi que des champs supplémentaires que vous n’utilisez pas ici. Lisez la remarque ci-dessous pour obtenir des conseils sur la création de vos propres modèles.
Enregistrez une copie du fichier au format .csv au sein d’un emplacement facile d’accès, comme votre ordinateur.

Conseil

Le modèle NPSP Data Import (Importation de données NPSP) constitue une bonne base de travail, mais il est recommandé de modifier et d’enregistrer différentes versions de celui-ci afin de créer vos propres modèles personnalisés. De cette façon, vous pouvez gagner du temps et vous concentrer uniquement sur les champs dont vous avez besoin pour les données que vous importez le plus souvent.

Chargement de votre fichier CSV dans des objets NPSP Data Import (Importation de données NPSP)

Il est temps de tester votre travail en l’important dans des objets NPSP Data Import (Importation de données NPSP.

Accédez à l’outil App Launcher (Lanceur d’application) () pour rechercher et sélectionner NPSP Data Imports (Importations de données NPSP).
Cliquez sur Import (Importer).
Vous êtes maintenant dans l’outil Data Import Wizard (Assistant d’importation de données). Dans l’onglet Custom objects (Objets personnalisés), cliquez sur NPSP Data Imports (Importations de données NPSP).
Vous verrez trois options dans le panneau « What do you want to do? » (« Que voulez-vous faire ? »). Dans le cadre des NPSP Data Imports (Importations de données NPSP), vous devez toujours cliquer sur Add new records (Ajouter de nouveaux enregistrements), car vous créez des enregistrements de préproduction d’importation de données NPSP.
Conservez les paramètres par défaut figurant en dessous de l’option Add new records (Ajouter de nouveaux enregistrements).
Dans le panneau « Where is your data located? » (Quel est l’emplacement de vos données ?), faites glisser votre fichier CSV à l’endroit où il est écrit « Drag CSV file here to upload » (Déposez ici le fichier CSV à télécharger) ou cliquez sur CSV, puis Choose file (Choisir un fichier) pour sélectionner le fichier CSV que vous avez enregistré précédemment.
Cliquez sur Next (Suivant) dans le coin inférieur droit.
Vous êtes maintenant sur la page Edit Field Mapping (Modifier le mappage de champs). Cette étape importante vise à s’assurer que les en-têtes des fichiers CSV correspondent aux champs de préproduction NPSP Data Import (Importation de données NPSP). Étant donné que vous avez utilisé le même texte dans le fichier CSV et dans l’objet de préproduction Data Import (Importation de données), ceux-ci doivent tous correspondre. Vérifiez une nouvelle fois les en-têtes, puis cliquez sur Next (Suivant).
Sur la page Review & Start Import (Réviser et démarrer l’importation), vous devriez voir que l’importation comprendra 12 champs mappés et aucun champ non mappé. Cliquez sur Start Import (Démarrer l’importation).
Cliquez sur OK dans la fenêtre contextuelle affichant « Congratulations, your import has started! » (Félicitations, votre importation a commencé !).

Vous verrez ensuite l’écran Bulk Data Load Jobs (Tâches de chargement de données en masse) comprenant des détails sur l’importation. Si vous souhaitez vérifier les résultats, vous pouvez cliquer sur View Result (Afficher le résultat) dans la section Batches (Lots) pour télécharger un fichier CSV d’enregistrements.

Vous devriez également vérifier les enregistrements NPSP Data Import (Importation de données NPSP). Utilisez l’outil App Launcher (Lanceur d’application) () pour revenir à la page NPSP Data Imports (Importations de données NPSP), puis sélectionnez la vue de liste To Be Imported (À importer). Vérifiez le premier enregistrement, qui concerne Elisa Harmon, afin de vous assurer que tous les champs apparaissent comme prévu.

Réalisation d’un essai d’importation

Maintenant que les enregistrements se trouvent dans l’objet NPSP Data Import (Importation de données NPSP), procédez à leur validation en réalisant une simulation d’importation afin de détecter d’éventuels problèmes (cet essai est facultatif, mais il est important de vérifier les enregistrements pour vous assurer que tout va bien avant de passer à l’importation réelle).

À partir de la vue de liste To Be Imported (À importer) sur la page NPSP Data Imports (Importations de données NPSP), cliquez sur Import All Data Import Records Importer tous les enregistrements d’importation de données).
Ne modifiez aucun paramètre et cliquez sur Begin Dry Run (Commencer l’essai).
Attendez la fin de l’essai, puis vérifiez le statut. Vous devriez avoir 2 enregistrements traités et 2 enregistrements validés. Cliquez sur Close (Fermer).
De retour sur la page NPSP Data Imports (Importations de données NPSP), passez à la vue de liste Dry Run - Validated (Essai - Validé).

Vérifiez les enregistrements. Ils doivent tous les deux être validés et prêts à être importés.

Importation de vos données

Maintenant que vous avez terminé la configuration et exécuté un test, vous êtes prêt à envoyer vos données à leurs champs et objets cibles.

Dans la vue de liste Dry Run - Validated (Essai - Validé) sur la page NPSP Data Import (Importation de données NPSP), cliquez sur Import All Data Import Records (Importer tous les enregistrements d’importation de données).
Sur la page suivante, laissez les options de configuration telles quelles et cliquez sur Begin Data Import Process (Début du processus d’importation de données).
Attendez la fin de l’importation, puis vérifiez le statut. Vous devriez avoir 2 enregistrements traités et 2 enregistrements importés. Cliquez sur Close (Fermer).

Cherchez à présent les enregistrements que vous venez d’importer. Accédez à la zone Global Search (Recherche globale), puis recherchez et sélectionnez l’enregistrement de contact concernant Elisa Harmon.

La zone Contact Details (Détails du contact) figurant sur l’enregistrement de contact d’Elisa Harmon

Dans la section Contact Details (Détails du contact), vous pouvez voir que sa langue préférée est définie sur English (Anglais), et dans la section Contact Information (Informations de contact), vous pouvez constater que la case Email Opt-out (Désinscription des e-mails) est cochée.

La zone Contact Information (Informations de contact) figurant sur l’enregistrement de contact d’Elisa Harmon

L’outil NPSP Data Importer (Importateur de données NPSP) a également créé un nouveau compte de foyer pour elle. Cliquez sur Harmon Household (Foyer Harmon) sous Account Name (Nom du compte) et observez les contacts associés.

Section Contacts (Contacts) du compte Harmon Household (Foyer Harmon)

Vous pouvez voir qu’un enregistrement a également été créé pour Bryan, qui vit dans le foyer d’Elisa. Si vous cliquez sur son enregistrement, vous pouvez voir que sa langue préférée et sa préférence relative à la désinscription des e-mails ont également été importées.

Intéressez-vous maintenant à l’autre contact que vous avez importé, en recherchant et en sélectionnant Bill Rodriguez dans la recherche globale.

La section Contact Details (Détails du contact) de l’enregistrement de Bill Rodriguez

En regardant l’enregistrement de Bill, vous pouvez voir que sa langue et sa préférence relative à la désinscription des e-mails ont également été importées.

Ça marche ! Cette étape est importante, car elle aide No More Homelessness (NMH) à atteindre certains de ses objectifs. Toutefois, qu’en est-il de l’un de ses autres impératifs ? Est-il possible pour Gorav et l’équipe de NMH de configurer un objet personnalisé et d’y importer des données avec l’importateur de données NPSP ?

Bonne nouvelle : ils peuvent le faire, et vous aussi par la même occasion ! C’est précisément ce à quoi vous allez vous intéresser à l’étape suivante.

Toutefois, avant de poursuivre, assurez-vous de sélectionner le Trailhead Playground que vous avez utilisé pour suivre ces étapes et cliquez sur Verify (Vérifier) pour collecter vos points.