Publixx Headless Server

Automatisierte Dokumentenerstellung ohne manuellen Aufwand. Generieren Sie PDF, PowerPoint, Word und Excel direkt aus Ihren Datenquellen.

Das Problem

Marketing-Teams erstellen täglich Dutzende Dokumente. Produktkataloge, Datenblätter, Präsentationen. Immer wieder dieselben Schritte: Daten kopieren, Template öffnen, Inhalte einfügen, exportieren. Das kostet Zeit und ist fehleranfällig.

Gleichzeitig wachsen die Anforderungen an Automatisierung. CI/CD-Pipelines, nächtliche Batch-Jobs, API-gesteuerte Workflows. Die klassische Desktop-Anwendung passt nicht mehr in moderne Infrastrukturen.

Unsere Lösung

Publixx Server bringt die volle Leistungsfähigkeit des Publixx Template Designers in eine headless Umgebung. Dieselben Templates, dieselben Daten, dieselben Exporte – nur ohne grafische Oberfläche.

Der Clou: Es ist keine separate Codebasis. Publixx läuft im Browser für interaktive Bearbeitung und im Server für automatisierte Prozesse. Ein Template funktioniert in beiden Welten identisch.

Eine Codebasis, zwei Welten

Im Browser

Designer und Marketing-Teams arbeiten visuell. Sie erstellen Templates, binden Datenfelder ein, definieren Layouts. Die Vorschau zeigt sofort das Ergebnis. Export per Klick – PDF, PowerPoint, Word, Excel, HTML.

Das ist Publixx, wie Sie es kennen.

Im Server

Entwickler und DevOps-Teams integrieren Publixx in ihre Workflows. Eine REST-API nimmt Anfragen entgegen. Ein headless Chrome rendert das Template. Der Export landet im Dateisystem oder wird direkt zurückgeliefert.

Das ist Publixx Server.

Technische Architektur

Publixx Server nutzt Puppeteer, um einen echten Chrome-Browser headless zu steuern. Das ist kein Kompromiss – es ist ein Vorteil.

Chrome rendert HTML, CSS und JavaScript exakt wie im Browser. Fonts werden korrekt dargestellt. SVG-Grafiken skalieren sauber. PDF-Exporte sind pixelgenau.

Anders als serverseitige PDF-Bibliotheken, die HTML interpretieren müssen, nutzt Publixx die volle Rendering-Engine von Chrome. Was Sie im Browser sehen, bekommen Sie auch im Export.

Deployment-Optionen

Lokal

Für Entwicklung und Tests. Node.js installieren, Puppeteer einrichten, fertig. Kein Docker nötig.

npm install
node test-local.js --config=katalog.json --pdf

Docker

Für Produktion und CI/CD. Ein Container mit allem was nötig ist – Chrome, Node.js, Publixx.

docker-compose up -d
curl -X POST http://localhost:3000/api/export \
  -d '{"config": "katalog.json", "format": "pdf"}'

Kubernetes

Für Skalierung. Mehrere Pods, Load Balancing, automatisches Scaling bei Last.

API-Design

Die REST-API ist bewusst einfach gehalten. Ein Endpoint für Exports, einer für Batch-Verarbeitung, einer für Workflows.

Einzelner Export

Übergeben Sie Config oder Template/Daten direkt. Wählen Sie das Format. Fertig.

POST /api/export
{
  "config": "produktkatalog.json",
  "format": "pptx"
}

Batch-Verarbeitung

Mehrere Exports in einem Request. Jeder Job wird sequentiell abgearbeitet.

POST /api/batch
{
  "jobs": [
    {"config": "katalog-de.json", "format": "pdf"},
    {"config": "katalog-en.json", "format": "pdf"},
    {"config": "katalog-fr.json", "format": "pdf"}
  ]
}

Workflow-Makros

Komplexe Abläufe als JSON definieren. Daten laden, filtern, transformieren, exportieren.

POST /api/macro/nightly-catalog
{
  "variables": {
    "dataUrl": "https://api.erp.local/products",
    "category": "electronics"
  }
}

Anwendungsfälle

Nächtliche Katalog-Generierung

Ein Cronjob startet um 2:00 Uhr. Die aktuellen Produktdaten werden aus dem PIM gezogen. Publixx Server generiert den Katalog als PDF. Um 6:00 Uhr liegt die aktuelle Version im Intranet.

On-Demand Datenblätter

Ein Kunde fordert ein Datenblatt an. Das CRM triggert einen Webhook. Publixx Server erstellt das personalisierte PDF. Der Kunde erhält es per E-Mail – in Sekunden, nicht Stunden.

CI/CD Pipeline

Jeder Merge in den Main-Branch löst einen Build aus. Teil des Builds: Dokumentation als PDF generieren. Publixx Server läuft als Service im Kubernetes-Cluster.

Multi-Channel Publishing

Ein Template, viele Ausgabekanäle. PDF für Print, PowerPoint für den Vertrieb, HTML für die Website, Excel für das Controlling. Derselbe Datensatz, unterschiedliche Formate.

Integration

Publixx Server integriert sich in bestehende Infrastrukturen. REST-API bedeutet: Jede Programmiersprache kann damit arbeiten. Python, Java, C#, PHP – ein HTTP-Request genügt.

Für komplexere Szenarien gibt es Webhooks. Publixx Server benachrichtigt Ihr System, wenn ein Export fertig ist. Oder wenn ein Fehler auftritt.

Die generierten Dateien können direkt in Cloud-Storage landen. S3, Azure Blob, Google Cloud Storage. Oder in Ihrem lokalen Dateisystem, NAS, SharePoint.

Performance

Ein typischer PDF-Export mit 20 Seiten dauert 3-5 Sekunden. PowerPoint mit 50 Folien etwa 8-12 Sekunden. Das hängt von der Komplexität ab – Bilder, Diagramme, Datenmengen.

Für höheren Durchsatz: Mehrere Instanzen parallel betreiben. Jede Instanz hält einen Browser-Pool. Requests werden verteilt. Skalierung ist linear.

Sicherheit

Publixx Server läuft in Ihrer Infrastruktur. Keine Daten verlassen Ihr Netzwerk. Keine Cloud-Abhängigkeit. Keine Drittanbieter.

Der Container läuft ohne Root-Rechte. Chrome ist sandboxed. Netzwerkzugriff ist konfigurierbar – nur die Domains erlauben, die nötig sind.

Voraussetzungen

Für lokale Installation: Node.js 18 oder höher. Chrome oder Chromium.

Für Docker: Docker Engine 20 oder höher. 2 GB RAM minimum, 4 GB empfohlen.

Publixx Server nutzt dieselben Templates wie die Browser-Version. Keine Konvertierung, keine Anpassung nötig.

Der Vorteil der gemeinsamen Codebasis

Andere Lösungen trennen zwischen "Designer" und "Server". Zwei Produkte, zwei Codebasen, zwei Probleme. Templates müssen konvertiert werden. Features fehlen auf einer Seite. Updates kommen zeitversetzt.

Publixx geht einen anderen Weg. Der Template Designer im Browser und der headless Server teilen sich 100% des Codes. Ein Update verbessert beide. Ein Bugfix wirkt überall. Ein Template funktioniert identisch.

Das bedeutet für Sie: Was Ihr Designer im Browser erstellt, können Sie direkt automatisieren. Keine Überraschungen, keine Kompatibilitätsprobleme, keine "funktioniert nur manuell"-Einschränkungen.

Erste Schritte

Laden Sie das Publixx Server Paket herunter. Kopieren Sie Ihre bestehenden Publixx-Templates in das `publixx`-Verzeichnis. Starten Sie den Server. Rufen Sie die API auf.

# Installation
npm install
# Erster Test
node test-local.js --config=ihr-template.json --pdf --visible
# Server starten
node server.js
# Export via API
curl -X POST http://localhost:3000/api/export \
  -H "Content-Type: application/json" \
  -d '{"config": "ihr-template.json", "format": "pdf"}'

Die generierte Datei liegt im `output`-Verzeichnis.

Kontakt

Haben Sie Fragen zur Integration? Benötigen Sie Unterstützung beim Setup? Wir helfen Ihnen gerne.

incoxx GmbH

E-Mail: info@incoxx.com

Web: www.incoxx.com 

Publixx Server ist Teil der Publixx-Produktfamilie. Dieselbe Qualität, dieselbe Flexibilität – jetzt auch für Ihre automatisierten Workflows.