Integrität und Überwachung der Synchronisierung

Home Dashboard

Während der Datenverarbeitung überprüft School Data Sync (SDS) Daten, indem gute Daten in den Data Lake übertragen und ungültige Daten gekennzeichnet werden. Am Ende jeder Synchronisierungsausführung werden Statistiken generiert, um die Integrität und Überwachung zu unterstützen.

Um die Integrität der Daten zu bestimmen, werden Datenabgleichs- und Validierungsregeln übergeben, um die erforderlichen und optionalen Daten zu schützen, die nur in den Data Lake fließen. Daten, die die Überprüfung nicht bestehen, werden als Fehler oder Warnungen identifiziert und nicht an den Data Lake gesendet.

Wenn keine Fehler oder Warnungen gefunden wurden, lautet das Ergebnis der Ausführung Abgeschlossen. Im home Dashboard wird folgendes angezeigt: "Keine Datenfehler oder Warnungen gefunden" und "Während der letzten Ausführung sind keine Datenfehler oder Warnungen aufgetreten. Halten Sie die großartige Arbeit weiter!"

Wenn Fehler und Warnungen gefunden werden, wird das Ergebnis der Ausführung mit Fehlern abgeschlossen.

• Ein Fehler wird ausgelöst, wenn ein Wert in einem Datensatz für erforderliche Daten keine Datenabgleichs- oder Validierungsregel bestanden hat. Der Datensatz wurde entfernt und nicht an den Data Lake gesendet.

Wenn nur Warnungen gefunden werden, wird das Ergebnis der Ausführung mit Warnungen abgeschlossen.

• Eine Warnung wird ausgelöst, wenn ein Wert in einem Datensatz für optionale Daten keine Datenabgleichs- oder Validierungsregel bestanden hat. Der Wert wurde entfernt, aber der Datensatz wurde an den Data Lake gesendet.

Das Startseitendashboard informiert darüber, dass "Wir einige Probleme mit Ihren Daten gefunden haben" und empfiehlt Ihnen, die Integrität der Synchronisierung zu untersuchen. Wenn Sie weitere Informationen zu den Ergebnissen der Synchronisierungsausführung anzeigen möchten, wählen Sie Synchronisierungsintegrität untersuchen aus.

Synchronisierungsintegrität

Die Synchronisierungsintegrität ist ein Tool, mit dem Sie die Integrität Ihrer synchronisierten Daten besser verstehen und bei Datenuntersuchungen unterstützen können.

Änderungen an den Daten erfolgen basierend auf Datenänderungen aus der letzten Synchronisierungsausführung.

Eine Synchronisierungsausführung ist die Sequenzierung von Verbindungs- und Verwaltungsdatenkonfigurationen.

Die Synchronisierungsintegrität bietet auch eine Verlaufsdarstellung der letzten 14 Ausführungen.

• Start der Ausführung: Zeitstempel beim Start der Gesamtausführung
• Ausführungsende: Zeitstempel zum Ende der Gesamtausführung
• Ausführen status: Allgemeine status für alle Datenflüsse
  • Wird ausgeführt: Aktiv ausgeführt
  • Abgeschlossen: Ohne Fehler oder Warnungen abgeschlossen
  • Mit Fehlern abgeschlossen: Abgeschlossen, aber Fehler wurden gefunden
  • Abgeschlossen mit Warnungen: Abgeschlossen, aber es wurden nur Warnungen gefunden.
  • Fehler: Ausführung vom System oder Kunden abgebrochen

Um die gekennzeichneten Daten zu untersuchen, können Sie Bericht herunterladen auswählen, um eine Kopie des Berichts abzurufen.

Der Bericht ist wie folgt formatiert:

Spaltenname	Beschreibung	Beispiel
Regel	Darstellung der Validierungsregel	RequiredDataViolated
ExternalIdentifier	Externe/Quell-ID der verknüpften Entität aus dem Quellsystem	7B2C8A0B33-F7E5-460B-993A-7257165430F7
Severity	Schweregraddarstellung der gekennzeichneten Daten	Validierungsfehler, Validierungswarnung
EntityCode	Darstellung des Bereichs im Zusammenhang mit dem Fehler	Person, Organisation, Registrierung
FriendlyMessage	Basierend auf Fehler- und Warnmeldungen	Ein erforderlicher Wert für {record} fehlt im Feldnamen: {field} aus der Quelle [{fileName}/{apiEndPoint}], um den Datensatz zu erstellen.
FlowName	Name des eingehenden oder ausgehenden Flows	OneRoster-API Eingehend
SourceSystemName	Name der Quelle, aus der der Datensatz stammt	Contoso SIS
Jahr	Studienjahr	2023
Time	Daten/Uhrzeit, zu der der Datensatz während der Verarbeitung identifiziert wurde, UTC.	2023-08-21T02:53:00Z

• Weitere Informationen zu Datenabgleichs- und Validierungsregeln finden Sie unter Validierungsregeln und -beschreibungen.
• Weitere Informationen zur standardmäßigen Liste der unterstützten Werte finden Sie unter Standardliste von Werten.
• familyName, givenName und email sind für Benutzer mit Kontakt-/Erziehungsberechtigtenrollen erforderlich.
• Erwarten Sie, dass Telefon und SMS in E.164 und + enthalten sein müssen. (Beispiel: +1234567890)

Tipp

Informationen zum manuellen Hochladen von Änderungen nach der ersten Ausführung zum Aktualisieren Ihrer Quelldaten finden Sie unter Aktualisieren von Quelldaten mit SDS v2.1 CSV.

Warnung

Die maximale Anzahl von Uploads mit einer entsprechenden Ausführung beträgt sechs Mal pro Kalendertag. Wenn Sie danach hochladen, wird es nur noch bis zu zwei mal ausgeführt, basierend auf dem sds automatisierten Ausführungsintervall alle 12 Stunden.

Priorisieren von Fehlern für die Behebung

Bei der Problembehandlung von Fehlern empfehlen wir Ihnen, Validierungsfehler mit den meisten Instanzen für denselben Entitätscode zu priorisieren, bevor Sie andere Fehler behandeln.

Validierungsfehler können zu zahlreichen nachfolgenden Fehlern für jede instance innerhalb desselben Datenlaufs führen. Bei der Behebung dieser Überprüfungsfehler werden häufig zuerst viele listenbezogene Fehler behoben, die während der Überprüfung gefunden werden.

Details zur Synchronisierungsintegritätsansicht

Um Statistiken aus der Ausführung anzuzeigen, können Sie Details anzeigen auswählen, um ein Flyout zu öffnen, um Ausführungsdetails anzuzeigen. Die Statistiken der Ausführung werden auf der Registerkarte Übersicht angezeigt.

Um besser zu verstehen, aus welcher Phase die Fehler und Warnungen möglicherweise ausgelöst wurden, wählen Sie die Registerkarte Phasen aus. Die Informationen sind in die folgenden Phasen unterteilt, je nachdem, welche Datenkonfigurationen verwalten aktiviert wurden.

• Daten der Institution

• Microsoft 365-Benutzer

• Microsoft 365-Gruppen

• Microsoft-IT-Gruppen

• Neueste status

  • Abgeschlossen: Ohne Fehler oder Warnungen abgeschlossen
  • Mit Fehlern abgeschlossen: Abgeschlossen, aber Fehler wurden gefunden.
  • Abgeschlossen mit Warnungen: Abgeschlossen, aber es wurden nur Warnungen gefunden.
  • Fehler: Ausführung vom System oder Kunden abgebrochen

Hinweis

Weitere Informationen finden Sie unter Institutionelle und Ausführungsstatistiken zu Statistiken unter Ausführungsdetails.

So ermittelt SDS vorhandene Daten und legt aktive status

Hinweis

Weitere Informationen zur Konfiguration des Akademischen Jahres finden Sie unter Behandlung des Akademischen Jahres.

Die Zuordnung eines Benutzers zu einer Sitzung (z. B. Akademisches Jahr) basiert auf seiner Rolle, die an eine organization gebunden ist.

Die Zuordnung eines Benutzers zu einer Klasse basiert auf seiner Rolle, die an eine Registrierung gebunden ist, die auch einen Link zu einer Sitzung enthält.

Basierend auf den verbundenen Daten werden diese Regeln verwendet, um die Bekanntheit des Datensatzes und seiner Sitzung status im Datenspeicher zu bestimmen.

• Die Daten spiegeln wider, wenn ein neuer Datensatz zum ersten Mal angezeigt wird.
  • SDS legt das erste angezeigte Datum (Uhrzeit) und das Datum der letzten Änderung (Uhrzeit) als aktuell fest und markiert den Datensatz ggf. als "in der Sitzung aktiv" als true.
• Die Daten spiegeln wider, wenn derselbe Datensatz in der nachfolgenden Ausführung vorhanden ist.
  • SDS behält den wert für das erste angezeigte Datum (Uhrzeit) bei, legt das Datum (die Uhrzeit der letzten Änderung) auf aktuell fest, und "ist in der Sitzung aktiv" wird auf true festgelegt.
• Die Daten spiegeln wider, wenn derselbe Datensatz in einer nachfolgenden Ausführung nicht vorhanden ist.
  • SDS behält die werte für das erste angezeigte Datum (Uhrzeit) und das Datum der letzten Änderung (Uhrzeit) bei, und markieren Sie den Datensatz ggf. als "in der Sitzung aktiv" mit "false".
    • Ausnahmen treten auf, wenn Organisationen, Personen (Benutzer) und Sitzungsdatensätze im Laufe der Zeit beibehalten und nicht inaktiviert werden.
    • Es gibt fortlaufende Updates für "inaktiviert". Wenn z. B. kein Benutzerdatensatz vorhanden ist, behält das System die vorhandenen Werte für Datum (Uhrzeit) und Datum der letzten Änderung (Uhrzeit) bei. Das System legt "ist in der Sitzung aktiv" für die Organisations-/Rollen- und Registrierungsdatensätze der Benutzer auf false fest.

Hinweis

Weitere Informationen zur Datenverarbeitung finden Sie unter Validate, Store and Data Health on SDS Overview .For more information about data handling, see Validate, Store and Data Health on SDS Overview.For more information about data handling, see Validate, Store and Data Health on SDS Overview.