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.
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 Connecteurs, 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.
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 télécharger des exemples de modèles de chargement, consultez les rubriques Champs obligatoires et Modèles ci-dessous.
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.
Corriger les erreurs de chargement
Si le système détecte des erreurs dans vos données, vous pouvez les résoudre avant d'appliquer vos modifications :
- À 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 choisissez 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.
Vérifier et appliquer les modifications
- À 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é.
- 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.
Configurations de téléchargement sauvegardées
Les configurations de téléchargement sauvegardées sont des modèles de chargement d'entités que vous prévoyez de réutiliser au fil du temps. Vous pouvez utiliser une configuration de téléchargement pour sauvegarder les paramètres d'un certain processus de chargement de fichiers (y compris les mappages de champs, les règles de nettoyage des données, les champs/actions supplémentaires, etc.) et appliquer ces mêmes paramètres aux futurs chargements de données similaires.
Vous pouvez sauvegarder une configuration de téléchargement à l'étape Résumé du flux de chargement des entités. Saisissez un nom pour votre configuration et cliquez sur Enregistrer.
Appliquer une configuration de téléchargement sauvegardée
Pour utiliser une configuration de téléchargement sauvegardée lors d'un prochain chargement, sélectionnez-la dans l'étape Importer un fichier du flux de chargement des entités.
Voir les chargements passés
Champs obligatoires
- L'identifiant de l'entité et le pays sont des champs obligatoires pour tous les types d'entités.
- Le champ Pays doit être formaté sous la forme d'un code pays ISO à deux lettres (également appelé code ISO alpha-2), qui est un standard international. Pour une liste complète des codes pays ISO, consultez la ressource de navigation ISO.
Remarque : toutes les URL présentes dans votre téléchargement doivent être valides (c'est-à-dire que si vous les copiez-collez depuis votre document dans un navigateur web, elles doivent fonctionner). Si vos URL contiennent des caractères spéciaux encodés qui empêchent la résolution correcte de l'URL lorsqu'elle est saisie dans un navigateur web, ils doivent être décodés avant d'être chargés sur le Knowledge Graph (à l'exception des espaces encodés sous la forme %20).
Champs obligatoires par type d'entité
| Type d'entité | Champs obligatoires |
| Établissement |
|
| Restaurant |
|
| DAB |
|
| Professionnel de la finance |
|
|
Professionnel de santé Il existe un format de chargement spécifique pour les établissements médicaux et les praticiens. Consultez le Guide de démarrage : Yext pour le secteur de la santé afin d'en savoir plus sur les bonnes pratiques à suivre pour les entités médicales. |
Remarque : Vous pouvez utiliser le Registre NPPES NPI pour trouver le numéro NPI d'un prestataire. |
|
Établissement médical Il existe un format de chargement spécifique pour les établissements médicaux et les praticiens. Consultez le Guide de démarrage : Yext pour le secteur de la santé afin d'en savoir plus sur les bonnes pratiques à suivre pour les entités médicales. |
|
| Événement |
|
| Hôtel |
|
| FAQ |
|
| Emploi |
|