Skip to content

import command

Frank Stüber edited this page Aug 25, 2025 · 8 revisions

Der Befehl import

Importiert Daten aus einer externen Fachanwendung nach Enbrea.

enbrea import 
    {--config|-c} <Dateipfad>
    {--provider|-p} {bbsplanung | danis | davinci | edoosys | excel | magellan | saxsvs | schildnrw | untis}
    {--behaviour|-b} {diff | full | smartfull}
    [--skip-enbrea]
    [--skip-provider]
    [--skip-snapshot]
    [{--log|-l} <Ordnerpfad>]

Erläuterungen zum Befehlssyntax findest Du hier.

Beschreibung

Der Befehl import orchestriert den Export aus einer Fachanwendung ins ECF-Format und das anschließende Hochladen und Einmischen der ECF-Dateien nach Enbrea. Die notwendige Konfiguration befindet sich in einer JSON-Datei. Mit Hilfe des Befehls init kannst Du Dir eine solche Konfigurationsdatei erstellen lassen.

Die folgenden Fachanwendungen werden unterstützt:

  • DAVINCI
  • MAGELLAN
  • Untis
  • edoo.sys
  • Schild-NRW
  • BBS-Planung
  • DaNiS
  • SaxSVS
  • Einfache Exceltabellen (XLSX oder CSV)

Beispiele

Beispiel 1

Exportiert DAVINCI-Daten ins ECF-Format und importiert diese Dateien anschließend nach Enbrea. Alle benötigten Konfigurationsdaten befinden sich in der Datei config.json.

enbrea import --config c:\enbrea\config.json --provider davinci 

Beispiel 2

Exportiert MAGELLAN-Daten ins ECF-Format, importiert diese Dateien aber NICHT nach Enbrea. Alle benötigten Konfigurationsdaten befinden sich in der Datei config.json.

enbrea import --config c:\enbrea\config.json --provider magellan --skip-enbrea 

Beispiel 3

Die Kurzform von Beispiel 1

enbrea import -c c:\enbrea\config.json -p davinci

Beispiel 4

Wie Beispiel 1, nur diesmal mit einem anderen Importverhalten (Smarter Vollimport).

enbrea import --config c:\enbrea\config.json --provider davinci --behaviour smartfull

Beispiel 5

Die Kurzform von Beispiel 4

enbrea import -c c:\enbrea\config.json -p davinci -b smartfull

Parameter

  • --config oder -c

    Dateipfad zur JSON-Konfigurationsdatei. Syntax und Beschreibung finden sich im JSON-Schema der Konfigurationsdatei.

  • --provider oder -p

    Einer der folgenden Werte:

    • davinci
    • magellan
    • untis
    • edoosys
    • schildnrw
    • bbsplanung
    • danis
    • saxsvs
    • excel
  • --behaviour oder -b

    Optionale Konfiguration des Importverhaltens. Folgende Werte sind möglich:

    • diff: Differenzimport, d.h. alle aus der externen Fachanwendung exportiert Daten werden mit dem vorherigen Export verglichen. Nur die geänderten und die gelöschten Datensätze werden nach Enbrea importiert. Beim ersten Import entspricht das Verhalten dem Vollimport.
    • full: Vollimport, d.h. es werden stets alle aus der externen Fachanwendung exportiert Daten nach Enbrea importiert.
    • smartfull: Smarter Vollimport, d.h. es werden stets alle aus der externen Fachanwendung exportiert Daten nach Enbrea importiert. Gleichzeitig findet aber auch ein Vergleich mit dem vorherigen Export statt und die gelöschten Datensätze werden ebenfalls nach Enbrea importiert.

    Der Standardwert ist diff.

  • --skip-provider

    Ist dieser Schalter gesetzt, erzeugt Enbrea Cli keine neuen ECF-Dateien aus der externen Fachanwendung, sondern geht beim Import nach Enbrea davon aus, dass diese schon vorliegen. Dieser Schalter ist vor allem für Testzwecke gedacht.

  • --skip-enbrea

    Ist dieser Schalter gesetzt, bricht Enbrea Cli nach dem Erzeugen der ECF-Dateien ab. Sehr praktisch, wenn man nur die ECF-Dateien haben möchte, aber keinen Import nach Enbrea durchführen will. Dieser Schalter ist vor allem für Testzwecke gedacht.

  • --skip-snapshot

    Ist dieser Schalter gesetzt, erstellt Enbrea Cli keinen Snapshot vor dem Import nach Enbrea. Dieser Schalter ist vor allem für Testzwecke gedacht.

  • --log oder -l

    Optionaler Ordnerpfad für Log-Dateien. Mit diesem Parameter kann gesteuert werden, ob und wo der Durchlauf des Befehls geloggt werden soll. Ein Log wird in Form von Textdateien angelegt. Für jeden Tag eine Datei, 90 Tage lang. Log-Dateien, die älter als 90 Tage sind, werden automatisch gelöscht.

Clone this wiki locally