En plus d'exporter des documents depuis DocuWare, vous pouvez créer des fichiers d'index avec docXporter. Cette fonction est particulièrement importante lors du transfert de documents et d'autres informations vers des systèmes ERP ou CRM.
Il n'existe pas de norme concernant le format et les caractéristiques avec lesquels ces fichiers d'index sont créés et traités. Il n'y a pas « un » type de fichier d'index : le format et la structure diffèrent, parfois de manière significative, d'un système cible à l'autre.
Grâce au moteur de modèles Scriban, docXporter crée pratiquement n'importe quel type de fichier d'index : les fichiers CSV et XML ne posent aucun problème.
Créer des modèles
Le moteur de modèles repose sur Scriban. Utilisez le manuel disponible sur la page du projet GitHub comme référence : https://github.com/scriban/scriban/tree/master/doc
Vous trouverez plusieurs modèles dans le dossier C:\ProgramData\docXporter\Templates. Utilisez-les comme base pour vos propres modèles. Les modèles doivent avoir l'extension de fichier .sbntxt. Faites une copie de l'un des modèles pour vos propres besoins.
Nous recommandons Visual Studio Code et l'extension associée Scriban pour la coloration syntaxique lors de l'édition.
Accès aux champs d'index
Les champs d'index sont disponibles sous forme de variables. Le nom de la base de données DocuWare est utilisé comme nom en majuscules.
Toutes les informations placées entre accolades {{ instructions entre accolades }} sont interprétées par le moteur de modèles. Tous les autres textes situés en dehors des accolades sont statiques et restent inchangés.
Extrait abrégé du modèle DATEV REWE :
{{-date.now | date.to_string "%Y%m%d%H%M%S"-}};;"DocXporter";"admin";"";"{{-BERATER-}}";Le contenu du champ BERATER s'affiche à droite. Lorsqu'il est utilisé entre des sorties de texte statique, le nom du champ est indiqué au format {{-BERATER-}}.
La date et l'heure actuelles s'affichent à gauche.
Accès aux champs de tableau
L'accès aux champs de tableau s'effectue de la même manière. Le champ de tableau SPLITBUCHUNG est également disponible sous forme de variable. Une boucle peut être utilisée pour itérer sur les lignes. Les valeurs des différentes colonnes sont alors accessibles via row.DBNAME.
Extrait abrégé du modèle DATEV REWE :
{{~ for row in SPLITBUCHUNG ~}}
{{- row.SPLIT_ERPEXPORT_BETRAG -}};{{- row.SPLIT_SOLLHABEN -}};"{{- W_HRUNG -}}";;;"";"{{- row.SPLIT_KONTO | get_value -}}";"{{-FIRMENKONTO-}}";
{{~ end # for of Table-Field ~}}L'exemple commence par une boucle
for. Celle-ci amène le moteur de modèles à itérer sur chaque ligne (variablerow) du champ de tableauSPLITBUCHUNGL'accès à une colonne / un champ s'effectue via
row.DBNAME. Ici par exemple,{{- row.SPLIT_ERPEXPORT_BETRAG -}}Bien entendu, les autres champs d'index sont également accessibles à l'intérieur de la boucle :
{{-COMPANY-ACCOUNT-}}La boucle se termine à la dernière ligne par end. La sortie comprise entre for..end est écrite dans le fichier d'index cible tant qu'il y a des lignes dans le champ de tableau.
La ligne
{{- row.SPLIT_KONTO | get_value -}}est remarquable. La valeurSPLIT_KONTOy est traitée par une fonctionget_value. Dans ce cas précis, l'objectif est de n'afficher que le numéro de compte (4711) et non la valeur réelle du (4711>Exemple général).