panelAdd()

bool panelAdd(array Daten, string Duplikate)

Die Funktion panelAdd() erstellt einen neuen Eintrag in der Adressliste, der anschließend für den Versand von Serienmails verwendet werden kann.

Hinweis: Wenn sich Teilnehmer:innen für den Adressverteiler anmelden sollen, dann ist der Fragetyp Opt-In für E-Mail-Verteiler in aller Regel besser geeignet als panelAdd().

• Daten
  Ein Array, welche die folgenden Schlüssel erlaubt:
  • 'email' / 'EMAIL' – E-Mail-Adresse
  • 'email.cc' / 'CC' – E-Mail CC
  • 'mobile' / 'PHONE' – Mobilrufnummer mit Vorwahl, z.B. +4916300000000
  • 'uid' – Eindeutige Kennung
  • 'username' / 'USERNAME' – Benutzername (für einen Login)
  • 'password' / 'PASS' – Passwort (für einen Login)
  • 'firstname' / 'FRSTNAME' – Vorname
  • 'lastname' / 'LASTNAME' – Nachname/Familienname
  • 'sex' / 'GENDER' – Geschlecht (m/w/Herr/Frau)
  • 'title' / 'TITLE' – Akademischer Titel
  • 'salutation' / 'ALTSALUT' – Vollständige Anrede (anstatt einer automatisch erzeugten Anrede)
  • 'language' / 'LANG' – Sprache (3-stelliges Sprachkürzel)
  • 'serial' / 'SERIAL' – Personenkennung (SERIAL)
  • 'subgroup' / 'SUBGROUP' – Teilgruppe
  • 'custom1' / 'CUSTOM1' – Benutzerdefiniertes Feld 1
  • 'custom2' / 'CUSTOM2' – Benutzerdefiniertes Feld 2
  • 'custom3' / 'CUSTOM3' – Benutzerdefiniertes Feld 3
  • 'custom4' / 'CUSTOM4' – Benutzerdefiniertes Feld 4
  • 'custom5' / 'CUSTOM5' – Benutzerdefiniertes Feld 5
  • 'privacy' / 'PRIVACY' – Datenschutzmodus
    • 'id' – personenbezogen
    • 'ps' – pseudonym
    • 'af' – anonymisieren beim Abschluss des Interviews
    • 'as' – anonym
  • 'expire' / 'VALID' – Ablaufdatum, automatische Löschung nach diesem Zeitpunkt (Unix-Zeitstempel)
• Duplikate
  Umgang mit doppelten Adresseinträgen, das heißt, mit existierenden Einträgen, welche dieselbe E-Mail-Adresse, Mobilnummer, Kennung (UID) oder denselben Benutzernamen haben.
  • 'import' – Adresseintrage unabhängig von existierenden Einträgen erstellen.
  • 'update' – Einen eventuell vorhandenen Adresseintrag mit den neuen Daten ergänzen.

Die Funktion gibt true zurück, wenn der Eintrag erstellt oder aktualisiert werden konnte, sonst false.