DW2WIN wird über ein Parameterdokument konfiguriert, das im IEF-Archiv in DocuWare liegt. Jede Konfigurationsgruppe (DW2WIN.<id>) enthält die folgenden Einstellungen. Mit DW2WIN init --group=... legen Sie Parameter an oder aktualisieren sie.
Globale Parameter
| Parameter | Beschreibung | Erforderlich | Mehrfach |
|---|
exportInterval | Minuten zwischen zwei Exportläufen, wenn DW2WIN als Dienst läuft. | Nein | Nein |
Läuft DW2WIN als Windows-Dienst, muss exportInterval größer als 0 sein. Der Wert 0 exportiert einmal und beendet das Programm. Das eignet sich nur für eine geplante Aufgabe oder einen manuellen Start.
Gruppenparameter
| Parameter | Beschreibung | Erforderlich | Mehrfach |
|---|
archive | Name des DocuWare-Archivs, aus dem exportiert wird. | Ja | Nein |
mandant | Kennung des Mandanten. Sie wird zwischen dem Basisordner und den Ordnerzuordnungen eingefügt. | Nein | Nein |
exportBasisFolder | Basispfad für die exportierten Dateien. | Nein | Nein |
fileTransferMappings | Zuordnung der Zielordner für den Dateitransfer. | Nein | Ja |
exportFilterFileTransfer | Filter für die Auswahl der zu exportierenden Dokumente. | Nein | Ja |
statusUpdate | DocuWare-Indexfeld, das nach dem Export geschrieben wird. | Nein | Nein |
statusUpdateForExport | Statuswerte, die ein Dokument als exportbereit kennzeichnen. | Nein | Ja |
stamp | Name des Stempels, der auf exportierte Dokumente gesetzt wird. | Nein | Nein |
layers | Anmerkungsebenen, die in den Export aufgenommen werden. | Nein | Nein |
firstSectionOnly | Exportiert nur den ersten Abschnitt jedes Dokuments. | Nein | Nein |
keepAnnotations | Exportiert Dokumente als PDF mit Stempeln und Anmerkungen. E-Rechnungen, die über eInvoiceField erkannt werden, behalten ihr Originalformat, sofern forcePDF nicht gesetzt ist. | Nein | Nein |
defaultFileType | Dateiformat, wenn keepAnnotations deaktiviert ist (PDF, Auto oder zip). Voreingestellt ist PDF. Für die ältere Gruppe IEF2WIN gilt Auto. | Nein | Nein |
eInvoiceField | DocuWare-Indexfeld für ZUGFeRD- und Factur-X-Rechnungen. Ist das Feld gefüllt, gilt das Dokument als E-Rechnung. | Nein | Nein |
forcePDF | Wandelt E-Rechnungen ebenfalls nach PDF, wenn keepAnnotations aktiv ist. Anmerkungen bleiben erhalten, das eingebettete XML entfällt. | Nein | Nein |
Parameter mit mehreren Werten können für dieselbe Gruppe mehrfach in der Tabelle stehen. Neue Gruppen heißen DW2WIN.<id>, zum Beispiel DW2WIN.MyCompany. Die älteren Gruppen DW2WIN, DW2WIN2 und IEF2WIN werden weiterhin unterstützt.
Anmerkungen und E-Rechnungen
Ist keepAnnotations aktiv, exportiert DW2WIN die meisten Dokumente als PDF, damit Stempel und Anmerkungen erhalten bleiben. E-Rechnungen, die über eInvoiceField erkannt werden, bleiben im Originalformat, in der Regel XML, damit die eingebetteten Rechnungsdaten erhalten bleiben. Ist keepAnnotations deaktiviert, gilt stattdessen defaultFileType. XML- und ZIP-Dateien werden immer unverändert exportiert.
Ist zusätzlich forcePDF aktiv, werden auch E-Rechnungen nach PDF gewandelt. Das eingebettete XML entfällt dann. Die Datei ist danach keine ZUGFeRD- oder Factur-X-Rechnung mehr.