Synchronisieren von Eltern- und Erziehungsberechtigtenkontakten in SDS

Übersicht

School Data Sync (SDS) unterstützt die Erfassung verschiedener Datenelemente für die primären Zwecke der Bereitstellung von Microsoft 365-Objekten und -Entitäten sowie zum Aktivieren und Erweitern von Insights. Eines der Datenelemente, die für die Synchronisierung in SDS unterstützt werden, sind übergeordnete und Wächterdaten. In diesem Dokument werden der Synchronisierungsprozess für Übergeordnete und Erziehungsberechtigte sowie die verschiedenen Anwendungsfälle und Überlegungen zur Synchronisierung dieses Datasets mit Microsoft 365 beschrieben.

Warum erfassen Schulen Kontaktdaten von Eltern und Erziehungsberechtigten?

1. Die Eltern-App bietet Lehrkräften eine Liste aller Eltern- und Erziehungsberechtigtenkontakte für jedes Kursteam, das sie über SDS verwalten und synchronisieren. Die Eltern-App ermöglicht es Lehrkräften, sich direkt in Teams mit einem der bei der Schule gespeicherten Kontakte der Eltern und Erziehungsberechtigten zu unterhalten und zu kommunizieren.

2. Wenn wöchentlicher Erziehungsberechtigter-E-Mail-Digest in Aufgaben in Teams aktiviert ist, sendet die Aufgaben-App jede Woche E-Mails an Eltern und Erziehungsberechtigte, die eine Zusammenfassungsansicht der Aufgaben aus der vorherigen Woche und Aufgaben für die kommende Woche für jeden Kurs enthalten.

3. App-Integrationen von Drittanbietern: Kontaktdaten von Eltern und Erziehungsberechtigten sind für Anwendungen von Drittanbietern über die relatedContacts-API auf MS Graph verfügbar. Durch die Bereitstellung der Daten über Graph können Organisationen ihre eigenen Erfahrungen und Anwendungsfälle für die Kontaktdaten von Eltern und Erziehungsberechtigten erstellen und bereitstellen.

Hinweis

Wenn Ihre Einrichtung derzeit kein SDS verwendet oder über eine Möglichkeit verfügt, Eltern- und Kontaktdaten an SDS zu liefern, können Administratoren Lehrkräften die Möglichkeit geben, über die übergeordnete App in Teams informationen direkt hinzuzufügen und zu aktualisieren. Weitere Informationen zu den Admin Schritten finden Sie unter Einrichten der übergeordneten Verbindung in Teams für EDU.

Welche Eltern- und Erziehungsberechtigtendaten werden unterstützt?

SDS unterstützt die Erfassung grundlegender Kontaktinformationen zu Eltern und Erziehungsberechtigten, einschließlich:

• Vorname
• Nachname
• E-Mail-Adresse
• Telefonnummer
• ID
• Rolle des entsprechenden Kontakts
• Zugehörige Studenten-ID

Wo und wie werden die Daten in Entra ID gespeichert?

• SDS schreibt die erfassten Übergeordneten- und Erziehungsberechtigtendaten in Substrate innerhalb eines ausgeblendeten Datenspeichers auf das Benutzerobjekt jedes Kursteilnehmers.
• Diese grundlegenden Kontaktdaten werden NICHT als Standard-E-Mail-Kontakte in Exchange Online geschrieben. Diese Wahl bestand darin, zu verhindern, dass alle Benutzer im Mandanten alle eltern und ihre zugehörigen Kontaktinformationen sehen, wenn SDS die Daten erfasst.
• Die Daten werden teams in Microsoft 365 nur für die ersten beiden zuvor erwähnten Szenarien zur Verfügung gestellt und auch für Anwendungen von Drittanbietern über die relatedContacts-API auf MS Graph zur Verfügung gestellt. Die API erfordert nur app-Berechtigungen, die vom Administrator erteilt werden. Dies bedeutet, dass Endbenutzer innerhalb des Mandanten keine Abfragen in MS Graph durchführen dürfen, um die Kontaktdaten von Eltern und Erziehungsberechtigten anzuzeigen oder darauf zuzugreifen, um die Privatsphäre der Eltern und Erziehungsberechtigten zu schützen.

Gewusst wie Daten von Übergeordneten und Erziehungsberechtigten synchronisieren?

Das Synchronisieren von Übergeordneten- und Erziehungsberechtigtendaten in SDS ist einfach. In diesem Abschnitt wird erläutert, wie Sie Eltern und Erziehungsberechtigte basierend auf Ihrem Ausgangspunkt und der von Ihnen verwendeten Synchronisierungsmethode synchronisieren:

SDS v1 CSV-Dateien

Wenn Sie Daten im CSV-Format von SDS v1 mit SDS synchronisieren, sollten Sie zwei zusätzliche CSV-Dateien einschließen, user.csv und guardianrelationship.csv.

SDS v2.1 CSV-Dateien

Wenn Sie Daten im SDS v2.1-CSV-Format mit SDS synchronisieren, sollten Sie eine weitere CSV-Datei einschließen, relationships.csv.

• Die userSourcedId im relationships.csv entspricht dem sourcedId-Wert des verwandten Kursteilnehmers innerhalb des users.csv. Das attribut relationshipUserSourcedId entspricht dem verknüpften übergeordneten Element in der users.csv-Datei.
• Wenn Sie Telefonnummern für Eltern und Erziehungsberechtigte einschließen, sollten Sie die Daten im E164-Format ohne Klammern oder Leerzeichen erfassen, einschließlich des Pluszeichens am Anfang der Zeichenfolge. Das E164-Format stellt sicher, dass die Telefonnummer von der übergeordneten App unterstützt wird, wenn die App SMS-basierte Kommunikationsszenarien einführt und einschließt.

OneRoster-API

• Wir haben allen aktuellen Anbietern Anleitungen zur allgemeinen OneRoster-API-Unterstützung mitgeteilt. Sie können ihnen helfen, indem Sie nachschlagen und Ihren Anbieter bitten, Unterstützung für das Einschließen von Kontaktdaten als Teil der Datenintegration einzuschließen. Teilen Sie den Artikel Onboardingleitfaden für OneRoster-API-Anbieter für SDS mit Ihrem Anbieter, damit dieser den Support aktualisieren und mit dem SDS Deployment Engineering-Team zusammenarbeiten kann, um den Support zu überprüfen und sein Profil zu aktualisieren.

• Zum Erfassen über die OneRoster-API wird basierend auf den unterstützten optionalen Datenfunktionen Ihres Anbieters der Umschalter Ein (Standard) für Kontaktedaten einschließen ausgewählt.

  • Wenn der Umschalter auf Aus festgelegt ist und nicht aktiviert werden kann, bedeutet das, dass das Profil des Anbieters die Bereitstellung der optionalen Daten derzeit nicht unterstützt.
  • Nachdem der Support von Ihrem Anbieter hinzugefügt wurde, können Sie Ihre Konfiguration bearbeiten, um die Umschaltfläche auf Ein auszuwählen, um die Daten in die nachfolgende Ausführung einzuschließen.

Senden von Kontaktdaten mit dem Student-Benutzerobjekt

Um die Kontaktdaten mit den Benutzerobjekten des Kursteilnehmers weiterzuleiten, müssen Sie sicherstellen, dass die Konfiguration Daten verwalten über die Umschaltfläche Student-Kontaktzuordnungen auf _On) verfügt, um die Daten in die nachfolgende Ausführung einzuschließen.

Rolle "Eltern" und "Erziehungsberechtigter"

SDS unterstützt verschiedene Rollen für Eltern und Erziehungsberechtigte, wie unten aufgeführt. Nur die Rollen von Eltern und Erziehungsberechtigten werden für die Eltern-App unterstützt. Wenn Sie Benutzer mit den anderen Rollen in SDS erfassen, sind diese in der Eltern-App nicht verfügbar. Wenn Sie beabsichtigen, dass die Person in der Eltern-App angezeigt und verfügbar ist, verwenden Sie eine der folgenden Rollen:

• Wächter
• Relativ
• Aide
• Arzt
• Administrator
• Andere

Status: aktiv im Vergleich zu inaktiv

Wenn SDS alle Übergeordneten und Erziehungsberechtigten zur zugehörigen Kontaktsammlung im verborgenen Substratdatenspeicher jedes Kursteilnehmers hinzufügt, wird jeder Elternteil und jeder Erziehungsberechtigte als aktiv markiert. Wenn Sie bei der nächsten Synchronisierung ein übergeordnetes Element oder einen Erziehungsberechtigten aus dem CSV-Dateiimport entfernen, wird er als inaktiv markiert. Diese status kann auf der Seite "Personen" für jeden Kursteilnehmer in SDS angezeigt werden. Nur Eltern und Erziehungsberechtigte mit einer aktiven status werden in der Eltern-App als verfügbar angezeigt. SDS löscht nicht automatisch Datensätze über- und erziehungsberechtigte Personen, wenn Sie das Senden von Daten in nachfolgenden Synchronisierungen beenden. Weitere Informationen zum Löschen übergeordneter Elemente finden Sie im nächsten Abschnitt.

Löschen von übergeordneten Elementen

SDS fügt alle Eltern und Erziehungsberechtigten der zugehörigen Kontaktsammlung für das Benutzerobjekt jedes Kursteilnehmers hinzu, wenn diese erfasst werden. Wenn das Benutzerobjekt des Kursteilnehmers gelöscht wird, werden auch alle entsprechenden Kontakte, die SDS im Laufe der Zeit gespeichert hat, gelöscht. Wenn Sie einen verwandten Kontakt entfernen müssen, ohne das Benutzerobjekt des Kursteilnehmers zu löschen, hat das SDS-Team ein PowerShell-Skript veröffentlicht, um diesen Prozess zu unterstützen. Wenn Sie Unterstützung beim Ausführen des PowerShell-Skripts benötigen, wenden Sie sich unter an https://aka.ms/sdssupportunser Supportteam. Nachdem der Kontakt erfolgreich aus Substrate entfernt wurde, stellen Sie sicher, dass Sie dasselbe übergeordnete Element oder denselben Erziehungsberechtigten aus allen nachfolgenden Uploads entfernen, um zu vermeiden, dass sie dem Verzeichnis wieder hinzugefügt werden.

Entfernen von Eltern- und Erziehungsberechtigtendaten

Übergeordnete und Wächterdaten werden im Azure-Substratspeicher gespeichert. Der Zugriff auf diesen Speicherort ist schwierig, erfordert Anwendungsberechtigungen und ist auch eingeschränkt, sodass Sie keinen einzelnen Eintrag entfernen können. Um einen einzelnen Elternteil oder Erziehungsberechtigten zu entfernen, der mit einem Kursteilnehmer synchronisiert wurde, müssen Sie alle Datensätze entfernen und dann die Datensätze erneut hinzufügen, die Sie dem Kursteilnehmer zuordnen möchten.

Diese Schritte helfen Ihnen, das folgende Skript auszuführen und übergeordnete und Wächterdaten zu entfernen.

O365-EDU-Tools/SDS Scripts/Reset-Guardians.ps1 bei master · OfficeDev/O365-EDU-Tools (github.com)

Wichtig

Dieses Skript verwendet das PowerShell-Modul Microsoft.Graph. Es wird nicht in PowerShell ISE ausgeführt.

Erstellen eines Zertifikats

Zum Ausführen des Skripts müssen Sie zunächst eine Anwendung in Microsoft Entra ID erstellen und ein Zertifikat für den Zugriff auf die Informationen bereitstellen. Die Schritte, Befehle und Details zum selbstsignierten Zertifikat finden Sie in diesem Artikel zum Erstellen eines selbstsignierten öffentlichen Zertifikats zum Authentifizieren Ihrer Anwendung.

1. Öffnen Sie PowerShell im Administratormodus.

   

2. Navigieren Sie zu dem Speicherort, an dem Sie arbeiten werden. In diesem Beispiel lautet dies C:\TEMP\Reset_Guardians_Script.

   

3. Öffnen Sie die folgende Seite, um die Schritte zum Erstellen des Befehls anzuzeigen. Geben Sie den ersten Befehl ein, und denken Sie daran, den Zertifikatnamen zu ändern. Es wird empfohlen, die Schaltfläche Kopieren zu verwenden, um den vollständigen Befehl zu vereinfachen.

   

4. In diesem Beispiel legen wir den Zertifikatnamen auf parentResetScript fest.

   

5. Ändern Sie den Ordnerspeicherort, bevor Sie den Befehl ausführen.

   

6. In diesem Beispiel verwenden wir denselben Ordner, in dem wir uns derzeit befinden.

   

Erstellen einer Anwendung

Die Anwendung bestimmt die Berechtigungen und den Zugriff für das Skript.

1. Navigieren Sie zum Microsoft Entra ID Admin Center und dann zur Identität | Anwendungen |App-Registrierungen.

   

2. Wählen Sie Neue Registrierung aus, um den Erstellungsprozess zu starten.

   

3. Geben Sie einen Namen für die Anwendung ein. In diesem Beispiel ist dies die übergeordnete Zurücksetzungsanwendung. Wir müssen keine weiteren Einstellungen auf dieser Seite ausfüllen.

   

4. Kopieren und speichern Sie die Anwendungs-ID (Client-ID). Es wird später verwendet, um das Skript auszuführen.

   

5. Wählen Sie API-Berechtigungen unter Verwalten aus.

   

6. Wählen Sie Berechtigung hinzufügen aus.

   

7. Wählen Sie Microsoft Graph aus.

   

8. Wählen Sie Anwendungsberechtigungen aus.

   

9. Suchen Sie nach Benutzer, und wählen Sie diese Option aus . ReadWrite.All und EDURoster.ReadWrite.All , und wählen Sie unten Berechtigungen hinzufügen aus, sobald beide ausgewählt sind.

   

   

10. Wählen Sie Administratoreinwilligung erteilen für (Mandantenname) aus, und bestätigen Sie dies.

    

    

11. Navigieren Sie auf der linken Seite unter Verwalten zu Zertifikate & Geheimnisse.

    

12. Wählen Sie die Registerkarte Zertifikate und dann Zertifikat hochladen aus.

    

13. Navigieren Sie zu dem Zertifikat, das wir in der ersten Phase erstellt haben.

    

14. Wählen Sie Hinzufügen.

    

15. Kopieren Sie abschließend den Fingerabdruck.

    

Ausführen des Reset_Guardians.ps1-Skripts

Zum Ausführen des Skripts benötigen Sie Ihre Mandanten-ID und das Skript, das Sie hier finden: O365-EDU-Tools/SDS Scripts/Reset-Guardians.ps1 at master · OfficeDev/O365-EDU-Tools (github.com)

1. Navigieren Sie zur Registerkarte Übersicht in Microsoft Entra ID, um Ihre Mandanten-ID zu finden.

   

2. Öffnen Sie das GitHub-Repository, und laden Sie das Skript herunter. In diesem Beispiel wird es in denselben Ordner heruntergeladen, in dem das Zertifikat enthalten ist.

   

3. Dieses Skript kann auf verschiedene Arten ausgeführt werden. Wenn Sie das Skript mit einem Text-Editor wie Editor öffnen, können Sie die verschiedenen Methoden sehen, die verwendet werden können. In diesem Beispiel führen wir es für alle Kursteilnehmer aus.

   

4. Zum Ausführen des Skripts können Sie das letzte Beispiel kopieren und die Felder durch unsere neuen Anwendungsinformationen und die Mandanten-ID ersetzen.

   \Reset-Guardians.ps1 -clientId "{Application (client) ID}" -certificateThumbprint "{Certificate Thumbprint}" -tenantId "{Tenant ID}" ## Replace the field including the { }
   

   

5. Nachdem Sie die EINGABETASTE gedrückt haben, geben Sie R ein, und drücken Sie die EINGABETASTE. Wenn es richtig ausgeführt wird, stellt das Skript eine Verbindung mit Graph her, beginnt mit dem Extrahieren der Kursteilnehmer und beginnt mit dem Entfernungsprozess. Je mehr Kursteilnehmer, desto länger dauert die Ausführung des Skripts.

   

6. Nachdem alle Kursteilnehmer extrahiert wurden, werden sie aufgefordert, die Entfernung der Eltern- und Erziehungsberechtigtendaten zu bestätigen. Geben Sie y ein, um fortzufahren.

   

7. Im Folgenden finden Sie ein Beispiel dafür, wie das Skript angezeigt wird, wenn es die Daten entfernt.

   

Hilfreiche Ressourcen

Admin-Setup für die Eltern-App

Aufgaben für Teams

relatedContact-Ressourcentyp