Überblick
Mit der optional erhältlichen Bibliothek FNRetrieval.DLL (Archivsystem 5) steuern Sie verschiedene Dritt-Anbieter als Empfänger von Suchanfragen für Belege (Retrieval) an.
Unterstützte Systeme:
eASys
Hyparchiv
Dateibasiertes Retrieval (für beliebige Dritt-Anbieter-Archive)
eASys-Anbindung
Voraussetzungen
COM-Schnittstelle Zerberus.Interface auf dem FibuNet-Client-Rechner
FNRetrieval.dll (über den FibuNet Support erhältlich)
Mandanten-INI-Datei (mmmmmMAND.INI) mit den Einstellungen für die Suchfunktion
FibuNet Mandanteneinstellung
Starten Sie den FibuNet Client und wechseln Sie auf den gewünschten Mandanten.
Wechseln Sie auf das Register Zusatz-Module und wählen Sie im Feld Archivsystem den Wert 5 für Retrieval DLL aus.
Speichern Sie mit OK (F2).
INI-Datei konfigurieren
Bearbeiten Sie die Mandanten-INI-Datei (z. B. C:\FibuNetData\data\00001\00001MAND.INI) und hinterlegen Sie die eASys-Konfiguration im Abschnitt [Archivintegration:DLLRetrieval]:
Schlüssel | Beschreibung |
ArchivName | Muss immer eASys sein |
User | eASys-Benutzername |
Passwort | eASys-Passwort |
ObjektID | eASys Objekt-ID |
SearchFieldName | eASys-Feldname, in dem die FibuNet Belegnummer 2 steht |
ObjektID_2 (optional) | Alternative Objekt-ID für eine zweite Recherche, falls die erste keinen Treffer liefert |
MandantFieldName (optional) | eASys-Feldname für die FibuNet-Mandantennummer |
Beispiel:
[Archivintegration:DLLRetrieval]
ArchivName=eASys
User=eABenutzer
Passwort=eAPassw
ObjektID=4711
SearchFieldName=eASuchfeld
ObjektID_2=2243
MandantFieldName=Mandant
Suche im eASys-Archiv
Öffnen Sie die Kontenauskunft oder Journalauskunft mit F5.
Wählen Sie einen Eintrag, bei dem die Belegnummer 2 vorhanden ist, und klicken Sie auf F6.
FibuNet sucht zunächst unter der angegebenen ObjektID. Liefert die Suche keinen Treffer und ist eine ObjektID_2 angegeben, wird eine weitere Suche gestartet.
Ist ein MandantFieldName angegeben, wird die FibuNet-Mandantennummer als zusätzliches Suchkriterium übergeben.
Gibt es keine Treffer, wird das eASys-Recherche-Fenster angezeigt.
Technische Hinweise
FibuNet öffnet bei der ersten Recherche den eASys-Server. Dieser bleibt bis zur nächsten Recherche geöffnet.
Um den eASys-Server zu beenden, müssen Sie den FibuNet-Client beenden.
FibuNet nutzt COM-Technologie für die eASys-Funktion RechercheEx.
Returncodes
Code | Bedeutung |
0 | Kein Fehler (eindeutiger Treffer, mehrdeutiger Treffer oder kein Treffer) |
01 | COM-Schnittstelle nicht vorhanden bzw. OLE-Objekt-Verbindung zu eASys Factory kann nicht hergestellt werden |
03 | eASys-Anmeldung gescheitert – überprüfen Sie Benutzer und Passwort |
04 | Ungültige eASys Objekt-ID |
10 | Allgemeine Exception – Meldungstext wird von der DLL ausgegeben |
Hyparchiv-Anbindung
Voraussetzungen
COM-Schnittstelle Hyparchiv.Desktop
FNRetrieval.dll im FibuNet-Client-Verzeichnis
Mandanten-INI-Datei (mmmMAND.INI) mit den Einstellungen
FibuNet Mandanteneinstellung
Starten Sie den FibuNet Client und wechseln Sie auf den gewünschten Mandanten.
Wechseln Sie auf das Register Zusatz-Module und wählen Sie im Feld Archivsystem den Wert 5 für Retrieval DLL aus.
Speichern Sie mit OK (F2).
INI-Datei konfigurieren
Bearbeiten Sie die Mandanten-INI-Datei (z. B. C:\FibuNet\MD00001\001MAND.INI) und tragen Sie das Department ein:
[Archivintegration:Hyparchiv]
Department=MyDepartment
Suche in Hyparchiv
Öffnen Sie die Kontenauskunft oder Journalauskunft mit F5.
Wählen Sie einen Eintrag, bei dem die Belegnummer 2 vorhanden ist, und klicken Sie auf F6.
Folgende Suchparameter werden verwendet:
FibuNet Mandant = Department (gespeichert in der Mandanten-INI-Datei)
FibuNet Wirtschaftsjahr = "JAHR"
FibuNet Belegnummer 2 = "BEL.NR"
Returncodes
Code | Bedeutung |
0 | Kein Fehler (eindeutiger Treffer, mehrdeutiger Treffer oder kein Treffer) |
01 | COM-Schnittstelle bzw. OLE-Objekt für Hyparchiv Desktop konnte nicht erzeugt werden |
02 | Trefferlistenfenster von Hyparchiv konnte nicht erzeugt werden |
10 | Allgemeine Exception – Meldungstext wird von der DLL ausgegeben |
Dateibasiertes Retrieval
Voraussetzungen
Das Dritt-Anbieter-Archiv/DMS greift auf die Datei Fnmicro.ask im Temp-Verzeichnis des FibuNet-Clients zu.
FNRetrieval.dll muss im Programmverzeichnis des FibuNet-Clients abgelegt sein.
Mandanten-INI-Datei mit den Einstellungen
FibuNet Mandanteneinstellung
Starten Sie den FibuNet Client und wechseln Sie auf den gewünschten Mandanten.
Wechseln Sie auf das Register Zusatz-Module und wählen Sie im Feld Archivsystem den Wert 5 für Retrieval DLL aus.
Speichern Sie mit OK (F2).
INI-Datei konfigurieren
Bearbeiten Sie die Mandanten-INI-Datei (z. B. C:\FibuNetData\data\00956\00956mand.ini). Setzen Sie mindestens den ArchivName auf Dateibasiert.
Optionale Einstellungen
LoggerSeverity – Steuert das Logging in die Datei FNRetrieval_<Windows-Kontoname>.log im Client-Data-Verzeichnis:
Wert | Beschreibung |
0 | Debug-Meldungen werden ausgegeben |
1 | Info-Meldungen werden ausgegeben |
SearchDataMode – Modifiziert bestimmte Suchwerte:
Wert | Beschreibung |
0 | Keine Modifikationen |
1 | Umwandlung der Belegnummer 1 bei Buchung über ein Zahlkonto. Die Kontonummer wird 4-stellig, das Wirtschaftsjahr 2-stellig und die Auszugsnummer 3-stellig übermittelt. Beispiel: A.0081/0011 auf Zahlkonto 1200 im Jahr 2018 wird zu 120018081. |
ZahlkontenBereich (bis FibuNet Release r1136) – Gibt die Zahlkonten für SearchDataMode=1 an. Bereiche mit "-" und Einzelwerte mit Komma trennen (z. B. 1200-1210,1220). Ab Release r1137 ist diese Einstellung nicht mehr notwendig, da FibuNet die Kontenart direkt übermittelt.
Beispiel INI-Datei
[Archivintegration:DLLRetrieval]
ArchivName=Dateibasiert
LoggerSeverity=1
SearchDataMode=1
ZahlkontenBereich=1200-1210,1220
Suche starten
Öffnen Sie die Kontenauskunft oder Journalauskunft mit Strg + F5.
Wählen Sie ein Suchkriterium und klicken Sie auf F6.
Falls die vorherige Abfrage vom Dritt-Anbieter-Archiv nicht bearbeitet wurde, erscheint die Meldung: Vorherige Abfrage wurde nicht abgearbeitet. Abfrage zurücksetzen?