Zum Inhalt springen
Developer

Logins freischalten

Legt für Personen ohne Zugang einen Login an und schickt ihnen die Mail zum Festlegen des Passworts.

Format
CSV (Komma oder Semikolon), UTF-8
Rechte
Administrator, Kontakte (CRM) schreiben
Beispieldateien
logins-beispiel_technisch.csv (technische Spaltennamen)
logins-beispiel_anwender.csv (deutsche Spaltennamen)

Kurz gesagt: Ihr nennt pro Zeile eine Person und setzt ja. vynst legt für diese Person einen Login an und schickt ihr eine Mail, mit der sie ihr Passwort festlegt.

Wofür ihr das braucht

Mitglieder oder Kontakte sollen sich selbst im Portal anmelden können. Statt jeden Login einzeln anzulegen, schaltet ihr mit dieser Datei viele Personen auf einmal frei.

Bevor ihr startet

  • Rechte: Ihr braucht das Zugriffsrecht Importe und seid Administrator mit Schreibrecht für Kontakte (CRM).
  • Personen: Die Personen müssen schon in vynst sein. Die Mail geht an die Adresse der Person, deshalb sollte sie eine E-Mail-Adresse hinterlegt haben.
  • Nur ohne Login: Personen, die schon einen Login haben, werden übersprungen. Ihre Zeile bleibt ohne Meldung.
  • Mails: Jede freigeschaltete Person bekommt eine Mail. Versendet die Datei daher nicht mehrfach.
  • Wartezeit: vynst wartet nach jeder Freischaltung 5 Sekunden, damit nicht viele Mails auf einmal gehen. Eine große Liste dauert deshalb lange.
  • Sicherung: Zieht vorher einen Export eurer Personen.

Datei vorbereiten

  • Dateiname: Frei wählbar, er muss .csv enden. Erkannt wird die Datei an der Kopfzeile.

  • Kopfzeile: PERSON_IDENTIFIER,TRIGGER_ACTIVATE_PERSON_LOGIN oder mit dem optionalen Feld RESET_TOKEN_VALID_FOR:

    PERSON_IDENTIFIER,TRIGGER_ACTIVATE_PERSON_LOGIN,RESET_TOKEN_VALID_FOR

    Mit Semikolon statt Komma geht ebenfalls.

  • Trennzeichen: Komma oder Semikolon, in der ganzen Datei gleich.

Spalten

Spalte Pflicht Inhalt Beispiel
Personen ID (PERSON_IDENTIFIER) ja Personennummer mit Präfix, wie sie in vynst steht, oder die Importierte ID der Person. Eine reine Zahl wird als interne Nummer verstanden. M-1001
Freischalten (TRIGGER_ACTIVATE_PERSON_LOGIN) ja ja schaltet frei. nein oder ein anderer Wert schaltet nicht frei. ja
RESET_TOKEN_VALID_FOR nein Wie viele Stunden der Link in der Mail gilt. Ohne Angabe, bei leerer Zelle oder 0 gilt er 336 Stunden (14 Tage). Der Wert muss eine ganze Zahl sein. 96

Beispiel:

PERSON_IDENTIFIER,TRIGGER_ACTIVATE_PERSON_LOGIN,RESET_TOKEN_VALID_FOR
AFS_CSV_1001,ja,96
AFS_CSV_1003,ja,96

Beispieldateien: logins-beispiel_technisch.csv mit den technischen Spaltennamen, logins-beispiel_anwender.csv mit den deutschen Spaltennamen.

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:.
  5. Kontrolliert bei einigen Personen, ob der Login angelegt wurde.

Gut zu wissen

  • Die Mail kommt später: Der Import stellt je Person einen Auftrag ein, den vynst danach abarbeitet. Der Login entsteht dann, und die Mail geht raus. Im Import-Protokoll steht dazu nichts.
  • Fehler bei der Anlage: Scheitert die Anlage im Hintergrund, etwa weil die Person keine E-Mail-Adresse hat, erscheint das nicht im Import-Protokoll. Prüft diese Personen einzeln.
  • Keine Vorschau: Die Datei prüft nicht vorab, ob eine Person eine E-Mail-Adresse hat.
  • Nein heißt nein: Eine Zeile mit nein steht im Protokoll trotzdem als Error: skipped missing TRIGGER_ACTIVATE_PERSON_LOGIN. Das ist eine Übersprung-Meldung und kein Fehler im Wert.
  • Deutsche Kopfzeile: Statt PERSON_IDENTIFIER,TRIGGER_ACTIVATE_PERSON_LOGIN geht auch Personen ID,Freischalten. Die beiden Spalten müssen in dieser Reihenfolge am Anfang stehen.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing PERSON_IDENTIFIER Die Personennummer fehlt. Die Zeile steht danach als LINE-DATA. Ergänzen und nur diese Zeile erneut importieren.
Error: skipped missing TRIGGER_ACTIVATE_PERSON_LOGIN Der Wert ist nicht ja (oder ein anderes Ja). Die Zeile wird übersprungen. Bei nein nichts tun. Bei ja Schreibweise prüfen.
Error: person not found Die Person ist mit dieser Nummer nicht zu finden. Die Zeile steht danach als LINE-DATA. Nummer prüfen und nur diese Zeile erneut importieren.
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