355 lines
19 KiB
Markdown
355 lines
19 KiB
Markdown
# LehrerApp Templating
|
||
|
||
## Dynamische Zeichenflächen für externe Apps
|
||
|
||
Externe `ITemplateDataProvider` können einen Platzhalter vom Typ `Drawing` mit einem
|
||
`DrawingValue` befüllen. Dabei wird kein QuestPDF-/Skia-Canvas nach außen gegeben. Die portable
|
||
Form besteht stattdessen aus einer geprüften, serialisierbaren Befehlsliste:
|
||
|
||
```csharp
|
||
var drawing = new DrawingValue(
|
||
[
|
||
new DrawRectangle(0, 0, 160, 24, "#2563EB", 0.8f, "#EFF6FF"),
|
||
new DrawString(4, 4, "Dynamischer Bericht", 11, "#1E3A8A", Bold: true),
|
||
new MoveTo(4, 19),
|
||
new LineTo(156, 19, "#93C5FD", 0.6f),
|
||
new DrawImage(120, 2, 30, 18, pngBytes, "image/png")
|
||
],
|
||
ContentHeight: 24);
|
||
```
|
||
|
||
Koordinaten und Längen verwenden die Einheit des Layouts; `DrawString.FontSize` wird wie bei
|
||
`TEXT` in Punkt angegeben. Unterstützt werden `DrawString`, `MoveTo`, `LineTo`, `DrawLine`,
|
||
`DrawRectangle` und `DrawImage` (PNG/JPEG). Die Befehle gelangen über den normalen
|
||
`ITemplateDataProvider`, beispielsweise als `values["ExternerBericht"] = drawing`.
|
||
|
||
`DrawStringEx(x, y, height, width, ...)` ergänzt eine geclippte Textbox mit `AlignLeft`,
|
||
`AlignCenter` oder `AlignRight`. Farbe und Schriftfamilie können bei beiden Textbefehlen gesetzt
|
||
werden. Ohne Schriftangabe wird `sans-serif` verwendet. Für portable Schriften registriert die
|
||
integrierende App TTF-/OTF-Daten einmal vor dem Rendern:
|
||
|
||
```csharp
|
||
DrawingFontRegistry.RegisterFont("MeineSchulschrift", fontBytes);
|
||
canvas.DrawStringEx(0, 0, 12, context.Width, "Zentrierte Überschrift",
|
||
DrawingTextAlignment.AlignCenter, 11, "MeineSchulschrift", "#1E3A8A", bold: true);
|
||
```
|
||
|
||
Explizite Zeilenumbrüche werden berücksichtigt; Text außerhalb von `height`/`width` wird
|
||
abgeschnitten. Eine automatische Worttrennung findet in dieser elementaren Zeichenfunktion nicht
|
||
statt.
|
||
|
||
Im Layout stehen zwei Varianten zur Verfügung:
|
||
|
||
```text
|
||
DRAWBOX 20 40 170 80 $ExternerBericht
|
||
FLOWDRAWBOX 20 40 170 237 $LangesProtokoll
|
||
```
|
||
|
||
`DRAWBOX` ist ein fester, geclippter Viewport. Inhalte außerhalb seiner Breite oder Höhe werden
|
||
nicht angezeigt. `FLOWDRAWBOX` zerlegt den vertikalen Zeichenraum anhand von `ContentHeight` in
|
||
gleich hohe Seitenfenster und setzt ihn auf Folgeseiten fort. Wie bei `FLOWBOX` darf ein Layout
|
||
höchstens ein fließendes Element enthalten; bei einem eigenen Folgeseitenlayout müssen Typ,
|
||
Position und Größe übereinstimmen.
|
||
|
||
Standardmäßig belegt jeder Ausschnitt einer `FLOWDRAWBOX` die volle deklarierte Höhe, auch wenn
|
||
der Inhalt kürzer ist. Mit dem Opt-in-Attribut `fit=content` belegt der letzte Ausschnitt nur die
|
||
tatsächliche Inhaltshöhe (`ContentHeight`), sodass nachfolgende Elemente eines `content-flow`
|
||
direkt anschließen und bei wachsendem Inhalt nach unten wandern:
|
||
|
||
```text
|
||
#pragma content-flow body
|
||
FLOWDRAWBOX $Exam.PointsTable w=165 h=150 fit=content
|
||
TEXT "Gesamtpunkte: $Result.Points von $Exam.MaxPoints Punkte" gap=14
|
||
#pragma end-content-flow
|
||
```
|
||
|
||
`fit=content` wirkt nur bei einem direkt gelieferten `DrawingValue`; ein per Callback
|
||
aufgezeichneter Inhalt (`PagedDrawingValue`) füllt weiterhin jede Box vollständig.
|
||
|
||
Ein Vorlagenpaket kann keinen Callback und keinen Typ aus einer fremden Assembly einschleusen.
|
||
Farben, Zahlen, Bildformate, Bildgröße und Gesamtzahl der portablen Befehle werden validiert.
|
||
Damit bleibt die paketfähige Schnittstelle deterministisch. Ein `PagedDrawingValue` ist dagegen
|
||
ein ausdrücklich vom vertrauenswürdigen In-Process-`ITemplateDataProvider` übergebener Delegate.
|
||
|
||
Für umfangreiche In-Process-Integrationen gibt es zusätzlich den klassischen seitenweisen
|
||
Callback `PagedDrawingValue`. Er wird vor QuestPDFs Layout vollständig in deklarative Seitenlisten
|
||
aufgezeichnet und daher nicht durch interne Layoutdurchläufe mehrfach ausgeführt:
|
||
|
||
```csharp
|
||
var value = new PagedDrawingValue(context =>
|
||
{
|
||
var nextRow = context.State is int row ? row : 0;
|
||
|
||
// Nur vollständige Strukturen zeichnen, die noch in die zugewiesene Box passen.
|
||
while (nextRow < rows.Count && PasstNochVollstaendig(rows[nextRow], context))
|
||
ZeichneZeile(context.Canvas, rows[nextRow++]);
|
||
|
||
context.State = nextRow;
|
||
return nextRow == rows.Count; // true = fertig, false = weitere FLOWDRAWBOX
|
||
}, InitialState: 0);
|
||
```
|
||
|
||
`DrawingPageContext` stellt `Width`, `Height`, `PageNumber`, `Canvas` und ein über alle Aufrufe
|
||
weitergereichtes `State`-Objekt bereit. So kann der Zeichner Tabellenzeilen, Diagrammgruppen oder
|
||
andere unteilbare Strukturen bewusst auf die nächste Seite verschieben. Ein `DRAWBOX`-Callback
|
||
wird genau einmal aufgerufen; bei `FLOWDRAWBOX` fordert `false` eine weitere Seite an. `MaxPages`
|
||
verhindert Endlosschleifen. Delegates funktionieren nur innerhalb desselben .NET-Prozesses;
|
||
prozessübergreifend bleibt `DrawingValue` die Übergabeform.
|
||
|
||
## PDF-Import im TemplateDesigner
|
||
|
||
Der Menüpunkt **Einfügen → PDF als Vorlage importieren** rekonstruiert einseitige PDF-Vorlagen.
|
||
Der präzisere Modus verwendet ein leeres Template zusammen mit einem ausgefüllten Beispiel und
|
||
ermittelt variable Textbereiche über einen toleranten Geometrie-Diff. Mit nur einem PDF werden
|
||
Datum, Zahlen und typische Adressbereiche lokal heuristisch vorerkannt.
|
||
|
||
PdfPig extrahiert Text, Bounding-Box, Schriftgröße und verfügbare Schriftmerkmale. Die optionale
|
||
KI-Klassifikation erhält ausschließlich diese strukturierte Zwischenrepräsentation und darf nur
|
||
Placeholder-Namen, Typ, Gruppierung und Konfidenz liefern. Koordinaten werden nicht an die KI
|
||
delegiert. Das gerasterte PDF bleibt als Hintergrund erhalten; erkannte variable Bereiche werden
|
||
deterministisch mit einem weißen Asset maskiert und anschließend als `TEXT` oder `TEXTBOX`
|
||
eingefügt. Der Nutzer prüft alle Vorschläge im Importdialog und muss die Übernahme ausdrücklich
|
||
bestätigen. Das Paket wird dabei noch nicht gespeichert.
|
||
|
||
Die serverseitige Klassifikation liegt in
|
||
[`LehrerBackend/pdf-template.php`](https://git.science-teaching.de/admin/LehrerBackend/src/branch/main/pdf-template.php)
|
||
und verwendet denselben
|
||
Login-, Bearer-Token-, Guthaben- und Abrechnungsmechanismus wie die übrigen KI-Funktionen. Das
|
||
Passwort wird vom eigenständigen Designer nicht gespeichert. Tabellen-/Chart-Erkennung und die
|
||
automatische Rekonstruktion mehrseitiger Vorlagen sind bewusst nicht Teil von v1.
|
||
|
||
## Zentrierte und rechtsbündige Zeilen
|
||
|
||
`TEXT` richtet `align=center` bzw. `align=right` innerhalb seiner Zeilenbreite aus. Ohne Angabe
|
||
reicht diese von `x` bis zum rechten Seitenrand, sodass Zentrierung nicht auf der Seitenmitte liegt.
|
||
Mit `w=` wird die Breite explizit gesetzt; Variablen im Text verschieben die Mitte dann nicht:
|
||
|
||
```text
|
||
PAGE 210 297 mm
|
||
TEXT 0 20 "Elternbrief $Group.Name" w=210 align=center size=16 bold=true
|
||
TEXT 20 30 "Klasse $Group.Name" w=170 align=center
|
||
```
|
||
|
||
`x=0 w=<Seitenbreite>` zentriert auf der Seite, `x=<Rand> w=<Seitenbreite − 2·Rand>` innerhalb der
|
||
Ränder. In einem `content-flow` ist `w` nicht nötig: dort gilt die Breite des Flows.
|
||
|
||
Weitere Hinweise:
|
||
|
||
- `w` muss eine positive Zahl in der Einheit des Layouts sein; andernfalls meldet der Parser einen Fehler.
|
||
- `w` gilt nur für `TEXT`. `TEXTBOX` und `FLOWBOX` besitzen bereits eine Breite und richten
|
||
`align=left|center|right` darin aus.
|
||
- `align` und `w` wirken auch bei Systemvariablen (`"Seite $$curPage von $$maxPageNum"`) und bei
|
||
Platzhaltern mit Format (`$Datum|dd.MM.yyyy`).
|
||
- Der Koordinateneditor des Designers kennt `w` bei `TEXT` nicht; das Attribut wird beim Verschieben
|
||
erhalten, aber nur in der DSL-Zeile bearbeitet.
|
||
|
||
## Mehrseitiger Fließtext
|
||
|
||
`TEXTBOX` bleibt ein absolut positionierter Bereich mit fester Höhe. Für Texte unbekannter Länge
|
||
steht `FLOWBOX` mit derselben Syntax zur Verfügung:
|
||
|
||
```text
|
||
PAGE 210 297 mm
|
||
FLOWBOX 20 45 170 232 $Klassenbucheintraege size=11
|
||
```
|
||
|
||
Der Inhalt wird innerhalb dieses Bereichs umbrochen und bei Bedarf auf beliebig vielen Seiten
|
||
fortgesetzt. Pro Layout ist höchstens eine `FLOWBOX` zulässig. Das optionale Manifestfeld
|
||
`continuationLayoutFile` verweist auf ein zweites Layout im Paket, das ab Seite 2 verwendet wird.
|
||
Damit können Folgeseiten beispielsweise einen kleineren Briefkopf oder einen eigenen Hintergrund
|
||
haben. Haupt- und Folgeseitenlayout müssen dieselbe Seitengröße besitzen; ihre `FLOWBOX` muss aus
|
||
technischen Gründen dieselbe Position und Größe haben. Ohne Folgeseitenlayout werden die statischen
|
||
Elemente der ersten Seite auf jeder erzeugten Seite wiederholt.
|
||
|
||
## Systemvariablen
|
||
|
||
Textinhalte können drei vom Renderer bereitgestellte Variablen verwenden. Sie werden nicht im
|
||
Manifest deklariert und nicht vom `ITemplateDataProvider` geliefert:
|
||
|
||
- `$$today` – aktuelles lokales Datum im deutschen Kurzformat
|
||
- `$$curPage` – aktuelle Seitenzahl
|
||
- `$$maxPageNum` – Gesamtzahl der Seiten
|
||
|
||
Sie können allein oder innerhalb eines Literals stehen, beispielsweise:
|
||
|
||
```text
|
||
TEXT 20 10 "Stand: $$today" size=9
|
||
TEXT 145 285 "Seite $$curPage von $$maxPageNum" size=9 align=right
|
||
```
|
||
|
||
QuestPDF löst aktuelle und gesamte Seitenzahl während der Dokumenterzeugung auf. Dafür ist kein
|
||
zusätzlicher Renderdurchlauf durch die Anwendung erforderlich. Die Variablen funktionieren auch in
|
||
konstanten Rich-Text-Platzhaltern.
|
||
|
||
## Konstante Platzhalter und Hervorhebung
|
||
|
||
Ein Platzhalter kann seinen Wert vollständig im Vorlagenpaket tragen. `IsConstant=true` bewirkt,
|
||
dass `ConstantValue` beim Rendern immer verwendet wird; ein gleichnamiger Wert aus dem externen
|
||
`ITemplateDataProvider` wird bewusst ignoriert. Damit eignen sich Konstanten besonders für lange
|
||
Textbausteine in `TEXTBOX`, rechtliche Hinweise oder wiederkehrende Fußtexte.
|
||
|
||
```csharp
|
||
new PlaceholderDefinition(
|
||
"Datenschutzhinweis",
|
||
PlaceholderType.Multiline,
|
||
IsConstant: true,
|
||
ConstantValue: "Dieser längere Text wird im Paket gespeichert.",
|
||
Bold: true,
|
||
Italic: false,
|
||
Underline: false);
|
||
```
|
||
|
||
Konstante Werte werden für `Text`, `Multiline`, `Date` und `Number` unterstützt. Die Eigenschaften
|
||
`Bold`, `Italic` und `Underline` wirken, wenn der Platzhalter direkt von einem `TEXT`- oder
|
||
`TEXTBOX`-Element referenziert wird. In der Layout-DSL kann Unterstreichung außerdem direkt mit
|
||
`underline=true` gesetzt werden.
|
||
|
||
Konstante Text- und Multiline-Werte unterstützen zusätzlich abschnittsweise Hervorhebung und
|
||
eingebettete externe Platzhalter:
|
||
|
||
```text
|
||
Sehr geehrte Familie [b]${Student.LastName}[/b],
|
||
|
||
bitte geben Sie die [u]unterschriebene Erklärung[/u] bis [i]Freitag[/i] zurück.
|
||
```
|
||
|
||
Unterstützt werden `[b]…[/b]`, `[i]…[/i]` und `[u]…[/u]`, auch verschachtelt. Die Klammerform
|
||
`${Name}` ist in Fließtext vorzuziehen; `${Datum|dd.MM.yyyy}` erlaubt zusätzlich ein Format.
|
||
Eingebettete Platzhalter müssen im Manifest als externe Platzhalter deklariert sein. Ihre gelieferten
|
||
Werte werden immer als reiner Text behandelt und können deshalb kein Markup einschleusen. Mit
|
||
`\[`, `\$` und `\\` lassen sich die Steuerzeichen wörtlich ausgeben.
|
||
|
||
## Freie Paketmetadaten
|
||
|
||
Jedes neu gespeicherte `.lavorlage`-Paket enthält eine lesbare `metadata.txt`. Pro Zeile steht ein
|
||
frei wählbares Schlüssel-Wert-Paar; leere Zeilen und mit `#` beginnende Kommentare werden beim
|
||
Einlesen ignoriert:
|
||
|
||
```text
|
||
language=de-DE
|
||
report-type=parent-letter
|
||
school-year=2026/27
|
||
```
|
||
|
||
Werte dürfen ein weiteres `=` enthalten. Schlüssel sind ohne Beachtung der Groß-/Kleinschreibung
|
||
eindeutig und Werte bleiben einzeilig. Der Loader stellt sie der Anwendung direkt über
|
||
`loadedTemplate.Manifest.Metadata` zur Verfügung. Bestehende Pakete ohne `metadata.txt` werden
|
||
weiterhin mit einer leeren Metadatensammlung geladen. Die empfohlenen Standardschlüssel stehen
|
||
zusätzlich als `TemplateMetadataKeys.Language` und `TemplateMetadataKeys.ReportType` bereit.
|
||
|
||
## Klausur-Deckblätter (`report-type=exam-cover`)
|
||
|
||
Eine Vorlage mit dem Metadatum `report-type=exam-cover` (`TemplateReportTypes.ExamCover`) erscheint
|
||
in der Hauptapp ausschließlich im Dialog „Deckblätter…" einer Klausur und nicht mehr in der Auswahl
|
||
für Elternbriefe und Arbeitsblätter. Importiert wird sie wie jede andere `.lavorlage` in den
|
||
Einstellungen. Je ausgewähltem Schüler entsteht eine Seite in einem Sammel-PDF
|
||
(`ITemplateBatchRenderer.RenderBatchToPdf`). Zusätzlich zu den Elternbrief-Platzhaltern
|
||
(`Student.Name`, `Student.FirstName`, `Student.LastName`, `Group.Name`, `SchoolYear`, `Datum`)
|
||
stehen bereit:
|
||
|
||
| Platzhalter | Typ | Inhalt |
|
||
| --- | --- | --- |
|
||
| `Exam.Title`, `Exam.Number`, `Exam.Kind`, `Exam.Niveau` | Text | Titel, Nummer, Art, Niveau der Arbeit |
|
||
| `Exam.Date` | Date | Datum der Arbeit |
|
||
| `Exam.ApprovalDate`, `Exam.AnnouncedDate`, `Exam.ReturnDate` | Text | Genehmigung, Ankündigung, Rückgabe (`TT.MM.JJJJ`, leer wenn nicht gesetzt) |
|
||
| `Exam.Course` | Text | `E-Kurs` / `G-Kurs` (Niveau der Arbeit, sonst des Schülers in der Lerngruppe); leer im Klassenverband |
|
||
| `Teacher.Abbreviation` | Text | Kürzel der Lehrkraft aus den Einstellungen, im Deckblatt-Dialog je Druck änderbar |
|
||
| `Exam.Variant` | Text | geschriebene Fassung (A/B), leer ohne Fassungen |
|
||
| `Exam.MaxPoints` | Text | erreichbare Punktzahl der geschriebenen Fassung, ohne Bonusaufgaben |
|
||
| `Result.Points`, `Result.Grade` | Text | erreichte Punkte und Note; als Blanko eine Linie aus Unterstrichen |
|
||
| `Result.Percent` | Text | erreichter Anteil, als Blanko leer |
|
||
| `Subject.Name`, `Group.GradeLevel` | Text | Fach und Jahrgangsstufe der Lerngruppe |
|
||
| `Exam.PointsTable` | Drawing | Punktetabelle (Aufgabe / Max. Punktzahl / Punktzahl) |
|
||
|
||
Im Vorlagen-Designer richtet „Als Klausur-Deckblatt einrichten" (Reiter mit den Metadaten) ein
|
||
Projekt dafür ein: Der Vorlagentyp wird gesetzt und alle Platzhalter aus dieser Tabelle werden mit
|
||
Beispielwerten angelegt (`ExamCoverPlaceholders`, derselbe Katalog, gegen den die Hauptapp getestet
|
||
ist). Die Punktetabelle steht unter „LehrerApp-Sonderinhalte" und wird als
|
||
`FLOWDRAWBOX … fit=content` in den Content-Flow vorbereitet. Die Vorschau zeichnet sie mit
|
||
`ExamPointsTableDrawing` — derselbe Code wie in der Hauptapp — in der Breite der deklarierten Box,
|
||
mit acht Aufgaben und einer Bonusaufgabe.
|
||
|
||
Die Punktetabelle hat feste Spaltenbreiten (38 mm Beschriftung, 20,5 mm je Aufgabe). Passen nicht
|
||
alle Aufgaben in die Breite der Box, folgt darunter ein weiterer Block; verkleinert wird nichts.
|
||
Sie gehört deshalb als `FLOWDRAWBOX … fit=content` in einen `content-flow`. Bonusaufgaben stehen
|
||
ohne Nummer und mit `+` vor der Punktzahl in der Tabelle.
|
||
|
||
## Bildskalierung
|
||
|
||
`IMG` unterstützt neben dem festen Begrenzungsrahmen eine optionale prozentuale Skalierung:
|
||
|
||
```text
|
||
IMG logo.png 15 15 30 12 scale=50%
|
||
```
|
||
|
||
Der Rahmen von `30 × 12` Layout-Einheiten wird dabei auf `15 × 6` skaliert. `x` und `y`
|
||
bleiben unverändert. Das Bild wird mit erhaltenem Seitenverhältnis in diesen Rahmen eingepasst.
|
||
Ohne `scale` gilt wie bisher `100%`. Zulässig sind Werte größer als `0` bis einschließlich
|
||
`1000%`.
|
||
|
||
## Wiederverwendbare Ausgangsvorlagen
|
||
|
||
Der TemplateDesigner verwaltet lokale Ausgangsvorlagen im Benutzerprofil. Eine Ausgangsvorlage
|
||
ist weiterhin ein normales `.lavorlage`-Paket und kann deshalb importiert oder exportiert werden.
|
||
|
||
- **Bearbeiten** öffnet die Ausgangsvorlage mit ihrer stabilen ID. Erneutes Speichern aktualisiert sie.
|
||
- **Als neues Projekt** kopiert Layout, Platzhalter und sämtliche Assets, vergibt aber eine neue ID.
|
||
- **Duplizieren** erzeugt eine weitere unabhängige Ausgangsvorlage.
|
||
- **Vorschau** rendert die Vorlage mit typgerechten Beispieldaten, ohne das aktuelle Projekt zu ändern.
|
||
|
||
Die Bibliothek liegt unter `LehrerApp/TemplateDesigner/starter-templates` im plattformspezifischen
|
||
Anwendungsdatenverzeichnis und wird nicht in das LehrerApp-Repository oder Release eingebettet.
|
||
|
||
## Visueller Koordinateneditor
|
||
|
||
Die QuestPDF-Vorschau dient gleichzeitig als maßstabsgetreue Zeichenfläche. Der Designer bildet
|
||
das tatsächlich sichtbare Seitenrechteck unabhängig von Zoom und freien Rändern auf die `PAGE`-
|
||
Koordinaten ab:
|
||
|
||
```text
|
||
dslX = (mausX - seitenrandLinks) / angezeigteSeitenbreite * pageWidth
|
||
dslY = (mausY - seitenrandOben) / angezeigteSeitenhöhe * pageHeight
|
||
```
|
||
|
||
Im Messmodus übernimmt ein Klick `x/y`; ein aufgezogener Bereich übernimmt zusätzlich Breite und
|
||
Höhe ins Elementformular. Im Bearbeitungsmodus lassen sich vorhandene Elemente verschieben und -
|
||
außer einzeiligem `TEXT` - am rechten unteren Anfasser skalieren. Rasterfang und Pfeiltasten sind
|
||
für Feinkorrekturen verfügbar. Änderungen werden in die ursprüngliche DSL-Zeile zurückgeschrieben,
|
||
wobei Inhalte, Platzhalter, Formatangaben und Attribute erhalten bleiben.
|
||
|
||
|
||
### Weitere Deckblatt- und Schülerbericht-Bausteine
|
||
|
||
Die Sonderinhalte im TemplateDesigner umfassen zusätzlich:
|
||
|
||
| Platzhalter (Drawing) | Inhalt |
|
||
| --- | --- |
|
||
| `Exam.RepeatInfo` | Erste Arbeit, bisherige Note und Regel der Wiederholung; bei normalen Arbeiten leer |
|
||
| `Student.InterimGrades` | Gespeicherter Zwischenstand mit Stichtag/Anlass, mündlich, schriftlich und vorläufiger Zeugnisnote |
|
||
| `Student.ParticipationChart` | Gewichtete Mitarbeit und Einzelaspekte auf der gemeinsamen -2 bis +2-Achse |
|
||
| `Student.Competencies` | Kompetenzbewertungen aus Klausuren und Mitarbeit |
|
||
| `Student.Homework` | Hausaufgabenkontrollen mit Datum und aktuellem Nachreichstatus |
|
||
| `Student.Documentation` | Dokumentation und Unterrichtsnotizen der gewählten Lerngruppe |
|
||
|
||
`Exam.RepeatInfo` und `Student.InterimGrades` sind in Klausur-Deckblättern verfügbar.
|
||
Ein Zwischenstand wird im Druckdialog über Datum und Anlass gewählt; fehlt ein ausgewählter
|
||
Schüler in diesem Durchgang, wird der Druck mit einem Hinweis verhindert.
|
||
|
||
Für Schülerberichte im Schülerdetail gibt es eine eingebaute Standardvorlage und importierbare
|
||
Pakete mit `report-type=student-report` (in einer der beiden vorhandenen Vorlagenbibliotheken).
|
||
Im Designer setzt „Als Schülerbericht einrichten“ den Typ und ergänzt die benötigten Platzhalter;
|
||
die Sonderinhalte werden danach nach Bedarf in den Content-Flow eingefügt. Es werden außerdem
|
||
`Student.Name`, `Group.Name`, `Report.Period` (Text) und `Report.Comment` (Multiline) befüllt.
|
||
Es gibt keine erforderliche Kontaktadresse: der Bericht ist für den Austausch mit Kollegen gedacht.
|
||
|
||
Für lange Inhalte `FLOWDRAWBOX … fit=content` verwenden. Ihre Höhe muss einschließlich `gap`
|
||
in den Flow-Slot passen; die Standardvorlage nutzt 230 mm Inhaltshöhe in einem 240-mm-Slot.
|
||
Feste `DRAWBOX`-Textblöcke melden Platzmangel. Der Mitarbeitsgraph braucht mindestens 50 mm
|
||
Breite und ausreichend Höhe für seine Legende. Die Textbausteine beachten die Maßeinheit der Vorlage.
|
||
|
||
Der Bericht filtert auf Schüler, Gruppe und Zeitraum. Gelöschte Dokumentation und Entwürfe werden
|
||
nicht übernommen; vertrauliche Dokumentation ist im Dialog zuschaltbar. Hausaufgabenstatus und
|
||
Dokumentation entsprechen dem aktuellen gespeicherten Zustand. Notenzwischenstände werden aus
|
||
gespeicherten Durchgängen übernommen und nicht beim Druck neu berechnet. KI-Texterzeugung ist
|
||
noch nicht angebunden; ergänzende Texte lassen sich im Berichtsdialog eingeben.
|