Zum Hauptinhalt springen

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:

OptionWirkung
Vollständiger NameDer Name des Kunden. Wenn hier keine Spalte zugeordnet ist, wird die E-Mail des Kunden als Name verwendet.
E-MailDie 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.
TelefonDie Telefonnummer des Kunden. Optional.
GeburtsdatumDas Geburtsdatum des Kunden. Optional. Verwende YYYY-MM-DD.
NotizenFreitextnotizen zum Kunden. Optional.
RechnungsnameDer Name, der künftig auf den Rechnungen dieses Kunden stehen soll, falls abweichend vom vollständigen Namen – zum Beispiel ein Firmenname. Optional.
RechnungsadresseDie 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 inFür
full_nameDer Name des Kunden
emailDie E-Mail-Adresse des Kunden
phoneDie Telefonnummer des Kunden
date_of_birthDas Geburtsdatum des Kunden
notesFreitextnotizen zum Kunden
billing_nameDer Rechnungsname für künftige Rechnungen dieses Kunden
billing_addressDie Rechnungsadresse für künftige Rechnungen dieses Kunden
tax_idDie 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:

OptionWirkung
Kunden-E-MailDie 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.
MitgliedschaftstypDer 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.
BeginnWann die Mitgliedschaft beginnt. Erforderlich. Verwende YYYY-MM-DD.
AblaufWann 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 CreditsDie 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 inFür
client_emailDie E-Mail-Adresse des Kunden
membership_type_nameDer Name des Mitgliedschaftstyps in Agon
starts_atDas Startdatum der Mitgliedschaft
expires_atDas Ablaufdatum der Mitgliedschaft
credits_remainingDie auf der Mitgliedschaft verbleibenden Credits

Kursfelder​

Angebotene Optionen beim Import von Kursen:

OptionWirkung
KursnameDer 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.
BeginnWann 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.
EndeWann der Kurs endet. Erforderlich. Verwende YYYY-MM-DD HH:MM:SS.
KapazitätMaximale Anzahl von Kunden, die buchen können. Optional, nur ganze Zahlen. Standardmäßig 1, wenn leer gelassen.
Name des KursleitersDer 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 inFür
class_nameDer Name des Kurses
starts_atDatum und Uhrzeit des Kursbeginns
ends_atDatum und Uhrzeit des Kursendes
capacityMaximale Anzahl Buchungen
instructor_nameDer 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​

  1. Finde die Zeile in der Tabelle Spaltenzuordnung prüfen.
  2. Öffne das Dropdown in der Spalte Agon-Feld.
  3. Wähle das richtige Feld oder — nicht importieren —, um die Spalte zu überspringen.
  4. Wiederhole dies für jede falsche Zeile.
  5. 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.

Verwandte Seiten​