dgsoft 4ac60601f0 Update 1

2025-10-01 21:14:31 +02:00

4.6 KiB

Raw Permalink Blame History

🧪 Template Testing - Automatische Test-Funktionen

📋 Übersicht

Der DOCX Template Server bietet jetzt automatische Template-Test-Funktionen, die Templates analysieren und mit zufälligen Daten befüllen können.

🚀 Neue Funktionen

1. 📊 Template-Analyse

Endpoint: GET /analyze-template/{templateName}

Analysiert ein Template und zeigt alle gefundenen Tags an:

curl http://localhost:3000/analyze-template/simple-template.docx

Response:

totalTags: Anzahl gefundener Tags
simpleTags: Einfache Platzhalter (++name++, ++email++)
tableTags: Tabellen-Tags (++items[0].product++)
tableNames: Erkannte Array-Namen
exampleData: Beispiel-Daten für alle Tags

2. 🎲 Automatisches Test-Dokument

Endpoint: POST /test-template/{templateName}

Erstellt automatisch ein Test-Dokument mit zufälligen Daten:

curl -X POST -H "Content-Type: application/json" \
     -d '{"rowCount": 5}' \
     http://localhost:3000/test-template/simple-template.docx

Parameter:

rowCount: Anzahl der Tabellenzeilen (Standard: 3)

🏷️ Unterstützte Tag-Typen

Einfache Tags

Der Server erkennt automatisch verschiedene Tag-Typen und generiert passende Daten:

Tag-Muster	Beispiel-Daten
`++name++`	Max Mustermann
`++vorname++`	Anna
`++firma++`	Tech Solutions GmbH
`++email++`	max@beispiel.de
`++datum++`	15.10.2025
`++preis++`	1.234,56 €
`++telefon++`	+49 123 4567890
`++stadt++`	Berlin
`++straße++`	Hauptstraße 42

Tabellen-Tags

Unterstützt Array-Syntax für Tabellen:

++items[0].product++
++items[0].quantity++
++items[0].price++

Wird automatisch zu einem Array von Objekten:

{
  "items": [
    {
      "product": "Premium Service",
      "quantity": 3,
      "price": "299.99 €"
    }
  ]
}

🎯 Intelligente Daten-Generierung

Deutsche Stammdaten

Namen: Max Mustermann, Anna Schmidt, Peter Weber...
Firmen: Tech Solutions GmbH, Digital Services Ltd...
Städte: Berlin, München, Hamburg, Köln...
Produkte: Premium Service, Business Solution...

Kontext-bewusste Generierung

Tags mit "email" → E-Mail-Adressen
Tags mit "preis" → Geldbeträge in Euro
Tags mit "datum" → Deutsche Datumsformate
Tags mit "telefon" → Deutsche Telefonnummern
Tags mit "produkt" → Produktnamen

📄 Verwendungsbeispiele

1. Template analysieren

# Alle Tags in einem Template anzeigen
curl http://localhost:3000/analyze-template/mein-template.docx | jq '.'

2. Schneller Test

# Test-Dokument mit 3 Tabellenzeilen
curl -X POST http://localhost:3000/test-template/mein-template.docx

3. Umfangreicher Test

# Test-Dokument mit 10 Tabellenzeilen
curl -X POST -H "Content-Type: application/json" \
     -d '{"rowCount": 10}' \
     http://localhost:3000/test-template/mein-template.docx

4. Direkt in MS Word öffnen

Das generierte Test-Dokument kann direkt über die WebDAV-URL in MS Word geöffnet werden:

ms-word:ofe|u|http://localhost:3000/webdav/output/test_template_123.docx

🔧 Template-Entwicklungs-Workflow

Template erstellen in MS Word mit ++tag++ Platzhaltern
Template analysieren mit /analyze-template/
Test-Dokument generieren mit /test-template/
Ergebnis prüfen und Template ggf. anpassen
Produktive Nutzung mit /generate-document

📊 Beispiel-Response

{
  "success": true,
  "templateName": "simple-template.docx",
  "foundTags": ["name", "email", "items[0].product"],
  "tableNames": ["items"],
  "generatedData": {
    "name": "Max Mustermann",
    "email": "max@beispiel.de",
    "items": [
      {
        "product": "Premium Service",
        "quantity": 2,
        "price": "299.99 €"
      }
    ]
  },
  "downloadUrl": "/download/test_simple-template_123.docx",
  "webdavUrl": "/webdav/output/test_simple-template_123.docx",
  "msWordUrl": "ms-word:ofe|u|http://localhost:3000/webdav/output/test_simple-template_123.docx",
  "message": "Test-Dokument erfolgreich erstellt mit 3 Tags und 1 Tabellen"
}

🎉 Vorteile

✅ Schnelle Template-Validierung ohne manuelle Daten-Eingabe
✅ Automatische Tag-Erkennung in DOCX-Dateien
✅ Intelligente Daten-Generierung basierend auf Tag-Namen
✅ Tabellen-Unterstützung mit konfigurierbarer Zeilenzahl
✅ Deutsche Lokalisierung für realistische Test-Daten
✅ Sofortige Ergebnisse mit Download- und WebDAV-Links
✅ MS Word Integration für direktes Öffnen

🚀 Jetzt können Sie Templates erstellen und sofort mit realistischen Daten testen!

4.6 KiB Raw Permalink Blame History