Configurer docXporter

La syntaxe utilisée dans un fichier XML réserve certains caractères ; ceux-ci doivent être réécrits pour pouvoir être enregistrés dans le fichier. Le tableau suivant présente les caractères les plus courants qui doivent être réécrits. Les problèmes surviennent particulièrement souvent lorsque l'esperluette n'est pas réécrite.

Les exemples classiques sont les noms d'organisation DocuWare des formulaires d'entreprise tels que GmbH & Co KG, ou les requêtes SQL comportant des conditions supérieur à / inférieur à.

Des problèmes peuvent également survenir si des caractères situés hors de l'espace de caractères ASCII sont utilisés. C'est par exemple le cas de é, à, etc.

Ces caractères doivent eux aussi être remplacés par les caractères de substitution correspondants. Une recherche sur Internet portant sur « Unicode character table » renvoie par exemple la page suivante : https://www.utf8-zeichentabelle.de/unicode-utf8-table.pl?names=-&unicodeinhtml=hex

Selon cette table, le caractère é est par exemple remplacé par é et à par à. Il est bien entendu également possible d'utiliser la notation hexadécimale correspondante.

URL des DocuWare Platform Services

Exemple : https://DOCUWARESERVER/DocuWare/Platform

Remplacez la valeur DOCUWARESERVER par le même nom de serveur que celui utilisé pour le DocuWare Web Client

Nom de l'utilisateur DocuWare avec lequel l'application se connecte à DocuWare.

Mot de passe de l'utilisateur DocuWare avec lequel l'application se connecte à DocuWare.

Le mot de passe doit être chiffré à l'aide de l'EncryptionTool fourni. Vous trouverez un raccourci dans le dossier des fichiers de configuration.

L'organisation DocuWare auprès de laquelle l'application est enregistrée.

GUID de l'armoire DocuWare depuis laquelle les documents sont exportés. Vous trouverez le GUID dans les paramètres généraux de l'armoire, dans DocuWare Configuration.

GUID de la boîte de dialogue de recherche utilisée pour rassembler les documents en vue de l'export. Vous trouverez le GUID dans les boîtes de dialogue d'armoire, dans DocuWare Configuration.

Active ou désactive l'option permettant d'apposer le tampon sur le document exporté.
Les valeurs valides sont True = activé, False = désactivé.

Reportez-vous aux informations complémentaires sur les tampons ci-dessous.

Ce commutateur est ignoré si EnableStamps a la valeur False.

Choisissez si :

• le tampon est apposé avant l'export du document et figure ainsi dans les documents exportés (si les annotations doivent être exportées via ExportMode) ;

• ou après l'export du document.

Les valeurs valides sont :

• True = tampon avant l'export

• False = tampon après l'export

Désigne le niveau d'annotation sur lequel le tampon est appliqué. Par défaut, ce réglage a la valeur 1.

Position en pixels, à partir du bord gauche du document, où le tampon est placé.

Pour un positionnement automatique du tampon, saisissez ici -1.

Position en pixels, à partir du haut du document, où le tampon est placé.

Pour un positionnement automatique du tampon, saisissez ici -1.

Nom du tampon appliqué au document lors de l'export.

Les valeurs valides sont DocuWare et SQL.

Indiquez le format dans lequel les documents seront enregistrés dans le système de fichiers après l'export. Tenez compte des majuscules et des minuscules.

Définit la partie du document à exporter.

L'index de la section à exporter. Pour que ce réglage soit pris en compte, la valeur SectionIndex doit être définie dans le réglage ExportCoverage.

Définit le dossier vers lequel les documents doivent être exportés. Exemple : C:\Export\ (un chemin UNC est possible). Si le dossier n'existe pas, il est créé. Vous pouvez aussi utiliser ici les valeurs d'index du document en indiquant le nom du champ entre accolades, par exemple {COMPANY}. Comme pour les autres réglages, le nom du champ est indiqué selon le nom de base de données du champ DocuWare.

Exemple : C:\Export\{COMPANY}\

Le ExportPath peut également contenir des parties d'un champ de date DocuWare, par exemple le mois ou l'année. Après le nom du champ, le format de date conforme à .NET est indiqué après deux-points, par exemple {DATE:MMMM} pour le nom complet du mois, ou {DATE:yy} pour une année à deux chiffres.

Si le mois et l'année sont tous deux utilisés dans un chemin d'export, l'information est saisie en une seule fois.

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

Résultat : C:\Export\2021\January\Peters Engineering\

Définit la structure du nom du fichier exporté. Vous pouvez utiliser à la fois des valeurs fixes et des valeurs d'index du document. Pour les valeurs d'index, le nom du champ est indiqué entre accolades, par exemple {COMPANY} ou {DWDOCID}. Comme pour les autres réglages, le nom du champ est indiqué selon le nom de base de données du champ DocuWare. Les fichiers sont exportés au format PDF par défaut.

Utilisez un nom de fichier unique afin d'éviter tout écrasement accidentel. Dans certaines circonstances, des documents différents peuvent recevoir le même nom de fichier lors de l'export, à savoir lorsque les deux documents contiennent la même valeur dans les champs d'index à partir desquels le nom de fichier est constitué. Dans ce cas, le document déjà exporté est écrasé.

Cela vaut en particulier pour la cible d'export MergedPdf.

Indiquez la compression utilisée pour enregistrer les fichiers Tiff. Elle influe sur la qualité et la taille du fichier. Les valeurs suivantes sont disponibles :

• JPEG : recommandé pour les documents en couleur et les documents en niveaux de gris

• CcittGroup4 : recommandé pour les documents en noir et blanc

Indiquez la résolution du Tiff. Plus la valeur est élevée, meilleure peut être la qualité ; toutefois, la taille du fichier risque d'augmenter avec des valeurs élevées.

Contient les valeurs d'index à modifier après l'export afin d'exclure les documents exportés du filtre d'export. La configuration fonctionne fondamentalement de la même manière que pour DWArchivFilter.

La syntaxe générale du réglage DWArchivUpdateIndex se présente comme suit. Une ligne Item supplémentaire doit être ajoutée pour chaque champ DocuWare.

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

La valeur de l'attribut name correspond au nom de base de données du champ DocuWare en majuscules (que vous trouverez dans les propriétés du champ concerné, dans DocuWare Configuration). Des caractères spéciaux comme y figurent parfois lorsqu'ils ont été utilisés lors de la création du champ. Ils doivent eux aussi être saisis, par exemple : Name=”COMPANY”

Exemple : <Item Name=“EXPORTED_” Value=“done” />. Value est soit une valeur fixe, soit une date relative telle que DATE(-1) pour la date de la veille.

Détermine si un fichier d'index doit être créé pour un document et comment il est créé. Les majuscules et les minuscules doivent être respectées.

Définit la structure du nom du fichier exporté. Vous pouvez utiliser à la fois des valeurs fixes et des valeurs d'index du document. Contrairement au réglage FileName (voir ci-dessus), l'extension de fichier doit être indiquée ici.

Le chemin du fichier modèle. Si seul le nom de fichier est indiqué, le modèle est recherché dans le dossier C:\ProgramData\docXporter\Templates. Si un chemin est indiqué, il est utilisé directement.

Détermine si l'export est effectué vers un fichier ZIP ou un dossier du système de fichiers.

Indiquez ici le modèle à partir duquel le nom du fichier de sortie doit être créé.

Il n'est pas nécessaire d'indiquer l'extension de fichier ici, car celle-ci est attribuée automatiquement. Selon la cible d'export sélectionnée, l'extension est .zip ou .pdf

Les fichiers sont mis à disposition dans le dossier défini dans le réglage ExportPath.

Lors de la création d'un fichier zip, la structure des noms de fichiers des documents au sein du fichier zip est définie via le réglage FileName.

Exemple : {CUSTOMER_NUMBER}

Pour regrouper les documents, ce réglage permet de créer un regroupement à partir d'un ou de plusieurs termes d'index.

La valeur définie ici est ajoutée au chemin temporaire généré en interne afin de regrouper les documents concernés dans les fichiers ZIP prévus une fois l'export terminé, ou de générer un PDF fusionné à partir de ces fichiers.

Exemple : {COMPANY}\{CUSTOMER_NUMBER} selon cet exemple, des fichiers ZIP sont créés contenant les documents qui partagent la même valeur dans les champs d'index COMPANY et CUSTOMER_NUMBER.

docXporter est utilisé pour exporter toutes les factures du trimestre en cours qui n'ont pas encore été exportées.

Voici ce qui est indiqué dans le fichier de configuration :

<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>

Désormais, au lieu des factures, ce sont les avoirs du trimestre en cours qui doivent être exportés, pour le client « Peters Engineering ». De plus, le champ Status doit être défini sur « Exported ».

Les paramètres suivants sont indiqués :

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

Comme DOCMENT_DATE a déjà été correctement défini dans la configuration, il n'est pas nécessaire de l'indiquer à nouveau.