Zum Inhalt springen
Developer

Ein Feld bei vielen Konten ändern

Setzt in einer Liste ein einzelnes Feld eines Abrechnungskontos, zum Beispiel den Firmennamen oder einen Fixpreis-Zusatz, für viele Konten auf einmal.

Format
CSV (Komma oder Semikolon), UTF-8
Rechte
Administrator, Kontakte (CRM) schreiben
Beispieldatei
konten-feld-beispiel_technisch.csv (herunterladen)

Kurz gesagt: Ihr schreibt pro Zeile ein Abrechnungskonto, den Namen des Feldes und den neuen Wert. So ändert ihr etwa bei vielen Konten gleichzeitig den Firmennamen oder einen Fixpreis.

Wofür ihr das braucht

Wenn sich eine Angabe bei vielen Konten gleichzeitig ändert, zum Beispiel nach einer Preiserhöhung oder einer Umbenennung, ist diese Datei schneller als Handarbeit.

Bevor ihr startet

  • Rechte: Ihr braucht das Zugriffsrecht Importe und seid Administrator mit Schreibrecht für Kontakte (CRM).
  • Kontonummer: Die Spalte ACCOUNT_IDENTIFIER braucht die Kontonummer, wie sie in vynst steht (zum Beispiel K-1001), oder die Importierte ID des Kontos (zum Beispiel AFS_CSV_K-1001), oder den Kurznamen. Eine reine Zahl wie 1001 versteht vynst als interne Datensatznummer. Prüft eine Testzeile zuerst an einem Konto, das ihr kennt.
  • Sicherung: Zieht vor größeren Änderungen einen Export eurer Konten.

Datei vorbereiten

  • Dateiname: Frei wählbar, er muss .csv enden. Erkannt wird die Datei an der Kopfzeile.
  • Kopfzeile: ACCOUNT_IDENTIFIER;UPDATE_SINGLE_FIELD_NAME;FIELD_VALUE. Mit Komma statt Semikolon geht ebenfalls. Statt ACCOUNT_IDENTIFIER ist auch COMPANY_IDENTIFIER möglich.
  • Pro Zeile: ein Konto, ein Feld, ein Wert.

Spalten

Spalte Pflicht Inhalt
ACCOUNT_IDENTIFIER (oder COMPANY_IDENTIFIER) ja Kontonummer, Importierte ID oder Kurzname, siehe oben
UPDATE_SINGLE_FIELD_NAME ja Name des Feldes, siehe Tabelle unten. Eine leere Zelle wird übersprungen.
FIELD_VALUE ja Neuer Wert. Eine leere Zelle wird übersprungen.

Felder:

Feld Schreibweisen in UPDATE_SINGLE_FIELD_NAME Wert
Firmenname Firmenname, COMPANY_NAME, NAME, name, companyName Text
Fixpreis-Zusatz 1 FIXED_PRICE_ADDON_ONE Betrag, zum Beispiel 12.50 oder 1.234,56
Fixpreis-Zusatz 2 FIXED_PRICE_ADDON_TWO Betrag, zum Beispiel 12.50 oder 1.234,56
Anzahl verknüpfter Personen LINKED_PERSON_COUNT ganze Zahl

Sonderwerte:

Wert Wirkung
SET_IW_EMPTY Das Feld wird auf einen leeren Text gesetzt.
SET_IW_NULL Das Feld wird geleert.
ADDON_DATA plus Feldname, zum Beispiel ADDON_DATAmeinFeld Der Wert wird aus dem Zusatzfeld meinFeld des Kontos übernommen. Bei Fixpreis-Zusätzen wird der bisherige Betrag zuvor im Zusatzfeld lastFixedPriceAddonOne beziehungsweise lastFixedPriceAddonTwo gesichert.

Beispiel (Inhalt der Beispieldatei, die Feldnamen stehen in der Spalte UPDATE_SINGLE_FIELD_NAME):

ACCOUNT_IDENTIFIER;UPDATE_SINGLE_FIELD_NAME;FIELD_VALUE
AFS_CSV_K-1001;COMPANY_NAME;Familie Hartmann
AFS_CSV_K-1003;FIXED_PRICE_ADDON_ONE;12.50
AFS_CSV_K-1003;FIXED_PRICE_ADDON_TWO;7.50
AFS_CSV_K-1001;LINKED_PERSON_COUNT;2

Beispieldatei: konten-feld-beispiel_technisch.csv

So geht’s

  1. Öffnet Einstellungen → Import.
  2. Klickt auf Hinzufügen und wählt die Datei aus.
  3. Wartet, bis der Eintrag grün oder rot ist.
  4. Prüft das Protokoll auf Zeilen mit Error:.

Gut zu wissen

  • Sofort wirksam: Es gibt keine Vorschau. Die Änderungen gelten mit dem Import.
  • Leere Werte: Eine leere Zelle in FIELD_VALUE oder UPDATE_SINGLE_FIELD_NAME überspringt vynst ohne Meldung. Zum Leeren eines Feldes schreibt SET_IW_EMPTY oder SET_IW_NULL.
  • Mehrere Zeilen für dasselbe Konto: Sie werden nacheinander angewendet. Die letzte Zeile gewinnt.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing ACCOUNT_IDENTIFIER / COMPANY_IDENTIFIER Die Kontonummer fehlt. Die Zeile steht danach als LINE-DATA. Ergänzen und nur diese Zeile erneut importieren.
Error: account / company not found Das Konto ist mit dieser Angabe nicht zu finden. Die Zeile steht danach als LINE-DATA. Kontonummer prüfen, nur diese Zeile erneut importieren.
Error: unknown field to update Der Feldname ist unbekannt. Die Zeile steht danach als LINE-DATA. Feldnamen aus der Tabelle verwenden.
Read: N rows So viele Zeilen wurden gelesen. Nichts tun.
Info: split into N files Die Datei wurde in Pakete zu je 500 Zeilen aufgeteilt. Nichts tun.
Error: less then one line Die Datei enthält keine Datenzeilen. Datei und Kopfzeile prüfen.

Siehe auch