OEM CARATblue Version 1.14 Stand: 13.01.2014 Die OEM CARATblue Komponente in der Version 1.14 stellt die Oberfläche für CARATblue ein und enthält die CARAT Schnittstellen F149, F150 und 100. Es gibt zwei Varianten mit unterschiedlichem Umfang. Die CARAT Schnittstellen sind in beiden Varianten identisch. 1. CaratOEM-1.14.zip enthält CARAT Schnittstellen und CARATblue Oberfläche 2. CaratINTF-1.14.zip enthält nur CARAT Schnittstellen (Addon zu egecko) Änderungshistorie: 1.1 Anpassung von Images wegen egecko Rel. 2011 1.2 Erweiterung F150 um weitere Belegarten 1.3 Erweiterung F150 um gemischte Konten 1.4 Problem F150 Skontofähiger Betrag beseitigt 1.5 Problem F149 Vertreter1 und Vertreter2 korrigiert 1.6 F149 Überarbeitung Update / Insert / belegte Felder 1.7 F150 Überarbeitung Korepositionen, Sachbuchungen Brutto/Netto, verschiedene Funktionsschalter, Drehtabelle für kundenindividuelle Belegarten auf CARAT Standard- Belegarten, Erweiterung von Protokollierung und Fehlermeldungen 1.8 F150 Überarbeitung Belegwechsel, Steuerschlüssel, Formatierungen 1.9 F150 Neuer Schalter für Belegkreis ist Teil von Belegnummer 1.10 F150 Neuer Schalter carat.skipkonto=kontenliste(csv) für das Überspringen von Buchungen auf bestimmte Konten F149 Formatierung Zahlungsbedingung und Vertreter, Schalter Vertreter in Dimension 1.11 F150 Neuer Schalter für interne Sortierung der Buchungen in Belegen, Reihenfolge Personen- /Sachbuchung nicht relevant, erfordert eindeutige Belegnummer F150 Negative Mengen für Kore bei negativen Beträgen (Stornierungen) 100 Neue Eigenschaft für blockweise Verarbeitung bei großen Datenmengen, dann ist aber keine Sortierung möglich 1.12 F150 Tolerierung nicht korrekt gefüllter Felder für Kostenrechnung 1.13 F149 Erweiterungen für SEPA Trennung Benutzeroberfläche CARATblue und Schnittstellen CARAT 1.14 F150 Fehler Kursbewertung bei Fremdwährungen korrigiert Formatierung von Belegnummer eingefügt Seite 1 von 12
Installation Vorgehen Schneller Modus: Die Zip-Datei in das egecko-basisverzeichnis entpacken. Achtung: Dabei werden einige bestehende Dateien von egecko überschrieben und bei bereits installierter OEM-Komponente auch die kundenspezifischen Einstellungen. Vorgehen Selektiver Modus: Die Zip-Datei in ein temporäres Verzeichnis entpacken. Den Inhalt des temporären Verzeichnisses in das egecko-basisverzeichnis kopieren. Beim Kopieren die MessageBox "Datei überschreiben ja/nein" entsprechend den individuellen Anforderungen beantworten. Die Bedeutung der Dateien ist im nächsten Abschnitt beschrieben. Update CARAT OEM Installation: Beim Update bestehender CARAT OEM Installationen reicht es gewöhnlich aus, die Datei oem.jar unter \lib\java auszutauschen und falls erforderlich. die properties-dateien mit neuen Schlüsselworten zu versehen. Seite 2 von 12
Dateistruktur Die Zip-Datei enthält die unten aufgeführten Dateien. Dateien, die mit anpassen = ja gekennzeichnet sind, werden bei Verwendung der CARAT-Schnittstellen für den korrekten Ablauf kundenspezifisch angepasst. Vor einer erneuten Installation der OEM Komponente müssen diese Dateien gesichert und die Anpassungen dann nachgezogen werden. Die beiden letzten Spalten dokumentieren, in welchen der Varianten die Dateien vorkommen. Pfadname anpassen Bedeutung 1 2 Im egecko-basisverzeichnis CARATblue.gif Bild für CARATblue-Hauptmenü CARATblue.ico Icon für CARATblue Manager.ico Icon für Manager.exe (überschreibt Original) First.ico Icon für First.exe (überschreibt Original) Updater.ico Icon für Updater.exe (überschreibt Original) Launcher.ico Icon für Launcher.exe (überschreibt Original) OEM_CARATblue.pdf diese Dokumentation Im Verzeichnis \lib\java oem.jar Im Verzeichnis \transfer Programmdatei mit Schnittstellen F149, F150 und 100 sowie in der Variante 1 mit allen Anpassungen der Benutzeroberfläche für CARATblue f149.properties ja Steuerdatei für F149-Transfer f150.properties ja Steuerdatei für F150-Transfer x100.properties ja Steuerdatei für 100-Export Im Verzeichnis \transfer\maps anredekz.map ja Drehtabelle für Anrede-Kennzeichen (F149) belegart.map ja Drehtabelle für kundenindividuelle Belegarten (F150) brutto.map ja Drehtabelle für Carat-Belegarten mit Bruttoerfassung (F150) landkz.map ja Drehtabelle für Länder-Kennzeichen (F149) steuerschl.map ja Drehtabelle für Steuerschlüssel (F150) waehrung.map ja Drehtabelle für Währungen (F149, F150) zahlart.map ja Drehtabelle für Zahlungsarten (F149) zahlkondition.map ja Drehtabelle für Zahlungskonditionen (F149, F150) Seite 3 von 12
1. Einstellen der Oberfläche von CARATblue Die folgenden Einstellungen sind nur bei Installation der kompletten Variante 1 mit CARATblue Benutzeroberfläche möglich. Im Manager von CARATblue für jeden Benutzer über Extras Einstellungen Im Manager von CARATblue das Menü des Benutzers anpassen: Checkbox Änderbar aktivieren Die Hauptmenü-Ebene ändern: Name "egecko" ändern in "CARATblue" Icon-Name "/de/css/menue/hauptebene/gecko.gif" ändern in "caratblue.gif" Seite 4 von 12
Seite 5 von 12
2. Einrichten der CARAT-Schnittstellen Alle Schnittstellen werden als Runjob unter Task implementiert. Die Steuerung einer Schnittstelle erfolgt immer über eine Properties-Datei, die dem Job als Parameter übergeben wird. Alle Properties-Dateien und weitere erforderliche Dateien sind unter dem Verzeichnis <egecko-ordner>\transfer abgelegt. Die Properties-Dateien und evt. aufgerufene Map-Dateien (Drehtabellen) müssen sorgfältig an die jeweiligen Gegebenheiten angepasst werden. Wichtiger Hinweis: Bei allen Pfadnamen, auch innerhalb der properties-dateien, muss als Pfadtrenner / statt \ verwendet werden! Ebenso ist die Groß-/Klein- Schreibung zu beachten. Die Import-Schnittstellen F149 und F150 werden über die Interface-Klasse RunTransfer (de.css.interfaces.runjob.runtransfer) gestartet mit dem Argument propfile <Pfadname der Properties-Datei>. Seite 6 von 12
Die Export-Schnittstelle 100 wird über die Interface-Klasse ExportCb100 (de.css.interfaces.caratblue.exportcb100) gestartet mit dem Argument propfile <Pfadname der Properties-Datei>. Seite 7 von 12
3. properties-dateien Die Schnittstellen F149, F150 und 100 werden über properties-dateien gesteuert, die mit einem Texteditor verwaltet werden können. Generell gilt: Bei allen Pfadnamen innerhalb der properties-dateien muss als Pfadtrenner / statt \ verwendet oder jedes \ in \\ verdoppelt werden. Beispiel: Datei c:\temp\abc.txt schreiben als c:/temp/abc.txt oder c:\\temp\\abc.txt. Die Groß-/Klein-Schreibung ist bei Pfadnamen unbedingt zu beachten. Kommentarzeilen beginnen mit //. Formatierungen von Datenfeldern erfolgen mit java DecimalFormat Pattern, z.b. Wert = 123, Format = 00000, ergibt 5-stellig numerisch 00123 Wert = 123, Format = K- 0000, ergibt K-0123 Folgende Werte können gesetzt werden: property Bedeutung F149 F150 100 classname= Name der Klasse, die durch RunTransfer gestartet wird, F149: de.css.interfaces.caratblue.transfercbf149 F150: de.css.interfaces.caratblue.transfercbf150 fileregex= sourcefilepath= Namen der Dateien aus dem Quell-Verzeichnis, die verarbeitet werden sollen, Angabe von regular expressions ist möglich, z.b. f149_[1-9].eur Quell-Verzeichnis, in dem die Eingabedateien gesucht werden destinationfilepath= Ziel-Verzeichnis, in dem die xml-dateien abgestellt werden savefilepath= errorfilepath= Sicherungs-Verzeichnis, in dem verarbeitete Eingabedateien abgelegt werden Fehler-Verzeichnis, in dem fehlerhaft verarbeitete Eingabedateien abgelegt werden caratmappath= Verzeichnis für Drehtabellen caraterrorlog= Protokolldatei für Versionsinfo und Ablauf outputfile= Pfadname der Ausgabedatei, dabei wird das Kürzel {orgunit} durch die Nummer der aktuellen OrgUnit ersetzt carat.lizenznr= Lizenznummer für die jeweilige Schnittstelle Seite 8 von 12
property Bedeutung F149 F150 100 carat.deb.format= Formatierung der Kontonummern Debitor carat.kred.format= Formatierung der Kontonummern Kreditor carat.sach.format= Formatierung der Kontonummern Sachkonto carat.gp.format= Formatierung der Nummer des Geschäftspartners <format> oder SAME = identisch wie Personenkonto oder AUTO = automatische Vergabe carat.kost.format= Formatierung der Kostenstellennummer carat.kotr.format= Formatierung der Kostenträgernummer carat.gemdeb.format= carat.gemkred.format= Formatierung der Kontonummern Debitor bei dualen Gemischten Konten Formatierung der Kontonummern Kreditor bei dualen Gemischten Konten carat.beleg.format= Formatierung der Belegnummer carat.steuer.format= Formatierung der Steuerschlüsselnummer carat.zahlkond.format= Formatierung der Zahlungskonditionsnummer carat.vertreter.format= Formatierung der Vetreternummer carat.f149.erweitert= Schalter j/n: F149 erweitert: Bei nein F149 Satzlänge=896, bei ja erweiterte Satzlänge=1021 (Default = n) carat.map.anredekz = Drehtabelle für Anredekennzeichen carat.map.belegart= Drehtabelle für kundenindividuelle Belegarten auf CARAT Standard-Belegarten carat.map.brutto= Drehtabelle für Belegarten Sachbuchung mit Brutto = j carat.map.landkz = Drehtabelle für Länderkennzeichen carat.map.steuer = Drehtabelle für Steuerschlüssel carat.map.waehrung = Drehtabelle für Währungskennzeichen carat.map.zahlart = Drehtabelle für Zahlungsarten carat.map.zahlkond= Drehtabelle für Zahlungskonditionen carat.deb.festkonto= Defaultwert Festkonto Forderung carat.kred.festkonto= Defaultwert Festkonto Verbindlichkeit carat.deb.hausbanknr= Defaultwert Hausbank-Nummer Debitor carat.kred.hausbanknr= Defaultwert Hausbank-Nummer Kreditor Seite 9 von 12
property Bedeutung F149 F150 100 carat.deb.mahnkondnr= Defaultwert Nummer der Mahnkondition Debitor carat.vertreterindim= Schalter j/n: Vertreter in Dimension (Default = n) carat.belegart=alt Bestehende CARAT-Belegarten werden 1:1 weitergegeben carat.ra.belegart= Belegart Rechnungsausgang carat.re.belegart= Belegart Rechnungseingang carat.ga.belegart= Belegart Gutschriftsausgang carat.ge.belegart= Belegart Gutschriftseingang carat.za.belegart= Belegart Zahlungsausgang carat.ze.belegart= Belegart Zahlungseingang carat.sa.belegart= Belegart Sachbuchung carat.belegsort=j/n Schalter j/n: interne Sortierung der Buchungen in Belegen, erfordert eindeutige Belegnummer (Default = n) carat.debitoren= Schalter j/n: Debitoren ausgeben (Default = n) carat.vondebitor= Von Debitorenkonto carat.bisdebitor= Bis Debitorenkonto carat.kreditoren= Schalter j/n: Kreditoren ausgeben (Default = n) carat.vonkreditor= Von Kreditorenkonto carat.biskreditor= Bis Kreditorenkonto carat.fetchlimit= Anzahl Konten für blockweise Verarbeitung bei großen Datenmengen, Ausgabe dann unsortiert (Default = -1) carat.belegkreis= Schalter j/n: Belegkreis verwenden (Default = j) carat.refnristopnr= Schalter j/n: Referenznummer ist OP-Nummer, wenn die Referenznummer nicht leer ist (Default = n) carat.kostenrechnung= Schalter j/n: mit Anschluss Kostenrechnung (Default = j) carat.spezialversion= Kundenspezifische Spezialversion Seite 10 von 12
Schalter Mögliche Schalterwerte sind: NEIN = 0, n, nein, no, false und JA = 1, j, ja, y, yes, true Falls der Schalter nicht in der properties-datei gesetzt wird, wird der angegebene Default-Wert angenommen. Drehtabellen Drehtabellen sind Textdateien, die mit einem Editor bearbeitet werden können. Sie ermöglichen zur Laufzeit die Ersetzung eines bestehenden Wertes durch einen anderen. Die Zuweisung erfolgt durch eine Tabellenzeile mit alterwert=neuerwert Falls keine passende Wertzuweisung und kein <default>= gefunden wird, bleibt der alte Wert unverändert. Beispiel: ; Steuerschlüssel Kommentar beginnt mit ; oder # in 1. Spalte 0=vnull alter Wert 0 wird ersetzt durch vnull 9=mvoll alter Wert 9 wird ersetzt durch mvoll 10=mnst 12=mred 77= alter Wert 77 wird ersetzt durch Leerstring 78=<null> alter Wert 78 wird ersetzt durch Nullpointer <leer>=keinwert alter Wert Leerstring wird ersetzt durch KeinWert <default>=mvoll Falls keine direkte Wertzuweisung gefunden wird, wird für einen beliebigen alten Wert mvoll zurückgegeben Seite 11 von 12
4. Lizenzierung der CARAT-Schnittstellen Die Lizenzierung der CARAT-Schnittstellen erfolgt nicht durch die CSS GmbH in Fulda, sondern durch die in VS-Villingen. Die für jede Schnittstelle ermittelte Lizenznummer muss in die zugehörige Properties-Datei eingetragen werden. Basis für die Ermittlung der CARAT-Lizenznummern sind die System- und die Referenznummer der egecko-lizenz. Folgende Informationen sind an die zu Vergabe der Lizenznummern zu übermitteln: Name und Anschrift des Kunden Ansprechpartner des Kunden Email oder Faxnummer, an die die Lizenz gesendet werden soll Name des Consultant System- und Referenznummer der egecko-lizenz (z.b. als Snapshot von Manager? Über Lizenz) Lizenz-Anforderungen an: Hermann-Schwer-Str. 3 78048 Villingen-Schwenningen Tel: 07721-4070-2597 Fax: 07721-4070-2674 Mail: info@caratsw.de Seite 12 von 12