Metainformationen zur Seite
Übersicht | X-tanken | Menü | Programme | Glossar | Themen | FAQ | Update
X-tanken
Häufig gestellte Fragen (FAQ)
Wie kann ich eigene Kommandos für den Download, die Einbettung von Hintergründen oder ZUGFeRD-Daten und den Mailversandt einrichten?
Dieser Artikel richtet sich ausdrücklich an die EDV-Fachleute in Ihrem Betrieb. Allen anderen Personenkreisen empfehlen wir die selbigen in entsprechende Überlegungen einzubeziehen und sich beraten zu lassen.
Es gibt Situationen, in denen es nicht möglich oder nicht gewünscht ist, die von X-tanken vorgegebenen und getesteten Befehle zu verwenden. Hierfür haben wir Ihnen die Möglichkeit eingebaut, den gewünschten Sachverhalt mit eigenen Kommandos umzusetzen. Dazu sind weitreichende Kenntnisse in der Shellprogrammierung erforderlich.
Um einen Befehl zu ersetzen schreiben Sie sich ein eigenes Shell-Script, oder ein Programm, welches die Parameter, die X-tanken vorgibt aufnimmt, die entsprechende Aufgabe erledigt und das gewünschte Ergebnis zur Verfügung stellt.
Wählen Sie in den Systembefehlsoptionen für die entsprechende Aufgabe den Eintrag „eigenes Kommando“ aus und geben Sie den Befehl inklusive seiner Parameter ein. Die von X-tanken dynamisch gefüllten Parameter sind durch Platzhalter in der Befehlszeile zu ersetzen. Folgende Platzhalter stehen dabei zur Verfügung:
| Bereich | Platzhalter | Beschreibung |
|---|---|---|
| Download | {URL} | Die URL, die zur herunterzuladenden Datei weist. (z.B. https://update.xpointsoftware.de/X-tanken/DOWNLOADTEST) |
| {Zieldatei} | Gibt an, wo die heruntergeladene Datei mit welchem Namen abzulegen ist. | |
| {Logdatei} | Die Datei in der die Fehlerausgaben des Download-Befehls gespeichert werden sollen. | |
| PDF-Hintergrund | {Quelldatei} | Es wird der Pfad und Dateiname zu einer PDF-Datei übergeben, die den Hintergrund erhalten soll. (z.B. Rechnungs-PDF ohne Hintergrund) |
| {Briefpapier} | Es wird der Pfad und Dateiname zu einer PDF-Datei übergeben, die das Briefpapier darstellt und in hinter die Quelldatei eingebunden werden soll. | |
| {Zieldatei} | Gibt an, wo und mit welchem Namen die zusammengeführte PDF-Datei abzulegen ist. | |
| {Lizenzkey} | Steht nur bei Verwendung des Befehls pdxt zur Verfügung. | |
| ZUGFeRD-Einbettung | {Quelldatei} | Es wird der Pfad und Dateiname zu einer PDF-Datei übergeben, die den Hintergrund erhalten soll. (z.B. Rechnungs-PDF ohne Hintergrund) |
| {Zusatzdatei} | Es wird der Pfad und Dateiname zu einer XML-Datei übergeben, die den ZUGFeRD-Anteil der Rechnung darstellt und in die Quelldatei eingebettet werden soll. | |
| {Zieldatei} | Gibt an, wo und mit welchem Namen die zusammengeführte PDF-Datei abzulegen ist. | |
| {Lizenzkey} | Steht nur bei Verwendung des Befehls pdf2pdf zur Verfügung. | |
| Mail-Versand | {Absender} | Es wird die Absender-E-Mail-Adresse übergeben, mit der die E-Mail versandt werden soll. |
| {Empfaenger} | Es wird die Empfänger-E-Mail-Adresse übergeben, die die E-Mail erhalten soll. Es wird immer nur eine E-Mail-Adresse angegeben. Ist der Versand an mehrere Empfänger erforderlich, so wird der Befehl mehrfach ausgeführt. | |
| {Betreff} | Der zu verwendende Betreff der E-Mail. | |
| {Inhalt} | Es wird der Pfad und Dateiname zu einer TXT-Datei übergeben, die den Inhalt (Body) der E-Mail darstellen soll. | |
| {Anhang} | Es wird der Pfad und Dateiname zu einer anzuhängenden Datei angegeben. Dies kann z.B. die Rechnung als PDF-Datei sein, aber auch die CSV-Datei, die die Rechnungsdaten enthält. Für mehrere Anhänge kann der Platzhalter {Anhang} in eckige Klammern eingeschlossen werden. Zum Beispiel: „[-a {Anhang}]“ dies wird von X-tanken als Iteration über mehrere zu versendende Anhänge verstanden. Achten Sie dabei auf die ggf. erforderlichen Leerzeichen. |
Testen Sie dann den Befehl. Nur wenn der Test erfolgreich war, kann der Befehl gespeichert werden. Sollte es beim Test zu einem Fehler kommen, so wird Ihnen dies im Bereich „Testergebnis“ auf der rechten Seite angezeigt.
Für „selbstgestrickte“ Shell-Scripte oder Befehle mit eingenen Parametern übernimmt der Anwender die volle Verantwortung. Xpoint wird hierfür keinen Support leisten.
Übersicht | X-tanken | Menü | Programme | Glossar | Themen | FAQ | Update