Integrität und Überwachung der Synchronisierung

Artikel
10/31/2024

Home Dashboard

Während der Datenverarbeitung überprüft School Data Sync (SDS) Daten, indem gute Daten in die Cachedaten ü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 sicherzustellen, dass nur in den Cache gespeicherte, gute erforderliche und optionale Daten gespeichert werden. Daten, die die Überprüfung nicht bestehen, werden als Fehler oder Warnungen identifiziert und nicht an den Cache 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 Cache 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 Cache 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

Übersicht über die 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
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 Manueller CSV-Upload mit School Data Sync.

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

Übersicht über Synchronisierungsdetails

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.

Phasen der Synchronisierungsdetails

Phasen sind ein Tool, das Einblicke in die ausgewählte Ausführung bietet, während die einzelnen Phasen der aktiven Synchronisierungsausführung durchlaufen werden. Die Informationen, die als Phase automatisch aktualisiert werden, werden abgeschlossen, und eine andere wird gestartet.

Abhängig von der Datengröße kann sich eine Phase über einen längeren Zeitraum im Zustand "Wird ausgeführt" befinden.

Hinweis

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

So ermittelt SDS vorhandene Daten und legt aktive status

Die Zuordnung eines Benutzers zu einem organization 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.

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.
Die Daten spiegeln wider, wenn derselbe Datensatz in der nachfolgenden Ausführung vorhanden ist.
- SDS behält den ersten sichtbaren Datumswert (Uhrzeit) bei, und legt das Datum (die Uhrzeit) der letzten Änderung auf aktuell fest.
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.
  - 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.