Konfiguration von docXporter

Da die in einer XML-Datei verwendete Syntax einige Zeichen reserviert hat, müssen diese umgeschrieben werden, um sie in der Datei zu speichern. Die folgende Tabelle zeigt die am häufigsten umgeschriebenen Zeichen. Probleme treten besonders häufig auf, weil das Zeichen & nicht umgeschrieben wird.

Klassische Beispiele sind DocuWare-Organisationsnamen für Unternehmensformen wie GmbH & Co KG oder wenn SQL-Abfragen mit größer als/kleiner als Bedingungen.

Probleme können auch auftreten, wenn Zeichen außerhalb des ASCII-Zeichensatzes verwendet werden. Beispiele hierfür sind é, à usw.

Solche Zeichen müssen ebenfalls durch entsprechende Ersatzzeichen ersetzt werden. Eine Internetsuche nach „Unicode-Zeichentabelle“ bringt beispielsweise die folgende Seite hervor: https://www.utf8-zeichentabelle.de/unicode-utf8-table.pl?names=-&unicodeinhtml=hex

Demnach wird beispielsweise das Zeichen é durch é oder à durch à ersetzt. Es ist natürlich auch möglich, die jeweilige hexadezimale Notation zu verwenden.

URL zu DocuWare Platform Services

Beispiel: https://DOCUWARESERVER/DocuWare/Platform

Ersetzen Sie den Wert DOCUWARESERVER durch denselben Servernamen wie für den DocuWare Web Client

Benutzername des DocuWare-Benutzers, den die Anwendung zum Anmelden bei DocuWare verwendet.

Wenn dieser Parameter leer bleibt, versucht die Anwendung, sich über die Windows-Authentifizierung mit dem Benutzer anzumelden, mit dem die Anwendung gestartet wurde.

Passwort des DocuWare-Benutzers, den die Anwendung zum Anmelden bei DocuWare verwendet.

Das Passwort muss über das bereitgestellte Verschlüsselungstool verschlüsselt werden. Sie finden eine Verknüpfung im Konfigurationsdateien-Ordner.

Die DocuWare-Organisation, bei der die Anwendung registriert ist.

GUID des DocuWare-Dateischranks, aus dem die Dokumente exportiert werden. Die GUID finden Sie in der DocuWare-Konfiguration in den allgemeinen Einstellungen des Dateiarchivs.

GUID des Suchdialogs, der verwendet wird, um die Dokumente für den Export zusammenzustellen. Die GUID finden Sie in der DocuWare-Konfiguration in den Dateiarchiv-Dialogen.

Aktivieren oder deaktivieren Sie die Option, den Stempel auf das exportierte Dokument zu setzen.
Gültige Werte sind True = aktiv, False = nicht aktiv.

Beachten Sie weitere Informationen zu Stempeln unten.

Dieser Schalter wird ignoriert, wenn EnableStamps den Wert False hat.

Entscheiden Sie, ob

• der Stempel vor dem Export des Dokuments gesetzt wird und daher in den exportierten Dokumenten enthalten ist (wenn Anmerkungen über den ExportMode exportiert werden sollen)

• oder nachdem das Dokument exportiert wurde.

Gültige Werte sind

• True = Stempel vor dem Export

• False = Stempel nach dem Export

Bezeichnet die Anmerkungsebene, auf der der Stempel angewendet wird. Standardmäßig hat diese Einstellung den Wert 1.

Position in Pixeln, beginnend am linken Rand des Dokuments, an der der Stempel platziert wird.

Für die automatische Positionierung des Stempels muss hier -1 eingegeben werden.

Position in Pixeln, beginnend am oberen Rand des Dokuments, an der der Stempel platziert wird.

Für die automatische Positionierung des Stempels muss hier -1 eingegeben werden.

Name des Stempels, der während des Exports auf das Dokument angewendet wird.

Gültige Werte sind DocuWare und SQL.

Geben Sie das Format an, in dem die Dokumente nach dem Export im Dateisystem gespeichert werden. Beachten Sie dabei Groß- und Kleinschreibung.

Definieren Sie, welcher Teil des Dokuments exportiert werden soll.

Der Index des zu exportierenden Abschnitts. Damit diese Einstellung verwendet werden kann, muss der Wert in der Einstellung ExportCoverage auf SectionIndex gesetzt werden.

Definiert den Ordner, in den die Dokumente exportiert werden sollen. Beispiel: C:\Export\ (UNC-Pfad ist möglich). Wenn der Ordner nicht existiert, wird er erstellt. Indexwerte des Dokuments können hier auch verwendet werden, indem der Feldname in geschweiften Klammern angegeben wird, z.B. {COMPANY}. Wie bei den anderen Einstellungen wird der Feldname gemäß dem Datenbanknamen des DocuWare-Felds angegeben.

Beispiel: C:\Export\{COMPANY}\

Der ExportPath kann auch Teile eines DocuWare-Datumfelds enthalten, z.B. den Monat oder das Jahr. Nach der Angabe des Feldnamens wird die .net-konforme Datumsformatierung mit einem Doppelpunkt angegeben, z.B. {DATE:MMMM} für den vollständigen Monatsnamen oder {DATE:yy} für ein zweistelliges Jahr.

Wenn sowohl Monat als auch Jahr in einem Exportpfad verwendet werden, werden die Informationen in einem eingegeben.

Beispiel: C:\Export\{DATE:yyyy}\{DATE:MMMM}\{COMPANY}\

Ergebnis: C:\Export\2021\Januar\Peters Engineering\

Definiert die Struktur des Dateinamens der exportierten Datei. Sowohl feste Werte als auch Indexwerte des Dokuments können hierfür verwendet werden. Im Falle von Indexwerten wird der Feldname in geschweiften Klammern angegeben, z.B. {COMPANY} oder {DWDOCID}. Wie bei den anderen Einstellungen wird der Feldname gemäß dem Datenbanknamen des DocuWare-Felds angegeben. Die Dateien werden standardmäßig als PDF-Dateien exportiert.

Verwenden Sie einen eindeutigen Dateinamen, um versehentliches Überschreiben zu verhindern. Unter bestimmten Umständen können verschiedene Dokumente während des Exports denselben Dateinamen erhalten, nämlich wenn beide Dokumente denselben Wert in den Indexfeldern enthalten, aus denen der Dateiname erstellt wird. In diesem Fall wird das bereits exportierte Dokument überschrieben.

Dies gilt insbesondere für das Exportziel MergedPdf.

Geben Sie die Komprimierung für das Speichern der Tiff-Dateien an. Beeinflussen Sie die Qualität und Dateigröße. Folgende Werte stehen zur Verfügung:

• JPEG: Empfohlen für Farbdokumente und Dokumente mit Graustufen

• CcittGroup4: Empfohlen für Schwarz-Weiß-Dokumente

Geben Sie die Auflösung des Tiffs an. Je höher der Wert, desto besser kann die Qualität sein, aber die Dateigröße wird bei hohen Werten potenziell zunehmen.

Enthält die Indexwerte, die nach dem Export geändert werden sollen, um exportierte Dokumente vom Exportfilter auszuschließen. Die Konfiguration funktioniert im Grunde genauso wie bei DWArchivFilter.

Die allgemeine Syntax der DWArchivUpdateIndex-Einstellung sieht so aus. Für jedes DocuWare-Feld muss eine weitere Item-Zeile hinzugefügt werden.

<Object Name="DWArchivUpdateIndex" Type="Docuscan.DocuwareExporter.Configuration.FieldMapping">
  <Item Name="STATUS" Value="Exported" />
</Object>

Der Wert des Name-Attributs entspricht dem Datenbanknamen des DocuWare-Felds in Großbuchstaben (kann in der DocuWare-Konfiguration der Feldeigenschaften des jeweiligen Felds gefunden werden). Manchmal enthalten diese auch wenn bei der Erstellung des Felds Sonderzeichen verwendet wurden. Diese müssen ebenfalls eingegeben werden, zum Beispiel: Name=”COMPANY”

Beispiel: <Item Name=“EXPORTED_” Value=“done” />. Der Wert ist entweder ein fester Wert oder ein relatives Datum wie DATE(-1) für das Datum des Vortages.

Steuert, ob eine Indexdatei für ein Dokument erstellt werden soll und wie sie erstellt wird. Groß-/Kleinschreibung muss beachtet werden.

Definiert die Struktur des Dateinamens der exportierten Datei. Sowohl feste Werte als auch Indexwerte des Dokuments können hierfür verwendet werden. Im Gegensatz zur Einstellung FileName (siehe oben) muss hier die Dateierweiterung angegeben werden.

Der Pfad zur Vorlagendatei. Wenn nur der Dateiname angegeben wird, wird die Vorlage im Ordner C:\ProgramData\docXporter\Templates gesucht. Wenn ein Pfad angegeben wird, wird dieser direkt verwendet.

Steuert, ob der Export in eine ZIP-Datei oder einen Dateisystemordner erfolgt.

Geben Sie hier das Muster an, aus dem der Dateiname für die Ausgabedatei erstellt werden soll.

Es ist nicht erforderlich, die Dateierweiterung hier anzugeben, da diese automatisch zugewiesen wird. Abhängig davon, welches Exportziel ausgewählt wurde, lautet die Erweiterung .zip oder .pdf

Die Dateien werden im Ordner bereitgestellt, wie in der Einstellung ExportPath angegeben.

Beim Erstellen einer Zip-Datei wird die Struktur der Dokumentdateinamen innerhalb der Zip-Datei über die Einstellung FileName definiert.

Beispiel: {CUSTOMER_NUMBER}

Um die Dokumente zu gruppieren, wird diese Einstellung verwendet, um eine Gruppierung aus einem oder mehreren Indexbegriffen zu erstellen.

Der hier definierte Wert wird an den intern generierten temporären Pfad angehängt, um die jeweiligen Dokumente nach Abschluss des Exports in die vorgesehenen ZIP-Dateien zu packen oder daraus eine zusammengeführte PDF-Datei zu erstellen.

Beispiel: {COMPANY}\{CUSTOMER_NUMBER} Nach diesem Beispiel werden ZIP-Dateien erstellt, die Dokumente mit demselben Wert in den Indexfeldern COMPANY und CUSTOMER_NUMBER enthalten.

DocXporter wird verwendet, um alle Rechnungen für das aktuelle Quartal zu exportieren, die noch nicht exportiert wurden.

Dies wird in der Konfigurationsdatei angegeben:

<setting name="DWArchivFilter" serializeas="Xml">
 <value>
   <arrayofstring xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
     <string>DOCUMENT_DATE=SEARCH_QUARTER()</string>
     <string>DOCUMENT_TYPE=Invoice</string>
     <string>STATUS=NOT Exported</string>
   </arrayofstring>
  </value>
</setting>

Nun sollen anstelle der Rechnungen die Gutschriften des aktuellen Quartals exportiert werden, bei denen der Kunde „Peters Engineering“ ist. Zusätzlich sollte das Statusfeld auf „Exported“ gesetzt werden.

Die folgenden Parameter werden angegeben:

DocXporter.exe -q “DOCUMENT_TYPE=Invoice#CUSTOMER=Peters Engineering” -u “STATUS=Exported”

Da DOCMENT_DATE in der Konfiguration bereits korrekt eingestellt ist, muss es nicht erneut angegeben werden.