Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- addons:textbausteine [2015/10/13 18:35]
oesi angelegt
+++ addons:textbausteine [2019/08/13 13:48] (aktuell)
@@ Zeile 1: / Zeile 1: @@
+[[:start| zurück zum Hauptmenü]]\\
 ====== Addon Textbausteine ======
-Mit diesem Addon können aus dem FAS fertige Serienbriefe erstellt werden die bereits mit einer Datenquelle verknüpft sind.
+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.
+Bei Aktivierung des AddOns wird im FAS ein zusätzlicher Menüpunkt //Textbausteine// angezeigt.
-Im FAS können Studierende, Mitarbeiter oder Verbände gewählt werden 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 die die entsprechenden Daten enthält.
+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..\\
-Der Serienbrief kann dann verwendet werden um den Serienbrief zu drucken oder Serienmails zu versenden.\\
 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 Word
+  * 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
+  * 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 holt. 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>
+    * **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 zB /var/fhcomplete/vorlagen/brief1.docx\\Der Dateiname darf keine Leerzeichen oder Sonderzeichen enthalten
+    * **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 zB Einladung.docx
+    * **name:** Dateiname des erstellten Serienbriefs (z.B. Einladung.docx)
-    * **gruppe:** Freitext zur Gruppierung im Menü. zB Studierende. In diesem Fall wird im Menüpunkt Textbausteine ein Submenü Studierende angezeigt
+    * **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
@@ Zeile 23: / Zeile 36: @@
 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
+  * **$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
+  * **$uid** - UID des markierten Mitarbeiters oder mehrere UIDs falls mehrere markiert wurden
-  * $studiengang_kz - Studiengangskennzahl des Verbands der im Verbandsbaum markiert wurde
+  * **$studiengang_kz** - Studiengangskennzahl des Verbands der im Verbandsbaum markiert wurde
-  * $semester - Semester des Verbands der im Verbandsbaum markiert wurde
+  * **$semester** - Semester des Verbands der im Verbandsbaum markiert wurde
-  * $studiensemester_kurzbz - aktuell ausgewähltes Studiensemester
+  * **$studiensemester_kurzbz** - aktuell ausgewähltes Studiensemester
-Wenn im FAS der Studenten Tab gewählt ist wird die prestudent_id übetragen wenn der Mitarbeiter Tab ausgewählt ist die UID. Es wird nicht beides gleichzeitig übermittelt.
+{{: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.

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge