Abstrakt

In diesem Artikel erfahren Sie, wie Sie PDFs in Ihren Simplifier-Anwendungen generieren können.

Prerequisites

• A customized PDF Template (see Create a PDF Template via Plugin)

Step 1 – Integration into your Application

To generate a PDF in your application, go to the Process Designer, and add a Business Object shape into the Story map where the PDF should be generated.

Select the Business Object “SF_PDF” and select the call “generate”. This business object is part of the Simplifier Standard Content and should already be available.

If you’re missing the Business Object, please visit our marketplace and download the latest version of the StandardContent.

Öffnen Sie den Eingabezuordnungsdialog und geben Sie die Parameter templateName und data ein. Der Vorlagenname kann mit einem konstanten Wert gefüllt werden.
Der data-Parameter ist optional – je nachdem, ob Ihre Vorlage dynamische Daten anzeigen soll – und sollte mit Variablen gefüllt werden.

Im Ausgabemapping werden die base64-Daten der generierten PDF-Datei zurückgegeben und können auf ein UI-Widget vom Typ “PDFViewer_PDFJS” abgebildet werden.

Schritt 2 – Konfigurationen für das PDF

Das serverseitige Business Objekt ‘SF_PDF‘ hat zwei Funktionen: ‘generate‘ und ‘generateWithConfig‘.
Wenn Sie Ihre Daten einfach nur in einer PDF-Datei anzeigen möchten, reicht es aus, die Funktion “Generieren” zu verwenden.
Wenn Sie jedoch einige Konfigurationen hinzufügen möchten, z. B. die Seitengröße oder die Seitenausrichtung, verwenden Sie ‘generateWithConfig’.
‘GenerateWithConfig’ verfügt über einen zusätzlichen Parameter: ‘configJSON’.
In diesem Parameter können Sie Ihre Konfigurationen im JSON-Format festlegen.

Beispiel:

var oConfig = {
    "orientation": "Landscape",
    "page-size": "A4",
    "margin-top": "1in",
    "margin-bottom": "1in",
    "margin-left": "1in",
    "margin-right": "1in",
    "footer-center": "[page] / [toPage]"
};

Anwendungsbeispiel

Laden Sie die Beispielanwendung vom Simplifier-Marktplatz herunter und importieren Sie die Datei in Ihre Simplifier-Instanz.
Nachdem Sie die Anwendung importiert und geöffnet haben, sollten Sie von einem Bildschirm begrüßt werden, auf dem auf der linken Seite eine Tabelle mit einigen Dummy-Daten und auf der rechten Seite ein leerer PDF-Viewer angezeigt wird.
Durch Drücken der Schaltfläche “PDF generieren ” wird eine PDF-Datei generiert und angezeigt.
Bitte stellen Sie sicher, dass das TestTemplate auf Ihrer Simplifier-Instanz verfügbar ist.

Falls Sie das laufende Beispiel mit Ihrer eigenen PDF-Vorlage testen möchten, müssen Sie nur den Namen der PDF-Vorlage in der SF_Example_PDF Anwendung ersetzen.
Gehen Sie zum Prozessdesigner und öffnen Sie die Story “PDF generieren” und ändern Sie den konstanten Wert von templateName im Eingabe-Mapping des Business Objekts “SF_PDF-> generieren“, das derzeit auf TestTemplate gesetzt ist. Die Daten, die an das PDF-Plugin gesendet werden, sind eine globale Variable mit einem vordefinierten Wert.
Sie finden es auf der Data Workbench.