Charger des entités dans Yext – Yext Help

Cet article explique comment ajouter et modifier des entités en bloc dans votre compte en important une feuille de calcul à l'aide du flux Chargement d'entités.

Pour apprendre à ajouter des entités une par une, reportez-vous à Ajouter une seule entité.

Remarque : le chargement d’entités est un moyen de télécharger des feuilles de calcul contenant des données d’entités vers le Knowledge Graph. Vous pouvez également télécharger des données d'entité au format .CSV, .XLSX ou JSON en utilisant le cadre Connectors, qui est un processus distinct du téléchargement d'entités. Pour apprendre à créer un connecteur de téléchargement de fichiers pour télécharger des données, consultez le guide Créer un connecteur de chargement de fichiers sur Hitchhikers.

Avant de commencer

Veillez à ce que votre feuille de calcul soit correctement formatée avant de débuter votre chargement :

Assurez-vous que votre fichier est au format .XLS, .XLSX ou .CSV.
Incluez des colonnes correspondant à l'ID de l'entité et au pays/à la région, ainsi qu'à tout autre champ requis pour le type d'entité que vous allez importer.
Pour voir tous les champs requis par type d'entité et pour télécharger des modèles de chargement à titre d'exemple, consultez Modèles de chargement d'entités et champs requis.

Charger des entités

Pour ajouter ou modifier des entités en important une feuille de calcul :

Accédez à Recherche d'entités (Knowledge Graph > Entités) et cliquez sur Ajouter des données.
Sélectionnez Chargement d'entités dans la boîte de dialogue Ajouter des données.
Cette action ouvrira l'étape de chargement du fichier du flux d'importation d'entités. Veuillez définir les options suivantes :
- Cliquez sur Choisir un fichier pour sélectionner votre feuille de calcul.
- Si vous utilisez une configuration de téléchargement enregistrée pour télécharger des données dans un format spécifique, choisissez votre configuration de téléchargement enregistrée dans le menu déroulant.
- Si vous n'utilisez pas de configuration de chargement enregistrée, laissez l'option sur Non, il s'agit d'une nouvelle feuille de calcul.
- Si vous chargez des données dans une langue autre que la langue par défaut de votre compte, veuillez sélectionner la langue concernée dans le menu déroulant.
- Cliquez sur Continuer.
À l'étape de configuration du fichier, associez les colonnes de votre feuille de calcul aux champs dans Yext. Le système mappera automatiquement les colonnes dans la mesure du possible, mais il se peut que vous deviez sélectionner le mappage de champ approprié pour certaines colonnes.
- Pour associer une colonne à un champ, cliquez sur le menu déroulant Mapper cette colonne, saisissez le nom du champ auquel associer la colonne, puis sélectionnez-le dans le menu.
- Si vous ne souhaitez charger les valeurs des champs pour aucune colonne non mappée de votre feuille de calcul, cliquez sur Ignorer toutes les colonnes non mappées pour ne pas associer ces colonnes à des champs.
- Afin de modifier le mappage des champs pour toute colonne qui a été associée automatiquement, cliquez sur le menu déroulant contenant le nom du champ associé et sélectionnez un autre champ.
Par défaut, chaque colonne mappée respectera les règles de nettoyage des données qui ont été définies, comme suit :
- Supprimer les espaces superflues : supprime les espaces à la fin ou au début de la valeur de la colonne
- Ignorer les valeurs non renseignées : le chargement d'entités n'importera pas les cellules vides (afin que les valeurs existantes dans Yext ne soient pas supprimées).
Pour modifier l'une des règles de nettoyage des données, cliquez sur Modifier en regard de la colonne que vous souhaitez changer.
- Selon le type de champ en cours de modification, différentes règles de nettoyage des données peuvent s'appliquer.
- Lorsque vous avez terminé, cliquez sur Fermer.
Utilisez les champs supplémentaires pour définir les valeurs de champ supplémentaires que vous n'avez pas incluses dans votre feuille de calcul. Pour définir une valeur de champ supplémentaire, cliquez sur Ajouter un champ.
- Sachez que ce paramètre définira la même valeur de champ pour toutes les entités (par exemple, définir une valeur de champ supplémentaire pour le champ « Accepte les réservations » définira toutes les entités sur « Oui » ou sur « Non »).
- Si vous souhaitez définir des valeurs de champ différentes pour différentes entités dans votre chargement, vous devez importer un nouveau fichier incluant le champ concerné. Pour ce faire, révisez votre feuille de calcul, puis cliquez sur le menu Plus d'actions dans le coin supérieur droit. Sélectionnez Charger le fichier révisé.
Si vous ajoutez un champ supplémentaire, choisissez le champ que vous souhaitez définir dans le menu déroulant Mapper cette colonne.
- Saisissez la valeur souhaitée pour toutes les entités dans la zone de texte Valeur du champ.
- Appliquez les règles de nettoyage des données si vous le souhaitez.
- Choisissez le périmètre des entités auxquelles appliquer le champ : toutes les nouvelles entités, toutes les entités déjà présentes dans le Knowledge Graph, ou toutes les entités du fichier.
- Cliquez sur Enregistrer lorsque vous avez terminé. Renouvelez l'opération pour tout autre champ supplémentaire que vous souhaitez ajouter.
Utilisez la section Actions supplémentaires pour ajouter les entités importées à un dossier, leur appliquer des intitulés ou un modèle d'entité.
- Cliquez sur Ajouter une action en regard de l'action que vous souhaitez effectuer.
- Dans le menu déroulant Sélectionner le type d'entité, choisissez le périmètre de votre action : toutes les nouvelles entités, toutes les entités manquantes (entités déjà présentes dans votre Knowledge Graph et qui ne font pas partie de ce chargement), toutes les entités de votre fichier ou toutes les entités de votre compte (y compris le chargement actuel).
- En fonction de l'action choisie, sélectionnez le dossier, l'intitulé ou le modèle que vous souhaitez appliquer.
- Pour plus d'informations sur ces actions, consultez les articles Créer un dossier, Gérer et appliquer des intitulés d'entité, ou Créer un modèle d'entité.
Après avoir mappé toutes vos colonnes et défini les champs ou actions supplémentaires, cliquez sur Continuer dans le coin inférieur droit.
À l'étape d'analyse du fichier, le système traitera votre chargement.
- Si votre chargement s'est déroulé sans problème, vous serez dirigé vers l'étape de vérification des modifications.
- Si des problèmes se sont produits lors de votre chargement, vous serez dirigé vers l'étape de correction des erreurs.
À l'étape de correction des erreurs , passez en revue et résolvez tout problème lié aux données de votre feuille de calcul. Le tableau affichera les colonnes comportant des erreurs et le nombre de lignes affectées par chaque erreur.
Choisissez l'une des méthodes suivantes en vue de résoudre les erreurs :
- Pour télécharger une feuille de calcul contenant des erreurs, les corriger dans votre fichier et le réimporter : cliquez sur Télécharger les erreurs.
- Pour corriger toutes les erreurs directement dans le flux de chargement d'entités, cliquez sur Corriger toutes les erreurs.
- Pour corriger un seul type d'erreur à la fois dans le flux de chargement d'entités, cliquez sur Corriger les erreurs dans la vue de la feuille de calcul en regard de l'erreur choisie.
- Pour passer le chargement des valeurs de champ contenant des erreurs, cliquez sur la flèche déroulante de l'erreur choisie et sélectionnez Ignorer ces valeurs.
Si vous avez choisi de corriger toutes les erreurs ou de corriger une seule erreur dans la vue de la feuille de calcul, vous verrez les lignes contenant des erreurs et une explication du problème. Saisissez la valeur corrigée pour chaque ligne dans la colonne Nouvelle valeur.
À l'étape de vérification des modifications, vous verrez une ventilation de toutes vos entités chargées par catégorie : nouvelles entités, entités mises à jour, entités inchangées (présentes dans votre chargement, mais sans aucun ajout ni modification des données) et entités manquantes (entités de votre compte qui n'étaient pas présentes lors de votre chargement).
- Cliquez sur chaque numéro Hero afin d'obtenir des détails sur les entités individuelles dans chaque catégorie.
- Cliquez sur Télécharger le récapitulatif complet afin de télécharger la ventilation pour toutes les catégories d'entités.
- Cliquez sur les boutons de téléchargement individuels de chaque catégorie pour télécharger le récapitulatif de chacune d'elles.
Cliquez sur chaque categorie dans l’étape Contrôler les modifications. Cochez la case en bas pour confirmer le changement (par exemple, « Je reconnais que j’ajoute [x] entités »), puis cliquez sur Suivant en bas à gauche pour passer à la categorie suivante.
- Cette opération doit être effectuée pour chaque catégorie, même si elle ne contient aucune entité.
Après avoir confirmé la dernière catégorie, cliquez sur Soumettre les modifications afin de confirmer tous les changements.
À l'étape du récapitulatif, le système traitera et appliquera les modifications à votre chargement. Vous pouvez contrôler ces modifications dans la barre de progression située en haut de l'écran.
- Si vous souhaitez enregistrer cette configuration de chargement pour importer davantage de données en utilisant les mêmes options de formatage à l'avenir, saisissez un nom de configuration à côté de l'option Nom de la configuration et cliquez sur Enregistrer.
- Sinon, cliquez sur Terminé ou Retour aux chargements pour quitter le flux de chargement d'entités.

Remarque :sii vous importez un fichier qui diffère fortement du contenu que vous avez stocké dans votre compte, il se peut que celui-ci soit manuellement vérifié et approuvé par Yext afin de s'assurer que toutes les modifications sont correctes et intentionnelles.

Après le chargement

Pour afficher les anciens téléchargements d'entités et vos configurations enregistrées, accédez à Knowledge Graph > Configuration. Cliquez sur la vignette Télécharger les configurations ou Télécharger les fichiers de données.