Übersicht

Anforderung

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

Module

CLARC INVOICE umfasst die Softwaremodule des Rechnungsverarbeitungsprozesses in CLARC ENTERPRISE. Die INVOICE Strecke besteht aus Folgenden Modulenfolgende Softwaremodule:

• • CLARC XTRACT: Führt die OCR-Erkennung und den Extraktionsvorgang durch.
  • CLARC INVOICE READER: Ist Bestandteil von CLARC XTRACT und ermittelt die rechnungsrelevanten Informationen aus den Dokumenten
und weißt diese dem hinterlegten Feldschema zu.CLARC XCONTROL VALIDATION
• • .
  • /wiki/spaces/CD2/pages/1319821: Ermöglicht die Validierung und die Freigabe von Rechnungen. 

Je nach Szenario kommt CLARC EWORK zum Einsatz. In diesem Modul werden die Anforderung wird zusätzlich CLARC EWORK eingesetzt, welches die Belege erfasst und zu Heftungen zusammengeführtzusammenführt.Die Einrichtung der Grundfunktionalität des Systems gestaltet sich sehr einfach und erfordert nur wenige Schritte.

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 das INVOICE Szenario die Einrichtung des Rechnungslesers stehen XML-Packages zur Verfügung, die alle elementaren Konfigurationsdaten beinhalten. Über Diese Packages werden über das Hauptmenü im C4 werden die XML-Dateien ausgewählt und importiert. Die jeweiligen Da die Knoten werden im C4 automatisch angelegt . Hierbei werden, ist eine explizite Pfadangabe über „Root Node“ im Import-Dialog nicht notwendig.

Image Removed

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

XML-Packages

xControl_Invoice.xml

xControlXCTRL_Invoice_ccInvoiceReaderReader_v304xxxvxxx.xml (+ Fix Packages)

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

 Info
title
Information
Bitte beachten Sie beim Einspielen der Konfigurationsdaten auf die Version der XML-Dateien, damit Erweiterungen und Fehlerbehebungen mit importiert werden.
Verfügen Sie bereits über das INVOICE System, aktivieren Sie beim Importieren die Funktion "Keep User Data" im Import-Dialog, da ansonsten bestehende Anpassungen überschrieben werden.
Für das INVOICE Szenario werden über die Packages verschiedene Konfigurationen an verschiedenen Stellen im C4 angelegt. Hierbei werden allgemeine Konfigurationsdaten, Projekt- und Anwendungskonfigurationen sowie Userexits und Recognitions angelegt.
Struktur der Konfigurationsdaten im C4
Die Allgemeinen Konfigurationsdaten werden im C4 unter Resources verwaltet und befinden sich im C4 unter folgendem Knoten: 
/clarc/Resources/xControl/Reader
/clarc/Resources/xControl/Flows/Invoice/Default/
Detailierte Informationen zu den einzelnen Parametern finden Sie im folgenden Bereich: INVOICE READER Konfiguration.
Struktur der Projektkonfiguration im C4
Die Projektkonfigurationen befinden sich unter CLARC XTRACT im C4:
/clarc/Software/clarc Xtract/Projects/ccInvoiceReader
/clarc/Software/clarc Xtract/Projects/xControl_Invoice
Image Removed
Image Removed
CLARC EWORK
/clarc/Software/clarc eWork/Applications/xControl_Invoice_Scan
Image Removed
Anpassung im C4
Für das Szenario müssen bestimmte Parameter wie die Datenbankverbindung und die Server Url für den RemoteQuery Service angepasst werden. 
CLARC XCONTROL 
Image Added
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/
Image Added
 Dann wird das entsprechende Schema für die Conversion Engine hinterlegt
/clarc/Schemes/Conversion/
Image Added
Außerdem muss noch ein Exportservice definiert werden. 
/clarc/Engines/Export/
Image Added
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.
Image Added
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.
Image Added
In dem Userexit Dialog muss noch der C4 Benutzer und das Passwort sowie die richtige RemoteQuery Server URL eingetragen werden.
Image Added
Ressourcen anpassen
/clarc/Resources/xControl/Flows/Invoice/Default/
ParameterBeschreibungConnectionString
Den ConnectionString zur 
 Datenbank, welche die Systemtabellen beinhaltet.
 RemoteQueryServerUrl
Die Url zum REMOTEQUERY Service der für verschiedene Datenbankrückgriffe eingesetzt. 
Z. B. http://Servername:4430
CLARC INVOICE READER
Systemdatenbank und die RemoteQueryServer Url müssen angepasst werden.
Image Added
Image Added
/clarc/Resources/xControl/Reader/Invoice/Database/ConnectionStrings/Default
Die Parameter 
BeschreibungInvoiceDB
ConnectionString zur XCONTROL INVOICE Datenbank. In den entsprechenden Tabellen werden die Stammdaten für die Debitoren, Kreditoren und Bestellungen gespeichert.
Provider=SQLOLEDB.1;Password=test;Persist Security Info=True;User ID=clarc;Initial Catalog=clarc;Data Source=MYSERVER\SQLEXPRESS
SystemDBConnectionString zur CLARC ENTERPRISE Datenbank. Wird für das Training im Rechnungsleser eingesetzt.
/clarc/Resources/xControl/Reader/Invoice/Database/TableNames/Default
ParameterBeschreibungPosConfigurations
Tabellenname: cc_xcontrol_creditors_positions
Konfigurationstabelle für kreditorspezifische Positionsdatenerkennungen.
 Info
title
Information
Hier bitte den Tabellen von "cc_xcontrol_creditors_position" auf "cc_xcontrol_creditors_positions" ändern
Datenbankrückgriffe für CLARC INVOICE
Die bereits eingerichteten Userexits ermöglichen einem Zugriff auf die Stammdaten. Angenommen die OCR-Erkennung liefert ein falsches Ergebnis, dann kann dieser mit Hilfe des Datenbankrückgriffes korrigiert werden.
 Info
title
Information
Bitte prüfen Sie, ob hier die richtige Library und die entsprechende Plattform hinterlegt ist. Nach dem Einspielen der Pakete sollten die Engines aktualisiert werden.
Im C4 befinden sich die Userexits unter folgendem Knoten:
/clarc/Engines/Userexits/xControl/xControl_Invoice_Creditors
/clarc/Engines/Userexits/xControl/xControl_Invoice_OrderNumber
Barcode und OCR
/clarc/Engines/Recognition/xControl/Invoice/Barcode
/clarc/Engines/Recognition/xControl/Invoice/SCO
"InvoiceDB" und "SystemDB" einfach in den Custom Bereich kopieren und den ConnectionString anpassen.
Image Added
/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.
Image Added
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.
Image Added
Image Added
 Reader Projekt anpassen
/clarc/Software/clarc xControl/Projects/ccInvoiceReader
Im Reiter „Post processing“ die Option „Use existing queue properties“ setzen.
Image Added
/clarc/Software/clarc xControl/Projects/ccInvoiceReader
Die Validierung über die Option „Validation active“ aktivieren.
Image Added
Image Added
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:

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".
Anschließend importieren Sie die XML Packages wie gehabt.
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".
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.
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.