[[:start| zurück zum Hauptmenü]]\\

====== Addon Textbausteine ======

Mit diesem AddOn können aus FAS fertige Serienbriefe erstellt werden, die bereits mit einer Datenquelle verknüpft sind.

Bei Aktivierung des AddOns wird im FAS ein zusätzlicher Menüpunkt //Textbausteine// angezeigt.
Im FAS können Studierende, MitarbeiterInnen oder Verbände gewählt und danach Serienbriefe für die ausgewählten Bereiche erstellt werden. Die Serienbriefe werden als Download angeboten und sind bereits mit einer Datenquelle verknüpft, welche die entsprechenden Daten enthält. Dieser kann anschließend gedruckt oder in Form einer Serien-E-Mail verwendet werden..\\
Textbausteine können derzeit nur im .docx Format erstellt werden.
===== Installation =====
Es muss ein Verzeichnis erstellt werden in dem die generierten CSV Dateien abgelegt werden.
Dieses Verzeichnis muss über das Web erreichbar sein:
<code>
mkdir /var/www/textbausteine
echo "" > /var/www/textbausteine/index.html
</code>

Damit die CSV Dateien korrekt erstellt werden können muss der Apache User Schreibrechte auf das Verzeichnis haben:
<code>
chown www-data /var/www/textbausteine
</code>

===== Erstellen eines Textbausteins =====

  * Erstellen des Serienbriefs im MS Word
  * Verknüpfen des Serienbriefs mit einem CSV File das Testdaten enthält, die später dynamisch generiert werden sollen
  * Der fertige Serienbrief wird wird abgespeichert und am Server im Verzeichnis für die Textbausteine abgelegt. (zB: /var/fhcomplete/vorlagen)
  * Anlegen des Textbausteins: (Derzeit nur über DB)
    * **SQL:** SQL Befehl der die Daten für das CSV importiert. \\ Jede Spalte im SQL ist eine Spalte im CSV. Es können Variablen verwendet werden, um die Daten auf die Auswahl im FAS einzuschränken. zB <code>SELECT vorname, nachname FROM public.tbl_prestudent JOIN public.tbl_person USING(person_id) WHERE prestudent_id in($prestudent_id)</code>
    * **pfad:** Absoluter Pfad zum Serienbrief \\ (z.B. /var/fhcomplete/vorlagen/brief1.docx) \\ Der Dateiname darf keine Leerzeichen oder Sonderzeichen enthalten.
    * **name:** Dateiname des erstellten Serienbriefs (z.B. Einladung.docx)
    * **gruppe:** Freitext zur Gruppierung im Menü (z.B. Studierende) \\ In diesem Fall wird im Menüpunkt //Textbausteine// ein Submenü //Studierende// angezeigt.
    * **bezeichnung:** Name des Menüpunkts im FAS

===== Variablen für Textbausteine =====

In den SQL Befehlen können folgende Variablen verwendet werden
  * **$prestudent_id** - Prestudent ID des markierten Studenten/Interessenten oder mehrere IDs falls mehrere markiert wurden
  * **$uid** - UID des markierten Mitarbeiters oder mehrere UIDs falls mehrere markiert wurden
  * **$studiengang_kz** - Studiengangskennzahl des Verbands der im Verbandsbaum markiert wurde
  * **$semester** - Semester des Verbands der im Verbandsbaum markiert wurde
  * **$studiensemester_kurzbz** - aktuell ausgewähltes Studiensemester


{{:icon_idee.png?25 |}} Wenn in FAS die **Registerkarte //Studierende//** ausgewählt ist, wird die **prestudent_id** übetragen; wenn die **Registerkarte //Mitarbeiter//** ausgewählt ist, die **UID**. Es wird **nicht beides gleichzeitig** übermittelt.