esXFibu Startparameter

Für die optionale Schnittstelle zu Finanzbuchhaltungsprogrammen esXFibu stehen eine Startparameter zur Verfügung, um zum Beispiel bestimmt Abläufe zu automatisieren.

Die Startparameter können in der Kommandozeile oder auch in einer Programmverknüpfung zur esxfibu.exe verwendet werden können.

Die nachfolgenden Erläuterungen beschreiben alle derzeit verfügbaren Parameter.

Windows-Verknüpfung

Möchte Sie die esXFibu-Schnittstelle mit Parametern starten, legen Sie dazu eine Verknüpfung der esXFibu.exe an. Die Datei befindet sich im esoffice Programmverzeichnis.

Nachfolgend wird ein möglicher Weg beschreiben eine Programmverknüpfung anzulegen und zu bearbeiten.

Programmverknüpfung anlegen und bearbeiten

  1. Öffnen Sie den Windows Explorer und wechseln in das esoffice-Programmverzeichnis.

  2. Klicken Sie mit der rechten Maustaste auf die Programmdatei, für die Sie eine Verknüpfung anlegen möchten, zum Beispiel esoffice.exe, esXLohn.exe oder esxfibu.exe.

  3. Wählen Sie im Kontextmenü den Eintrag Kopieren.

  4. Wechseln Sie in das Verzeichnis in dem die Verknüpfung angelegt werden soll, zum Beispiel auf den Desktop.

     

    Sie können die Programmverknüpfung im esoffice-Programmverzeichnis oder einen anderen beliebigen Verzeichnis anlegen.

  5. Klicken Sie mit der rechten Maustaste auf eine freie Stelle im gewünschten Verzeichnis, wählen Sie im Kontextmenü den Eintrag Verknüpfung einfügen.

  6. Klicken Sie mit der rechten Maustaste auf die eingefügte Programmverknüpfung , wählen Sie im Kontextmenü den Eintrag Eigenschaften.

    Verknüpfungen sind an dem Pfeilsymbol zu erkennen

  7. In der Ziel- oder Befehlszeile können Sie die nachfolgend beschriebenen Parameter verwenden, jeweils durch ein Leerzeichen getrennt.

 

Start der esXFibu mit abweichendem Para-Verzeichnis (Parameter -e:)

 

Verzeichnispfade sollten grundsätzlich in Anführungszeichen (") eingefasst werden, nicht in Hochkomma (').

Datenbank

-a: Aliasname/Pfad 

Verweist auf den Datenbank-Alias zum Beispiel ESLokal oder Pfadangabe zur Datenbank

Im Normalfall braucht kein Parameter angegeben werden, der auf eine Datenbank verweist, hier verwendet esoffice grundsätzlich den Alias ESWin.

Die Angabe der Datenbank / des Datenbank-Alias kann notwendig sein, wenn eine parallele Testumgebung genutzt werden soll.

 

-a:ESLokal

Angabe eines Datenbank-Alias, der Alias sollte bereits vorhanden ist.

Programmstartparameter

Para-Ordner

Im esoffice-Para-Verzeichnis / Ordner befinden sich unter anderem die Lizenzdatei (licence.cfg), die Datenbankverbindungskonfiguration (dbxconnections.ini) und Datenbanktreiberkonfiguration (dbxdrivers.ini).

-e:"[Laufwerk]:\Pfad"

Pfad zum Para-Verzeichnis mit Angabe eines Laufwerks

-e:"\\Netzwerkpfad"

Pfad zum Para-Verzeichnis im Netzwerk in der UNC-Schreibweise

 

-e:"E:\ESOffice\Para"

Silentmode Fibu-Übergabe

-r

ESXFibu kann über den Kommandozeilenparameter -r automatisch ohne Benutzerinteraktion gestartet werden.

Dabei wird zunächst ein Datenexport mit den dafür vordefinierten Einstellungen für den aktuellen Monat gestartet.

Anschließend wird automatisch der Zahlungsimport gestartet.

Im Unterordner ESXFibu im angegebenen Para-Verzeichnis werden für jeden automatischen Fibulauf zugehörige Protokolldateien namens FibuProt+LaufNr.txt (Übergabe) und ZahlProt+LaufNr.txt (Zahlungsimport) erstellt.

 

Wird esXFibu über den Parameter -r automatisch gestartet, dann wird das aktuelle Datum als Ende des zu übernehmenden Zeitraums gesetzt.

Import / Export trennen

Export

-r:1

Import

-r:2

Durch Angabe eines Parameterwertes 1 (Export, kompletter Aufruf -r:1) bzw. 2 (Import) können beim automatisierten Start von esXFibu Datenexport und -import auch getrennt voneinander durchgeführt werden.

Wird der Import separat gestartet, dann wird an den Dateinamen der Protokolldatei Zahlprot.txt der Zeitstempel des Imports im Format (YYYY-MM-DD_HH-MM-SS) angehängt, da ohne Export keine Vorlaufnummer vorhanden ist.

 

Nach dem automatischen Import wird die eingelesene Datei ins Protokollverzeichnis verschoben, um zu vermeiden das Dateien doppelt eingelesen werden.

Die Datei erhält dabei die gleiche Namensergänzung wie die Zahlungsprotokolldatei (Entweder Vorlaufnummer oder Zeitstempel).

Offset zum aktuellen Datum

-r:"m=xx"

Beim automatisierten Starten der esXFibu kann über den Parameterwert m ein Offset von Monaten bezogen auf das aktuelle Datum angeben werden, und damit der Übergabezeitraum gesteuert werden.

 

Aktuelles Datum = 10.03.2021

Aufruf ESXFibu

-r:"m=0" => Zeitraum = 01.03.2021-31.03.2021

-r:"m=-1" => Zeitraum = 01.02.2021-28.02.2021

-r:"m=1" => Zeitraum = 01.04.2021-30.04.2021

 

Wenn der Parameterwert m gesetzt ist, wird standardmäßig nur ein Export durchgeführt.

Man kann mehrere Parameterwerte durch Leerzeichen getrennt kombinieren

 

-r:"m=0 2" 

Würde einen Export für den aktuellen Monat und einen Import durchführen

Übergabe je Geschäftsstelle

-g:[GSNr]

Beim automatisierten Starten der esXFibu kann über den Parameterwert g: die zu verwendende Geschäftsstellennummer gesetzt werden kann.

 

Parameterübergabe

-g:10 

Setzt die verwendete Geschäftsstelle auf die Geschäftsstelle mit der Nummer 10

Der Parameter bewirkt, dass die aktuelle Geschäftsstelle im Programm auf den übergebenen Wert gesetzt wird. Auch die abhängigen Einstellungen, wie das zu verwendende Grundeinstellungsset werden davon abhängig geladen.

 

Ist in den Einstellungen der esXFibu unter Übertragung / Übernahme die Einstellung Geschäfststelle oder Mandant gesetzt, ist beim beim Starten im Silentmodus (-r) zusätzlich der Parameter -g zu übergeben.

Die zu exportierenden Daten werden dann automatisch nach der Geschäftsstelle bzw. dem in der Geschäftsstelle hinterlegten Mandanten gefiltert.

 

Beispiel für Geschäftsstelle 100

-e:M:\Para -r:"m=0" -g:100

Mehrere Geschäftsstellen

-e:M:\Para -r:"m=0" -g:1
-e:M:\Para -r:"m=0" -g:2
-e:M:\Para -r:"m=0" -g:15

Für jede weitere Geschäftsstelle eine eigene Zeile hinzufügen

Liste Ausgangsrechnungsnummern

-r:RA=[Rechnungsnr. Ausgangsrechnungen]

Beim automatisierten Starten der esXFibu kann über den Parameterwert RA eine Liste von Ausgangsrechnungsnummern empfangen werden.

Beim Export der Ausgangsrechnungen werden dann nur die übergebenen Rechnungen übertragen.

Die einzelnen Rechnungen sind dabei durch Komma voneinander zu trennen

-r:RA=1,2,3 

Überträgt die Ausgangsrechnungen mit den Rechnungsnummern 1, 2 und 3

Speicherort für Log- und Protokolldateien verändern

-c:"[Laufwerk]:\Pfad"

Pfad zum Log-Verzeichnis mit Angabe eines Laufwerks

-c:"\\Netzwerkpfad"

Pfad zum Log-Verzeichnis im Netzwerk in der UNC-Schreibweise

 

-c:"E:\fibu\fibulog"

Über den Parameter -c kann ein individueller Pfad angegeben werden, unter dem alle Log- und Protokolldateien eines Fibulaufs abgespeichert werden. Ist der Parameter -c nicht vorhanden, werden die Dateien im esoffice-Para-Verzeichnis abgelegt.

Dateinamen Fibu-Ausgabe anpassen

Geschäftsstelle (GSNr)

%nGSNr

Die Geschäftsstellennummer kann über den Platzhalter %nGSNr im Dateinamen eingefügt werden.

Dabei steht n für die Anzahl Stellen auf welche die Geschäftsstellennummer (GSNr) formatiert wird.

 

%4GSNr ergibt für Geschäftsstelle 1 (GSNr 1) ein 0001 im Dateinamen.

Datum

Das aktuelle Datum kann über die Formatanweisung %fd in den Dateinamen aufgenommen werden

Innerhalb von %fd können dabei die Platzhalter d für den Tag, m für den Monat, y für das Jahr, h für die Stunden, n für die Minuten und s für die Sekunden verwendet werden.

 

Dateiname = Kunden%fd_yymmdd_hhnnss%fd.txt ergibt bei der Erstellung am 12.03.2021 um 10:46:30 Datei Kunden_210312_104630.txt

Dateiname = Kunden%fd-dd.mm.yyyy-hhnn%fd.txt ergibt bei der Erstellung am 12.03.2021 um 10:46:30 Datei Kunden-12.03.2021-1046.txt