Anleitung zur Spaltenzuordnung
Nach dem Lesen dieser Seite kannst du die Tabelle Spaltenzuordnung prüfen in Einstellungen → Migration lesen, verstehen, welche deiner Spalten Agon zugeordnet hat, eine falsche Zuordnung korrigieren und mit Spalten umgehen, die Agon nicht einordnen konnte – für Kunden, Mitgliedschaften und Kurse.
Dies ist eine Ergänzung zur Migrationsübersicht – beginne dort für den vollständigen Importablauf.
So ordnet Agon deine Spalten zu
Bevor du hochlädst, wählst du aus, was du importierst – Kunden, Mitgliedschaften oder Kurse – unter Was importierst du?. Diese Wahl entscheidet, welchem Satz von Agon-Feldern deine Spalten zugeordnet werden können; jede Entität hat ihre eigene Feldliste, die in ihrem eigenen Abschnitt unten behandelt wird.
Wenn du auf Datei analysieren klickst, betrachtet Agon jede Spaltenüberschrift in deiner Datei und versucht, sie an einem der Felder der gewählten Entität auszurichten. Überschriften, die offensichtlich zu einem Feldnamen passen (zum Beispiel email, Email, email_address), werden direkt zugeordnet; die übrigen werden durch Interpretation des Überschriftentexts zugeordnet (und bei textreichen Spalten auch anhand einiger Werte der Spalte selbst, um zum Beispiel „Type" von „Plan" zu unterscheiden). Die Tabelle zeigt dir dann, was sie entschieden hat, mit der Meldung „Wir haben jede Spalte deiner Datei einem Agon-Feld zugeordnet".
An diesem Punkt wird nichts importiert. Die Zuordnung ist nur ein Ausgangsvorschlag, den du prüfst und anpasst, bevor du bestätigst.
Kundenfelder
Jede Zeile der Zuordnungstabelle hat ein Dropdown Agon-Feld mit diesen Optionen, wenn du Kunden importierst:
| Option | Wirkung |
|---|---|
| Vollständiger Name | Der Name des Kunden. Wenn hier keine Spalte zugeordnet ist, wird die E-Mail des Kunden als Name verwendet. |
| Die E-Mail-Adresse des Kunden. Erforderlich – eine Zeile ohne E-Mail wird übersprungen. Wenn die E-Mail bereits zu einem Kunden in Agon gehört, wird die Zeile übersprungen, statt diesen Kunden zu überschreiben. | |
| Telefon | Die Telefonnummer des Kunden. Optional. |
| Geburtsdatum | Das Geburtsdatum des Kunden. Optional. Verwende YYYY-MM-DD. |
| Notizen | Freitextnotizen zum Kunden. Optional. |
| Rechnungsname | Der Name, der künftig auf den Rechnungen dieses Kunden stehen soll, falls abweichend vom vollständigen Namen – zum Beispiel ein Firmenname. Optional. |
| Rechnungsadresse | Die Adresse, die künftig auf den Rechnungen dieses Kunden stehen soll. Optional. |
| Steuernummer / USt-IdNr. | Die Steuernummer bzw. USt-IdNr. des Kunden, für seine künftigen Rechnungen. Optional. |
| — nicht importieren — | Diese Spalte ignorieren. Ihre Werte werden nicht importiert. |
Rechnungsname, Rechnungsadresse und Steuernummer/USt-IdNr. werden nur für Rechnungen verwendet, die Agon nach dem Import des Kunden erstellt – sie ändern nichts am Ablauf des Imports selbst. Agon importiert keine historischen Rechnungen des Kunden aus deiner alten Plattform; die bleiben im alten System archiviert, und die Migration versucht nicht, sie zu übernehmen. Wenn ein Kunde auf künftigen Rechnungen korrekt erscheinen muss (zum Beispiel eine zu berechnende Firma, oder ein Kunde, dessen Land eine Steuernummer/USt-IdNr. auf der Rechnung erfordert), fülle diese drei Felder aus – andernfalls lass sie weg.
Stattdessen die Spalten in deiner Datei umbenennen
| Benenne deine Überschrift um in | Für |
|---|---|
full_name | Der Name des Kunden |
email | Die E-Mail-Adresse des Kunden |
phone | Die Telefonnummer des Kunden |
date_of_birth | Das Geburtsdatum des Kunden |
notes | Freitextnotizen zum Kunden |
billing_name | Der Rechnungsname für künftige Rechnungen dieses Kunden |
billing_address | Die Rechnungsadresse für künftige Rechnungen dieses Kunden |
tax_id | Die Steuernummer bzw. USt-IdNr. des Kunden für seine künftigen Rechnungen |
Gib Geburtsdaten im Format YYYY-MM-DD an, zum Beispiel 1990-01-15.
Mitgliedschaftsfelder
Angebotene Optionen beim Import von Mitgliedschaften:
| Option | Wirkung |
|---|---|
| Kunden-E-Mail | Die E-Mail des Kunden, zu dem diese Mitgliedschaft gehört. Erforderlich – der Kunde muss bereits in Agon existieren (importiere zuerst deine Kunden). Eine Zeile, deren E-Mail zu keinem Kunden in Agon passt, wird übersprungen. |
| Mitgliedschaftstyp | Der Name des Mitgliedschaftstyps in Agon (zum Beispiel „10er-Kurspaket"). Erforderlich – wird über den Namen einem existierenden Mitgliedschaftstyp zugeordnet (Groß-/Kleinschreibung spielt keine Rolle, die Schreibweise aber schon). Passt nichts, wird die Zeile übersprungen – erstelle zuerst den Mitgliedschaftstyp in Agon (Mitgliedschaften in der linken Seitenleiste) und importiere dann erneut. |
| Beginn | Wann die Mitgliedschaft beginnt. Erforderlich. Verwende YYYY-MM-DD. |
| Ablauf | Wann die Mitgliedschaft endet. Optional. Verwende YYYY-MM-DD. Ein bereits vergangenes Datum wird trotzdem importiert – als Mitgliedschaft mit Status abgelaufen, nicht verworfen, damit dein historischer Datensatz erhalten bleibt. |
| Verbleibende Credits | Die Anzahl der auf der Mitgliedschaft verbleibenden Credits. Optional, nur ganze Zahlen. |
| — nicht importieren — | Diese Spalte ignorieren. |
Stattdessen die Spalten in deiner Datei umbenennen
| Benenne deine Überschrift um in | Für |
|---|---|
client_email | Die E-Mail-Adresse des Kunden |
membership_type_name | Der Name des Mitgliedschaftstyps in Agon |
starts_at | Das Startdatum der Mitgliedschaft |
expires_at | Das Ablaufdatum der Mitgliedschaft |
credits_remaining | Die auf der Mitgliedschaft verbleibenden Credits |
Kursfelder
Angebotene Optionen beim Import von Kursen:
| Option | Wirkung |
|---|---|
| Kursname | Der Name des Kurses (zum Beispiel „Yoga Flow"). Erforderlich. Wird über den Namen einem existierenden Kurstyp in Agon zugeordnet – anders als bei Mitgliedschaftstypen erstellt Agon automatisch einen neuen Kurstyp, wenn nichts passt, und verwendet dabei Start-/Endzeit (für die Dauer) und Kapazität dieser Zeile als Standardwerte, statt die Zeile zu überspringen. Das ist beabsichtigt: Eine erste Migration ist meist der erstmalige Import des gesamten Kurskatalogs des Studios. |
| Beginn | Wann der Kurs beginnt. Erforderlich. Verwende YYYY-MM-DD HH:MM:SS. Eine Startzeit, die nicht eindeutig in der Zukunft liegt, wird übersprungen – es werden nur anstehende Kurse importiert. |
| Ende | Wann der Kurs endet. Erforderlich. Verwende YYYY-MM-DD HH:MM:SS. |
| Kapazität | Maximale Anzahl von Kunden, die buchen können. Optional, nur ganze Zahlen. Standardmäßig 1, wenn leer gelassen. |
| Name des Kursleiters | Der Name des Kursleiters. Optional. Wird über den Namen einem existierenden Kursleiter in Agon zugeordnet. Anders als bei den obigen Feldern führt keine Übereinstimmung nicht dazu, dass die Zeile übersprungen wird – der Kurs wird trotzdem ohne Kursleiter importiert, und du weist anschließend manuell einen über den eigenen Bearbeitungsbildschirm des Kurses zu. |
| — nicht importieren — | Diese Spalte ignorieren. |
Stattdessen die Spalten in deiner Datei umbenennen
| Benenne deine Überschrift um in | Für |
|---|---|
class_name | Der Name des Kurses |
starts_at | Datum und Uhrzeit des Kursbeginns |
ends_at | Datum und Uhrzeit des Kursendes |
capacity | Maximale Anzahl Buchungen |
instructor_name | Der Name des Kursleiters |
Spalten, die Agon nicht zuordnen konnte
Eine Spalte, die Agon nicht einordnen konnte, zeigt in der Tabelle ein Badge nicht zugeordnet.
Eine Spalte, die als nicht zugeordnet belassen wird, wird übersprungen – ihre Daten werden nicht importiert. Das ist das richtige Ergebnis für Spalten, für die Agon kein Feld hat, etwa interne Datensatz-IDs oder Tags. (Beim Import von Kunden muss eine Spalte „Notes" nicht unbedingt unzugeordnet bleiben – ordne sie oben dem Feld Notizen zu, wenn sie importiert werden soll.)
Wenn eine nicht zugeordnete Spalte importiert werden soll, öffne ihr Dropdown und wähle das richtige Feld aus der Liste für die Entität, die du importierst.
Eine Zuordnung korrigieren
- Finde die Zeile in der Tabelle Spaltenzuordnung prüfen.
- Öffne das Dropdown in der Spalte Agon-Feld.
- Wähle das richtige Feld oder — nicht importieren —, um die Spalte zu überspringen.
- Wiederhole dies für jede falsche Zeile.
- Klicke auf Import bestätigen, wenn die gesamte Tabelle stimmt.
Überschriften, die den eigenen Feldnamen von Agon entsprechen (siehe die Umbenennungstabellen oben, eine je Entität), werden direkt zugeordnet, sodass die Tabelle korrekt zurückkommt. Speichere die Datei nach dem Umbenennen und führe Datei analysieren erneut aus.
Was tun, wenn etwas schiefgeht?
Eine Spalte wurde dem falschen Feld zugeordnet Nutze das Dropdown Agon-Feld in dieser Zeile, um das richtige zu wählen. Die automatische Zuordnung ist nur ein Vorschlag, und bei ungewöhnlichen Überschriftennamen ist ein Fehler leicht möglich.
Eine Spalte, die ich brauche, zeigt „nicht zugeordnet" Öffne ihr Dropdown und wähle das Feld, zu dem sie gehört. Nicht zugeordnete Spalten werden übersprungen, sodass nichts aus dieser Spalte importiert wird, bis du sie zuordnest.
Zwei meiner Spalten enthalten die gleiche Art von Daten Jedem Agon-Feld kann nur eine Spalte zugeführt werden. Ordne die bessere zu und stelle die andere auf — nicht importieren —, oder führe sie vor dem Hochladen in deiner Tabelle zusammen.
Meine Datei hat mehr als eine Kopfzeile oder verbundene Zellen Agon erwartet eine einzelne Kopfzeile, gefolgt von einer Zeile pro Datensatz. Löse verbundene Zellen auf und entferne zusätzliche Kopfzeilen in deiner Tabelle, dann lade sie erneut hoch.
Meine Spalte „Mitgliedschaftstyp" kommt immer wieder als nicht zugeordnet zurück, oder der Typ wird nicht gefunden Das Feld Mitgliedschaftstyp ordnet nur einen existierenden Mitgliedschaftstyp über den Namen zu – es erstellt nie einen. Prüfe, ob der Name in deiner Datei exakt einem bereits in Agon eingerichteten Mitgliedschaftstyp entspricht (Mitgliedschaften in der linken Seitenleiste), und führe dann Datei analysieren erneut aus. Das unterscheidet sich von Kursname unten, das automatisch einen neuen Kurstyp erstellt, wenn nichts passt.
Eine Kurszeile hat einen Kurstyp erstellt, den ich nicht erwartet habe Das ist bei Kursname so vorgesehen: Wenn der Name zu keinem existierenden Kurstyp in Agon passt, wird automatisch ein neuer aus Start-/Endzeit und Kapazität dieser Zeile erstellt, statt die Zeile zu überspringen. Benenne doppelte Kurstypnamen in deiner Quelldatei um oder führe sie zusammen, bevor du importierst, wenn sie in Agon zu einem Kurstyp zusammenfallen sollen.
„Name des Kursleiters" scheint keine Rolle zu spielen Es ist optional und führt nie dazu, dass eine Kurszeile übersprungen wird. Passt es nicht exakt zum Namen eines Kursleiters in Agon, wird der Kurs trotzdem ohne Kursleiter importiert – weise anschließend manuell einen zu.