====== E-Mail-Verteiler herunterladen ======

Die Empfängerliste für den Serienmail-Versand kann man unter **Einladungen verschicken** -> **Adressliste** → //E-Mail-Verteiler herunterladen// als CSV-Datei herunterladen. CSV-Dateien kann man in allen gängigen Anwendungen zur Datenverarbeitung oder Tabellenkalkuation (z.B. Excel, OpenOffice Calc, SPSS, ...) öffnen. Die Datei ist Unicode-formatiert.

===== Datenspalten in der Datei =====

In der Datei sind stets alle folgenden Spalten enthalten -- unabhängig davon, ob die Einträge entsprechende Angaben enthalten.

Eine evtl. zugeteilte Personenkennung wird in der Liste __nicht__ vermerkt, weil die erhobenen Daten sonst nicht mehr anonym wären.

  * **EMAIL** Die E-Mail-Adresse des Empfängers
  * **PHONE** Mobiltelefon-Nummer
  * **FRSTNAME** Vorname
  * **LASTNAME** Nachname
  * **GENDER** Geschlecht des Empfängers (zur Bestimmung der Anrede)
    * **1** männlich
    * **2** weiblich
    * **-1** nicht eingetragen
  * **TITLE** Titel (z.B. akademischer Titel)
  * **ALTSALUT** Alternative Anrede (z.B. "Sehr geehrte Frau Dr. Müller"). Wird die alternative Anrede spezifiziert, so wird die Anrede im Anschreiben nicht automatisch aus Name, Titel und Geschlecht erstellt.
  * **SERIAL** Personenkennung des Teilnehmers (nur enthalten, wenn der Adressat nicht anonym importiert wurde)
  * **SUBGROUP** Teilgruppe, welcher der Empfänger zugeordnet wurde
  * **STATUS //<n>//** Teilnahmestatus für die Serienmail mit der ID //<n>//
    * **0** Der Empfänger hat noch keine E-Mail erhalten und es wurde ihm auch keine Personenkennung zugewiesen
    * **1** Der Empfänger hat den Link zum Fragebogen noch nicht angeklickt
    * **2** Der Empfänger hat den Fragebogen besucht
    * **3** Der Empfänger hat den Fragebogen bis zum Ende ausgefüllt. Dieser Code ist nur verfügbar, wenn für den Fragebogen der Zugriffsmodus "Serienmail" spezifiziert wurde. Im Modus "Teilnahmecode" wird auch bei vollständig ausgefülltem Fragebogen der Code 2 beibehalten.
    * **-1** Die E-Mail-Adresse wurde serverweit für den Empfang von Serienmails gesperrt (Robinson-Listing)
    * **-2** Beim Versand der E-Mail trat ein Fehler auf, die E-Mail wurde mit einer Fehlermeldung abgewiesen (z.B. ungültige E-Mail-Adresse o.ä.)
  * **SENDDATE //<n>//** Datum, an dem sie Serienmail mit der ID //<n>// an den Teilnehmer verschickt wurde\\ Der Versandzeitpunkt wird im JMT-Format (Jahr-Monat-Tag) angegeben.


===== Datenimport in R =====

SoSci Survey liefert beim Download der Adressliste eine CSV-Datei, welche für Excel optimiert ist (Kodierung UTF-16 Lower Endian). Um die CSV-Datei in R einzulesen, muss das ''fileEncoding'' entsprechend angegeben werden:

<code R>
addresses = read.csv("panel.csv", sep="\t", quote = "\"", fileEncoding  = "UTF16LE")
</code>

Falls man diese Kodierung weglässt, erhält man folgenden Fehler:

<code>
Error in make.names(col.names, unique = TRUE) : 
  invalid multibyte string at '<ff><fe>
</code>