Benutzer-Werkzeuge

Webseiten-Werkzeuge


addons:textbausteine

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:

mkdir /var/www/textbausteine
echo "" > /var/www/textbausteine/index.html

Damit die CSV Dateien korrekt erstellt werden können muss der Apache User Schreibrechte auf das Verzeichnis haben:

chown www-data /var/www/textbausteine

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
      SELECT vorname, nachname FROM public.tbl_prestudent JOIN public.tbl_person USING(person_id) WHERE prestudent_id in($prestudent_id)
    • 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

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.

/var/www/fhcomplete/htdocs/dokuwiki/data/pages/addons/textbausteine.txt · Zuletzt geändert: 2018/06/19 07:55 von pollmann