Dokumentlayouts und PDF-Ausgabe verstehen

Workspace erzeugt kaufmännische Dokumente zuerst als HTML und erstellt daraus bei Bedarf ein PDF. Das betrifft zum Beispiel Angebote, Auftragsbestätigungen, Rechnungen, Gutschriften, Lieferscheine, Retouren, Picklisten und Einkaufsbestellungen.

Für Benutzer zählt am Ende das sichtbare Dokument: Stimmen Empfänger, Datum, Positionen, Beträge, Seitenumbrüche und Anhänge? Diese Seite erklärt, warum Vorschau und finale PDF-Ausgabe wichtig sind und wie Sie typische Layoutprobleme einordnen.

Was Workspace beim Dokument erstellt

Ein Dokument entsteht aus vier Bausteinen:

BausteinBedeutung
VorgangsdatenBestellung, Angebot, Rechnung oder Sendung liefern Empfänger, Positionen, Beträge und Status.
DokumentenprofilDas Profil bestimmt unter anderem Absender, Sprache, Branding und rechtlichen Kontext.
DokumentvorlageDie Vorlage legt fest, wie Kopf, Tabelle, Summen, Fußbereich und Hinweise aussehen.
RenderingWorkspace berechnet Seiten, erzeugt HTML und erstellt daraus ein PDF.

Öffnen Sie Handel > Dokumente > Dokumentvorlagen, wenn Sie prüfen möchten, welche Vorlage für einen Dokumenttyp und eine Sprache aktiv ist. Öffnen Sie Handel > Dokumente > Dokumentenprofile, wenn Sie Absender, Sprache oder Branding prüfen möchten.

Warum Seitenhöhe wichtig ist

Ein A4-PDF hat nur begrenzt Platz. Lange Positionsnamen, mehrzeilige Beschreibungen, Frachttexte, Rabattbegründungen, Logos, Fußzeilen oder zusätzliche Hinweise können eine Seite höher machen als erwartet.

Workspace misst deshalb viele Dokumente am echten gerenderten HTML. Der Ablauf ist vereinfacht:

  1. Workspace rendert eine interne Messfassung des Dokuments.
  2. Ein Browser misst, wie hoch Positionen, Kopf, Summenblock und Fußbereich wirklich sind.
  3. Workspace verteilt die Positionen auf Seiten.
  4. Workspace rendert das finale HTML ohne interne Messmarkierungen.
  5. Workspace erstellt daraus das PDF.

Diese Messung hilft, dass Positionslisten nicht in Summenblöcke, Fußzeilen oder den Seitenrand laufen.

Welche Dokumente automatisch gemessen werden

Workspace nutzt automatische Höhenmessung für die wichtigsten positionsbasierten Dokumente, wenn keine festen Positionsgrenzen gesetzt sind:

DokumentWas gemessen wird
AngebotPositionen, Kopf, Zwischensummen, Summenblock, Hinweise und Fußbereich.
Rechnung und GutschriftPositionen, Übertrag, Zwischensumme, Summenblock und Fußbereich.
AuftragsbestätigungPositionen, Abschlussblöcke und Fußbereich.
LieferscheinPositionen, Positionsübertrag und Fußbereich.
RetourePositionen, Abschlussblöcke und Fußbereich.
PicklistePickpositionen und Seitenabschluss.
EinkaufsbestellungPositionen und Abschlussseite; Workspace prüft zusätzlich, ob die finale PDF-Seite wirklich passt.

Wenn eine Vorlage feste Werte wie items_per_page_first oder items_per_page_follow nutzt, gelten diese Werte als harte Grenze. Dann verwendet Workspace für diesen Lauf nicht den automatischen Zuschnitt.

Vorschau und finales PDF unterscheiden

Die Vorschau hilft beim Prüfen. Das finale PDF ist der relevante Beleg für den Versand, Download und die Ablage.

Prüfen Sie nach Änderungen an Vorlagen immer beides:

  1. Öffnen Sie eine Vorschau mit einem Vorgang, der mehrere Seiten erzeugt.
  2. Erzeugen Sie ein finales Testdokument in einem sicheren Testvorgang.
  3. Öffnen Sie das PDF.
  4. Prüfen Sie Seitenanzahl, Umbrüche, Positionen, Summen, Logo und Fußbereich.

Verlassen Sie sich nicht nur auf eine einseitige Vorschau. Layoutfehler zeigen sich oft erst bei langen Positionen oder auf der letzten Seite.

Dokumentvorlagen sicher ändern

Ändern Sie Vorlagen vorsichtig, wenn sie Positionslisten enthalten.

Beachten Sie diese Regeln:

  • Nutzen Sie die vorhandene Positionsliste der Vorlage statt eine eigene freie Tabelle zu bauen.
  • Lassen Sie Kopfbereiche auf Folgeseiten kompakt.
  • Setzen Sie keine großen Zusatzblöcke direkt vor den Fußbereich, ohne danach ein mehrseitiges PDF zu prüfen.
  • Entfernen Sie keine technischen Platzhalter oder Messbereiche aus einer bestehenden Vorlage, wenn Sie den automatischen Seitenzuschnitt behalten möchten.
  • Verwenden Sie feste Positionsgrenzen nur bewusst. Sie schalten den automatischen Zuschnitt für diesen Lauf aus.

Für einfache Textänderungen wie Footer, Begrüßung, Zahlungsinformationen oder rechtliche Hinweise reicht meist eine Vorschau plus PDF-Prüfung. Für strukturelle Änderungen an Tabellen, Kopf, Summen oder Fußbereich sollten Sie ein mehrseitiges Testdokument verwenden.

Typische Fehlerbilder

BeobachtungWahrscheinliche UrsachePrüfung
Das PDF hat mehr Seiten als die sichtbare Seitenzählung.Vorlage und Messbereich passen nicht mehr zusammen.Prüfen Sie, ob die Vorlage stark verändert wurde und ob ein mehrseitiges PDF betroffen ist.
Summen oder Fußbereich liegen zu nah am Seitenrand.Die letzte Seite enthält mehr Inhalt als die Vorlage einplant.Prüfen Sie lange Positionen, Hinweise, Frachttexte und Fußzeilen.
Auf Folgeseiten bleibt viel freier Platz.Feste Positionsgrenzen oder konservative Layoutwerte begrenzen die Seite.Prüfen Sie items_per_page_first und items_per_page_follow in Vorlage oder Konfiguration.
Logo oder Bild fehlt nur im PDF.Die Bildquelle ist für den PDF-Renderer nicht erreichbar.Verwenden Sie hinterlegte Branding-Assets statt externe Bildlinks.
Vorschau sieht richtig aus, finaler Versand aber nicht.Vorschau und finaler Lauf verwenden unterschiedliche Sprache, Vorlage, Profil oder Vorgangsdaten.Prüfen Sie aktives Mapping, Sprache, Dokumentenprofil und finalen Vorgang.

Was Sie bei Problemen tun

  1. Prüfen Sie zuerst das aktive Dokumentvorlagen-Mapping für Dokumenttyp und Sprache.
  2. Prüfen Sie das Dokumentenprofil für Absender, Sprache und Branding.
  3. Rendern Sie eine Vorschau mit einem mehrseitigen Vorgang.
  4. Erzeugen Sie ein finales Test-PDF.
  5. Vergleichen Sie Vorschau und PDF.
  6. Prüfen Sie Versandprotokolle, wenn das PDF richtig ist, aber nicht beim Empfänger ankommt.

Nächste Schritte