Knoten „Dokument aus E-Rechnung erstellen" verwenden

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins agorum core electronic invoicing. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Interne ID: agorum.electronic.invoicing.createView

Dieser Knoten erstellt aus E-Rechnungsdaten in XML-Format ein einfach lesbares Dokument auf Grundlage eines Dokumenttemplates. Die Angabe des zu verwendenden Dokumenttemplates ist erforderlich. Der Knoten erwartet E-Rechnungsdaten in der für agorum core normalisierten Form, die etwa durch einen vorgeschalteten parse-Knoten erstellt werden.

Aussehen des Knotens

Achtung: Für die Anzeige der Daten aus der XML-Rechnung in einem lesbaren Format setzt agorum core electronic invoicing voraus, dass Sie LibreOffice installiert haben. Wenn Sie noch OpenOffice verwenden, müssen Sie stattdessen LibreOffice installieren.

Verhaltensweise

Der Knoten liest die übergebenen E-Rechnungsdaten in der normalisierten Form und fügt diese Daten in das mit den Parametern angegebene Dokumenttemplate ein. Wenn Sie über die Parameter festlegen, dass ein PDF erzeugt werden soll, wird ein PDF-Dokument erzeugt, andernfalls ein Word-Dokument (in docx-Format).

Anwendung

Beispiel

Sie können den Workflow-Knoten dazu verwenden, die E-Rechnungsdaten aus der XRechnung einzulesen und in einem lesbaren Dokument darzustellen. In diesem Beispielworkflow wird eine der mitgelieferten Dokumentvorlagen verwendet, um das Dokument darzustellen. Es handelt sich bei dieser Anzeige des Dokuments also nicht um die Darstellung des Rechnungsausstellers, sondern um eine Möglichkeit zur Anzeige der XRechnung in einem frei gewählten Darstellungsformat.

Beispielworkflow mit dem createView-Knoten

Der createView-Knoten hat in diesem Fall folgende Einstellungen:

Als Dokumentvorlage wird eine der mitgelieferten Beispielvorlagen verwendet: Invoice_Template_Complete_All_Keys.docx
Texte und Formate werden in den Standardeinstellungen verwendet.
Es wird ein PDF-Dokument erzeugt.
Die normalisierten Rechnungsdaten werden über die Datenvariable parsedData empfangen.
Als Ausgangsvariable wird viewDocument gesetzt.

Der letzte Workflow-Knoten (agorum.object.file) dient dazu, das erzeugte Dokument zu speichern.

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
true (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
false (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Vorlage	Mit diesem Parameter geben Sie die Vorlage für die zu erstellende E-Rechnung an. Sie müssen eine Vorlage angeben.	/agorum/roi/customers/agorum.electronic.invoicing/template/Invoice_Template_Complete.docx
Texte	Über diesen Wert können Sie die Feldnamen für die zu generierende Rechnung angeben. Dadurch werden die Standardnamen der Metadaten überschrieben. Sie können Feldnamen nur angeben, wenn die entsprechenden Felder auch in der Standard-Ausprägung des Dokuments enthalten sind. Der Wert wird als JSON-Struktur übergeben. Geben Sie Texte wie folgt an: Wählen Sie ein Feld in der Liste Ursprungs-Text aus und tragen Sie den abweichenden Namen im Eingabefeld Wert ein. Weitere Felder können Sie über das Symbol + hinzufügen.	Abweichende Texte (Feldnamen) angeben
Format numerischer Werte	Sie können den Standardwert (deutsche Zahlenformatierung nach dem Schema für Deutschland, de-DE) überschreiben. Für eine Liste der möglichen Lokalisierungsangaben siehe Gebietsschema: Sprachcodes und Ländercodes. Durch die Angabe ändern Sie lediglich die Darstellung der Zahlen im generierten Dokument, nicht den gespeicherten Wert.	de-CH (für die Zahlenformatierung für die Schweiz) Zahlen werden dann etwa so dargestellt: 5'897.70 (und nicht 5.897,70)
Datums-Format	Über diesen Wert kann das Datums-Format für die generierte Rechnung angegeben werden. Der Wert wird für die Darstellung von Datumswerten in dem Dokument verwendet. Durch die Angabe ändern Sie lediglich die Darstellung der Datumsangaben im generierten Dokument, nicht den gespeicherten Wert.	dd-MM-yyyy (um das Datum mit Bindestrichen anstelle von Punkten darzustellen)
PDF erstellen	Markieren Sie die Checkbox, wenn aus dem befüllten Template ein PDF-Dokument erstellt werden soll. Andernfalls gibt der Knoten ein Word-Dokument (docx) zurück.
Datenvariable	Mit diesem Parameter geben Sie an, wo im Token die Arbeitsdaten für den Knoten enthalten sind, also der Abschnitt, in dem die normalisierten Rechnungsdaten enthalten sind. Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.	parsedData
Ausgangsvariable	Mit diesem Parameter geben Sie an, wo das Ergebnis des Knotens gespeichert werden soll. Dabei wird ein Ansichtsdokument der Rechnung erzeugt, welches für weitere Knoten verwendet werden kann. Bei dem Dokument handelt es sich um das erstellte und ausgefüllte Word-Dokument mit den Rechnungsdaten. Wird die Variable leer gelassen, überschreibt das Ergebnis die aktuellen Attachments des Workflows (Variable sys_acw_attachments). In der Ausgangsvariable wird stets ein Array hinterlegt, auch wenn nur 1 Eintrag vorhanden ist. Ist das Ergebnis des Knotens leer, so ist das Array ein leeres Array: [] Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.	viewDocument
Rechte	Siehe Rechte auf Knoten vergeben

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.