Mappage d’un objet personnalisé

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.

Capture de données dans des objets personnalisés

Il est temps de relever le deuxième défi de No More Homelessness (NMH) : l’organisation veut être en mesure de procéder au recensement des informations recueillies via les enquêtes réalisées auprès des donateurs, de déterminer si un donateur a répondu à une enquête dans son intégralité et, le cas échéant, de savoir si celui-ci a bien été remercié pour ses réponses. La solution de NMH consiste à créer un objet personnalisé et à y importer les informations qui avaient été consignées au préalable dans des feuilles de calcul.

Au cours de cette étape, vous suivez Gorav, l’administrateur intrépide de NMH, dans la création d’un objet personnalisé et des champs associés, la modification de l’objet intermédiaire NPSP Data Import (Importation de données NPSP) et le mappage des champs en vue de leur traitement par l’importateur. Certaines des étapes qui vont suivre vous sembleront familières, car elles sont identiques à celles que vous avez suivies précédemment pour les champs d’un objet standard. Toutefois, vous allez maintenant les appliquer aux champs d’un objet personnalisé.

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

L’objet personnalisé que vous créez ici représente un exemple et non une solution complète. NMH devra ajouter des champs et des fonctionnalités supplémentaires pour répondre à ses besoins. Pensez à visiter Salesforce AppExchange (le lien y menant figure dans la section Ressources) pour y rechercher s’il existe une solution prête à l’emploi correspondant aux défis concrets que vous devez relever.

Création de l’objet et des champs personnalisés

Commencez par créer l’objet personnalisé.

Accédez à Setup (Configuration).
Cliquez sur Object Manager (Gestionnaire d’objet).
Cliquez sur Create (Créer), puis sur Custom Object (Objet personnalisé).
Saisissez les informations suivantes :
- Label (Étiquette) : Donor Survey (Enquête auprès des donateurs)
- Plural Label (Étiquette au pluriel) : Donor Surveys (Enquêtes auprès des donateurs)
- Object Name (Nom de l’objet) : Donor_Survey (Enquête_Donateurs) (ce champ devrait être renseigné automatiquement)
- Description : For tracking donor surveys and acknowledgements. (Permet d’assurer un suivi des enquêtes auprès des donateurs et des remerciements qui leur sont adressés.)
- Renseignez la section Enter Record Name Label and Format (Saisir l’étiquette et le format du nom de l’enregistrement) comme ceci :
  - Saisissez Survey Number (Numéro de l’enquête) dans Record Name (Nom de l’enregistrement).
  - Pour Data Type (Type de données), sélectionnez Auto Number (Numéro automatique).
  - Dans Display Format (Format d’affichage), saisissez DS-{0000}.
  - Dans Starting Number (Numéro de début), saisissez 0001.
- Sélectionnez Allow Reports (Autoriser les rapports).
- Sélectionnez Allow Activities (Autoriser les activités).
- Dans la section Object Creation Options (Options de création d’objet), cochez la case Launch New Custom Tab Wizard after saving this custom object (Lancer l’assistant Nouvel onglet personnalisé après l’enregistrement de cet objet personnalisé).
Cliquez sur Save (Enregistrer).
Cliquez sur Tab Style (Style d’onglet) et sélectionnez une icône. Vous avez choisi Form (Formulaire), mais vous pouvez faire preuve de créativité.
Cliquez sur Next (Suivant), puis à nouveau sur Next (Suivant) et enfin sur Save (Enregistrer).

Si vous souhaitez en savoir plus sur la création d’objets personnalisés, consultez le module Trailhead Objets personnalisés : Aperçu, dont le lien figure dans la section Ressources.

L’objet Donor Survey (Enquête auprès des donateurs) est maintenant créé. Ensuite, ajoutez deux champs à cet objet. Le premier est une liste de sélection pour laquelle vous souhaitez créer un ensemble de valeurs de liste de sélection.

Cliquez sur Home (Accueil) dans 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 Global Value Sets (Ensembles de valeurs globales), cliquez sur New (Nouveau).
Dans Label (Étiquette), saisissez Survey Status (Statut de l’enquête).
Dans Name (Nom), saisissez Survey_Status (Statut_Enquête) (ce champ devrait être renseigné automatiquement).
Saisissez les valeurs suivantes, une par ligne :
```
Sent
Completed
Thanked
```
Cliquez sur Save (Enregistrer).

Vous êtes désormais prêt à ajouter les champs.

Cliquez sur Object Manager (Gestionnaire d’objet) dans Setup (Configuration).
Trouvez et sélectionnez l’objet Donor Survey (Enquête auprès des donateurs).
Cliquez sur Fields & Relationships (Champs et relations).
Cliquez sur New (Nouveau).
Choisissez Lookup Relationship (Relation de référence), puis cliquez sur Next (Suivant).
Sélectionnez Contact (Contact) dans la liste de sélection Related To (Associé à), puis cliquez sur Next (Suivant).
Dans Field Label (Étiquette du champ), conservez la saisie Contact et faites de même pour Contact dans Field Name (Nom du champ), puis cliquez sur Next (Suivant).
Cliquez sur Next (Suivant) à deux reprises, puis sur Save & New (Enregistrer et nouveau) pour créer le champ suivant.
Sélectionnez Picklist (Liste de sélection), puis cliquez sur Next (Suivant).
Saisissez les informations suivantes :

Field Label (Étiquette du champ) : Status
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 Survey Status (Statut de l’enquête) dans la liste de sélection.
Field Name (Nom du champ) : Status (Statut) (ce champ devrait être renseigné automatiquement).

Cliquez sur Next (Suivant), puis à nouveau sur Next (Suivant) et enfin sur Save (Enregistrer).

NMH aurait besoin d’ajouter d’autres champs pour que cet objet soit utile, mais arrêtons-nous ici pour nous concentrer sur le mappage.

Consultez le nouvel objet en cliquant sur App Launcher (Lanceur d’application) ( Icône de l’outil App Launcher (Lanceur d’application) ), puis recherchez et sélectionnez Donor Surveys (Enquêtes auprès des donateurs). Étant donné qu’aucune enquête n’existe encore, cliquez sur New (Nouveau) pour vérifier que tous vos nouveaux champs s’affichent comme prévu.

Une nouvelle enquête auprès des donateurs

Création de champs intermédiaires

Vous devez maintenant modifier l’objet NPSP Data Import (Importation de données NPSP) afin d’y ajouter l’un des nouveaux champs que vous venez de créer. Pourquoi n’ajouter qu’un seul champ ? Parce que votre nouvel objet Donor Survey (Enquête auprès des donateurs) utilise, pour se connecter aux enregistrements de contact, des champs de référence, et que ces derniers figurent déjà dans l’objet NPSP Data Import (Importation de données NPSP). Vous procéderez à leur mappage ultérieurement.

Créez le champ de préproduction dont vous avez besoin pour le statut.

Accédez à Setup (Configuration), puis cliquez sur Object Manager (Gestionnaire d’objet).
Trouvez et sélectionnez l’objet 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).
Saisissez les informations suivantes :

Field Label (Étiquette du champ) : Donor Survey Status (Statut de l’enquête auprès des donateurs)
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 Survey Status (Statut de l’enquête) dans la liste de sélection.
Field Name (Nom du champ) : Donor_Survey_Status (Statut_Enquête_Donateurs) (ce champ devrait être renseigné automatiquement).

Cliquez sur Next (Suivant), puis à nouveau sur Next (Suivant) et enfin sur Save (Enregistrer).

Vous souhaitez également créer deux champs système pour recueillir des informations sur les enregistrements cibles traités par l’outil NPSP Data Importer (Importateur de données NPSP) : un champ de statut qui indique si l’essai d’importation ou l’importation à proprement parler a réussi et un champ de référence qui vous permet d’accéder à l’enregistrement importé final.

À partir de l’onglet Fields & Relationships (Champs et relations) de l’enregistrement NPSP Data Import (Importation de données NPSP) dans l’outil Object Manager (Gestionnaire d’objet), cliquez sur New (Nouveau).
Sélectionnez Text (Texte), puis cliquez sur Next (Suivant).
Saisissez les valeurs suivantes :

Field Label (Étiquette du champ) : Donor Survey Import Status (Statut d’importation de l’enquête auprès des donateurs)
Length (Longueur) : 255 (vous devez saisir cette valeur de 255 caractères autorisés au maximum pour un champ de texte pour tous les champs de type Import Status [Statut d’importation]).
Field Name (Nom du champ) : Donor_Survey_Import_Status (Statut_Importation_Enquête_Donateurs) (ce champ devrait être renseigné automatiquement).

Cliquez sur Next (Suivant) à deux reprises, puis sur Save & New (Enregistrer et nouveau) pour créer le champ suivant.
Choisissez Lookup Relationship (Relation de référence), puis cliquez sur Next (Suivant).
Dans le champ Related To (Associé à), sélectionnez Donor Survey (Enquête auprès des donateurs) et cliquez sur Next (Suivant).
Remplacez le contenu de Field Label (Étiquette du champ) par Donor Survey Imported (Enquête auprès des donateurs importée) et appuyez sur la touche Tab de votre clavier pour que Field Name (Nom du champ) soit rempli avec Donor_Survey_Imported (Enquête_Donateurs_Importée), puis cliquez sur Next (Suivant).
Cliquez sur Next (Suivant), puis à nouveau sur Next (Suivant) et enfin sur Save (Enregistrer).

Mise en ordre de la présentation de page

Profitez de travailler sur l’objet NPSP Data Import (Importation de données NPSP) dans l’outil Object Manager (Gestionnaire d’objet) pour mettre en ordre sa présentation de page afin de pouvoir trouver facilement vos nouveaux champs. Prendre le temps d’organiser la présentation de votre page NPSP Data Import (Importation de données NPSP) peut vous aider à examiner rapidement les données importées et à gagner du temps par la suite.

Cliquez sur Page Layouts (Présentations de page).
Cliquez sur Data Import Layout (Présentation Importation de données).
Ajoutez une nouvelle section. Cliquez sur le menu Fields (Champs) en haut de l’écran afin de le mettre en surbrillance, puis cliquez sur l’élément Section et faites-le glisser sur la page après la section Donation Information (Informations sur le don).
Nommez votre section Donor Survey Information (Informations sur l’enquête auprès des donateurs), puis cliquez sur OK.
Les nouveaux champs apparaissent par défaut dans la section Information (Informations) en haut de la page. Vous pouvez cliquer dessus et les faire glisser vers votre nouvelle section ou cliquer sur le bouton de suppression (), puis les faire glisser de la zone Fields (Champs) supérieure vers la nouvelle section.
Cliquez sur Save (Enregistrer).

Si vous accédez à l’un des enregistrements NPSP Data Import (Importation de données NPSP) avec lesquels vous travailliez précédemment, la nouvelle section devrait ressembler à ceci.

La section Donor Survey Information (Informations sur l’enquête auprès des donateurs) dans un enregistrement NPSP Data Import (Importation de données NPSP)

Création de mappages avancés

Maintenant que vous avez créé tous vos champs et mis en ordre la présentation de page, il est temps de connecter les objets Donor Survey (Enquête auprès des donateurs) et NPSP Data Import (Importation de données NPSP) avec Advanced Mapping (Mappage avancé).

Vous souvenez-vous du moment où vous avez mappé vos nouveaux champs standard pour Contact1 et Contact2 ? Vous avez modifié un groupe d’objets existant. Comme vous mappez un nouvel objet, vous devez d’abord créer un groupe d’objets.

Cliquez sur l’outil App Launcher (Lanceur d’application) (), puis recherchez et sélectionnez NPSP Settings (Paramètres NPSP)
Cliquez sur System Tools (Outils système).
Cliquez sur Advanced Mapping for Data Import & Gift Entry (Mappage avancé pour Importation de données et Saisie de dons)
Cliquez sur Configure Advanced Mapping (Configurer le mappage avancé).
Cliquez sur Create New Object Group (Créer un autre groupe d’objets).
Saisissez les informations suivantes :

Group Name (Nom du groupe) : Donor Survey (Enquête auprès des donateurs)
Object Name (Nom de l’objet) : Donor Survey (Donor_Survey__c) (Enquête auprès des donateurs [Enquête_Donateurs__c])
Is Child/Parent (Est enfant/parent) : Enfant
Of This Object Group (De ce groupe d’objets) : Contact 1
Through This Field (À ce champ) : Contact (Contact__c) (Contact [Contact__c])
Link to Record (Lier à l’enregistrement) : Donor Survey Imported (Donor_Survey_Imported__c) (Enquête auprès des donateurs importée [Enquête_Donateurs_Importée__c])
Statut d'importation : Donor Survey Import Status (Donor_Survey_Import_Status__c) (Statut d’importation de l’enquête auprès des donateurs [Statut_Importation_Enquête_Donateurs__c])

Cliquez sur Save (Enregistrer).

Le traitement du nouveau groupe d’objets peut prendre quelques secondes. Une fois ce processus terminé, vous pouvez ajouter les mappages de champs.

Dans la ligne Donor Survey (Enquête auprès des donateurs), cliquez sur la flèche de menu () et sélectionnez View Field Mappings (Afficher les mappages de champs).
Cliquez sur Create New Field Mapping (Créer un mappage de champs personnalisé).
Recherchez et sélectionnez Donor Survey Status (Donor_Survey_Status__c) (Statut de l’enquête auprès des donateurs [Statut_Enquête_Donateurs__c]) comme source.
Recherchez et sélectionnez Status (Status__c) (Statut [Statut__c]) comme cible.
Cliquez sur Save (Enregistrer).

Vous avez créé l’objet cible et les champs personnalisés, créé des champs intermédiaires sur l’objet NPSP Data Import (Importation de données NPSP) et créé votre mappage. Maintenant, vous devez préparer vos données et les intégrer dans Salesforce.

Vous verrez comment procéder dans l’étape suivante, mais avant de poursuivre, assurez-vous de sélectionner le Trailhead Playground où vous avez suivi cette étape et de cliquer sur Verify (Vérifier).