Export nach MAGELLAN

MAGELLAN ist eine Software zum Verwaltungen von Schulen und Schulbibliotheken. ENBREA kann seine Daten mit MAGELLAN bidirektional synchronisieren.

Im Modul Bewerbungen werden die an der Schule laufenden Bewerberverfahren und die Bewerber verwaltet. Bewerber können für die Schulverwaltung aus ENBREA nach MAGELLAN übernommen werden. Es werden Bewerber mit dem Status angenommen extrahiert und in Ihre MAGELLAN-Datenbank übergeben. In der MAGELLAN-Schulverwaltung sind die übertragenen Bewerberdatensätze im Menüpunkt Bewerber sichtbar.

Wie funktioniert der Export?¶

Der Workflow besteht grob aus zwei Schritten:

ENBREA CLI exportiert Daten aus ENBREA und generiert ECF-Dateien.
ENBREA CLI importiert die generierten ECF-Dateien nach MAGELLAN.

Initialisierung¶

Falls noch nicht geschehen, auf Ihrem lokalen Computer ENBREA CLI installieren.
Im Windows-Explorer ein neues Verzeichnis c:\enbrea anlegen (das Verzeichnis kann natürlich auch anders heißen).
Im Suchfeld der Windows-Taskleiste Eingabeaufforderung eintippen und die Windows-Eingabeaufforderung öffnen.
Mit Befehl cd in das soeben angelegte Verzeichnis wechseln:
```
cd c:\enbrea
```
Nun folgenden Befehl eintippen:
```
enbrea init -c enbrea.json
```
Es wird jetzt eine JSON-formatierte Konfigurationsdatei enbrea.json angelegt, die als Vorlage für die weitere Konfiguration dient.

Konfiguration¶

Die gesamte Konfiguration des Exports befindet sich in der soeben angelegten Textdatei enbrea.json. Diese Datei in einem Texteditor öffnen und die gewünschten Eigenschaften überschreiben.

Die folgenden Eigenschaften müssen angepasst werden. Sie konfigurieren den individuellen Zugang zu ENBREA:

Allgemeine Konfiguration

Url: URL zu Ihrer ENBREA-Instanz
AccessToken: ENBREA-Zugriffstoken
SchoolTerm: Kürzel des ENBREA-Zeitraums
Magellan.ApplicationProcessId: ID des Bewerberverfahrens, das exportiert werden soll. Die ID können Sie aus der Enbreaoberfläche kopieren. Bitte öffnen Sie dafür im Modul Bewerbungen den Unterpunkt Bewerberverfahren und klicken auf das gewünschte Bewerberverfahren. Die ID wird Ihnen oben rechts gezeigt und kann kopiert werden.

Die folgenden Eigenschaften müssen ebenfalls angepasst werden. Sie konfigurieren den Zugang zur Firebird-Datenbank von MAGELLAN:

MAGELLAN

Magellan.DatabaseConnection: Ein Connection-String zur MAGELLAN-Firebird-Datenbank.
Magellan.TenantId: ID des MAGELLAN-Mandanten
Magellan.SchoolTermId: ID des MAGELLAN-Zeitraums. Die ID des Zeitraums ist in der Adressleiste des Browsers sichtbar, während man an der ENBREA-Instanz angemeldet ist.

Alle andere Eigenschaften sind schon vorkonfiguriert, können aber natürlich jederzeit überschrieben werden.

Bitte beachten

Der Backslash (= umgedrehter Schrägstrich) in Dateipfaden muss in einer JSON-Datei stets gedoppelt werden, also \\ statt \.

Nachfolgend je ein Beispiel für die Eintragungen für eine lokal und eine entfernt gespeicherte Datenbank.

Das Ergebnis für eine lokal gespeicherte Datenbank könnte wie folgt aussehen:

{
  "Url": "https://enbrea.cloud/meine-schule",
  "AccessToken": "9067eff1-6817-4e59-855c-9ace4e51f139",
  "SchoolTerm": "1. HJ 20223/2004",
  "ApplicationProcess": "Mein_Bewerbungsverfahren", 
  ... 

  "Magellan": {
    "DatabaseConnection": "DataSource=localhost;Database='C:\\Users\\Public\\Documents\\Stueber Systems\\MAGELLAN 10\\Datenbank\\Magellan11.fdb';Charset=UTF8;User=sysdba;Password=qwertz",
    "TenantId": 1,
    "SchoolTermId": 42,
    "TargetFolder": ".\\magellan\\export",
    "SourceFolder": ".\\magellan\\import"
  }
}

Das Ergebnis für eine auf einem entfernten Rechner gespeicherte Datenbank könnte wie folgt aussehen:

{
  "Url": "https://enbrea.cloud/meine-schule",
  "AccessToken": "9067eff1-6817-4e59-855c-9ace4e51f139",
  "SchoolTermId": "1. HJ 20223/2004",

  ... 

  "Magellan": {
    "DatabaseConnection": "DataSource=Mein_Server;Database='C:\\Users\\Public\\Documents\\Stueber Systems\\MAGELLAN 10\\Datenbank\\Magellan10.fdb';Charset=UTF8;User=sysdba;Password=qwertz",
    "TenantId": 1,
    "SchoolTermId": 42,
    "TargetFolder": ".\\magellan\\export",
    "SourceFolder": ".\\magellan\\import"
  }
}

Testen¶

Im Suchfeld der Windows-Taskleiste Eingabeaufforderung eintippen und die Windows-Eingabeaufforderung öffnen.
Mit folgendem Befehl in unser ENBREA-Verzeichnis wechseln:
```
cd c:\enbrea
```
Folgenden Befehl eintippen und bestätigen:
```
enbrea export -p magellan -c enbrea.json
```

Die Daten aus ENBREA werden ins ECF-Format übersetzt und anschließend nach MAGELLAN übertragen.

Automation¶

Die Synchronisation zwischen ENBREA und MAGELLAN kann natürlich automatisiert werden. Am einfachsten geht dies mit dem ENBREA CLI-Befehl create-export-task.

Ein Beispiel:

Im Suchfeld der Windows-Taskleiste Eingabeaufforderung eintippen und die Windows-Eingabeaufforderung als Administrator öffnen.
Mit folgendem Befehl in unser ENBREA-Verzeichnis wechseln:
```
cd c:\enbrea
```

Folgenden Befehl eintippen und bestätigen:

enbrea create-export-task -p magellan -c enbrea.json -i 15

Mit diesem Aufruf wird der in enbrea.json konfigurierte ENBREA-Export nach MAGELLAN alle 15 Minuten ausgeführt.

Eine ausführliche Beschreibung der Möglichkeiten rund um das Thema Automation findet sich im Kapitel Automation.