# Untis Synchronisation

{% hint style="warning" %}
Für die Nutzung des Untis Provider und installation benötigen Sie die DotNet9 Version.

Diese finden Sie hier: [<img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/235A9bL5OGAGZjmpSEVf/download-custom%20(1).png" alt="" data-size="line">Download](https://builds.dotnet.microsoft.com/dotnet/Runtime/9.0.5/dotnet-runtime-9.0.5-win-x64.exe)
{% endhint %}

Untis Provider Installer:[<img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/235A9bL5OGAGZjmpSEVf/download-custom%20(1).png" alt="" data-size="line">](https://mnsprocloud.blob.core.windows.net/download/UntisProvider.msi)[Download](https://mnsprocloud.blob.core.windows.net/download/UntisProvider.msi)&#x20;

**Aktuelle Version:** 1.16.0

**Letztes Update**: 27.05.2025

***

Folgende Schritte müssen für die Einrichtung einer Synchronisation zwischen dem Untis-Stundenplan und dem Stundenplan im MNSpro Klassenbuch konfiguriert werden:

{% hint style="info" %}
Untis ist ein Produkt der Units GmbH, Belvederegasse 11,  A-2000 Stockerau, Österreich \
[www.untis.at](http://www.untis.at). MNSpro enthält keine Lizenz für dieses Produkt, die Lizenzierung erfolgt von der Einrichtung direkt.
{% endhint %}

## Generierung eines API-Schlüssels in der MNSpro Cloud Oberfläche

### Einstellungen – Allgemein – API-Schlüssel generieren

Um einen neuen API-Schlüssel für die Stundenplan-Synchronisierung zwischen UNTIS und dem MNSpro Klassenbuch zu generieren, müssen die folgenden Menüpunkte im MNSpro Cloud Dashboard angesteuert werden (die entsprechenden Menüpunkte sind <mark style="color:red;">**rot**</mark> umrandet):

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/qZzCXl7jGBIzKKGZtMmJ/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/DzxY5DuN8IDA1p0aazHQ/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/lqEgZcz6eaOkcdnQNsCD/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/3og5gpG2VaMh7HelJJ1c/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Die Bezeichnung dieses neuen API-Schlüssels kann frei gewählt werden. Es sollte vom Namen her jedoch am besten ersichtlich sein, welche Funktion er übernimmt -> daher empfehlen wir die Namen ***„Untis Synchronisation***“ oder „***Stundenplan Untis Synchronisation***“.
{% endhint %}

Als Funktion muss die Option ***TimeTable*** ausgewählt werden und als Zeitraum empfiehlt sich das Schuljahresende einzutragen, in dem mithilfe dieses API-Schlüssels eine Synchronisation durchgeführt werden soll.

{% hint style="warning" %}
**WICHTIG**: Aus sicherheitsrelevanten Aspekten empfiehlt es sich, diesen API-Schlüssel regelmäßig durch einen neuen zu ersetzen!
{% endhint %}

In dem darauffolgenden Fenster, nach dem Klick auf den roten „Erstellen“-Button, finden Sie den generierten API-Schlüssel.&#x20;

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/Ml9uxFS5wOKtetNmoxqt/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**WICHTIG**: Dieser Schlüssel wird lediglich an dieser Stelle vollständig angezeigt und kann auch nur unmittelbar nach der Generierung vollständig eingesehen und kopiert werden! Wenn der Schlüssel nicht mehr bekannt ist, kann er lediglich gelöscht und ein neuer Key generiert werden.
{% endhint %}

{% hint style="info" %}
Falls Sie die Option *Allgemein* unter Einstellungen nicht sehen, dann fehlt Ihnen noch das benötigte Recht. Als Admin können Sie sich dieses Recht unter **Einstellungen** --> **Berechtigungen** --> **Administrator** --> **Berechtigungen verwalten** und dort unter dem Punkt "Einstellungen" selbst vergeben!
{% endhint %}

## Vorbereitungen MNSpro Cloud Klassenbuch

### Einstellungen – Stundenplan – Importvalidierung: E-Mails

Um eine E-Mail-Adresse zu hinterlegen, an die Synchronisationsfehler gesendet werden sollen, ist es notwendig, in die Einstellungen vom Stundenplan zu wechseln.&#x20;

Dies sollte vor der ersten Synchronisation durchgeführt werden. Dies geschieht über die Kachel „Stundenplan“, nach Auswahl der Einstellungen in dem linken Navigationsbereich.

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/AIXyhoAgjDfpSFS0YMG1/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/8dcXY009sSDy5KvywTQp/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/1XpXxJMI5bttw7jSQcr6/23.webp" alt=""><figcaption></figcaption></figure>

Hier ist zunächst der erste Punkt relevant, um E-Mail-Adressen für die Synchronisationsfehler zu definieren. Auf die anderen beiden Punkte in diesen Importvalidierungseinstellungen des Stundenplans („Unterrichtsstunden“ und „Lehrer/in“) kommen wir zu einem späteren Zeitpunkt zurück.

### Einstellungen – Klassenbuch – Allgemein

Informationen zu diesem Punkt finden Sie [hier](https://docs.mnspro.cloud/administration-my.mnspro.cloud/mnspro-cloud/klassenbuch-and-stundenplan/einrichtung-des-klassenbuchs).

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/vWnmsoOzRNEpr2NlMx45/image.png" alt=""><figcaption></figcaption></figure>

### Einstellungen – Klassenbuch - Stammdaten

Hier müssen die Informationen zu Ihrer Schule ausgefüllt werden.&#x20;

Nähere Informationen zu diesem Punkt finden Sie [hier](https://docs.mnspro.cloud/administration-my.mnspro.cloud/mnspro-cloud/klassenbuch-and-stundenplan/einrichtung-des-klassenbuchs).

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/wBHULHG9fw1bURIkkIpq/image.png" alt=""><figcaption></figcaption></figure>

## Vorbereitungen Untis&#x20;

Neben den Vorbereitungen in der MNSpro Cloud Umgebung gibt es auch noch Anpassungen, die im Vorfeld in Untis durchgeführt werden.

### Untis – Lehrer – Stammdaten

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/Uwqjpidlr8avs8vBseir/einrichtung_abb11.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/UELPAdO99OnLflF9Feaj/einrichtung_abb12.png" alt=""><figcaption></figcaption></figure>

Die Spalte „E-Mail-Adresse“ muss gleich sein, wie die E-Mail-Adresse des entsprechenden MNSpro Cloud-Benutzers!

{% hint style="info" %}
Kursnamen in Untis sollten an die Namen in anderen Schulverwaltungsprogrammen angeglichen werden (sollte das nicht passieren, kann es zu einem Mehraufwand bei den Kurszuordnungen kommen, da dann manuell die Gruppennamen aus Untis mit den Gruppennamen der MNSpro Cloud-Gruppen, die meist aus einem Export aus anderen Schulverwaltungsprogrammen stammen).
{% endhint %}

## Konfiguration Untis TimeTable Provider

Sind die zuvor dokumentierten Voraussetzungen alle erfüllt, kann mit dem Download der UntisProvider.msi fortgefahren werden und das Tool ausgeführt und anschließend den Einrichtungsanweisungen gefolgt werden.

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/ykyTu4hQBDCtbllFpEw6/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Sollte der Hinweis auftauchen, dass aktuell keine .Net Core Version installiert ist, muss diese vor der Ausführung der Installation noch nachinstalliert werden und anschließend das Tool neu gestartet werden!

<img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/smp1FQwKv0ocMtxMoPGO/image.png" alt="" data-size="original">

​​
{% endhint %}

Im ersten Schritt werden grundlegende Parameter abgefragt:

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/Y5gkIZOnlgR4n8ZMGAlo/image.png" alt=""><figcaption></figcaption></figure>

**API Schlüssel:** Unter ***ApiKey*** ist der im ersten Schritt erstellte Schlüssel einzutragen.

**Minimum Pausenzeit (in Minuten):** Ist ein Schwellwert ab wann Pausen im Stundenplan als solche angezeigt werden, in diesem Beispiel werden Pausen bis zu 5 Minuten zwischen zwei Unterrichtsstunden ignoriert.

**Untis Programm Speicherort:** Verlangt das Installationsverzeichnis von Untis. Dieser ist voraussichtlich nach jedem Jahr, wenn eine neue Version verwendet wird, anzupassen.

Je nach Verbindungsart werden in folgenden Schritt verschiedene erforderliche Angaben benötigt:

**Untis Datendatei (Datenbankdatei):** Ist die Datei, in der die Schule den Untis Stundenplan erstellt.

**Schulnummer (MySQL):** Ist der Name, der bei Anlage der Datenbank gewählt wurde.&#x20;

**Schuljahr (MySQL):** Hier kann ausgewählt werden, welches Schuljahr aus der Datenbank importiert werden soll

**Untis Datenbank Benutzername (MySQL):** Benutzername, mit welchem die Verbindung zur MySQL Datenbank hergestellt wird

**Untis Datenbank Passwort (MySQL):** Passwort, mit welchem die Verbindung zur MySQL Datenbank hergestellt wird

**Untis Datenbank Version (MySQL):** Die Datenbank - Sicherungsversion, die importiert werden soll.

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/FwmnUbXZTWYIpmhTf1jZ/image.png" alt=""><figcaption><p>Beispiel: Dialog Datendatei</p></figcaption></figure>

Durch Klick auf *Weiter* gelangen Sie zu einem Dialog, wo der Speicherort des ***Untis TimeTableProviders*** ausgewählt werden kann.

{% hint style="info" %}
Wählen Sie hier einen Netzwerkpfad aus, falls das Tool von mehreren verwendet werden soll!&#x20;
{% endhint %}

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/VWk9LNwGFk7RsGkPbvEF/image.png" alt=""><figcaption></figcaption></figure>

Im nächsten und letzten Fenster wird durch Klick auf Installieren die Installation abgeschlossen und das Tool bereitgestellt. Es wird entsprechend eine Verknüpfung auf dem Desktop hinterlegt.&#x20;

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/QPZQQsc0OcVieRHQNnU3/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/pXZklS3Rp5SIE0Sset5y/image.png" alt=""><figcaption></figcaption></figure>

Was macht eine Synchronisation: Die Synchronisation legt die Stufen aus Untis als Stufen im MNSpro Klassenbuch an.\
-> es werden die Kurse erstellt und die Kurslehrer hinterlegt,\
-> die Klassenstrukturen werden gebildet: innerhalb der Klassen werden die Kurse zugewiesen, \
-> für die Lehrer:innen wird eine Übersicht über Ihre Unterrichtsstunden generiert,\
-> das Stundenplanraster wird angelegt,\
-> in Untis hinterlegte Ferien- und Feiertage werden eingetragen\
Bei Problemen mit der Synchronisation wird eine E-Mail an die zuvor festgelegte E-Mail-Adresse versendet, in der die Fehlerdetails dokumentiert sind!

### Aktualisierung des Tools

Die aktuelle Version des Tools hat einen Auto Update Mechanismus. Das Tool prüft automatisch im Hintergrund auf aktuelle Versionen und wird&#x20;

### Kurszuordnung

Falls nicht wie empfohlen die Namen in Untis den Namen in MNSpro Cloud angeglichen wurden, muss an diesem Punkt die Kurszuordnung erfolgen.&#x20;

Dazu wechseln Sie wieder im Portal auf den Reiter **Einstellungen** und wählen anschließend **Stundenplan** aus. Unter **Kurszuordnung** können Sie anschließend diese durchführen.&#x20;

Nähere Informationen dazu finden Sie [hier](https://docs.mnspro.cloud/administration-my.mnspro.cloud/mnspro-cloud/klassenbuch-and-stundenplan/stundenplan/einrichtung/untis-synchronisation/kurszuordnungen).&#x20;

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/e2fSlmDiPmhweDCZLRl3/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/Z6Td9i9Ye4FprObKJdCd/image.png" alt=""><figcaption></figcaption></figure>

### Schulleitung, Stufenleitung, Klassenlehrenden&#x20;

Abschließend müssen Sie noch die Schulleitung, die Stufenleitung und die Klassenlehrenden auswählen. &#x20;

Nähere Informationen dazu finden Sie unter [Schulleitung ](#einstellungen-klassenbuch-stammdaten)und [Stufeneinstellungen](https://docs.mnspro.cloud/administration-my.mnspro.cloud/mnspro-cloud/klassenbuch-and-stundenplan/einrichtung-des-klassenbuchs/zuruck-zu-den-einstellungen/sie-benutzen-kein-untis/stufe-eintragen).

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/lyGD0mRQgac48InwUP73/einrichtung_abb18.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/A4Od0F3CQQZZ9lIJ7PQi/einrichtung_abb19.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/eMM10O3xY9lhYI07xrzv/blobs/tJ5WZcn1XzYxPZE4SqpO/einrichtung_abb20.png" alt=""><figcaption></figcaption></figure>