Datenaustausch mit Sdui¶

Sdui bietet Schulen eine DSGVO-konforme Lösung in der digitalen Kommunikation und Organisation mit Lehrern, Schülern und Eltern an. DaVinci kann Stundenplandaten mit Sdui abgleichen. Diese werden dann in der Sdui-App angezeigt. Die Übertragung kann manuell oder automatisiert erfolgen.

Der Workflow sieht grob wie folgt aus:

• Die DaVinci Console liest Daten direkt aus einer DaVinci-Datei oder von einem DaVinci-Server und überträgt diese in Ihre Sdui-Instanz

• Mit dem PowerShell-Modul PSDaVinci können Sie den Workflow mit einem einzigen Befehl ausführen.

• Dieser Vorgang kann über die Windows Aufgabenplanung automatisiert werden.

Voraussetzungen¶

Es werden PowerShell 7, das PowerShell-Modul PSDaVinci und natürlich eine Installation von DaVinci benötigt.

PowerShell 7¶

Die Systemvoraussetzungen für eine erfolgreiche Ausführung der PowerShell-Skripte ist PowerShell 7. PowerShell 7 ist nicht Teil des Betriebssystems und muss separat installiert werden.

1. Öffnen Sie die Download-Webseite für PowerShell 7 auf GitHub in Ihrem Web-Browser.

2. Laden Sie das passende Installationpaket herunter. In der Regel wird dies das MSI-Paket für Windows 64bit sein (z.B. PowerShell-7.1.3-win-x64.msi).

   

3. Starten Sie das MSI-Paket auf Deinem Computer und folgen Sie den Anweisungen.

Die Ausführung von lokalen PowerShell-Skripten unter Windows Server 2019 ist standardmäßig erlaubt, unter Windows 10 jedoch nicht. In der Regel kann man mit der Ausführungsrichtlinie RemoteSigned gut leben.

1. Tippen Sie im Suchfeld der Windows-Taskleiste powershell 7 oder pwsh ein und starten Sie PowerShell als Administrator.

   

2. Tippen Sie Set-ExecutionPolicy RemoteSigned ein und bestätigen Sie.

   

Jetzt können Sie lokale PowerShell-Skripte problemlos starten.

PSDaVinci¶

Installieren Sie das PowerShell-Modul PSDaVinci:

1. Tippen Sie im Suchfeld der Windows-Taskleiste powershell 7 oder pwsh ein und starten Sie PowerShell.

   

2. Tippen Sie Install-Module PSDaVinci ein und bestätigen Sie mit der Eingabetaste.

3. Beantwortn Sie die anschließende Frage, ob Sie der PowerShell Gallery (PSGallery) vertrauen möchten mit Yes.

   

Das PowerShell-Modul wird nun installiert.

Konfiguration¶

1. Legen Sie im Windows-Explorer ein neues Verzeichnis c:\davinci an (das Verzeichnis kann natürlich auch anders heißen).

2. Starten Sie PowerShell 7 über das Windows-Menü: Start > Windows Powershell > Windows Powershell

3. Wechseln Sie mit folgendem Befehl in das soeben angelegte Verzeichnis mit:

   cd c:\davinci
   

4. Tippen Sie nun folgenden PowerShell-Befehl ein:

   Initialize-DaVinciExport sdui davinci.json
   

   Es wird jetzt eine Konfigurationsdatei davinci.json angelegt, die als Vorlage für die weitere Konfiguration dient.

Konfigurieren der json Datei¶

Die gesamte Konfiguration des Imports befindet sich in der Textdatei davinci.json. Öffnen Sie diese Datei in einem Texteditor und überschreiben die gewünschten Eigenschaften.

Die folgende Eigenschaft muss angepasst werden. Sie konfiguriert den individuellen Zugang zu Sdui:

Die Admin-PIN für Sdui finden Sie in Sdui unter Administration > Stundenplan > Synchronisation.

Die folgenden Eigenschaften müssen beim Abgleich von einer lokalen DaVinci-Datei überschrieben werden:

Die folgenden Eigenschaften müssen beim Abgleich von einer DaVinci-Datei, die auf einem DaVinci-Server gehostet wird auf alle Fälle überschrieben werden:

Es empfiehlt sich einen seperaten DaVinci-Benutzer für diese Funktion anzulegen, er muss lediglich das Recht haben, sich an DaVinci anmelden zu können.

Bitte schauen Sie hier,wenn Sie Fragen zur Einrichtung der Benutzer in DaVinci haben.

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

Beispiel für eine lokale DaVinci Datei¶

Das Ergebnis für den Abgleich mit einer lokalen DaVinci-Datei könnte wie folgt aussehen:

{
    "daVinci": {
        "SduiExport": {
            "SduiPIN": "abc-def-ghi",
            "SourceProvider": "File",
            "SourceFileName": "davinci\\beispiel.daVinci",
        }
    }
}

Beispiel für eine DaVinci-Serverdatei¶

Das Ergebnis für den Abgleich mit einer DaVinci-Datei, die auf einem DaVinci-Server gehostet wird, könnte wie folgt aussehen:

{
    "daVinci": {
        "SduiExport": {
            "SduiPIN": "abc-def-ghi",
            "SourceProvider": "Server",
            "ServerName" : "localhost",
            "ServerPort" : "8100",
            "ServerUserName" : "admin",
            "ServerPassword" : "qwertz",
            "ServerFileID" : "{c24f1a9d-692c-47aa-9046-db444b9f0c8e}"
        }
    }
}

Testen¶

1. Starten Sie PowerShell 7 über das Windows-Menü: Start > Windows Powershell > Windows Powershell

2. Wechseln Sie mit folgendem Befehl in unser DaVinci-Verzeichnis:

   cd c:\davinci
   

3. Tippen Sie folgenden PowerShell-Befehl ein:

   Start-DaVinciExport sdui davinci.json
   

Die Daten aus DaVinci werden direkt nach Sdui übertragen.

Automation¶

Die Synchronisation zwischen DaVinci und Sdui kann automatisiert werden. Eine vollständige Automatisierung gelingt am besten über die Windows-Aufgabenplanung. Die Aufgabenplanung ist Bestandteil von Windows und ermöglicht das Starten von Anwendungen einmalig oder wiederkehrend zu festgelegten Zeitpunkten.

Ein Beispiel¶

Wir wollen, dass der Abgleich zwischen DaVinci und Sdui alle 10 Minuten gestartet wird. Ein Upload erfolgt nur dann, wenn es auch Änderungen in DaVinci seit dem letzten Abgleich gegeben hat. Da dieser Prozess im Hintergrund läuft, soll die Ausgabe in einer Textdatei geloggt werden, so dass nachträglich geprüft werden kann, ob die Aktion erfolgreich war oder nicht. Dabei soll jeden Tag eine neue Textdatei angelegt werden. Die Konfigurationsdatei ist in unserem Beispiel unter c:\davinci\davinci.json gespeichert.

!!! warning wichtig: Damit ein Logfile angelegt wird, bitte vorher den Ordner logs unter c:\davinci anlegen!

Los geht's:

1. Starten Sie die Aufgabenplanung, indem Sie im Suchfeld der Windows-Taskleiste "Aufgabenplanung" eintippen.

2. Klicken Sie in der Aufgabenplanung in der rechten Aktionsleiste auf Aufgabe erstellen. Es öffnet sich ein Dialogfenster.

   

3. Tippen Sie auf der Registerkarte Allgemein einen Namen für Ihre neue Aufgabe ein und optional eine Beschreibung.

   

4. Wechseln Sie auf die Registerkarte Trigger und klicken Sie auf Neu. Jetzt müssen Sie definieren, wie oft der Abgleich ausgeführt werden soll. Wählen Sie Täglich aus und tragen Sie unter Wiederhole jede 10 Minuten ein. Bestätigen Sie mit OK.

   

5. Wechseln Sie nun auf die Registerkarte Aktionen und klicken Sie auf Neu. Jetzt müssen Sie definieren, was denn nun geschehen soll. Belassen Sie die Auswahl bei Programm starten und tragen Sie in die drei Eingabefelder folgende Angaben ein:

   Feld	Eingabe
   Programm/Skript	pwsh.exe
   Argumente hinzufügen	-command "& {Start-DaVinciExport sdui .\davinci.json *> .\logs\log-sdui-$(Get-Date -f yyyy-MM-dd).txt}"
   Starten in (optional)	c:\davinci Bitte prüfen Sie, ob das Verzeichnis "davinci" an der Stelle angelegt wurde und ggfs. passen Sie bitte den Pfad an. Bitte im davinci-Verzeichnis ein neues Verzeichnis "logs" erstellen!

   Das Ganze sieht dann so aus. Klicke Sie anschließend wieder auf OK.

   

6. Alles sieht gut aus, Sie können mit OK abschließend bestätigen.

Die Aufgabenplanung erstellt jetzt die gewünschte Aufgabe.

Ein Sache ist aber noch wichtig. Standardmäßig wird Ihre Aufgabe nur dann ausgeführt, wenn Sie an Ihrem Computer aktiv angemeldet sind. Das ist aber nicht immer erwünscht. Möchte man die Aufgabe beispielsweise auf einem Windows-Server erstellen, dann soll diese ja auch dann ausgeführt werden, wenn kein Server-Administrator am Server angemeldet ist (Das ist ja der Standardfall). In diesem Fall müssen Sie die Konfiguration Ihrer Aufgabe anpassen:

1. Wählen Sie eine neue Aufgabe in der Windows-Aufgabenplanung aus und klicken Sie rechts unter Ausgewähltes Element auf Eigenschaften. Es öffnet sich ein Dialogfenster.

   

2. Wählen Sie unter Sicherheitsoptionen die Option Unabhängig von der Benutzeranmeldung ausführen aus und bestätigen Sie mit OK.

   

3. Sie werden jetzt aufgefordert, sich mit einem passenden Windows-Benutzerkonto zu authentifizieren. In der Regel sollte Ihr eigenes Windows-Benutzerkonto ausreichen.

   

Das Ergebnis:

Wir haben eine Aufgabe erstellt, die das PowerShell-Cmdlet zum Übertragen der Daten von DaVinci nach Sdui alle 10 Minuten startet. Ein Upload erfolgt nur dann, wenn es auch Änderungen in DaVinci seit dem letzten Abgleich gegeben hat. Die Ausgabe wird in eine Textdatei geloggt, so dass Sie stets kontrollieren können, ob der letzte Übertrag erfolgreich war oder nicht.