Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Aufteilung und Extraktion von Dateien

ExtractFilesEInvoice()

Diese Funktion extrahiert eingebettete Anlagen aus einer E-Rechnungsdatei. Der Standardname für die Zieldateien ist %FileName% und bezieht sich auf die enthaltenen Anlagen, die somit standardmäßig unter ihrem Originalnamen extrahiert werden.

Als Quelldateien werden PEPPOL-, UBL-, XRechnung- und ZUGFeRD-Formate unterstützt, die vom Programm verarbeitet werden können. Das konkrete Format wird von der Makrofunktion selbst ermittelt. Im Fall des ZUGFeRD-Formats sind XML-Quelldateien und PDF-Quelldateien zulässig.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

3

Text

Namensfilter für die zu extrahierenden Dateianlagen

Standardwert: * (alle Dateianlagen)

Beispiele

ExtractFilesEInvoice("test.xml", "%FileBaseName%.extracted.%FileExt%", "*.pdf|*.xml") extrahiert aus einer E-Rechnungsdatei im XML-Format alle PDF-Dateianlagen und XML-Dateianlagen und ergänzt die Originalnamen um den Suffix extracted.

ExtractFilesPdf()

Diese Funktion extrahiert eingebettete Anlagen aus einer PDF-Datei. Der Standardname der Zieldateien ist %FileName% und bezieht sich auf die enthaltenen Anlagen, die somit standardmäßig unter ihrem Originalnamen extrahiert werden.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

3

Text

Namensfilter für die zu extrahierenden Dateianlagen

Standardwert: * (alle Dateianlagen)

4

Bool

Wahrheitswert, ob auch als Anmerkungen auf Seitenebene eingebundene Anlagen berücksichtigt werden

Standardwert: FALSE (nur globale Anlagen werden einbezogen)

Beispiele

ExtractFilesPdf("test.pdf", , "*.xml") extrahiert aus einer PDF-Datei alle XML-Dateianlagen unter dem Original-Dateinamen.

ExtractFilesZip()

Diese Funktion extrahiert Dateien aus einer komprimierten ZIP-Containerdatei. Der Standardname der Zieldateien ist %FileName% und bezieht sich auf die enthaltenen Dateien, die somit standardmäßig unter ihrem Originalnamen extrahiert werden.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

3

Text

Namensfilter für die zu extrahierenden Dateien

Standardwert: * (alle Dateien)

Beispiele

ExtractFilesZip("test.zip") extrahiert alle Dateien, die in einem ZIP-Archiv enthalten sind, unter dem Original-Dateinamen.

ExtractPages()

Diese Funktion extrahiert eine Seite oder einen zusammenhängenden Seitenbereich aus einer mehrseitigen TIFF- oder PDF-Datei.

Der Standardname der Zieldatei ist %FileBaseName%.extracted.%FileExt%.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

3

Text

Definition der Seite, ab der die Extraktion beginnen soll:

  • First: Extraktion ab der ersten Seite (Standardwert)

  • Last: Extraktion ab der letzten Seite

Alternativ kann eine konkrete Seitennummer angegeben werden.

4

Number

Anzahl zu extrahierender Seiten

Standardwert: 1

Bei der Startseite Last werden von hinten gezählt die letzten n Seiten der Datei extrahiert.

Beispiele

ExtractPages("test.pdf", , "Last", 3) extrahiert die letzten 3 Seiten aus einer PDF-Datei unter dem Namen test.extracted.pdf.

SplitByBarcode()

Diese Funktion trennt eine mehrseitige TIFF-Datei oder eine PDF-Datei anhand zu lesender Leitseiten-Barcode-Werte in mehrere Seitenbereiche auf.

Der Standardname der Zieldateien ist %FileBaseName%.split.%FileExt%. Als spezielle Variable für die Namensgebung steht hier zusätzlich %BcValue% zur Verfügung, die den zur Trennung herangezogenen Barcode-Wert beinhaltet.

Aufgrund der gefundenen Barcode-Werte ist keine Trennung der Quelldatei erforderlich. Dennoch wird eine Kopie der unveränderten Quelldatei als Zieldatei erzeugt (%FileBaseName%.split.%FileExt%). Auf diese Weise kann unabhängig vom Ergebnis der Barcode-Erkennung mit einheitlichen Zieldateinamen weitergearbeitet werden.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

3

Text

Arbeitsmodus für die Barcode-Suche und Seitentrennung:

  • First: Suche nach der ersten Seite mit einem Barcode und Trennung vor dieser Seite (Standardwert)

  • Last: Rückwärtssuche nach der letzten Seite mit einem Barcode und Trennung vor dieser Seite

  • All: Suche über alle Seiten und Trennung vor jeder Barcode-Seite

  • Repeat: Suche über alle Seiten und Trennung vor jeder Seite, auf der sich der Barcode-Wert gegenüber der vorigen Seite geändert hat – ausgeschlossen nicht gefundener Werte

4

Text

Typ der zu suchenden Barcodes:

  • Simple: normaler 1D-Barcode (Standardwert)

  • DM: Datamatrix-Code

  • QR: QR-Code

5

Text

Filter zur optionalen Beschränkung der Suche auf Barcodes mit einem bestimmten Inhalt oder Aufbau

Je Seite wird nur der erste gefundene Barcode herangezogen.

Syntax: siehe Syntax von Namensfiltern

Standardwert: *

6

Number

Auflösung (dpi) für eine bei PDF-Seiten notwendige implizite Konvertierung in Rasterbilder vor der Barcode-Erkennung

Standardwert: 300

7

Bool

Wahrheitswert, ob auch auf der ersten Seite zwingend ein Barcode gefunden werden muss oder ansonsten ein Fehler vorliegt

Standardwert: FALSE

8

Bool

Wahrheitswert, ob die Seiten mit dem Barcode nicht mit extrahiert werden

Standardwert: FALSE

Beispiele

SplitByBarcode("test.tif", , "All", "Simple", "A#######") trennt eine TIFF-Datei über alle Seiten anhand eines Barcodes mit dem angegebenen Muster in Einzeldateien namens test.split.tif. Für eine eindeutige Namensgebung kann der Zieldateiname %FileBaseName%.%FileNo%.%FileExt% definiert werden, sodass die Dateien in der Form test.1.tif, test.2.tif nummeriert werden.

SplitPdf()

Diese Funktion trennt eine PDF-Datei in ihre Einzelseiten auf.

Der Standardname der Zieldateien ist %FileBaseName%.split.pdf.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

Beispiele

SplitPdf("test.pdf") trennt eine PDF-Datei in Einzeldateien test.split.pdf pro Seite.

SplitTiff()

Diese Funktion trennt eine mehrseitige TIFF-Datei in ihre Einzelseiten auf.

Der Standardname der Zieldateien ist %FileBaseName%.split.%FileExt%.

Parameter

Datentyp

Beschreibung

1

Text

2

Text

Beispiele

SplitTiff("test.tif") trennt eine TIFF-Datei in Einzeldateien test.split.tif pro Seite.