Importation de données dans un objet personnalisé

Remarque

Vous souhaitez apprendre en français ? Commencez le défi dans un Trailhead Playground en français et utilisez les traductions fournies entre crochets pour naviguer. Copiez et collez uniquement les valeurs en anglais, car les validations de défi reposent sur les données en anglais. Si vous ne réussissez pas le défi dans votre organisation en français, nous vous recommandons (1) de définir le paramètre régional sur les États-Unis, (2) de définir la langue sur l’anglais en suivant les instructions ici, puis (3) de cliquer à nouveau sur le bouton « Vérifier le défi ».

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

Maintenant que vous avez créé votre objet et mappé ses champs, revenez aux feuilles de calcul et terminez cette importation.

Mise à jour du modèle

Accédez à la page de modèles d’importation de données NPSP et téléchargez le modèle Donation Import (Individuals) (Importation de donations [Individus]). Ouvrez-le, accédez à l’onglet Import Wizard Template (Modèle de l’assistant d’importation), puis ajoutez vos nouveaux champs.

1. 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.
   
2. 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.
   
3. Ajoutez une autre colonne après la colonne Donation Record Type Name (Nom du type d’enregistrement du don) et saisissez Donor Survey Status (Statut de l’enquête auprès des donateurs) dans la ligne d’en-tête.
   
4. Supprimez les exemples de données de la première ligne.
   
5. Enregistrez le modèle, mais laissez-le ouvert. Vous l’utilisez lors de la prochaine étape.
   

Conseil

N’oubliez pas que les modèles Data Import (Importation de données) sont uniquement un point de départ. Vous pouvez les utiliser pour créer vos propres modèles adaptés aux données que vous importez le plus souvent.

Création d’enregistrements tests

Maintenant, créez vos enregistrements tests.

1. Dans la première ligne de données du modèle, saisissez les informations suivantes :
   

• Contact1 First Name (Prénom du Contact1) : Silas
  
• Contact1 Last Name (Nom du Contact1) : Stetson
  
• Contact1 Preferred Language (Langue préférée du Contact1) : English (Anglais)
  
• Contact1 Email Opt Out (Désinscription des e-mails du Contact2) : False (Faux)
  
• Contact1 Personal Email (E-mail personnel du Contact1) : silas@mailinator.com
  
• Contact1 Preferred Email (E-mail préféré du Contact1) : Personal (Personnel)
  
• Donation Donor (Donateur) : Contact1
  
• Donation Amount (Montant du don) : 5000
  
• Donation Date (Date du don) : paramétrée sur le dernier jour du mois. Utilisez le format de date de vos paramètres régionaux, tel que JJ/MM/AA. Vous devrez peut-être d’abord modifier la mise en forme du fichier de modèle.
  
• Donation Stage (Étape du don) : Pledged (Promis)
  
• Donor Survey Status (Statut de l’enquête auprès des donateurs) : Completed (Terminé)
  

2. Dans la deuxième ligne de données du modèle, saisissez les informations suivantes :
   

• Contact1 First Name (Prénom du Contact1) : Marie
  
• Contact1 Last Name (Nom du Contact1) : Maldonado
  
• Contact1 Preferred Language (Langue préférée du Contact1) : Spanish (Espagnol)
  
• Contact1 Email Opt Out (Désinscription des e-mails du Contact2) : False (Faux)
  
• Contact1 Personal Email (E-mail personnel du Contact1) : marie@mailinator.com
  
• Contact1 Preferred Email (E-mail préféré du Contact1) : Personal (Personnel)
  
• Donation Donor (Donateur) : Contact1
  
• Donation Amount (Montant du don) : 2500
  
• Donation Date (Date du don) : paramétrée sur le dernier jour du mois. Encore une fois, utilisez le format de date de vos paramètres régionaux.
  
• Donation Stage (Étape du don) : Closed Won (Fermée gagnée)
  
• Donor Survey Status (Statut de l’enquête auprès des donateurs) : Thanked (Remercié)
  

3. Vous pouvez éventuellement supprimer toutes les colonnes inutilisées (si vous le faites, il devrait vous rester les colonnes des lettres A à K).
   
4. Enregistrez le fichier au format .csv sur votre ordinateur.
   

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.

1. Accédez à l’outil App Launcher (Lanceur d’application) (), saisissez NPSP dans la barre de recherche et sélectionnez NPSP Data Imports (Importations de données NPSP).
   
2. Cliquez sur Import (Importer).
   
3. Dans l’onglet Custom objects (Objets personnalisés), cliquez sur NPSP Data Imports (Importations de données NPSP).
   
4. Cliquez sur Add new records (Ajouter de nouveaux enregistrements) sous « What do you want to do? » (« Que voulez-vous faire ? ») et conservez la valeur par défaut de tous les paramètres associés.
   
5. 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 sur Choose file (Choisir un fichier) pour sélectionner le fichier CSV que vous venez d’enregistrer.
   
   
   
   
6. Cliquez sur Next (Suivant).
   
7. Vous êtes maintenant sur la page Edit Field Mapping (Modifier le mappage de champs). Assurez-vous que les en-têtes des colonnes de votre fichier CSV correspondent aux destinations dans l’objet NPSP Data Import (Importation de données NPSP) (si vous avez suivi ces instructions, cela devrait être le cas), puis cliquez sur Next (Suivant).
   
   
   
   
8. Sur la page Review & Start Import (Réviser et démarrer l’importation), vous devriez voir que l’importation comprendra 11 champs mappés et aucun champ non mappé. Cliquez sur Start Import (Démarrer l’importation).
   
   
   
   
9. Cliquez sur OK dans la fenêtre contextuelle affichant « Congratulations! » (« Félicitations ! »).
   

Une page Bulk Data Load Jobs (Tâches de chargement de données en masse) s’affichera à nouveau pour que vous puissiez vérifier les résultats dans la zone Batches (Lots).

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). Consultez le premier enregistrement, qui concerne Silas Stetson, et faites défiler la page vers le bas pour vous assurer que les données relatives à l’enquête auprès des donateurs ont bien été importées.

Il semble que c’est bien le cas ! Vous remarquerez que les champs Donor Survey Import Status (Statut d’importation de l’enquête auprès des donateurs) et Donor Survey Imported (Enquête auprès des donateurs importée) sont maintenant vides, car ils sont automatiquement renseignés lors de l’importation.

Réalisation d’un essai d’importation

Maintenant que les enregistrements se trouvent dans des objets NPSP Data Import (Importation de données NPSP), réalisez une simulation facultative pour détecter d’éventuels problèmes.

1. À 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).
   
2. Pour le moment, ne modifiez pas les paramètres et cliquez sur Begin Dry Run (Commencer l’essai).
   
3. 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).
   
   
   
   
4. 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 qui sont affichés. Ils doivent tous les deux être validés et prêts à être importés.

Importation de vos données

L’heure de l’importation est arrivée !

1. 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).
   
2. 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).
   
   
   
   
3. Attendez la fin de l’importation (cela peut prendre une minute), puis vérifiez le statut. Vous devriez avoir 2 enregistrements traités et 2 enregistrements validés. Cliquez sur Close (Fermer).
   
   
   

Vérification des résultats

De retour sur la page NPSP Data Imports (Importations de données NPSP), sélectionnez la vue de liste Successfully Imported (Importé avec succès) et cliquez sur l’enregistrement de Silas Stetson.

Faites défiler l’enregistrement jusqu’en bas pour voir la mise à jour du statut de l’enregistrement de l’enquête auprès des donateurs. Le champ Donor Survey Import Status (Statut d’importation de l’enquête auprès des donateurs) devrait afficher la valeur Created (Créé) et vous devriez voir un lien au sein du champ Donor Survey Imported (Enquête auprès des donateurs importée).

Cliquez sur le lien dans le champ Donor Survey Imported (Enquête auprès des donateurs importée) pour afficher l’enregistrement relatif à l’enquête auprès des donateurs.

Vous verrez que le numéro de l’enquête auprès des donateurs a été créé automatiquement, que l’enregistrement de contact a été associé par l’outil NPSP Data Importer (Importateur de données NPSP) et que le statut que vous aviez défini a été importé.

À présent, cliquez sur l’enregistrement de contact, puis sur l’onglet Related (Associé). Vous pouvez voir que l’enquête auprès des donateurs a également été automatiquement associée ici.

Lorsque vous terminez une importation comme celle-ci et que vous êtes satisfait des résultats, il est logique que vous souhaitiez supprimer les enregistrements intermédiaires NPSP Data Import (Importation de données NPSP). Pour en savoir plus, suivez le lien traitant de ce sujet qui figure dans la section Ressources ci-dessous. Toutefois, ne faites pas cela dans votre Trailhead Playground tout de suite, car vous devrez vérifier ces enregistrements pour terminer ce défi. 

Il existe une exception notable en ce qui concerne la suppression des enregistrements NPSP Data Import (Importation de données NPSP) : si les enregistrements ont été créés à partir d’un outil tel que Gift Entry (Saisie de dons), il est préférable de les conserver au moins jusqu’à la fin de votre audit annuel pour garder une trace de la manière dont le don a été saisi dans Salesforce.

Les bons outils pour un travail réussi

Dans ce projet, vous avez créé de nouveaux objets et champs personnalisés, créé des champs intermédiaires correspondants sur l’objet NPSP Data Import (Importation de données NPSP), utilisé le mappage avancé pour créer les champs associés, et importé des données. Vous pouvez être fier de vous : c’est un GRAND accomplissement !

L’exemple de No More Homelessness (NMH) était assez simple. Toutefois, sachez que vous utiliserez les mêmes composantes lorsque vous importerez des données dans un champ standard non inclus dans l’outil NPSP Data Importer (Importateur de données NPSP), dans vos propres éléments personnalisés ou dans des éléments que vous avez ajoutés avec une application AppExchange ou un autre package géré.

Surtout, rappelez-vous : vous n’êtes pas seul pour réaliser toutes ces tâches. N’hésitez pas à consulter la documentation détaillée dont les liens figurent dans la section Ressources. D’autre part, vous pouvez toujours vous tourner vers le groupe Data Quality & Management (Qualité et gestion des données) de la Trailblazer Community.

Pour le moment, célébrez cette première réussite qui vous permettra de réaliser de nombreuses autres importations à l’avenir. Si vous avez suivi les instructions de cette étape, sélectionnez votre Trailhead Playground et cliquez sur Verify (Vérifier) pour terminer ce projet et recevoir votre badge.

Conseil

Une fois le présent projet terminé, si vous avez des questions sur l’outil NPSP Data Importer (Importateur de données NPSP), vous pouvez toujours vous tourner vers la communauté pour obtenir de l’aide. Consultez le groupe Data Quality & Management (Qualité et gestion des données) dans la Trailblazer Community pour poser des questions et partager des conseils.

Ressources

• Aide Salesforce : Modèles d’importation de données NPSP
  
• Aide Salesforce : Chargement des données à partir du modèle
  
• Aide Salesforce : Vérification du chargement des données
  
• Aide Salesforce : Réalisation d’un essai pour vérifier votre chargement
  
• Aide Salesforce : Traitement de votre importation 
  
• Aide Salesforce : Suppression des enregistrements importés
  
• Aide Salesforce : Nettoyage et formatage des données
  
• Trailblazer Community : Qualité et gestion des données