Au lieu d’ajouter un enregistrement d’objet personnalisé à la fois, vous pouvez en ajouter et en mettre à jour plusieurs en masse en important un fichier CSV. Vous devez être un administrateur pour importer des enregistrements d’objets personnalisés en masse.
Exigences et limitations
- Le fichier CSV d’importation ne peut pas faire plus de 1 Go. Nous conseillons un maximum de 500 000 lignes (une ligne d’en-tête et jusqu’à 499 999 lignes de données). De plus, chaque ligne ne peut dépasser 32 Ko.
- Le fichier CSV d’importation peut contenir 102 colonnes maximum.
- N’incluez pas le même enregistrement plusieurs fois dans un même fichier CSV. Votre importation risquerait d’échouer.
- Il n’y a aucune garantie que les enregistrements soient créés ou mis à jour dans l’ordre dans lequel ils apparaissent dans le fichier CSV.
- Vous ne pouvez importer qu’un seul fichier CSV à la fois. Donc, si vous avez plus de données que le nombre maximum de lignes pris en charge par le fichier CSV, vous devez créer des fichiers indépendants pour chaque lot de données et les importer les uns après les autres.
- L’importation en masse des enregistrements d’objets personnalisés est irréversible. Avant d’importer le fichier CSV qui contient les informations de tous vos enregistrements actuels, testez-le avec un seul enregistrement pour vous assurer que le chargement fonctionne comme vous le souhaitez.
Création d’un fichier CSV d’enregistrements d’objets personnalisés
- Le fichier doit être au format CSV et enregistré avec l’encodage de caractères UTF-8.
- La première ligne du fichier CSV est la ligne d’en-tête.
- La ligne d’en-tête doit contenir un champ de nom. (facultatif) Si vous voulez mettre à jour les enregistrements en masse ultérieurement, vous devez aussi inclure un champ external_id. Tous les autres noms de champ dans la ligne d’en-tête doivent correspondre exactement aux clés de champ dans votre objet personnalisé.
- Pour importer les valeurs des champs de liste déroulante, utilisez la valeur clé_champ du champ de liste déroulante personnalisé comme titre de colonne et spécifiez le marqueur des options, pas leur valeur conviviale.
- Pour importer les valeurs des champs de relation de recherche, utilisez la valeur clé_champ du champ de relation de recherche personnalisé comme titre de colonne et spécifiez l’ID ou l’ID externe de l’enregistrement. Si vous utilisez l’ID de l’enregistrement, fournissez la valeur. Si vous utilisez l’ID externe, utilisez le format external_id:valeur, où valeur est remplacée par la valeur de l’ID externe de l’enregistrement.
- Si vous n’importez pas de données pour un champ, ne le répertoriez pas dans la ligne d’en-tête.
- Ajoutez des sauts de ligne aux notes ou aux champs multiligne en appuyant sur ALT+ENTRÉE pour Windows ou CTRL+OPTION+RETOUR sur un macOS.
Si vous effectuez un chargement en masse de vos enregistrements afin d’utiliser vos données existantes pour un nouvel objet personnalisé, nous vous conseillons de suivre Planification de votre workflow d’objets personnalisés. Pendant ce processus, nous vous conseillons de créer des feuilles de calcul avec ces données pour chacun de vos objets personnalisés. Si vous structurez soigneusement votre feuille de calcul pour qu’elle corresponde à l’objet personnalisé créé dans Zendesk et suivez les directives ci-dessus, vous pouvez exporter la feuille de calcul sous la forme d’un fichier CSV et l’utiliser pour ce chargement en masse. Dans ce cas, n’oubliez pas d’ajouter une colonne pour external_id et un ID pour chaque enregistrement si vous voulez pouvoir les mettre à jour en masse ultérieurement.
Importation du fichier CSV d’enregistrements d’objets personnalisés
Vous pouvez utiliser l’importateur de données pour importer un fichier CSV qui crée de nouveaux enregistrements d’objets personnalisés ou met à jour les enregistrements existants, et capture les journaux de toutes les tentatives d’importation par le biais de la page Importateur de données.
- Avant de pouvoir charger des enregistrements en masse pour un objet personnalisé, vous devez créer l’objet personnalisé dans Zendesk.
- Dans le Centre d’administration, cliquez sur Objets et règles (
) dans la barre latérale, puis sélectionnez Outils > Importateur de données. - Cliquez sur Importer.
- Sous Type d’importation, choisissez l’une des options suivantes :
- Création uniquement : seuls les nouveaux enregistrements d’objets personnalisés sont créés. Toutes les données portant sur les enregistrements existants dans le fichier CSV sont ignorées.
- Mise à jour uniquement : remplace les données pour les enregistrements d’objets personnalisés existants présents dans votre fichier CSV. Toutes les données portant sur les nouveaux enregistrements sont ignorées.
- Création et mise à jour : crée de nouveaux enregistrements d’objets personnalisés et met à jour les données pour les enregistrements d’objets personnalisés existants présents dans votre fichier CSV.
- Sous Destination cible, sélectionnez le nom de l’objet personnalisé.
- Sous Téléchargement de fichier, faites glisser et déposez votre fichier ou cliquez pour télécharger et sélectionnez votre fichier CSV dans le navigateur.
Si vous voulez changer le fichier que vous avez sélectionné, cliquez sur l’icône de suppression (
) en regard du nom du fichier. - Cliquez sur Suivant.
- Consultez la liste Mappage des champs.
- Si le mappage est correct, cliquez sur Suiv.
- Sinon, cliquez sur Retour. Modifiez le fichier CSV pour qu’il respecte les exigences de format et chargez-le à nouveau.
- Lisez le résumé des détails de l’importation dans la boîte de dialogue de confirmation, puis cliquez sur Commencer l’importation.
Une fois l’importation commencée, il est impossible d’annuler les modifications importées. Pour connaître le statut d’une importation, consultez votre historique des importations.