Automatisieren des SDS-CSV-Uploads mit Power Automate

Mit School Data Sync (SDS) und Power Automate können Sie Ihre lokal exportierten SIS/SMS-CSV-Dateien automatisch synchronisieren und Ihre Microsoft 365-Daten auf dem neuesten Stand halten. Keine manuellen Änderungen oder manuellen CSV-Uploads über die SDS-Benutzeroberfläche für die aktive akademische Sitzung mehr. Bietet die folgenden Vorteile:

• Erleichtert die Verwaltung und Überwachung lokaler CSV-Dateiuploads.
• Hält Microsoft 365-Benutzer und -Kurse basierend auf Änderungen von SIS/SMS und nicht auf manuellen Änderungen durch Lehrkräfte oder Administratoren auf dem neuesten Stand.
• Verwalten Sie den gesamten Uploadprozess über die Power Automate-Benutzeroberfläche in der Cloud, die einfacher zu verwenden ist als PowerShell-Skripts.
• Die gesamte Überwachung und Verwaltung der Lösung erfolgt in Microsoft 365.
• Serverbetriebssystemunterstützung für bessere Zuverlässigkeit und lokales Datengateway für den lokalen Dateiupload.

Übersicht

Beginnen Sie mit der Installation von Konfigurieren des CSV-Dateispeicherorts, einschließlich der Installation eines lokalen Datengateways, die etwa 5 Minuten dauern sollte. Als Nächstes konfigurieren Sie Power Automate Flow für die Verwendung der School Data Sync-Vorlage, die eine Verbindung mit dem Gateway herstellt, und verwenden den SDS-Connector, um Dateien zur Verarbeitung in SDS zu pushen.

Wichtig

Vergessen Sie nicht, ein lokales Dienstkonto auf dem Computer zu erstellen, auf dem das Gateway installiert ist. Anweisungen finden Sie hier. Dies ist für den Dateisystemteil der Flowerstellung erforderlich .

Voraussetzungen

Eine vollständige Liste der Anforderungen und für den Fall, dass Probleme bei der Installation auftreten, finden Sie unter Installieren eines lokalen Datengateways .

Mindestanforderungen

• .NET Framework 4.6 (Gatewayrelease August 2019 und früher)
• .NET Framework 4.7.2 (Gatewayrelease September 2019 und höher)
• Eine 64-Bit-Version von Windows 7 oder eine 64-Bit-Version von Windows Server 2008 R (oder höher)

Empfohlen

• Eine 8-Kern-CPU
• 8 GB Arbeitsspeicher
• Eine 64-Bit-Version von Windows Server 2012 R2 oder höher
• SSD-Speicher (Solid State Drive) für Spooling

Wichtige Überlegungen

• Gateways werden bei Server Core-Installationen nicht unterstützt.
• Der Benutzer, der das Gateway installiert, muss der Administrator des Gateways sein.
• Das Gateway kann nicht auf einem Domänencontroller installiert werden.
• Wenn Sie die Windows-Authentifizierung verwenden möchten, stellen Sie sicher, dass Sie das Gateway auf einem Computer installieren, der Mitglied derselben Active Directory-Umgebung wie die Datenquellen ist.
• Sie sollten kein Gateway auf einem Computer installieren, z. B. auf einem Laptop, der im Ruhezustand ausgeschaltet oder vom Internet getrennt ist. Das Gateway kann unter keinem dieser Umstände ausgeführt werden.
• Wenn ein Gateway ein Drahtlosnetzwerk verwendet, kann die Leistung beeinträchtigt werden.
• Sie können bis zu zwei Gateways auf einem einzelnen Computer installieren: eines im persönlichen Modus und das andere im Standardmodus. Auf demselben Computer können nicht mehr als ein Gateway im selben Modus ausgeführt werden.

Ports

Das Gateway erstellt eine ausgehende Verbindung mit Azure Service Bus. Die Kommunikation erfolgt über ausgehende Ports: TCP 80, 443 (Standard), 5671, 5672, 9350 bis 9354. Das Gateway erfordert keine eingehenden Ports. Wenn Sie ausgehende Ports auf Ihrem Server einschränken, müssen Sie sicherstellen, dass diese ausgehenden Ports geöffnet sind.

Konfigurieren des Speicherorts der CSV-Datei

Überprüfen der Region Ihrer Power Apps-Umgebung

1. Melden Sie sich beim Power Platform Admin Center mit Ihrem globalen Administratorkonto an.

2. Navigieren Sie zu Umgebungen , und überprüfen Sie die Region der umgebung, die Sie verwenden. Die Region ist erforderlich, um sicherzustellen, dass Sie das lokale Datengateway installieren, um dieselbe Region zu verwenden.

   

Herunterladen des lokalen Datengateways

1. Laden Sie das Gatewayinstallationsprogramm herunter, speichern Sie es, und führen Sie es auf einem lokalen Computer aus.

2. Übernehmen Sie den Standardinstallationspfad, oder geben Sie den Speicherort auf Ihrem Computer an, an dem Sie das Gateway installieren möchten.

3. Überprüfen und akzeptieren Sie die Nutzungsbedingungen und die Datenschutzbestimmungen, und wählen Sie dann Installieren aus.

   

4. Nachdem das Gateway erfolgreich installiert wurde, geben Sie Ihr globales Administratorkonto an, und wählen Sie Anmelden aus.

   

5. Wählen Sie Register a new gateway on this computer Next (Neues Gateway auf diesem Computer> registrieren) aus. Dadurch wird Ihre Gatewayinstallation beim Gateway-Clouddienst registriert.

   

6. Füllen Sie die angeforderten Informationen für Die Gatewayinstallation aus:

   • Der Name, den Sie für Ihre Installation verwenden möchten
   • Der zu erstellende Wiederherstellungsschlüssel, der mindestens acht Zeichen umfassen muss

   Wichtig

   Speichern und bewahren Sie Ihren Wiederherstellungsschlüssel an einem sicheren Ort auf. Sie benötigen diesen Schlüssel, wenn Sie den Standort des Gateways ändern oder wenn Sie ein vorhandenes Gateway migrieren, wiederherstellen oder übernehmen.

7. Wählen Sie Konfigurieren aus.

   

8. Ändern Sie auf dem nächsten Bildschirm nicht die empfohlene Region unter Region auswählen , es sei denn, Sie wissen mit Sicherheit, dass Sie die Region ändern müssen. Überprüfen Sie die Region Ihrer Power Apps-Umgebung unter Überprüfen der Region Ihrer Power Apps-Umgebung , um sicherzustellen, dass die ausgewählte Region identisch ist. Wählen Sie dann Fertig aus.

   

9. Nachdem die Bestätigungsseite angezeigt wird, wählen Sie Schließen aus. Das Installationsprogramm bestätigt, dass Ihr Gateway jetzt online und einsatzbereit ist.

   

   Hinweis

   Sie müssen nicht auf dem Link "Gateway in Azure erstellen" auswählen. In diesem Artikel wird die Funktionsweise des Datengateways erläutert.

Erstellen eines neuen lokalen Dienstkontos

1. Wechseln Sie zu Computerverwaltung.

2. Doppelklicken Sie auf Lokale Benutzer und Gruppen.

3. Doppelklicken Sie auf Benutzer.

4. Klicken Sie mit der rechten Maustaste im mittleren Bereich auf Neuen Benutzer hinzufügen .

5. Geben Sie einen Benutzernamen wie SDSServiceAccount ein, und notieren Sie den Namen und das Kennwort, den Sie auswählen, wenn Sie es erneut verwenden müssen.

6. Deaktivieren Sie die Option "Benutzer muss Kennwort bei der nächsten Anmeldung ändern".

7. Optional: Aktivieren Sie die Option "Kennwort läuft nie ab".

8. Wählen Sie Erstellen aus.

   

Erstellen eines Ordners für Ihre CSV-Dateien

Richten Sie den Ordnerspeicherort ein, an dem der Export Ihrer CSV-Dateien vorhanden sein muss.

1. Öffnen Sie den Datei-Explorer.
2. Navigieren Sie zu Ihrem Laufwerk "C:\".
3. Wählen Sie mit der rechten Maustaste aus, und wählen Sie Neuer>Ordner aus.
4. Geben Sie Ordnername ein. In diesem Beispiel erstellen wir den Ordner "CSV-Dateien".

Erteilen Sie Ihrem lokalen Dienstkonto vollständige Berechtigungen für den CSV-Ordner.

1. Wählen Sie mit der rechten Maustaste den Ordner aus, den Sie in Schritt 3 erstellt haben, und wechseln Sie zu Eigenschaften.

2. Wechseln Sie zur Registerkarte Sicherheit .

3. Wählen Sie Bearbeiten aus.

   

4. Klicken Sie auf Hinzufügen.

5. Legen Sie die Option Speicherort auf Ihren lokalen Computer fest. Dies ist die erste Option in der Liste, wenn Sie Standorte auswählen.

6. Geben Sie den Namen des SDSServiceAccount (den Sie in Schritt 2, Nummer 5 erstellt haben) in das Feld "Objektnamen" (drittes Feld) ein, und wählen Sie Namen überprüfen aus.

7. Wählen Sie OK aus.

   

8. Stellen Sie sicher, dass dem Dienstkonto vollzugriff gewährt wird. Wählen Sie Anwenden aus.

9. Wählen Sie OK aus.

   

Kopieren Sie Ihre CSV-Dateien in den Ordner.

1. Kopieren Sie den neuesten Extrakt Ihrer CSV-Dateien in den Ordner.

   

   Achtung

   Stellen Sie sicher, dass in diesem Ordner nur CSV-Dateien vorhanden sind.

Konfigurieren des Power Automate-Flows

Stellen Sie sicher, dass die Power Automate-App aktiviert ist.

1. Starten Sie Ihren Browser.
2. Wechseln Sie zu , https://admin.microsoft.com und melden Sie sich mit Ihrem globalen Administratorkonto an.
3. Wählen Sie Benutzer und dann Aktive Benutzer aus.
4. Suchen Sie im Feld "Benutzer suchen" nach Ihrem Administratorkonto.
5. Wählen Sie Ihr Konto aus.
6. Wählen Sie Lizenz und Apps aus.
7. Stellen Sie unter Apps sicher, dass "Power Automate für Office 365" aktiviert ist. Wenn nicht, wählen Sie die Option aus, und wählen Sie dann Speichern aus.

Wichtig

Der Dateisystemconnector kann nur innerhalb des Vorlagenerstellungsprozesses eingerichtet oder geändert werden. Wenn jemals Änderungen am Dateisystem erforderlich sind; Einschließlich Benutzername, Kennwort oder Ordnerspeicherort müssen Sie den Flow vollständig neu erstellen.

Einrichten der Vorlage

1. Starten Sie Ihren Browser.

2. Gehen Sie zu https://make.powerautomate.com.

3. Stellen Sie sicher, dass Sie mit Ihrem globalen Administratorkonto angemeldet sind.

   Achtung

   Ihr Konto sollte mit dem Konto identisch sein, das Sie zum Einrichten des Gateways verwendet haben, um das Setup für Configure CSV file loacaiton zu erstellen.

4. Navigieren Sie auf der linken Seite zu Vorlagen.

   

5. Suchen Sie in der Vorlagensuchaufforderung nach School Data Sync. Wählen Sie Automate School Data Sync CSV Upload (CSV-Upload für School Data Sync automatisieren) aus.

   Achtung

   Für SDS (klassisch) gelten die folgenden Optionen: Wählen Sie die neue SDS-Benutzeroberfläche nicht aus oder verwenden Sie sie nicht:

   Automatisieren von CSV-Dateien, die in Ihr School Data Sync-Synchronisierungsprofil (klassisch) hochgeladen wurden

   Senden von E-Mails bei Fehlern bei School Data Sync (klassisch)

   School Data Sync (klassisch) über SFTP

   

   

6. Wählen Sie erstellen für den Dateisystemconnector aus. Sie werden aufgefordert, einen neuen Dateisystemconnector einzurichten und die Anmeldeinformationen für das Datengateway und das lokale Dienstkonto zu verwenden, um auf den Speicherort des CSV-Dateiordners zuzugreifen.

   Achtung

   Wenn Sie bereits über ein Dateisystem verfügen, müssen Sie auf die Auslassungspunkte klicken und auswählen, um einen neuen Connector zu erstellen.

   

7. Nennen Sie die Verbindung. Es wird empfohlen, den Namen in Bezug auf seine Funktion zu benennen. In unserem Beispiel sds CSV File Automation.

8. Geben Sie im Stammordner den Pfad zu Ihrem zuvor erstellten CSV-Dateiordner ein. In unserem Beispiel wird "C:\CSV_Files" verwendet.

9. Der Authentifizierungstyp sollte standardmäßig auf Windows festgelegt sein.

10. Benutzername ist der vollständige Benutzername für das zuvor erstellte Dienstkonto, einschließlich des Computernamens. In unserem Beispiel wird DESKTOP-SD85O7N\SDSServiceAccount verwendet.

11. Geben Sie das Kennwort für dieses lokale Dienstkonto ein.

12. Wählen Sie das Gateway aus, das zuvor eingerichtet wurde.

    Tipp

    Wenn das zuvor eingerichtete Gatway nicht angezeigt wird, führen Sie die Schritte zur Problembehandlung für fehlendes lokales Datengateway aus.

13. Wählen Sie Erstellen aus.

    

14. Wählen Sie Weiter aus, um den Prozess zum Erstellen/Anpassen des Flows zu starten.

Abrufen der School Data Sync | Datenquelle verbinden | Flow-ID

1. Navigieren Sie auf einer separaten Registerkarte zum SDS-Portal unter https://sds.microsoft.com.

2. Navigieren Sie zu Synchronisierung | Configuraiton | Registerkarte "Daten verbinden". Wechseln Sie zum Abschnitt für die entsprechende Quellkonfiguration, die den CSV-Datenextrakten entspricht, die hochgeladen werden sollen.

   • Wenn Sie eine entsprechende Connect-Datenkonfiguration für Ihre Quelle in SDS erstellen müssen, befolgen Sie die entsprechenden Anweisungen basierend auf dem verwendeten CSV-Format. Dies muss geschehen, um die Konfiguration Ihres Power Automate-Flows abzuschließen.
     • Verbinden von Daten mit SDS v2.1 CSV
     • Verbinden von Daten mit SDS v1 CSV

3. Suchen Sie unten in der entsprechenden Connect-Datenkonfiguration für Ihre Quell-ID, die als GUID dargestellt wird. Kopieren Sie sie, damit sie später beim Konfigurieren des Power Automate-Flows verwendet werden kann.

   

Erstellen und Konfigurieren einer Anwendung

Wichtig

Sie benötigen ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie hier ein kostenloses Abonnement einrichten oder die aktuelle Liste der Azure-Angebote überprüfen.

Führen Sie auf einer separaten Registerkarte die folgenden Schritte aus:

1. Registrieren einer Anwendung

2. Generieren eines geheimen App-Clientschlüssels

3. Gewähren von Anwendungsberechtigungen für die Anwendung

   • IndustryData-InboundFlow.ReadWrite.All
   • IndustryData-DataConnector.Upload

4. Erteilen der Administratoreinwilligung

   Hinweis

   Ausführlichere Informationen findest du unter Konfigurieren der Clientanwendung .

Einrichten von Power Automate Flow

1. Wechseln Sie zurück zur Registerkarte Power Automate, um dort fortzufahren, wo sie aufgehört haben.

2. Um mit der Konfiguration des Flows zu beginnen, wählen Sie Weiter aus.

3. Ändern Sie bei Bedarf die Wiederholungshäufigkeit für die bestimmte Tageszeit und die Häufigkeit, mit der die Synchronisierung ausgeführt werden soll.

   

   Tipp

   Es wird empfohlen, dass Sie genügend Zeit für den Export und das Kopieren in den CSV-Ordner einräumen, bevor die definierte Wiederholungshäufigkeit ausgeführt wird.

4. Geben Sie die Werte Client-ID und Geheimer Clientschlüssel unter Client-ID abrufen und Geheimer Clientschlüssel ein.

   • Geben Sie die Client-ID im Schritt Clientid ein.
   • Geben Sie im Schritt Geheimer Clientschlüssel den geheimen Clientschlüssel ein.

   

5. Geben Sie Ihre TenandId ein.

6. Geben Sie den ID-Wert aus Den Werten aus Abrufen der School Data Sync | Datenquelle verbinden | Flow-ID

   

7. Geben Sie den vollständigen Dateipfad ein, der beim Einrichten eines Ordners für Ihre CSV-Dateien erstellen in der Eingabeaufforderung Ordner des Blocks "Dateien im Ordner auflisten" im Abschnitt "Dateien hochladen" erstellt wurde. Um zu überprüfen, ob die Verbindung korrekt ist, können Sie das Bild Ordner am Ende des Felds und dann den Pfeil auswählen. Sollte nur den Text "No Items" enthalten.

   

8. Wählen Sie Speichern aus, und testen Sie dann den Connector, indem Sie oben rechts auf der Seite Testen auswählen. Wählen Sie "I'll perform the trigger action" (Ich führe die Triggeraktion aus) aus, und speichern Und testen Sie sie. Bestätigen Sie abschließend, indem Sie "Run Flow" (Flow ausführen) auswählen, um Ihren Flow zu testen.

9. Der Flow sollte ausgeführt werden und alle grünen Häkchen erhalten, die angeben, dass alles erfolgreich war. Wenn Probleme auftreten, wenden Sie sich an den SDS-Support oder Ihren Bereitstellungs-Manager.

   Hinweis

   Die Power Automate-Vorlage lädt nur die Dateien in SDS hoch, damit sie in die nächste Synchronisierungsausführung einbezogen werden. Synchronisierungsausführungen werden in der Regel alle 12 Stunden ausgeführt. Überprüfen Sie SDS | Startdashboard oder Synchronisierung | Führen Sie aus , um zu bestätigen, dass der Validierungs- und Synchronisierungsprozess für die nachfolgende Synchronisierungsausführung nach dem automatisierten Upload ordnungsgemäß abgeschlossen wurde.