Arquivo, CI, ERP, Funcionários, Professores, Burocratas, Administradores
2 627
edições
Mudanças
Ir para navegação
Ir para pesquisar
Sincronização das salas, professores e alunos no Google Classroom (ver código-fonte)
Edição das 09h54min de 25 de fevereiro de 2021
, 09h54min de 25 de fevereiro de 2021Primeira versão do manual.
'''ITCIxxx''' - Esta instrução descreve o funcionamento do processo responsável por fazer a manutenção das turmas no Google Classroom (uma turma para cada disciplina ofertada no semestre atual). Além da criação das turmas, ele também atualiza a lista de alunos e professores que encontram-se vinculados à essas turmas no Google Classroom.
== O processo de sincronização ==
O processo de sincronização dos usuários é executado por um script que encontra-se agendado no DC. O que o script faz é executar o aplicativo '''SincronizaClassroom.exe''' (que efetivamente faz a comunicação com a API do Google e faz as alterações necessárias) e, em seguida, envia o log da execução do processo por e-mail para ci@cfjl.com.br.
O script é executado automaticamente 3 vezes por dia: às 00:10, às 12:10 e às 18:10. Assim, uma alteração feita no sistema (nova matrícula, alteração em dados -- como nome do aluno/colaborador) levam, em condições normais, até 12 horas para serem aplicadas no Google Classroom e no sistema de e-mails.
A execução do SincronizaClassroom.exe leva entre 5 e 20 minutos na maior parte das vezes. O tempo de execução depende principalmente do número de alterações que precisam ser aplicadas no Classroom. Outro fator que aumenta o tempo de execução (causando essa grande "variação" na duração das execuções) é que, caso a chamada à alguma das APIs dê timeout durante a execução, o script para e inicia novamente o processo, desde o início.
=== Forçar a sincronização manualmente - Opção pela interface gráfica do servidor ===
Este passo mostra como fazer para forçar a sincronização logando-se no servidor e forçando a execução da sincronização.
# Abra o aplicativo '''Conexão de área de trabalho remota''' e conecte-se ao controlador de domínio do centro (máquina '''dc'''). Faça login com seu usuário e senha.
# Na máquina remota, abra o agendador de tarefas.
# No agendador de tarefas, clique em '''Biblioteca do agendador de tarefas''' (1), escolha a tarefa '''SincronizaClassroom''' (2) e clique em '''Executar''' (3).<p>[[File:9e35b82c-6756-4309-916f-142f618c6783.png]]</p>
# Aguarde os e-mails com os logs de sincronização, o que indica que a execução foi concluída.
=== Forçar a sincronização manualmente - Comando Powershell na máquina própria ===
Este passo mostra como fazer para forçar a sincronização sem precisar logar no servidor, através do PowerShell. Ele pode ser executado a partir de qualquer máquina que esteja no domínio, desde que o usuário logado no momento tenha permissão para acessar o servidor.
Para iniciar a sincronização, abra o PowerShell e digite o seguinte comando:
<syntaxhighlight lang="powershell">
Invoke-Command -ComputerName dc -ScriptBlock { Start-ScheduledTask -TaskName "SincronizaClassroom" }
</syntaxhighlight>
== Notas ==
* Além do envio por e-mail, o log é salvo dentro do diretório "logs", no mesmo diretório em que se encontra o aplicativo de sincronização.
[[Categoria:CI]]
== O processo de sincronização ==
O processo de sincronização dos usuários é executado por um script que encontra-se agendado no DC. O que o script faz é executar o aplicativo '''SincronizaClassroom.exe''' (que efetivamente faz a comunicação com a API do Google e faz as alterações necessárias) e, em seguida, envia o log da execução do processo por e-mail para ci@cfjl.com.br.
O script é executado automaticamente 3 vezes por dia: às 00:10, às 12:10 e às 18:10. Assim, uma alteração feita no sistema (nova matrícula, alteração em dados -- como nome do aluno/colaborador) levam, em condições normais, até 12 horas para serem aplicadas no Google Classroom e no sistema de e-mails.
A execução do SincronizaClassroom.exe leva entre 5 e 20 minutos na maior parte das vezes. O tempo de execução depende principalmente do número de alterações que precisam ser aplicadas no Classroom. Outro fator que aumenta o tempo de execução (causando essa grande "variação" na duração das execuções) é que, caso a chamada à alguma das APIs dê timeout durante a execução, o script para e inicia novamente o processo, desde o início.
=== Forçar a sincronização manualmente - Opção pela interface gráfica do servidor ===
Este passo mostra como fazer para forçar a sincronização logando-se no servidor e forçando a execução da sincronização.
# Abra o aplicativo '''Conexão de área de trabalho remota''' e conecte-se ao controlador de domínio do centro (máquina '''dc'''). Faça login com seu usuário e senha.
# Na máquina remota, abra o agendador de tarefas.
# No agendador de tarefas, clique em '''Biblioteca do agendador de tarefas''' (1), escolha a tarefa '''SincronizaClassroom''' (2) e clique em '''Executar''' (3).<p>[[File:9e35b82c-6756-4309-916f-142f618c6783.png]]</p>
# Aguarde os e-mails com os logs de sincronização, o que indica que a execução foi concluída.
=== Forçar a sincronização manualmente - Comando Powershell na máquina própria ===
Este passo mostra como fazer para forçar a sincronização sem precisar logar no servidor, através do PowerShell. Ele pode ser executado a partir de qualquer máquina que esteja no domínio, desde que o usuário logado no momento tenha permissão para acessar o servidor.
Para iniciar a sincronização, abra o PowerShell e digite o seguinte comando:
<syntaxhighlight lang="powershell">
Invoke-Command -ComputerName dc -ScriptBlock { Start-ScheduledTask -TaskName "SincronizaClassroom" }
</syntaxhighlight>
== Notas ==
* Além do envio por e-mail, o log é salvo dentro do diretório "logs", no mesmo diretório em que se encontra o aplicativo de sincronização.
[[Categoria:CI]]