Automatizzare il caricamento csv di SDS con Power Automate

Con School Data Sync (SDS) e Power Automate, è possibile sincronizzare automaticamente i file CSV SIS/SMS esportati in locale e mantenere aggiornati i dati di Microsoft 365. Non vengono più apportate modifiche manuali o caricamenti csv manuali tramite l'interfaccia utente SDS per la sessione accademica attiva. Offre i vantaggi seguenti:

• Semplifica la gestione e il monitoraggio dei caricamenti di file CSV locali.
• Mantiene gli utenti e le classi di Microsoft 365 aggiornati in base alle modifiche apportate da SIS/SMS anziché alle modifiche manuali di docenti o amministratori.
• Gestire l'intero processo di caricamento tramite l'interfaccia utente di Power Automate nel cloud, che è più semplice da usare rispetto agli script di PowerShell.
• Tutto il monitoraggio e la gestione della soluzione avviene in Microsoft 365.
• Supporto del sistema operativo del server per migliorare l'affidabilità e il gateway dati locale per il caricamento di file locali.

Panoramica

Iniziare con l'installazione della configurazione del percorso del file CSV, che include l'installazione di un gateway dati locale, che dovrebbe richiedere circa 5 minuti per la configurazione. Successivamente, configurare Power Automate Flow per usare il modello Di sincronizzazione dati dell'istituto di istruzione che si connette al gateway e usare il connettore SDS per eseguire il push dei file in SDS per l'elaborazione.

Importante

Non dimenticare di creare un account del servizio locale nel computer in cui è installato il gateway. Le istruzioni sono disponibili qui. Questa operazione è necessaria per la parte file system della creazione del flusso.

Prerequisiti

Per un elenco completo dei requisiti e in caso di problemi di installazione, vedere Installare un gateway dati locale .

Requisiti minimi

• .NET Framework 4.6 (versione del gateway di agosto 2019 e versioni precedenti)
• .NET Framework 4.7.2 (versione del gateway di settembre 2019 e versioni successive)
• Una versione a 64 bit di Windows 7 o una versione a 64 bit di Windows Server 2008 R (o versioni successive)

Consigliata

• CPU a 8 core
• 8 GB di memoria
• Una versione a 64 bit di Windows Server 2012 R2 o versioni successive
• Archiviazione SSD (Solid State Drive) per lo spooling

Considerazioni importanti

• I gateway non sono supportati nelle installazioni server core.
• L'utente che installa il gateway deve essere l'amministratore del gateway.
• Il gateway non può essere installato in un controller di dominio.
• Se si prevede di usare autenticazione di Windows, assicurarsi di installare il gateway in un computer membro dello stesso ambiente Active Directory delle origini dati.
• Non è consigliabile installare un gateway in un computer, ad esempio un computer portatile che potrebbe essere spento in stato di sospensione o disconnesso da Internet. Il gateway non può essere eseguito in nessuna di queste circostanze.
• Se un gateway usa una rete wireless, le prestazioni potrebbero risentirne.
• È possibile installare fino a due gateway in un singolo computer: uno in modalità personale e l'altro in modalità standard. Non è possibile avere più di un gateway in esecuzione nella stessa modalità nello stesso computer.

Porte

Il gateway crea una connessione in uscita a bus di servizio di Azure. Comunica sulle porte in uscita: TCP 80, 443 (impostazione predefinita), 5671, 5672, da 9350 a 9354. Il gateway non richiede porte in ingresso. Se si limitano le porte in uscita nel server, è necessario assicurarsi che queste porte in uscita siano aperte.

Configurare il percorso del file CSV

Verificare l'area dell'ambiente di Power Apps

1. Accedere all'interfaccia di amministrazione di Power Platform con l'account amministratore globale.

2. Passare ad Ambienti e verificare l'area dell'ambiente in uso. L'area è necessaria per assicurarsi di installare il gateway dati locale per usare la stessa area.

   

Scaricare il gateway dati locale

1. Scaricare, salvare ed eseguire il programma di installazione del gateway in un computer locale.

2. Accettare il percorso di installazione predefinito o specificare il percorso nel computer in cui si vuole installare il gateway.

3. Esaminare e accettare le condizioni per l'utilizzo e l'informativa sulla privacy e quindi scegliere Installa.

   

4. Dopo aver installato correttamente il gateway, specificare l'account amministratore globale e scegliere Accedi.

   

5. Scegliere Registra un nuovo gateway in questo computer> Avanti, che registra l'installazione del gateway con il servizio cloud del gateway.

   

6. Completare le informazioni richieste per l'installazione del gateway:

   • Nome desiderato per l'installazione
   • Chiave di ripristino che si vuole creare, che deve avere almeno otto caratteri

   Importante

   Salvare e mantenere la chiave di ripristino in un luogo sicuro. Questa chiave è necessaria quando si modifica la posizione del gateway o quando si esegue la migrazione, il ripristino o il rilevamento di un gateway esistente.

7. Selezionare Configura.

   

8. Nella schermata successiva non modificare l'area consigliata in Seleziona area a meno che non si sappia con certezza che è necessario modificare l'area. Fare riferimento all'area dell'ambiente di Power Apps in Verificare l'area dell'ambiente di Power Apps per assicurarsi che l'area selezionata sia la stessa. Selezionare quindi Fine.

   

9. Dopo aver visualizzato la pagina di conferma, scegliere Chiudi. Il programma di installazione conferma che il gateway è ora online e pronto per l'uso.

   

   Nota

   Non è necessario selezionare il collegamento che legge Create un gateway in Azure. Per altre informazioni sul contesto, questo articolo illustra il funzionamento del gateway dati.

Create un nuovo account del servizio locale

1. Passare a Gestione computer.

2. Fare doppio clic su Utenti e gruppi locali.

3. Fare doppio clic su Utenti.

4. Fare clic con il pulsante destro del mouse nel riquadro centrale per aggiungere un nuovo utente.

5. Immettere un nome utente come SDSServiceAccount e registrare il nome e la password scelti perché è necessario usarlo di nuovo.

6. Deselezionare l'opzione "L'utente deve modificare la password all'accesso successivo".

7. Facoltativo: selezionare l'opzione "Password non scade mai".

8. Selezionare Crea.

   

Create una cartella per i file CSV

Configurare il percorso della cartella in cui deve esistere l'esportazione dei file CSV.

1. Aprire Esplora file.
2. Passare all'unità C:\.
3. Selezionare a destra e selezionare Nuova>cartella.
4. Immettere Nome cartella. In questo esempio viene creata la cartella denominata "file CSV".

Concedere all'account del servizio locale autorizzazioni complete per la cartella CSV

1. Selezionare a destra la cartella creata nel passaggio 3 e passare a Proprietà.

2. Passare alla scheda Sicurezza .

3. Selezionare Modifica.

   

4. Selezionare Aggiungi.

5. Impostare l'opzione Percorso sul computer locale. Questa è la prima opzione nell'elenco quando si seleziona Posizioni.

6. Digitare il nome SDSServiceAccount (creato nel passaggio 2, numero 5) nel campo dei nomi degli oggetti (terzo campo) e selezionare Controlla nomi.

7. Seleziona OK.

   

8. Assicurarsi che il controllo completo venga concesso all'account del servizio. Selezionare Applica.

9. Seleziona OK.

   

Copiare i file CSV nella cartella

1. Copiare l'estratto più recente dei file CSV nella cartella.

   

   Attenzione

   Assicurarsi di avere solo file CSV in questa cartella.

Configurare il flusso di Power Automate

Assicurarsi che l'app Power Automate sia abilitata

1. Avviare il browser.
2. Passare a https://admin.microsoft.com e accedere con l'account di Amministrazione globale.
3. Selezionare Utenti, quindi Utenti attivi.
4. Search per l'account Amministrazione nella casella "utenti Search".
5. Selezionare l'account.
6. Selezionare Licenza e app.
7. In App verificare che "Power Automate for Office 365" sia abilitato. In caso contrario, selezionare quindi Salva.

Importante

Il connettore file system può essere configurato o modificato solo dall'interno del processo di creazione del modello. Se sono mai necessarie modifiche al file system; tra cui Nome utente, Password o Percorso cartella, sarà necessario ricreare completamente il flusso.

Configurare il modello

1. Avviare il browser.

2. Vai a https://make.powerautomate.com.

3. Assicurarsi di aver eseguito l'accesso con l'account di Amministrazione globale.

   Attenzione

   L'account deve essere uguale a quello usato per configurare il gateway per la configurazione per Configurare loacaiton del file CSV.

4. Passare a Modelli, sul lato sinistro.

   

5. Nel prompt di ricerca Modelli cercare School Data Sync. Selezionare Automatizzare il caricamento CSV di Sincronizzazione dati dell'istituto di istruzione.

   Attenzione

   Di seguito sono riportati gli elementi seguenti per SDS (versione classica), non selezionare o usare con la nuova esperienza SDS:

   Automatizzare i file CSV caricati nel profilo di sincronizzazione dati dell'istituto di istruzione (versione classica)

   Inviare Email in errori di sincronizzazione dati dell'istituto di istruzione (versione classica)

   School Data Sync (versione classica) tramite SFTP

   

   

6. Selezionare Create per il connettore file system. Viene richiesto di configurare un nuovo connettore file system e usare le credenziali di accesso del gateway dati e dell'account del servizio locale per accedere al percorso della cartella file CSV.

   Attenzione

   Se è già disponibile un file system, è necessario fare clic sui puntini di sospensione e scegliere di creare un nuovo connettore.

   

7. Assegnare un nome alla connessione. È consigliabile assegnarle un nome correlato alla relativa funzione. Nell'esempio, Automazione file CSV SDS.

8. Nella cartella radice immettere il percorso della cartella file CSV creata in precedenza. Nell'esempio "C:\CSV_Files".

9. Il tipo di autenticazione deve essere impostato su Windows per impostazione predefinita.

10. Username è il nome utente completo per l'account del servizio creato in precedenza, incluso il nome del computer. Nell'esempio desktop-SD85O7N\SDSServiceAccount.

11. Immettere la password per l'account del servizio locale.

12. Selezionare il gateway configurato in precedenza.

    Consiglio

    Se non viene visualizzato Gatway configurato in precedenza, seguire la procedura di risoluzione dei problemi del gateway dati locale mancante.

13. Selezionare Crea.

    

14. Selezionare Continua per avviare il processo di creazione/personalizzazione del flusso.

Ottenere la sincronizzazione dati dell'istituto di istruzione | Connettere l'origine dati | ID flusso

1. In una scheda separata passare al portale SDS all'indirizzo https://sds.microsoft.com.

2. Passare a Sincronizzazione | Configuraiton | Scheda Connetti dati. Passare alla sezione relativa alla configurazione di origine corrispondente corrispondente agli estratti di dati CSV da caricare.

   • Se è necessario creare una configurazione dei dati connect corrispondente per l'origine in SDS, seguire le istruzioni pertinenti in base al formato CSV in uso. Questa operazione deve essere eseguita per completare la configurazione del flusso di Power Automate.
     • Connettere i dati con SDS v2.1 CSV
     • Connettere i dati con SDS v1 CSV

3. Nella parte inferiore della configurazione dei dati connect corrispondente per l'ID di origine, rappresentato come GUID. Copiarlo in modo che possa essere usato in un secondo momento durante la configurazione del flusso di Power Automate.

   

Create e configurare un'applicazione

Importante

È necessario un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, è possibile configurare una sottoscrizione gratuita qui o controllare l'elenco corrente delle offerte di Azure.

In una scheda separata seguire questa procedura:

1. Registrare un'applicazione

2. Generare il segreto client dell'app

3. Concedere le autorizzazioni dell'applicazione all'applicazione

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

4. Concedere il consenso Amministrazione

   Nota

   Per altre informazioni dettagliate, vedere Configurare l'applicazione client .

Configurare Power Automate Flow

1. Indietro alla scheda Power Automate per continuare da dove eravamo rimasti.

2. Per iniziare a configurare il flusso, selezionare Continua.

3. Se lo si desidera, modificare la "frequenza di ricorrenza" per l'ora specifica del giorno e la frequenza con cui si vuole eseguire la sincronizzazione.

   

   Consiglio

   È consigliabile concedere molto tempo per il completamento dell'esportazione e della copia nella cartella CSV prima dell'esecuzione della frequenza di ricorrenza definita.

4. Immettere i valori ID client e Segreto client da Ottenere l'ID client e il segreto client.

   • Immettere l'ID client nel passaggio Clientid .
   • Immettere il segreto client nel passaggio Segreto client .

   

5. Immettere il tenandid.

6. Immettere il valore ID dai valori di Get the School Data Sync | Connettere l'origine dati | ID flusso

   

7. Immettere il percorso completo del file, creato durante la configurazione Create una cartella per i file CSV all'interno del prompt cartella del blocco "Elenca file nella cartella" all'interno della sezione "Carica file". Per verificare che la connessione sia corretta, è possibile selezionare l'immagine Cartella alla fine della casella e quindi la freccia. Deve contenere solo il testo "Nessun elemento".

   

8. Selezionare Salva e quindi testare il connettore selezionando Test in alto a destra nella pagina. Scegliere "Eseguirò l'azione trigger", quindi salvare e testare. Confermare infine selezionando "Esegui flusso" per testare il flusso.

9. Il flusso deve essere eseguito e ricevere tutti i segni di spunta verdi che informano che tutto ha avuto esito positivo. In caso di problemi, contattare il supporto SDS o il gestore della distribuzione.

   Nota

   In questo modo vengono caricati solo i file in SDS da includere nell'esecuzione successiva della sincronizzazione. Controllare SDS | Dashboard home o sincronizzazione | Eseguire per verificare che il processo di convalida e sincronizzazione sia stato completato correttamente.