PDF & DOCX Generierung

Zusätzlich zum normalen Erzeugen von DOCX und PDF Dokumenten aus Word-Templates, unterstützt Stella mittels einer externen API die ERstellung dieser Formate auf Basis von beliebigem HTML.

Setup

Für die Nutzung muss ein Konto für ConvertAPI bestehen und ein Token generiert worden sein:

Dieser Token muss in der Konfiguration der Helper Applikation eingetragen werden:

Dieser Token gilt dabei sowohl für die PDF- als auch für die DOCX-Generierung.

Auslöser

Normalerweise wird der Service in der Helper Applikation periodisch aufgerufen durch ein periodisches Script im CRM. Die URL lautet

https://<hostname>/pfadzumhelper/helper.nsf/index.xsp/html2pdf

bzw.

https://<hostname>/pfadzumhelper/helper.nsf/index.xsp/html2docx.

Es gibt einen Rückgabewert in Form eines JSON Response, der im Erfolgsfall so aussieht:

{
    "message": "Found 1 data source(s) for html conversion generation\n",
    "errors": "",
    "status": "ok"
}

Die Menge an "gefundenen Quellen" im message-Teil variiert je nach dem wieviele definiert wurden.

Datenquelle definieren

Die Funktion erwartet eine Datenbankkonfiguration (Data Source) in der Helper Applikation vom Typ "HTML 2 PDF". Dadurch werden die Infos im Reiter HTML 2 PDF relevant:

Feld	Beschreibung
Document Selection Formula	Auswahlformel für Dokumente, die zu konvertierendes HTML in einem Feld enthalten
Flag Field Name	Feld, welches später durch einen neuen Wert beschreibt, dass das Dokument konvertiert wurde
Flag Computation Formula	Werteformel für das Flag Field, i.d.R. ein statischer Wert
Source Field Name (MIME)	Feld im Dokument, welches das HTML enthält
Target Field Name (Attachment)	Feld im Dokument, in dem später die Datei gespeichert wird
Field for PDF Title	Feld, das den Titel für das spätere PDF/DOCX Dokument enthält