HowTo - CLARC INVOICE in 5 einfachen Schritten

Owned by Merve Yurdakul
Nov. 20, 2018
4 min read

Übersicht

Anforderung

Die Konfiguration für den initialen Betrieb des CLARC INVOICE Szenarios soll beschrieben werden. 

Module

CLARC INVOICE umfasst folgende Softwaremodule:

Je nach Anforderung wird zusätzlich CLARC EWORK eingesetzt, welches die Belege erfasst und zu Heftungen zusammenführt.

Voraussetzung

Vorerst müssen alle drei Module auf dem System installiert werden und lauffähig sein. Des Weiteren müssen die erforderlichen Datenbanktabellen angelegt werden. Die Datenbanktabellen werden bei der Installation von CLARC XCONTROL automatisch angelegt, wenn die Funktion "create database tables" aktiviert wird.

Informationen zur Installation finden Sie im Folgenden Bereich: Installation.

Packages importieren

Für die Einrichtung des Rechnungslesers stehen XML-Packages zur Verfügung, die alle Konfigurationsdaten beinhalten. Diese Packages werden über das Hauptmenü im C4 ausgewählt und importiert. Da die Knoten im C4 automatisch angelegt werden, ist eine Pfadangabe über „Root Node“ im Import-Dialog nicht notwendig.

Die Packages befinden sich nach der Installation unter <clarc>\packages\.

XML-Packages

xControl_Invoice.xml
XCTRL_Invoice_Reader_vxxx.xml (+ Fix Packages)

Information

Bitte beachten Sie beim Einspielen der Konfigurationsdaten auf die Version der XML-Dateien, damit Erweiterungen und Fehlerbehebungen mit importiert werden.

Vorbereitung

Als Beispiel dienend stellen wir auch dar, wie man für das Invoice Szenario ein Konvertierungsschema und ein Exportservice anlegt, um den Prozess zu vervollständigen. Es können sämtliche Konvertierungsschemen oder Exportservices definiert werden, dies hängt vom Prozess ab.

Als erstes wird die Conversion Engine angelegt, die befindet sich unter folgendem Pfad:

/clarc/Engines/Conversion/

 Dann wird das entsprechende Schema für die Conversion Engine hinterlegt

/clarc/Schemes/Conversion/

Außerdem muss noch ein Exportservice definiert werden. 

/clarc/Engines/Export/

Anpassung

Recognition Pfade anpassen

/clarc/Engines/Recognition/XCONTROL OCR/BARCODE
/clarc/Engines/Recognition/XCONTROL OCR/SCO

Hier muss einfach die richtige Library und die entsprechende Plattform ausgewählt werden.

Userexit Pfade anpassen

/clarc/Engines/Userexits/xControl/xControl_Invoice_Creditors
/clarc/Engines/Userexits/xControl/xControl_Invoice_OrderNumber

Hier muss einfach die RemoteQuery DLL mit der entsprechenden Plattform ausgewählt werden.

In dem Userexit Dialog muss noch der C4 Benutzer und das Passwort sowie die richtige RemoteQuery Server URL eingetragen werden.

Ressourcen anpassen

/clarc/Resources/xControl/Flows/Invoice/Default/

Den ConnectionString zur Systemdatenbank und die RemoteQueryServer Url müssen angepasst werden.

/clarc/Resources/xControl/Reader/Invoice/Database/ConnectionStrings/Default

Die Parameter "InvoiceDB" und "SystemDB" einfach in den Custom Bereich kopieren und den ConnectionString anpassen.

/clarc/Software/clarc remoteQuery/Connections/xControl_Invoice

Den ConnectionString für den RemoteQuery ändern.

Scananwendung anpassen

/clarc/Software/clarc eWork/Applications/xControl_Invoice_Scan

Im Reiter Process das Projekt "ccInvoiceReader" auswählen.

Validierung anpassen

/clarc/Software/clarc eWork/Applications/xControl_Invoice_Scan
Im Reiter "Process" den zuvor angelegten Exportservice und das Conversionscheme auswählen und im Reiter "Training" das Xtract Project "ccInvoiceReader" eintragen.

 Reader Projekt anpassen

/clarc/Software/clarc xControl/Projects/ccInvoiceReader
Im Reiter „Post processing“ die Option „Use existing queue properties“ setzen.

/clarc/Software/clarc xControl/Projects/ccInvoiceReader
Die Validierung über die Option „Validation active“ aktivieren.

Anschließend können Sie das Designstudio öffnen und testen, ob der Rechnungsleser läuft.

Versionsaktualisierung

Verfügen Sie bereits über eine Installation des Reader und möchten diesen aktualisieren, dann gehen Sie wie folgt vor:


  1. Erstellen Sie eine Sicherungskopie des Knotens "Reader", welcher sich unter folgendem Pfad befindet: /clarc/Resources/xControl/Reader und benennen diesen zum Beispiel in "Reader_Backup".
  2. Anschließend importieren Sie die XML Packages wie gehabt.
  3. Bitte beachten Sie, dass Sie beim importieren die Option "Overwrite" wie in der Abbildung zu erkennen ist auswählen. Verwenden Sie bitte an dieser Stelle nicht die Funktion "Keep user data", sondern ausschließlich "Overwrite".
  4. Die Funktion "Keep user data" verhindert zwar, dass angepasste Ressourcen nicht überschrieben werden. Beim importieren prüft die Funktion jedoch nicht, ob veraltete Konfigurationsdaten vorliegen, die in der aktuellen Version nicht mehr relevant sind oder gar zu Problemen führen kann.
  5. Nachdem die Packages erfolgreich importiert worden sind, können die individuell angepassten Ressourcen aus dem "Backup Knoten" in den neuen "Reader" Knoten rüber kopiert werden. Somit gewährleisten Sie, dass alle Erweiterungen und Fehlerbehebungen problemlos mit importiert werden und Sie können einfach Ihre Ressourcen anpassen und haben ein Backup.