Home

Das Ecf-Tool für MAGELLAN liest Dateien im Ecf-Format aus und importiert diese in eine MAGELLAN-Datenbank (ab Version 8). Es werden sowohl neue Daten hinzugefügt, als auch bestehende Daten aktualisiert, wenn die Voraussetzungen dafür erfüllt sind.

Die Voraussetzungen basieren auf der Datenlage in den zu importierenden Daten im Efc-Format und der MAGELLAN-Datenstruktur und variieren nach zu importierender Tabelle, welche auf den folgenden Seiten weiter erläutert werden.

Legende

Spalte	Bedeutung
Ecf	Name der Spalte in der Ecf-Kopfzeile, beschreibt die Daten an der Position (Kopfzeile = 1. Zeile in der Datei)
Typ	Welcher Art (Text, Nummer, Datum, etc.) ist der Wert
Typ*	Das Sternchen gibt an, dass der Wert (verpflichtend!!) vorhanden sein muss
MAGELLAN	Feld in der MAGELLAN Tabelle in der die Daten geschrieben werden
Beschreibung	Zusätzliche Informationen

Konfiguration

Wir verwenden hier ein durchgehendes Beispiel mit dem Basipfad C:\magellan-import.

Zum Ausführen des Tools benötigen Sie eine Json- Konfigurationsdatei (z.B. import.json) im Basispfad, die strukturell wie folgt aussieht (Inhalte müssen Ihrer Umgebung angepasst werden):

{
    "Magellan": {
        "EcfImport": {
            "SourceFolderName": "C:\\magellan-import\\ecf",
            "DatabaseConnection" : "User=sysdba;Password=masterkey;DataSource=localhost;Database='C:\\magellan-import\\datenbank\\MAGELLAN8.FDB';Charset=UTF8;Dialect=3;",
            "TenantId": 1
        }
    }
    
}

Erklärung der Inhalte

Bezeichner	Beschreibung
SourceFolderName	Pfad zu den Ecf-Csv-Dateien die in die MAGELLAN Datenbank kopiert werden sollen
DatabaseConnection	Verbindungtext zur MAGELLAN Firebird-Datenbank
TenantId	Der Import der Ecf-Daten erfolgt für einen konkreten Mandanten. Dieser muss in MAGELLAN angelegt sein. Hier wird die ID des Mandanten aus MAGELLAN angegeben.

Erklärung zu DatabaseConnection

"User=sysdba;Password=masterkey;DataSource=localhost;Database='C:\\magellan-import\\datenbank\\MAGELLAN8.FDB';

Bezeichner	Beschreibung
User	Datenbankbenutzer; Nehmen Sie hier immer den SYSDBA (als Super-Administrator) mit allen Rechten.
Password	Das Passwort des angegeben Benutzers (im Beispiel sind die Firebird Standardwerte angegeben)
DataSource	Der Host (Rechner im Netzwerk) auf dem Firebird läuft und die Datenbankdatei liegt localhost = Eigener Rechner, es könnte auch ein Rechnername im Netzwerk oder eine IP-Adresse angegeben werden.
Database	Der lokale Pfad zur Datenbankdatei auf dem Rechner, auf dem die Datenbank liegt.

Aufruf

Aufruf von der Kommandozeile:

dotnet C:\ProgramData\Stueber Systems\Ecf-Tools\ecf-magellan.dll import -c "c:\magellan-import\import.json"

Es wird in die, in der Konfigurationsdatei angegebene Datenbank importiert.