Au lieu d’ajouter une organisation à la fois, vous pouvez en ajouter plusieurs en masse en important un fichier CSV. 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.
Conditions imposées aux importations en masse (utilisateurs et organisations)
Les importations en masse portent sur les données essentielles des utilisateurs ou des organisations. Par exemple, avec l’importation en masse, vous pouvez importer les données décrites dans le tableau ci-dessous. Cependant, vous ne pouvez pas importer les fuseaux horaires, les photos, les préférences linguistiques, etc. 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 ou Importation d’organisations avec l’API Zendesk.
- Le nombre de lignes maximum dépend de la méthode d’importation.
- Quand vous utilisez les pages d’importation en masse pour importer des données d’utilisateur et d’organisation nouvelles et existantes, le fichier de données CSV d’importation peut contenir un maximum de 2 000 lignes. (une ligne d’en-tête et jusqu’à 1 999 lignes de données).
- Quand vous utilisez l’importateur de données pour importer des données d’organisation nouvelles et existantes, 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.
- Quand vous utilisez l’importateur de données, les limites suivantes s’appliquent :
- 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.
- 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, vous 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 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 tous les champs obligatoires 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 | Obligatoire. Nom de l’organisation. |
external_id | Facultatif, mais conseillé ; obligatoire 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. |
domain_names (avec l’importateur de données uniquement) |
Informations détaillées sur l’organisation, par exemple son adresse. Ces informations sont visibles uniquement par les agents (jamais par les utilisateurs finaux). À utiliser à la place de l’en-tête default quand vous utilisez l’importateur de données. |
default (pas avec l’importateur de données) |
Ce champ permet de mapper des utilisateurs sur une organisation. Saisissez un ou plusieurs domaines de messagerie séparés par des espaces (par exemple, organisation1.com organisation2.com). À utiliser à la place de l’en-tête domain_names quand vous n’utilisez pas l’importateur de données. Consultez Ajout automatique d’utilisateurs dans une organisation en fonction de leur domaine de messagerie. |
shared | True ou False. Précise si l’organisation sera partagée. Consultez Définition d’une organisation partagée pour les utilisateurs finaux. |
shared_comments | True ou False. La valeur True permet aux utilisateurs de l’organisation d’ajouter des commentaires à leurs tickets respectifs (dans ce cas, le champ « partagée » doit également avoir la valeur True). Consultez Définition d’une organisation partagée pour les utilisateurs finaux. |
group | Entrez un groupe par défaut pour l’organisation. Consultez Mappage d’un groupe sur une organisation. |
tags | Si les marqueurs sont activés pour les utilisateurs et les organisations dans Zendesk Support (consultez Ajout de marqueurs aux utilisateurs et aux organisations), vous pouvez définir des marqueurs pour l’organisation. Séparez les marqueurs par des espaces. 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> (avec l’importateur de données uniquement) |
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é d’un champ d’organisation personnalisé, cliquez sur l’icône Admin () et sélectionnez Champs d’organisation, puis cliquez sur le nom d’un champ personnalisé. La clé du champ se trouve dans le volet des propriétés sur la droite. 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.
|
custom_fields.<clé du champ> (pas avec l’importateur de données) |
Quand vous effectuez une importation en masse d’organisations, vous pouvez importer un champ d’organisation personnalisé en spécifiant le préfixe custom_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. custom_fields.subscription_date Pour trouver la clé d’un champ d’organisation personnalisé, cliquez sur l’icône Admin () et sélectionnez Champs d’organisation, puis cliquez sur le nom d’un champ personnalisé. La clé du champ se trouve dans le volet des propriétés sur la droite. Si une valeur n’est pas formatée correctement, l’importation échouera et vous recevrez par e-mail un rapport d’erreur spécifiant ce qui n’a pas été enregistré. 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 des options de la liste déroulante, utilisez le marqueur que vous avez ajouté lorsque vous avez créé la liste déroulante.
Remarque – Si le champ d’organisation personnalisé que vous importez est un champ Relation de recherche, saisissez l’ID de l’objet connexe comme valeur pour ce champ. Par exemple, pour une organisation, saisissez l’ID de l’organisation et pour un utilisateur, saisissez l’ID de l’utilisateur. Pour un enregistrement d’objet personnalisé, saisissez l’ID de l’enregistrement. Pour trouver l’ID d’une organisation, d’un utilisateur ou d’un enregistrement d’objet personnalisé, vous pouvez exporter les données de votre compte ou utiliser l’API Organisations, l’API Utilisateurs ou l’API Enregistrements d’objets personnalisés.
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 du fichier CSV (organisations)
Vous pouvez utiliser une importation en masse pour créer de nouvelles organisations ou mettre à jour les informations d’organisations existantes.
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. Consultez Conditions imposées aux importations en masse (utilisateurs et organisations).
Utilisation de l’importateur de données pour importer des données d’organisation
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.
- 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 Organisations.
- Sous Type 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 spécifications 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.
Utilisation d’une importation CSV pour mettre à jour des données d’organisation existantes
Nous conseillons d’utiliser l’importateur de données, mais vous pouvez toujours utiliser les pages d’actions en masse pour importer les données des organisations nouvelles et mises à jour. Vous recevrez un e-mail quand vos importations de cette page sont terminées.
- Dans le Centre d’administration, cliquez sur Utilisateurs () dans la barre latérale, puis sélectionnez Actions en masse > Importer des organisations.
- Sélectionnez le type d’importation à exécuter :
-
Créer des organisations
-
Mettre à jour des organisations existantes : utilisez ce type d’importation pour remplacer les données existantes pour les organisations répertoriées dans votre fichier CSV.
Le champ external_id ou name des organisations doit être inclus dans le fichier CSV pour qu’il soit possible de les identifier. En dehors du champ d’identifiant d’une organisation, n’incluez que les champs que vous voulez mettre à jour dans le fichier. Si la ligne d’une organisation a un champ vide, il remplacera les données existantes pour cette organisation.
-
- Selon le cas, cliquez sur le lien Sélectionner un fichier ou sur le lien Je préfère coller les données CSV.
- Cliquez sur Importer.
Une fois l’importation commencée, il est impossible d’annuler les modifications importées.
- (facultatif) Consultez le statut des importations en cours à la page Centre d’administration > Objets et règles > Outils > Importateur de données. Une fois une importation terminée, elle est capturée dans l’historique des importations.