# Vorschau

Damit Sie Ihre Anpassungen nicht erst durch das Anlegen eines echten Dokuments prüfen müssen, bietet das Plugin eine **Live-Vorschau**. Diese erzeugt das Dokument als PDF anhand einer echten Bestellung und öffnet es in einem neuen Tab.

<figure><img src="/files/aPtSqlcgfnOcpDK1pJqi" alt=""><figcaption></figcaption></figure>

## Vorschau erzeugen

Die Vorschau-Funktion finden Sie im Kopfbereich der Dokumentkonfiguration (neben den Aktions-Buttons), sobald die Konfiguration gespeichert wurde:

1. **Bestellung wählen** – Über das Auswahlfeld „Bestellung wählen (Standard: neueste)" wählen Sie die Bestellung, mit der die Vorschau erstellt werden soll. Treffen Sie keine Auswahl, wird automatisch die **neueste Bestellung** verwendet.
2. **Vorschau** – Klicken Sie auf den Button **Vorschau**. Das PDF wird generiert und in einem neuen Browser-Tab geöffnet.

> **Wichtig:** Speichern Sie Ihre Änderungen, bevor Sie die Vorschau erzeugen. Die Vorschau rendert den aktuell gespeicherten Stand des Dokuments.

## Voraussetzungen

* Es muss **mindestens eine Bestellung** im Shop vorhanden sein. Andernfalls erscheint die Meldung: *„Keine Bestellung gefunden. Es wird mindestens eine Bestellung benötigt, um eine Vorschau zu generieren."*
* Die Dokumentkonfiguration muss gespeichert sein (kein neues, ungespeichertes Dokument).

## Fehlerbehebung

Schlägt die Generierung fehl, zeigt die Administration eine Fehlermeldung mit der konkreten Ursache an (z. B. ein Twig-Syntaxfehler in Ihrem Template). Typische Ursachen:

| Meldung / Symptom                             | Mögliche Ursache & Lösung                                                        |
| --------------------------------------------- | -------------------------------------------------------------------------------- |
| Twig-/Syntaxfehler in der Fehlermeldung       | Prüfen Sie Ihr Twig-Template auf nicht geschlossene Tags oder Tippfehler         |
| „Die Vorschau konnte nicht generiert werden." | Allgemeiner Fehler – prüfen Sie Template, gewählte Bestellung und Server-Logs    |
| „Keine Bestellung gefunden."                  | Legen Sie mindestens eine Bestellung an oder wählen Sie eine konkrete Bestellung |

> **Tipp:** Die Vorschau ist ideal, um Twig-Anpassungen an Positionstabelle und Zusammenfassung schnell zu testen, da Fehler im Template direkt als Meldung sichtbar werden.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hubyte.de/pdf-dokumenten-template-bearbeiten/vorschau.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.