====== Kandidierende importieren ======

Seit uniWAHL Version 6.5.3 lassen sich Wahlvorschläge über die Funktion des Wahlimports aus einer Transferdatei (XSLX) direkt ins System importieren. Insbesondere bei hohen Kandidierendenzahlen oder wenn alle Wahlvorschläge bereits digital vorliegen, ist dieses Verfahren zu empfehlen, da so eine große Anzahl von Personen sehr schnell per Import hinzugefügt werden kann.

===== - Importiere Wahlddateien =====

Sie importieren eine bereits bestehende Kandidierendenliste im Menü ''Datei / Importiere Wahl''. Hier werden Sie durch einen Assistenten geführt, der das Einlesen der Strukturdaten-Datei (Wahlvorschläge) ermöglicht.
 
{{:handbuch:5_wahlvorschlaege:5-6_kandidatenimport:20260318093815.png?nolink}}
\\ Abb. : Wahldateien auswählen

|Strukturdaten XLSX-Dateipfad|Wählen Sie hier eine Datei aus, die alle Kandidierenden enthält, z.B. den Export einer Nominierung oder selbst erstellte Kandidierendenliste. |
|WHL-Datei         |Wählen Sie hier eine bestehende Wahlvorgangsdatei (Gremien, Gruppen, Wahlordnung, Texte, Layouts etc.), in die die Wahlvorschläge übernommen werden sollen.   |                                                                                                                                          
Klicken Sie auf ''Weiter''.

===== - Datenfelder zuordnen =====

Im nächsten Schritt müssen Sie den Spalten der Importdatei die Schlüsselfelder zuordnen, die für den Import benötigt werden.

{{:handbuch:5_wahlvorschlaege:5-6_kandidatenimport:20260318094913.png?nolink}}
\\ Abb. : Spalten zuordnen

<WRAP center round important>
**Bitte beachten Sie folgende Hinweise:**

Die Spalten **Gremium** (__Langbezeichner__ des Gremiums) und **Wahlbereichskürzel** (__Kurzname__ des Wahlbereich) sind beim Kandidatenimport Pflichtfelder und müssen zugeordnet werden. Diese müssen **__exakt__** den Bezeichnern in uniWAHL entsprechen, da sonst neue Gremien bzw. Gruppen angelegt werden. 

Das Feld **Gruppe** darf **__NICHT__** zugeordnet werden, da dies ausschließlich für den Gremienimport (vgl. [[handbuch:4_vorbereitung:4-1_wahlvorgang_anlegen#oderwahlimport|Wahlimport]]) genutzt wird. 

Das Feld **Wahlbereichskürzel** (__Kurzname__ des Wahlbereich) darf **__NICHT__** als "Gruppe" in der Importdatei benannt sein, da sonst automatisch falsch zugeordnet wird.
</WRAP>

{{:handbuch:5_wahlvorschlaege:5-6_kandidatenimport:20260318095031.png?nolink}}
\\ Abb. : Erforderliche Felder werden angezeigt

<WRAP center round tip>
**Tipp: Weitere Datenfelder** der Personendaten, die ins System übernommen werden sollen, können einfach als **gelesener Bezeichner** ausgewählt werden (Titel, Zusätze). Sie können - müssen aber nicht - links benannt werden.
</WRAP>

===== - Import abschließen =====

Zuletzt werden die in der Datei erkannten Wahlbereiche angezeigt. In der Tabelle lässt sich kontrollieren, ob - durch fehlerhafte / doppelte Bezeichner - weitere Gruppen angelegt werden und der Import durch Klick auf ''Weiter'' abschließen. 

{{:handbuch:5_wahlvorschlaege:5-6_kandidatenimport:20260318095548.png?nolink}}
\\ Abb. : Importierte Wahlbereiche / Gruppen inklusive weiterer Daten zur Nachkontrolle

===== - Datenübernahme kontrollieren =====

Es wird ein neues Wahlprojekt geöffnet. Die erzeugten Strukturen müssen nun geprüft (z.B. via [[faq:2_benutzerhinweise#wie_kann_ich_die_wahldaten_exportieren|Export]]) und ggf. bereinigt werden (Kontextmenü im Navigationsfeld). Alle Wahlbereiche, in denen Kandidierende enthalten waren, werden direkt auf Status 3 "**Kandidateneingabe fertig**" gesetzt (eventuell müssen Gruppen [[handbuch:8_funktionen:8-1_status_zuruecksetzen|zurückgesetzt]] werden).

{{:handbuch:5_wahlvorschlaege:5-6_kandidatenimport:20260318095754.png?nolink}}
\\ Abb. : Wahlprojektdatei