Lieferschein
Druckvorlage Bestellung
PayPal - Rechnungskauf
Lieferantenbestellung
Kassenbon (80 mm)
Gutscheinvorlage
Druck-Vorlagen
Druck-Vorlagen im Backend
Druck-Vorlagen steuern die HTML-Grundlagen fuer Belege und druckbare Dokumente. In dieser Verwaltung werden Vorlagentyp, interne Bezeichnung und HTML-Inhalt gepflegt; die konkrete Verwendung erfolgt danach in Kundengruppen, Verkaufsstellen, Gutschein-Einstellungen, E-Mail-Vorlagen oder Bestellprozessen.
Aufgabe der Druck-Vorlagen
Druck-Vorlagen werden als HTML gespeichert. Je nach Typ erzeugt das System daraus eine druckbare Ansicht, einen PDF-Inhalt oder eine Zusatzdatei fuer den E-Mailversand. Die Uebersicht ist deshalb der zentrale Pflegeort fuer die Vorlage selbst, aber nicht fuer jede fachliche Zuordnung.
Diese Seite beschreibt die gemeinsame Verwaltung aller Druck-Vorlagen. Variablen und Besonderheiten einzelner Dokumentarten liegen auf den sichtbaren Unterseiten fuer Rechnung und Mahnung, Lieferschein, Bestellung, PayPal-Rechnungskauf, Lieferantenbestellung, Kassenbon und Gutscheinvorlage.
Uebersicht, Suche und Filter
Die Backend-Seite zeigt eine BsTable mit allen Druck-Vorlagen, die nach Bezeichnung sortiert geladen werden. Ein eigener fachlicher Filterbereich ist in der Admin-Oberflaeche nicht definiert; Suche, Sortierung und Spaltensteuerung kommen aus der allgemeinen Tabellenoberflaeche.
- Neu: Der Button Vorlage erstellen oeffnet das Modalformular fuer eine neue Druck-Vorlage.
- Suche in der Tabelle: Die Tabellenoberflaeche kann vorhandene Zeilen durchsuchen. Die Seitenlogik setzt dafuer keinen zusaetzlichen Vorlagentyp-Filter.
- API-nahe Filter: Fuer Schnittstellenzugriffe sind Filter nach
id,nameunddescriptionerkennbar. Die Suche setzt den Suchbegriff aufdescription; Listen werden standardmaessig nachdescriptionsortiert. - Typen abrufen: Die API stellt die verfuegbaren Vorlagentypen separat bereit. Im Backend wird dieselbe Typenliste im Feld
namegenutzt. - Reset und Anwenden: Eigene Reset- oder Anwenden-Buttons sind fuer diese Seite nicht definiert. Filter-Reset erfolgt ueber die Tabellen- oder Schnittstellenlogik.
Tabelle
| Spalte | Bedeutung | Backend-Bezug |
|---|---|---|
| Id | Interne ID der Druck-Vorlage. Auf kleinen Ansichten wird die Spalte ausgeblendet. | id |
| Bezeichnung | Interne sprechende Bezeichnung der Vorlage. Diese Bezeichnung hilft dabei, mehrere Vorlagen desselben Typs auseinanderzuhalten und erscheint in Auswahlfeldern. | description |
| Type | Lesbarer Name des Vorlagentyps. Der angezeigte Wert wird aus dem internen Feld name und der Typenliste abgeleitet. | name ueber getType |
| Optionen | Enthaelt die Bearbeiten-Aktion. Die Spalte ist zentriert und nicht sortierbar. | id |
Optionen und Sicherheitslogik
- Bearbeiten: Oeffnet die Vorlage im grossen Modal. Die Aktion verwendet die Vorlagen-ID und laedt Bezeichnung sowie HTML-Inhalt.
- Loeschen: In der geprueften Backend-Oberflaeche ist die Loeschaktion auskommentiert. Normale Nutzeraktionen koennen Druck-Vorlagen hier daher nicht direkt loeschen.
- Rechte: Die Verwaltung wird nur angezeigt, wenn das Backend-Recht fuer Druckvorlagen vorhanden ist.
- Speichern: Nach dem Speichern schliesst das Modal und die Seite meldet die erfolgreiche Verarbeitung. Die Tabelle wird danach mit den gespeicherten Daten weiterverwendet.
Formularfelder
Dasselbe Modalformular wird fuer neue und vorhandene Druck-Vorlagen verwendet. Bei vorhandenen Vorlagen bleibt der Typ unveraendert; bei neuen Vorlagen muss der Typ zuerst festgelegt werden.
| Backend-Feld | Wann sichtbar | Zweck und Auswirkung |
|---|---|---|
name | Nur bei neuen Vorlagen | Legt den Vorlagentyp fest. Erlaubt sind nur Werte aus der Typenliste. Der Typ bestimmt, an welcher Stelle die Vorlage spaeter ausgewaehlt oder verwendet werden kann. |
description | Immer | Pflichtfeld fuer die interne Bezeichnung. Die Bezeichnung dient der Wiedererkennung in Tabellen und Auswahlfeldern. |
value | Immer | Pflichtfeld fuer den HTML-Inhalt. Aus diesem HTML entstehen die druckbare Ausgabe, PDF-Inhalte oder Anhangsinhalte. Das Feld ist als grosses Textfeld ausgelegt. |
Der HTML-Inhalt sollte erst nach einem Test mit echten Beispielbestellungen oder dem passenden Fachprozess freigegeben werden. Schon kleine HTML-Fehler koennen Ausdruck, PDF-Erzeugung oder Anhangsdarstellung beeinflussen.
Vorlagentypen und Zuordnung
Die verfuegbaren Typen kommen aus der Druckvorlagen-Entity. Die Zuordnung erfolgt nicht ueber diese Uebersicht selbst, sondern in dem Fachbereich, der den jeweiligen Dokumenttyp nutzt.
| Interner Typ | Anzeige | Typische Zuordnung |
|---|---|---|
print_bill_neu | Rechnungsvorlage | Kundengruppe und Rechnungsdruck |
print_bill_billsafe | PayPal-Rechnungskauf Vorlage | Kundengruppe und Rechnungskauf-Dokumente |
print_mahnung1 | Mahnung 1 Vorlage | Kundengruppe und erster Mahnprozess |
print_mahnung2 | Mahnung 2 Vorlage | Kundengruppe und zweiter Mahnprozess |
print_cash_bill | Kassenbonvorlage | Verkaufsstelle |
print_lieferschein_neu | Lieferscheinvorlage | Kundengruppe und Lieferscheindruck |
print_order | Druckvorlage Bestellung | Kundengruppe und Bestelldruck |
print_order_individuell | Individuelle Vorlage Bestellung fuer E-Mailversand | Zusatzdatei in E-Mail-Vorlagen und Status-E-Mails |
print_gutschein | Gutscheinverkauf | Gutschein-Einstellungen |
Unterseiten nutzen
Die Unterseiten erklaeren die Variablen und Besonderheiten der einzelnen Dokumentarten. Fuer die Pflege ist diese Reihenfolge sinnvoll:
- Passenden Vorlagentyp in der Uebersicht erstellen oder eine vorhandene Vorlage bearbeiten.
- HTML-Inhalt mit den Variablen der passenden Unterseite pflegen.
- Vorlage im passenden Fachbereich zuordnen, zum Beispiel Kundengruppe, Verkaufsstelle, Gutschein-Einstellung oder E-Mail-Vorlage.
- Dokument aus einem echten Vorgang testen, bevor die Vorlage produktiv genutzt wird.