Un champ représente un élément de données stocké sur une entité individuelle. Un seul champ peut être utilisé pour différents types d'entités.
Pour afficher et gérer les champs de votre compte, accédez à Knowledge Graph > Configuration et cliquez sur la tuile Champs.
Yext propose plusieurs champs intégrés, et vous pouvez créer des champs personnalisés supplémentaires selon vos besoins. Tous les champs sur les entités, qu'ils soient intégrés ou personnalisés, ont les propriétés suivantes :
- Un type (le format des données acceptées par le champ ; vous trouverez plus d'informations sur les types de champs ci-dessous)
- Un nom d'affichage
- Un nom d'API
- Validation (par exemple, un nombre maximum de caractères pour les champs de texte, ou un rapport hauteur/largeur pour les photos)
- Comportement multilingue (comment le champ se comporte lorsqu'il est traduit, si vous utilisez des expériences multilingues)
Créer un champ personnalisé
Vous pouvez créer des champs personnalisés pour stocker des informations supplémentaires sur les entités dans le Knowledge Graph.
-
Accédez à Knowledge Graph > Configuration et cliquez sur la tuile Champs.
- Cliquez sur Créer un champ personnalisé.
-
Cliquez sur le menu déroulant Sélectionner un type de champ et choisissez le type de champ personnalisé que vous souhaitez créer.
- Pour en savoir plus sur la création de types de champs, consultez l'article Gérer les types de champs
- Complétez les détails de vos paramètres de champ. Vous trouverez ci-dessous une description des paramètres disponibles.
- Une fois vos paramètres ajoutés, cliquez sur Sauvegarder le champ en bas à droite.
Paramètres de champ de base
Saisissez les informations de base concernant votre champ. Selon le type de champ que vous avez sélectionné, les options affichées peuvent légèrement varier.
-
Nom de champ
- Remarque : vous ne pouvez pas modifier le type de champ après sa création.
-
ID : il sera automatiquement défini en fonction du nom, mais vous pouvez le modifier si vous le souhaitez.
- Il est déconseillé de le modifier une fois le champ créé, car cela pourrait perturber les applications se référant à l'ID actuel du champ.
- Disponibilité du type d'entité : sélectionnez le ou les types d'entités pour lesquels vous souhaitez que ce champ soit disponible.
- Paramètres du champ : définissez les options de validation du champ et les entrées acceptées. Selon le type de champ que vous avez sélectionné, les options affichées peuvent varier.
-
Description de l'info-bulle : (facultatif) cette option permet d'afficher une description qui apparaîtra dans le Knowledge Graph lorsque les utilisateurs cliquent sur l'icône en forme de point d'interrogation à côté du nom du champ.
Paramètres de champ avancés
Configurez des paramètres supplémentaires pour votre champ si vous le souhaitez. Selon le type de champ que vous avez sélectionné, les options affichées peuvent légèrement varier.
- Groupe d'autorisation pour les champs personnalisés : attribuez un groupe d'autorisation pour champs afin de restreindre les utilisateurs pouvant accéder à ce champ. Pour en savoir plus sur la création de groupes d'autorisations personnalisés, consultez l'article Créer un groupe d'autorisation pour les champs personnalisés.
- Comportement des langues supplémentaires : si vous utilisez des profils de langues supplémentaires pour vos entités, sélectionnez le comportement souhaité pour ce champ dans tous les profils d'entités. Pour en savoir plus sur le comportement des langues alternatives, consultez la référence relative au comportement du champ de profil de langue supplémentaire sur Hitchhikers.
-
Périmètre d'écriture : cette option permet de désigner les systèmes autorisés à apporter des modifications au champ. Choisissez une ou plusieurs des options suivantes :
- Système Yext (cette option sera toujours sélectionnée)
- Application
- Utilisateur
- Connecteur
Traductions
Si vous utilisez des profils de langues supplémentaires, ajoutez des traductions aux paramètres des champs :
- Cliquez sur Ajouter une traduction pour n'importe quel paramètre où l'option est affichée, comme le nom et l'info-bulle.
- Choisissez la langue souhaitée et saisissez la valeur traduite. Cliquez sur Sauvegarder ou Sauvegarder et ajouter un autre élément pour ajouter une autre traduction aux mêmes paramètres.
Computed Field Values (Valeurs de champs calculés)
Vous pouvez définir des méthodes de calcul pour les champs si vous souhaitez qu'ils soient automatiquement configurés par le système Yext. Pour en savoir plus sur l'utilisation des valeurs de champs calculés, consultez le guide correspondant.
Click sur l'onglet Méthode de calcul pour accéder aux paramètres de calcul du champ.
Mettre à jour les paramètres d'un champ
Vous pouvez mettre à jour les paramètres des champs existants. Notez qu'il peut ne pas être possible de modifier certains paramètres de champ si :
- le champ est déjà utilisé dans des entités ;
- le champ est un champ intégré de Yext, et non un champ personnalisé.
Pour mettre à jour les paramètres des champs :
- Accédez à Knowledge Graph > Configuration et sélectionnez la tuile Champs.
- Localisez le champ souhaité dans le tableau et cliquez dessus.
- Modifiez les paramètres souhaités dans l'onglet Paramètres. Lorsque vous avez terminé, cliquez sur Sauvegarder le champ en bas à droite.
Afficher les noms d'API des champs
Le nom de l'API est l'identifiant unique d'un champ dans le système backend de Yext. Les noms d'API sont utilisés pour identifier les champs des applications, telles que l'intégration de Yext avec d'autres systèmes.
Vous pouvez consulter les champs et leurs noms d'API de plusieurs façons.
Via une configuration des champs de types d'entités
- Cliquez sur Knowledge Graph dans la barre de navigation, puis sur Configuration.
- Cliquez sur Entity Types (Types d'entité).
- Cliquez sur Afficher les détails à côté du type d'entité souhaité.
- Cliquez sur l'onglet Champs.
- Vous verrez tous les champs configurés pour ce type d'entité, classés par section de champ. Le nom de l'API pour un champ est indiqué directement sous le nom du champ.
Via la modification d'entités
- Cliquez sur Knowledge Graph dans la barre de navigation, puis sur Entités.
- Sélectionnez l'entité souhaitée.
- Vous verrez la liste des champs associés à cette entité avec le nom d'API affiché sous le nom du champ.
Via les paramètres des champs
- Cliquez sur Knowledge Graph dans la barre de navigation, puis sur Configuration.
- Cliquez sur Configuration.
- Vous verrez une liste de tous les champs de votre compte avec le nom d'API affiché sous le nom du champ.