Résumé ◀▼
Vous pouvez importer ou mettre à jour plusieurs organisations en masse à l’aide d’un seul fichier CSV, ce qui vous fait gagner du temps par rapport à un processus individuel. Le fichier CSV doit respecter certaines règles de mise en forme et limites de taille, et vous devez être administrateur pour effectuer des importations. Ce processus prend en charge les données de base de l’organisation et les champs personnalisés, mais présente certaines limites, notamment l’absence de garantie quant à l’ordre d’importation et l’impossibilité d’avoir des entrées en double dans un même fichier. Les journaux d’historique d’importation suivent la progression.
Au lieu d’ajouter une organisation à la fois, vous pouvez en ajouter plusieurs en une seule fois en important un fichier CSV (valeurs séparées par des virgules). Vous pouvez utiliser l’importation en masse pour ajouter ou mettre à jour des organisations. Vous devez être un administrateur pour importer des organisations en masse. Vous pouvez aussi ajouter ou mettre à jour plusieurs utilisateurs et plusieurs enregistrements d’objets personnalisés à la fois.
L’importation des organisations en masse est une action irréversible. Avant d’importer le fichier CSV qui contient les informations de toutes vos organisations, testez-le avec un seul enregistrement d’organisation pour vous assurer que le chargement fonctionne comme prévu.
Limites de l’importation en masse avec l’importateur de données
Les importations en masse portent sur les données essentielles des utilisateurs ou des organisations. Pour importer les données non répertoriées dans ce tableau, vous devez utiliser l’API Zendesk REST. Consultez Importation d’utilisateurs avec l’API Zendesk.
- Quand vous utilisez l’importateur de données, 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 128 Ko.
- Le fichier CSV d’importation peut contenir 200 colonnes maximum.
- Le fichier CSV d’importation ne peut pas garantir l’ordre d’importation des lignes.
- N’incluez pas le même utilisateur ou la même organisation 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. Quand vous n’utilisez pas l’importateur de données, jusqu’à deux lots de données sont placés en file d’attente et traités en arrière-plan. Si vous voulez importer plus de deux lots, vous devez attendre que l’importation des deux premiers soit terminée pour en ajouter d’autres.
- Vous ne pouvez pas utiliser l’importation en masse pour importer les coordonnées des comptes Facebook ou X (anciennement Twitter) des utilisateurs finaux. Vous devez utiliser l’API REST de Zendesk. Consultez Importation d’utilisateurs avec l’API Zendesk.
Création d’un fichier CSV pour importer des organisations
Pour importer des organisations en masse, utilisez un fichier de données d’organisations CSV. Cette section explique comment configurer votre fichier de données CSV.
- Le fichier doit être au format CSV et enregistré avec le codage 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 tous les champs exigés du tableau ci-dessous, plus tout autre champ répertorié dans le tableau ci-dessous que vous souhaitez inclure.
- Dans votre ligne d’en-tête, utilisez domain_names ou default, selon votre méthode d’importation. Vous ne pouvez pas les utiliser ensemble.
- Si vous n’importez pas de données pour un champ, ne le répertoriez pas dans la ligne d’en-tête.
- Les colonnes de données vides dans le fichier écrasent toutes les données existantes pour cette organisation.
- 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.
| Champs | Description |
|---|---|
| name | Exigé. Nom de l’organisation. |
| external_id | Facultatif, mais conseillé ; exigé si vous projetez d’utiliser l’importateur de données pour mettre ces enregistrements à jour ultérieurement. Une valeur d’identification unique, comme un numéro d’identification d’employé ou de client dans un système externe. |
| notes | Notes sur l’organisation. Seuls les agents (et non les utilisateurs finaux) peuvent consulter ces notes. |
| details | Informations détaillées sur l’organisation, par exemple son adresse. Ces informations sont visibles uniquement par les agents (jamais par les utilisateurs finaux). Utilisez ce champ à la place de l’en-tête default quand vous utilisez l’importateur de données. |
| domain_names | Les noms des domaines de l’organisation pour le mappage d’utilisateur. Si vous incluez plus d’un domaine pour une organisation, séparez-les par une barre verticale (|). |
| group_id | Entrez un groupe par défaut pour l’organisation. Consultez Mappage d’un groupe sur une organisation. |
| tags | Si les marqueurs pour les utilisateurs et les organisations ont été activés dans Zendesk Support, vous pouvez définir des marqueurs pour l’organisation. Séparez les marqueurs par des barres verticales ( | ). Quand vous importez des organisations en masse, les marqueurs de votre fichier CSV remplacent les marqueurs d’organisation existants. Si vous ne le souhaitez pas, utilisez plutôt l’API Marqueurs pour mettre les marqueurs à jour. |
| organization_fields.<clé du champ> | Quand vous effectuez une importation en masse d’organisations, vous pouvez importer un champ d’organisation personnalisé en spécifiant le préfixe organization_fields. et la clé du champ. Par exemple, pour la clé du champ subscription_date, utilisez ce qui suit pour définir les valeurs importées pour ce champ. organization_fields.subscription_date Pour trouver la clé du champ pour un champ d’organisation, consultez Trouver la clé ou l’ID d’un champ personnalisé. Si la valeur d’un champ n’est pas formatée correctement, l’importation échoue et vous pouvez voir les détails de l’erreur dans l’historique des importations. Pour les champs de dates personnalisés, utilisez le format AA/MM/JJ ou AA-MM-JJ. Pour les champs de case à cocher, utilisez True ou False. Pour définir la valeur du champ de liste déroulante, utilisez le marqueur que vous avez ajouté lorsque vous avez créé la liste déroulante.
Remarque – Les champs de recherche de relation ne sont pas pris en charge lors de l’importation d’organisations à la page Importateur de données.
|
Importation d’organisations avec l’importateur de données
Vous pouvez utiliser l’importateur de données pour importer un fichier CSV qui crée de nouvelles organisations ou met à jour les organisations existantes et capture les journaux de toutes les tentatives d’importation par le biais de la page Importateur de données.
Le fichier CSV est ajouté dans la file d’attente. Après traitement (importation), les organisations spécifiées dans ce fichier sont ajoutées à Zendesk Support. Cela devrait prendre environ une heure par fichier, mais cela dépend de la taille des fichiers et de la file d’attente.
- 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 Destination cible, sélectionnez Organisation.
- Sous Options d’importation, choisissez l’une des options suivantes :
- Créer des enregistrements uniquement : seules les nouvelles organisations sont créées. Toutes les données portant sur les organisations existantes dans le fichier CSV sont ignorées.
- Mettre à jour des enregistrements uniquement : remplace les données pour les organisations existantes présentes dans votre fichier CSV. Le champ external_id est requis pour mettre les organisations à jour. Toutes les données portant sur les nouvelles organisations sont ignorées.
- Créer et mettre à jour des enregistrements : crée de nouvelles organisations et met à jour les données pour les organisations existantes présentes dans votre fichier CSV.
- 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 télé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.