Aller au contenu principal

Guide de correspondance des colonnes

Après avoir lu cette page, vous saurez lire le tableau Vérifier la correspondance des colonnes dans Paramètres → Migration, comprendre lesquelles de vos colonnes Agon a associées, corriger une association erronée et traiter les colonnes qu'Agon n'a pas pu placer — pour les clients, les abonnements et les cours.

Cette page complète la Vue d'ensemble de la migration : commencez par celle-ci pour le déroulement complet de l'import.


Comment Agon associe vos colonnes​

Avant d'importer, vous choisissez ce que vous importez — Clients, Abonnements ou Cours — sous Que voulez-vous importer ?. Ce choix détermine à quel ensemble de champs Agon vos colonnes peuvent être associées ; chaque entité a sa propre liste de champs, traitée dans sa propre section ci-dessous.

Lorsque vous cliquez sur Analyser le fichier, Agon examine chaque en-tête de colonne de votre fichier et tente de l'aligner sur l'un des champs de l'entité choisie. Les en-têtes qui correspondent de façon évidente au nom d'un champ (par exemple email, Email, email_address) sont associés directement ; les autres sont associés en interprétant le texte de l'en-tête (et, pour les colonnes à contenu textuel, quelques valeurs de la colonne elle-même, pour distinguer des en-têtes comme « Type » ou « Plan »). Le tableau vous montre ensuite ce qu'il a décidé, avec le message « Nous avons associé chaque colonne de votre fichier à un champ Agon ».

Rien n'est importé à ce stade. L'association n'est qu'une suggestion de départ que vous vérifiez et ajustez avant de confirmer.


Champs client​

Chaque ligne du tableau d'association comporte un menu déroulant Champ Agon avec ces choix lorsque vous importez des Clients :

ChoixRôle
Nom completLe nom du client. Si aucune colonne n'est associée ici, l'e-mail du client est utilisé comme nom.
E-mailL'adresse e-mail du client. Obligatoire — une ligne sans e-mail est ignorée. Si l'e-mail appartient déjà à un client dans Agon, la ligne est ignorée au lieu d'écraser ce client.
TéléphoneLe numéro de téléphone du client. Facultatif.
Date de naissanceLa date de naissance du client. Facultative. Utilisez YYYY-MM-DD.
NotesNotes libres sur le client. Facultatif.
Nom de facturationLe nom à indiquer sur les futures factures de ce client, si différent de son nom complet — par exemple le nom d'une société. Facultatif.
Adresse de facturationL'adresse à indiquer sur les futures factures de ce client. Facultatif.
Numéro fiscal / TVALe numéro fiscal ou de TVA du client, pour ses futures factures. Facultatif.
— ne pas importer —Ignorer cette colonne. Ses valeurs ne sont pas importées.

Le nom de facturation, l'adresse de facturation et le numéro fiscal/TVA ne servent que pour les factures générées par Agon après l'import du client — ils ne changent pas le déroulement de l'import lui-même. Agon **n'**importe pas les factures historiques du client depuis votre ancienne plateforme ; elles restent archivées dans l'ancien système, et la migration ne tente pas de les récupérer. Si un client doit apparaître correctement sur les factures futures (par exemple une société facturée, ou un client dont le pays exige un numéro fiscal/TVA sur la facture), renseignez ces trois champs — sinon, laissez-les de côté.

Renommer plutôt les colonnes de votre fichier​

Renommez votre en-tête enPour
full_nameLe nom du client
emailL'adresse e-mail du client
phoneLe numéro de téléphone du client
date_of_birthLa date de naissance du client
notesNotes libres sur le client
billing_nameLe nom de facturation pour les futures factures de ce client
billing_addressL'adresse de facturation pour les futures factures de ce client
tax_idLe numéro fiscal ou de TVA du client pour ses futures factures

Indiquez les dates de naissance au format YYYY-MM-DD, par exemple 1990-01-15.


Champs abonnement​

Choix proposés lorsque vous importez des Abonnements :

ChoixRôle
E-mail clientL'e-mail du client auquel appartient cet abonnement. Obligatoire — le client doit déjà exister dans Agon (importez d'abord vos clients). Une ligne dont l'e-mail ne correspond à aucun client dans Agon est ignorée.
Type d'abonnementLe nom du type d'abonnement dans Agon (par exemple « Carnet 10 cours »). Obligatoire — associé par nom à un type d'abonnement existant (la casse ne compte pas, l'orthographe si). Si rien ne correspond, la ligne est ignorée — créez d'abord le type d'abonnement dans Agon (Abonnements dans le menu latéral gauche), puis réimportez.
Date de débutQuand l'abonnement commence. Obligatoire. Utilisez YYYY-MM-DD.
Date d'expirationQuand l'abonnement se termine. Facultative. Utilisez YYYY-MM-DD. Une date déjà passée est quand même importée — comme abonnement au statut expiré, et non écartée, pour préserver votre historique.
Crédits restantsLe nombre de crédits restants sur l'abonnement. Facultatif, nombres entiers uniquement.
— ne pas importer —Ignorer cette colonne.

Renommer plutôt les colonnes de votre fichier​

Renommez votre en-tête enPour
client_emailL'adresse e-mail du client
membership_type_nameLe nom du type d'abonnement dans Agon
starts_atLa date de début de l'abonnement
expires_atLa date d'expiration de l'abonnement
credits_remainingLes crédits restants sur l'abonnement

Champs cours​

Choix proposés lorsque vous importez des Cours :

ChoixRôle
Nom du coursLe nom du cours (par exemple « Yoga Flow »). Obligatoire. Associé par nom à un type de cours existant dans Agon — à la différence des types d'abonnement, si rien ne correspond, Agon crée automatiquement un nouveau type de cours à partir de l'heure de début/fin (pour sa durée) et de la capacité de cette ligne comme valeurs par défaut, plutôt que d'ignorer la ligne. C'est volontaire : une première migration correspond généralement à l'arrivée pour la première fois de tout le catalogue de cours du studio.
Date de débutQuand le cours commence. Obligatoire. Utilisez YYYY-MM-DD HH:MM:SS. Une heure de début qui n'est pas strictement dans le futur est ignorée — seuls les cours à venir sont importés.
Date de finQuand le cours se termine. Obligatoire. Utilisez YYYY-MM-DD HH:MM:SS.
CapacitéNombre maximal de clients pouvant réserver. Facultatif, nombres entiers uniquement. Par défaut 1 si laissé vide.
Nom de l'instructeurLe nom de l'instructeur. Facultatif. Associé par nom à un instructeur existant dans Agon. À la différence des champs ci-dessus, l'absence de correspondance **n'**ignore pas la ligne — le cours est quand même importé sans instructeur, et vous en affectez un manuellement par la suite depuis l'écran de modification du cours lui-même.
— ne pas importer —Ignorer cette colonne.

Renommer plutôt les colonnes de votre fichier​

Renommez votre en-tête enPour
class_nameLe nom du cours
starts_atLa date et l'heure de début du cours
ends_atLa date et l'heure de fin du cours
capacityLe nombre maximal de réservations
instructor_nameLe nom de l'instructeur

Colonnes qu'Agon n'a pas pu associer​

Une colonne qu'Agon n'a pas pu placer affiche un badge non associée dans le tableau.

Une colonne laissée en non associée est ignorée : ses données ne sont pas importées. C'est le bon résultat pour les colonnes pour lesquelles Agon n'a pas de champ, comme les identifiants internes ou les tags. (Lors d'un import de Clients, une colonne « Notes » n'a pas besoin de rester non associée — associez-la au champ Notes ci-dessus si vous voulez qu'elle soit importée.)

Si une colonne non associée devrait être importée, ouvrez son menu déroulant et choisissez le bon champ dans la liste de l'entité que vous importez.


Corriger une association​

  1. Repérez la ligne dans le tableau Vérifier la correspondance des colonnes.
  2. Ouvrez le menu déroulant de la colonne Champ Agon.
  3. Choisissez le bon champ, ou — ne pas importer — pour ignorer la colonne.
  4. Répétez pour chaque ligne erronée.
  5. Cliquez sur Confirmer l'import lorsque l'ensemble du tableau est correct.

Les en-têtes qui correspondent aux noms des champs d'Agon (voir les tableaux de renommage ci-dessus, un par entité) sont associés directement, le tableau revient donc correct. Après le renommage, enregistrez le fichier et relancez Analyser le fichier.


Que faire si quelque chose ne fonctionne pas ?​

Une colonne a été associée au mauvais champ Utilisez le menu déroulant Champ Agon sur cette ligne pour choisir le bon. L'association automatique n'est qu'une suggestion, et les noms d'en-tête inhabituels sont faciles à se tromper.

Une colonne dont j'ai besoin affiche « non associée » Ouvrez son menu déroulant et choisissez le champ auquel elle appartient. Les colonnes non associées sont ignorées : rien de cette colonne n'est importé tant que vous ne l'associez pas.

Deux de mes colonnes contiennent le même type de données Une seule colonne peut alimenter chaque champ Agon. Associez la meilleure et réglez l'autre sur — ne pas importer —, ou fusionnez-les dans votre tableur avant l'import.

Mon fichier comporte plusieurs lignes d'en-tête, ou des cellules fusionnées Agon attend une seule ligne d'en-tête suivie d'une ligne par enregistrement. Aplatissez les cellules fusionnées et supprimez les lignes d'en-tête supplémentaires dans votre tableur, puis réimportez.

Ma colonne « Type d'abonnement » revient toujours non associée, ou le type n'est pas trouvé Le champ Type d'abonnement ne fait qu'associer un type d'abonnement existant par nom — il n'en crée jamais. Vérifiez que le nom dans votre fichier correspond exactement à un type d'abonnement déjà configuré dans Agon (Abonnements dans le menu latéral gauche), puis relancez Analyser le fichier. C'est différent de Nom du cours ci-dessous, qui crée automatiquement un type de cours lorsque rien ne correspond.

Une ligne de cours a créé un type de cours que je n'attendais pas C'est le comportement attendu pour Nom du cours : si le nom ne correspond à aucun type de cours existant dans Agon, un nouveau est créé automatiquement à partir de l'heure de début/fin et de la capacité de cette ligne, plutôt que d'ignorer la ligne. Renommez ou fusionnez les noms de types de cours dupliqués dans votre fichier source avant l'import si vous voulez qu'ils fusionnent en un seul type de cours dans Agon.

« Nom de l'instructeur » ne semble pas avoir d'importance Il est facultatif et ne fait jamais ignorer une ligne de cours. S'il ne correspond pas exactement au nom d'un instructeur dans Agon, le cours est quand même importé sans instructeur — affectez-en un manuellement par la suite.

Pages associées​