~~NOTOC~~
| Datenbereich:       | Schüler                     |
| Bezeichnung:        | Musterbrief 2 BERS (ST297)  |
| Dateiname:          | Musterbrief 2 BERS.bsb      |
| Schulart(en):       | *                           |
| Rechtsgrundlage:    | keine Rechtsgrundlage       |
| Berichte-Typ:       | Serienbrief                 |
| Autor:              | Claus Gumbmann (ClGu)       |
| Veröffentlicht am:  | 22.03.2023                  |


===== Beschreibung =====

Serienbrief: Musterbrief 2 zur schuleigenen Anpassung. Der vorgeschaltene Dialog kann, wie unten beschrieben, verändert werden. Für den Empfänger des Briefs greift eine [[bers:berichte:empfaengerautomatik|Empfängerautomatik]] oder kann manuell überschrieben werden:
  * über 21 Jahre immer Schüler*in selbst
  * über 18 entweder Schüler*in selbst oder Erziehungsberechtigte, wenn im Schriftverkehrsverteiler angehakt
  * unter 18 immer Erziehungsberechtigte/r

Der Bericht ist vorbereitet für die schuleigene Hintergrund-Graphik. Der Berichte bietet die Möglichkeit,

   * schulartspezifischen Text auszugeben,
   * im Dialog selbst angelegte Nebenstellen als Absender auszuwählen,
   * im Dialog ein Mitglied der Schulleitung (SL, ständ. SV, weit. ständ. SV und Mitarbeiter der SL) auszuwählen.
   * Dialogelement selbst zu gestalten (im RUN_ONCE_EVENT)

Der Bericht muss über die weiße Berichtebibliothek exportiert werden und anschließend unter einem neuen Namen importiert werden. Danach kann der importierte Bericht bearbeitet werden.

===== Groovy-Programmierung =====
Im RUN_ONCE_EVENT der Seite können Einstellungen für den Dialog des Berichts vorgenommen werden und es wird erläutert, wie man auf die Inhalte des Dialogs zugreifen kann. **Die Verwendung des Musterbriefs 2 setzt Programmiererfahrung (die Sprache ist dabei unerheblich) voraus.**\\ \\
**Möglichkeit Elemente des Anwenderdialogs**
   * a = Absender (erforderlich)			
   * b = Empfänger (erforderlich)                 	
   * c = Datum					
   * d = manuell Zeichnen                         	
   * e = Unterzeichner				
   * f = Bearbeiter				
   * g = Zeichen                            	
   * h = freies Textfeld 1				
   * i = freies Textfeld 2 
   * j = Schulleitung zeichnet zusätzlich
   * k = Schulleitungsmitglied für die Möglichkeit j wählbar
   * l = TextArea
   * m = Hinweis auf BAföG
   * n = freie Checkbox
   * o = freie Auswahlmöglichkeit


===== Einstellungsmöglichkeiten =====

Über den RUN_ONCE_EVENT der Seite kann man den Dialog bearbeiten \\
{{:bers:berichte:veroeffentlicht:s297_editor.png?nolink&600|}} \\

Die Kommentare erklären, wie die Elemente verwendet werden können\\
Über die Zeichenfolge unten wird gesteuert, welche Elemente im Dialog angezeigt werden sollen\\
{{:bers:berichte:veroeffentlicht:s297_runonce.png?nolink&600|}} \\

Über den ONLOAD_EVENT eines Textfeldes ergeben sich weitere Möglichkeiten, den Bericht anzupassen.\\
{{:bers:berichte:veroeffentlicht:s297_editor2.png?nolink&600|}} \\

Hier am Beispiel des Haupttext-Textfeldes. Im grün markierten Bereich kann der Ausgabetext für eine Berufsschule angepasst werden. 
{{:bers:berichte:veroeffentlicht:s297_onload.png?nolink&600|}}


===== Vorauswahl =====
{{:bers:berichte:veroeffentlicht:S297_dialog.png?nolink&300|}}


===== Vorschau =====

{{:bers:berichte:veroeffentlicht:s297_vorlage.png?nolink&600|}}

(Quelle: ASV Schulungsversion)

===== Änderungs-Historie =====
| Änderungsdatum  | Beschreibung der Änderung                                 | Tickets  | Autor  |
| 20.03.2023      | Anpassungen für Release 24.1.                             | -        | ClGu   |
| 24.01.2024      | TextArea und freie Checkbox eingebaut                     | -        | ClGU   |
| 24.01.2024      | 3. Geschlecht implementiert                               | -        | ClGu   |
| 22.03.2023      | Auswahlmöglichkeit für Mitglied der Schulleitung ergänzt  | -        | ClGu   |
| 22.03.2023      | Schulartspezifische Textausgabe integriert                | -        | ClGu   |