====== 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 [[:de:create:questions:opt-in]] 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.


===== Rückgabewert =====

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