Diagramme und Berichte

Kombinieren Sie Diagramme, Tabellen und Text in einer Vorlage für Vertriebs-, Marketing- oder Projektberichte. Für eigene Diagramme müssen Sie kein fertiges Berichtsdesign kaufen.

Ein Diagramm im Generator erstellen

1. Fügen Sie über Ressourcen ein Diagramm hinzu und wählen Sie Typ und Titel im Inspektor.
2. Öffnen Sie „Diagrammdaten bearbeiten“, um Seriennamen, Farben, Kategorien und Zahlenwerte zu ändern. Fügen Sie nach Bedarf Serien oder Zeilen hinzu.
3. Anwenden übernimmt Änderungen ins Diagramm. Abbrechen verwirft Änderungen aus dem Dialog. Speichern Sie die Vorlage und prüfen Sie Vorschau und Ausgaben.

Typen und Limits

Säulen-, Balken-, Linien-, Flächen-, Kreis- und Ringdiagramme werden unterstützt. Ihre JSON-Typcodes sind:

Die Beispiele werden von der eigenen Diagramm-Engine des Produkts aus denselben vier Zeilen gezeichnet. Nur der Typcode ändert sich.

Jedes Diagramm unterstützt bis zu 100 Kategorien und 6 Serien. Kreis- und Ringdiagramme erlauben nur eine Serie und lehnen negative Werte ab.

Beispiel für ein Vorlagenelement

Dieses Objekt ist ein Diagrammelement im elements-Array einer Vorlage mit schemaVersion: 2, keine vollständige Erstellungsanfrage. Das Beispiel speichert Daten direkt in content.data.

{
  "id": "monthly-revenue",
  "type": "chart",
  "placementMode": "flow",
  "layout": { "width": 100, "widthUnit": "percent", "height": 240 },
  "content": {
    "title": "Revenue",
    "data": [{ "month": "Jan", "revenue": 42 }, { "month": "Feb", "revenue": 52 }]
  },
  "chart": {
    "type": "bar",
    "labelField": "month",
    "series": [{ "field": "revenue", "label": "Revenue", "color": "#e3232a" }],
    "showLegend": true,
    "showValues": true
  }
}

Dynamische Daten binden

Fügen Sie dem Diagrammelement binding: monthlyRevenue hinzu und senden Sie in den Anfragedaten ein Objektarray namens monthlyRevenue, um pro Dokument unterschiedliche Daten zu verwenden. Entfernen Sie dann content.data. labelField wählt das Kategoriefeld, jedes Serienfeld den jeweiligen Zahlenwert. Verschachtelte Pfade wie sales.net werden unterstützt.

Fehlende oder nicht endliche Zahlen werden nicht in null umgewandelt, sondern bleiben in Linien- und Flächendiagrammen als Lücken bestehen. Korrigieren Sie negative Kreis- und Ringwerte in den Quelldaten. Bei dichten Diagrammen können Wertbeschriftungen zur Vermeidung von Überlappungen entfallen.

Ein Bericht mit aktuellen Daten

Ein an monthlyRevenue gebundenes Diagramm liest das gleichnamige Array aus der Anfrage. Die Vorlage bleibt gleich; nur die Zahlen kommen mit jedem Aufruf neu.

curl -X POST https://api.pdfgine.com/api/v1/render \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "templateCode": "sales-report",
        "format": "pdf",
        "locale": "de",
        "data": {
          "monthlyRevenue": [
            { "month": "2026-01", "revenue": 42000, "target": 40000 },
            { "month": "2026-02", "revenue": 51500, "target": 45000 },
            { "month": "2026-03", "revenue": 47250, "target": 50000 }
          ]
        }
      }'

Jedes Arrayobjekt ist eine Kategorie. labelField wählt den Kategorienamen; jedes Serienfeld wählt eine Zahl aus demselben Objekt.

Häufige Fehler

• binding und content.data sind Alternativen, kein Paar. Hat ein Diagramm beides, zeichnet es weiterhin die festen Daten und Ihre Anfrage wirkt ignoriert.
• Serienwerte müssen Zahlen sein. "42.000,00" ist eine Zeichenfolge; formatieren Sie sie für Leser in einem Textelement, nicht in der Serie.
• Ein Diagramm enthält höchstens 100 Punkte und 6 Serien. Aggregieren Sie vor dem Senden, statt auf die Darstellung zusätzlicher Zeilen zu hoffen.
• In Word ist das Diagramm ein Bild, kein bearbeitbares Word-Diagramm. Leser können es daher nicht direkt bearbeiten. PDF und Viewer zeigen dieselbe Darstellung.
• 100% bezeichnet die Breite des umgebenden Bereichs, nicht des Blatts. Innerhalb einer Spalte oder eines Containers mit Innenabstand ist sie schmaler als die Seite.

Verhalten von Vorschau und Ausgabe

Diagramme verwenden einen gemeinsamen SVG-Renderer. PDF und Viewer bewahren das Erscheinungsbild. Word-Exporte enthalten Diagrammbilder statt nativer bearbeitbarer Word-Diagrammobjekte.

100% Breite bedeutet die verfügbare Breite des umgebenden Bereichs, nicht des gesamten Blatts. Seitenränder, Spalten und Innenabstände können diesen Bereich verkleinern.