Automatizar o Carregamento de CSV do SDS com o Power Automate

Com o School Data Sync (SDS) e o Power Automate, pode sincronizar automaticamente os seus ficheiros SIS/SMS CSV exportados localmente e manter os seus dados do Microsoft 365 atualizados. Não existem mais alterações manuais ou carregamentos manuais de csv através da interface de utilizador do SDS para a sessão académica ativa. Fornece as seguintes vantagens:

• Facilita a gestão e monitorização de carregamentos de ficheiros csv locais.
• Mantém os utilizadores e as turmas do Microsoft 365 atualizados com base nas alterações do SIS/SMS em vez de alterações manuais por parte de educadores ou administradores.
• Faça a gestão de todo o processo de carregamento através da IU do Power Automate na cloud, o que é mais simples de utilizar do que os scripts do PowerShell.
• Toda a monitorização e gestão da solução ocorre no Microsoft 365.
• Suporte do SO do Servidor para uma melhor fiabilidade e gateway de dados no local para carregamento de ficheiros local.

Visão geral

Comece por instalar a configuração da localização do ficheiro CSV, que inclui a instalação de um Gateway de Dados no local, que deve demorar cerca de 5 minutos a ser configurado. Em seguida, irá Configurar o Power Automate Flow para utilizar o modelo School Data Sync que se liga ao gateway e utilizar o conector SDS para enviar ficheiros para o SDS para processamento.

Importante

Não se esqueça de criar uma Conta de Serviço Local no computador que tem o Gateway instalado. Pode encontrar as instruções aqui. Isto é necessário para a parte do Sistema de Ficheiros da criação do Flow.

Pré-requisitos

Veja Instalar um gateway de dados no local para obter uma lista completa dos requisitos e caso existam problemas de instalação.

Requisitos mínimos

• .NET Framework 4.6 (Lançamento do gateway de agosto de 2019 e anterior)
• .NET Framework 4.7.2 (Lançamento do gateway em setembro de 2019 e posterior)
• Uma versão de 64 bits do Windows 7 ou uma versão de 64 bits do Windows Server 2008 R (ou posterior)

Recomendado

• Uma CPU de 8 núcleos
• 8 GB de memória
• Uma versão de 64 bits do Windows Server 2012 R2 ou posterior
• Armazenamento de unidade de estado sólido (SSD) para spooling

Considerações importantes

• Os gateways não são suportados em instalações Server Core.
• O utilizador que está a instalar o gateway tem de ser o administrador do gateway.
• O gateway não pode ser instalado num controlador de domínio.
• Se estiver a planear utilizar a autenticação do Windows, certifique-se de que instala o gateway num computador que seja membro do mesmo ambiente do Active Directory que as origens de dados.
• Não deve instalar um gateway num computador, como um portátil que possa estar desligado do modo de suspensão ou desligado da Internet. O gateway não pode ser executado em nenhuma dessas circunstâncias.
• Se um gateway utilizar uma rede sem fios, o respetivo desempenho poderá sofrer.
• Pode instalar até dois gateways num único computador: um em execução no modo pessoal e o outro em execução no modo padrão. Não pode ter mais do que um gateway em execução no mesmo modo no mesmo computador.

Portas

O gateway cria uma ligação de saída para o Azure Service Bus. Comunica nas portas de saída: TCP 80, 443 (predefinição), 5671, 5672, 9350 a 9354. O gateway não requer portas de entrada. Se restringir as portas de saída no servidor, tem de garantir que estas portas de saída estão abertas.

Configurar a localização do ficheiro CSV

Verificar a região do ambiente do Power Apps

1. Inicie sessão no centro de administração do Power Platform com a sua conta de administrador global.

2. Navegue para Ambientes e verifique a região do ambiente que está a utilizar. A região é necessária para ajudar a garantir que instala o Gateway de Dados no local para utilizar a mesma região.

   

Transferir o Gateway de Dados no local

1. Transfira, guarde e execute o instalador do gateway num computador local.

2. Aceite o caminho de instalação predefinido ou especifique a localização no computador onde pretende instalar o gateway.

3. Reveja e aceite os termos de utilização e a declaração de privacidade e, em seguida, selecione Instalar.

   

4. Depois de o gateway ser instalado com êxito, forneça a sua conta de administrador global e selecione Iniciar sessão.

   

5. Selecione Registar um novo gateway neste computador> Seguinte, que regista a instalação do gateway no serviço cloud do gateway.

   

6. Conclua as informações pedidas para a instalação do gateway:

   • O nome que pretende para a instalação
   • A chave de recuperação que pretende criar, que tem de ter, pelo menos, oito carateres

   Importante

   Guarde e mantenha a chave de recuperação num local seguro. Precisa desta chave quando altera a localização do gateway ou quando migra, recupera ou assume um gateway existente.

7. Selecione Configurar.

   

8. No ecrã seguinte, não altere a região recomendada em Selecionar Região , a menos que saiba com certeza que precisa de alterar a região. Veja a região do ambiente do Power Apps em Verificar a região do seu ambiente do Power Apps para garantir que a Região selecionada é a mesma. Em seguida, selecione Concluído.

   

9. Depois de aparecer a página de confirmação, selecione Fechar. O instalador confirma que o gateway está agora online e pronto para ser utilizado.

   

   Observação

   Não precisa de selecionar na ligação que indica Criar um gateway no Azure. Para obter mais contexto, este artigo explica como funciona o gateway de dados.

Criar uma nova conta de serviço local

1. Aceda a Gestão de Computadores.

2. Faça duplo clique em Utilizadores e Grupos Locais.

3. Faça duplo clique em Utilizadores.

4. Clique com o botão direito do rato no painel central para Adicionar Novo Utilizador.

5. Introduza um Nome de Utilizador como SDSServiceAccount e registe o nome e a palavra-passe que escolher, pois tem de utilizá-lo novamente.

6. Desmarque a opção "O utilizador tem de alterar a palavra-passe no início de sessão seguinte".

7. Opcional: selecione a opção "A palavra-passe nunca expira".

8. Selecione Criar.

   

Criar uma pasta para os seus ficheiros CSV

Configure a localização da pasta onde a exportação dos seus ficheiros CSV tem de existir.

1. Abra o Explorador de Arquivos.
2. Navegue para a sua unidade C:\.
3. Selecione à direita e selecione Nova>Pasta.
4. Introduza Nome da Pasta. Neste exemplo, estamos a criar a pasta denominada "Ficheiros CSV".

Conceder à sua conta de serviço local permissões completas na pasta CSV

1. Selecione à direita na pasta que criou no Passo 3 e aceda a Propriedades.

2. Aceda ao separador Segurança .

3. Selecione Editar.

   

4. Selecione Adicionar.

5. Defina a opção Localização para o seu computador local. Esta é a primeira opção na lista quando seleciona Localizações.

6. Escreva o nome SDSServiceAccount (que criou no Passo 2, número 5) no campo de nomes de objetos (terceiro campo) e selecione Verificar Nomes.

7. Selecione OK.

   

8. Certifique-se de que é concedido controlo total à conta de serviço. Selecione Aplicar.

9. Selecione OK.

   

Copiar os ficheiros CSV para a pasta

1. Copie a extração mais recente dos seus ficheiros CSV para a pasta .

   

   Cuidado

   Certifique-se de que só tem ficheiros CSV nesta pasta.

Configurar o Fluxo do Power Automate

Certifique-se de que tem a aplicação Power Automate ativada

1. Inicie o browser.
2. Aceda a https://admin.microsoft.com e inicie sessão com a sua Conta de Administrador Global.
3. Selecione Utilizadores e, em seguida, Utilizadores Ativos.
4. Procure a sua conta de Administrador na caixa "Procurar utilizadores".
5. Selecione na sua conta.
6. Selecione Licença e aplicações.
7. Em Aplicações, certifique-se de que "Power Automate para Office 365" está ativado. Caso contrário, selecione Guardar.

Importante

O conector do Sistema de Ficheiros só pode ser configurado ou modificado a partir do processo de criação do modelo. Se alguma vez forem necessárias alterações ao Sistema de Ficheiros; incluindo a localização do Nome de Utilizador, Palavra-passe ou Pasta, terá de recriar totalmente o Fluxo.

Configurar o modelo

1. Inicie o browser.

2. Saiba mais em https://make.powerautomate.com.

3. Certifique-se de que iniciou sessão com a sua Conta de Administrador Global.

   Cuidado

   A sua conta deve ser a mesma que utilizou para configurar o gateway duirng da configuração para Configurar o ficheiro CSV loacaiton.

4. Navegue para Os Modelos, no lado esquerdo.

   

5. Na linha de comandos de pesquisa Modelos, procure School Data Sync. Selecione Automatizar Carregamento CSV do School Data Sync.

   Cuidado

   Seguem-se o SDS (Clássico), não selecionar ou utilizar com a nova experiência do SDS:

   Automatizar ficheiros CSV carregados para o perfil de sincronização do School Data Sync (Clássico)

   Enviar E-mail em Erros do School Data Sync (Clássico)

   School Data Sync (Clássico) via SFTP

   

   

6. Selecione Criar para o conector do Sistema de Ficheiros. É-lhe pedido para configurar um novo conector do Sistema de Ficheiros e utilizar o Gateway de Dados e as credenciais de início de sessão da Conta de Serviço Local para aceder à localização da pasta de ficheiros CSV.

   Cuidado

   Se já tiver um Sistema de Ficheiros disponível, terá de clicar nas reticências e optar por criar um novo conector.

   

7. Atribua o nome Ligação. Recomendado atribuir-lhe um nome relacionado com a função. No nosso exemplo, Automatização de Ficheiros CSV do SDS.

8. Na Pasta Raiz, introduza o caminho para a Pasta de Ficheiros CSV criada anteriormente. No nosso exemplo, "C:\CSV_Files".

9. Por predefinição, o Tipo de Autenticação deve ser definido como Windows.

10. Username (Nome de utilizador) é o Nome de utilizador completo da conta de serviço criada anteriormente, incluindo o nome do computador. No nosso exemplo, DESKTOP-SD85O7N\SDSServiceAccount.

11. Introduza a Palavra-passe dessa conta de serviço local.

12. Selecione o Gateway que foi configurado anteriormente.

    Dica

    Se não estiver a ver o Gatway que foi configurado anteriormente, siga os passos de resolução de problemas do gateway de dados no local em falta.

13. Selecione Criar.

    

14. Selecione Continuar para iniciar o processo de Criação/Personalização do Fluxo.

Obter o School Data Sync | Ligar origem de dados | ID do Fluxo

1. Num separador separado, aceda ao portal do SDS em https://sds.microsoft.com.

2. Navegue para Sincronizar | Configuraiton | Separador Ligar dados. Aceda à secção da configuração de origem correspondente que corresponde aos extratos de dados CSV que vão ser carregados.

   • Se precisar de criar uma configuração de Dados de ligação correspondente para a sua Origem no SDS, siga as instruções relevantes com base no formato CSV que está a utilizar. Isto tem de ser feito para concluir a configuração do fluxo do Power Automate.
     • Ligar dados com O SDS v2.1 CSV
     • Ligar dados com O SDS v1 CSV

3. Na parte inferior da configuração de dados de Ligação correspondente para o ID de localização de Origem, que é representado como um GUID. Copie-o para que possa ser utilizado mais tarde ao configurar o fluxo do Power Automate.

   

Criar e Configurar uma Aplicação

Importante

Precisa de uma conta do Azure com uma subscrição ativa. Se não tiver uma subscrição do Azure, pode configurar uma subscrição gratuita aqui ou verificar a lista atual de ofertas do Azure.

Num separador separado, siga os passos para:

1. Registar uma Aplicação

2. Gerar Segredo do Cliente da Aplicação

3. Conceder Permissões de Aplicação à Aplicação

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

4. Conceder Consentimento do Administrador

   Observação

   Aceda a Configurar a Aplicação Cliente para obter mais informações de avanço.

Configurar o Power Automate Flow

1. Volte ao separador Power Automate para continuar onde ficámos.

2. Para começar a configurar o fluxo, selecione Continuar.

3. Se pretender, altere a "Frequência de Periodicidade" para a hora específica do dia e a frequência com que pretende que a sincronização seja executada.

   

   Dica

   Recomenda-se que aguarde bastante tempo para que a exportação e a cópia sejam concluídas para a pasta CSV antes de a frequência de periodicidade definida ser executada.

4. Introduza os valores ID de Cliente e Segredo do Cliente em Obter ID de Cliente e Segredo do Cliente.

   • Introduza o ID de Cliente no passo Clientid .
   • Introduza o Segredo do Cliente no passo Segredo do Cliente .

   

5. Introduza o seu TenandId.

6. Introduza o valor de ID dos valores de Obter o School Data Sync | Ligar origem de dados | ID do Fluxo

   

7. Introduza o caminho completo do ficheiro, criado ao configurar Criar uma pasta para os seus ficheiros CSV na linha de comandos Pasta do bloco "Listar ficheiros na pasta" que se encontra na secção "Carregar Ficheiros". Para verificar se a ligação está correta, pode selecionar na imagem Pasta no final da caixa e, em seguida, na seta. Só deve ter o texto "Sem Itens" dentro do mesmo.

   

8. Selecione Guardar e, em seguida, teste o conector ao selecionar Testar no canto superior direito da página. Selecione "Vou executar a ação do acionador" e, em seguida, guarde e teste. Por fim, confirme ao selecionar "Executar Fluxo" para testar o fluxo.

9. O fluxo deve ser executado e receber todas as marcas de verificação verdes a indicar que tudo foi bem-sucedido. Se existirem problemas, contacte o Suporte do SDS ou o gestor de implementação.

   Observação

   O modelo do Power Automate só carrega os ficheiros para o SDS para serem incluídos na próxima execução de Sincronização. Normalmente, as execuções de sincronização são agendadas para serem executadas a cada 12 horas. Verifique o SDS | Dashboard base ou Sincronização | Execute para confirmar que o processo de validação e sincronização foi concluído de forma apropriada para a execução da sincronização subsequente após o carregamento automatizado.