Integração MestreGr

A integração MestreGr serve principalmente para integrar o cadastro de turmas, disciplinas, professores, coordenadores, provas e trabalhos com um sistema de terceiro. Todos os cadastros são feitos dentro do Mentorweb, e por padrão automaticamente é enviado essa integração todos os dias as 2hr da manhã, caso desejado também é possível configurar um outro horário, neste caso são enviados a integração duas vezes ao dia. Também é possível realizar a integração manualmente.
Para que essa integração automaticamente ocorra é necessário que no arquivo ICoruja.xml dentro do tomcat seja configurado a integração(executaIntegracaoMestreGR), com o parâmetro:

<Parameter name="executaIntegracaoMestreGR" value="S" override="false" />

. Caso o cliente tenha failover/balanceamento de carga, deve ser colocado esse parâmetro só no app01.

Configuração MestreGR

O menu de configurações MestreGR precisa primeiramente ser liberado o acesso para o usuário, esse processo é feito acessando o security, módulo graduação e localizar o menu “configuração mestreGR”, e habilitando. Para os clientes que não possuem acesso ao security deverá ser solicitado a liberação do menu ao suporte da Edusoft.

Após a liberação, acessar o menu para configurar a integração. Token: A chave token de acesso do software de terceiro. Esta chave de acesso é fornecida pelo terceiro, portanto ao realizar a configuração deve-se entrar em contato com o terceiro e solicitar esse token.
URL de integração: Informar a url do software de terceiro. Esta informação também é fornecida pelo terceiro.
Horário de integração: Neste campo pode-se informar o horário para realizar a integração de forma automática. Por padrão o sistema fará as 2hr da manhã. Caso desejar realizar a integração mais de uma vez pode-se informar um horário nesse campo. Caso não informado, ficará o padrão.
E-mail para log de erro: Informar nesse campo, o-mail para recebimento do log caso acorrer algum erro durante o processo de integração automático.

Aba Funções

Nesta aba é configurado o de - para, do coordenador e professor. Para saber o código que deve ser informado para cada um, deve-se entrar em contato com o responsável do sistema terceiro e solicitar qual o código para professor e coordenador dentro do sistema. E configurar com tais valores esses campos.

Código MestreGR: Código de identificação dentro do sistema, fornecido pelo terceiro.
Tipo de Usuário: Informar o usuário que possuí esse código(professor ou coordenador).

Integração Manual com MestreGR

O menu de Integração Manual com MestreGR precisa primeiramente ser liberado o acesso para o usuário, esse processo é feito acessando o security, módulo graduação e localizar o menu “Integração Manual com MestreGR”, e habilitando. Para os clientes que não possuem acesso ao security deverá ser solicitado a liberação do menu ao suporte da Edusoft.

Através desta rotina pode ser realizada a integração manual. O único campo obrigatório é o período letivo. Caso informado apenas esse campo, o sistema envia todos os cursos,turmas e disciplinas do período letivo informado.

Período letivo: Informar o período letivo que é realizada a integração manual(Obrigatório).
Curso: Informar o curso desejado para integração.
Turma: Informar a turma desejada para integração.
Disciplina: Informar a disciplina desejada para integração.

Após executar a integração de forma manual, é exibido um log de integração, tanto para execução com sucesso, como quase ocorra algum erro na integração. Abaixo exemplo da mensagem de log:

Fluxo da Integração

Abaixo colocamos um fluxograma do processo de integração. Para visualizar em tela cheia, basta clicar sobre a imagem e utilizar a opção de zoom, ou a tecla control + a bolinha do mouse.

Acessar MestreGR

O menu de Acessar MestreGR dá ao professor acesso ao sistema terceiro para digitação das notas dos trabalhos e provas dos alunos. Para tal acesso é necessário liberar o menu para o usuário, acessando o security, módulo central do professor. Localizando o menu: Acessar MestreGR e liberando acesso. Para os clientes que não possuem acesso ao security deverá ser solicitado a liberação do menu ao suporte da Edusoft.

Após fornecido acesso ao menu, o professor pode logar no portal do professor, e acessar o menu disponibilizado. Quando o professor acessar esse menu ele é redirecionado para o sistema que esta configurado para integração.

Atenção: o e-mail é uma das chaves para realizar o login. Quando não há e-mail no cadastro de pessoa do Mentorweb, o Mentorweb envia o seguinte e-mail como chave para realização do login:

código do aluno@sememail.com.br

Ou seja, quando no Mentorweb não há e-mail informado, no cadastro de pessoa no lado do Mestre/GR deverá possuir este padrão de e-mail acima, caso contrário, ocorrerá problema no login.

Endpoint de retorno das notas

O endpoint abaixo, é um endpoint de responsabilidade da edusoft, e o mesmo é o responsável pelo retorno das notas dos alunos. Após o professor digitar as notas das provas e trabalhos, o sistema do terceiro dispara uma integração de retorno das notas, a integração acessa este endpoint para retornar as notas e médias para o Mentorweb. Para saber mais sobre este serviço, acessar Endpoint MestreGR.

Serviço API > /ICoruja/rest/ICorujaACA/gravaNotaAvaliacaoParcialParaAlunos

Abaixo um exemplo do endpoint configurado no ambiente de qualidade da edusoft.

As notas retornadas do sistema de terceiro alimentarão o diário eletrônico. Enviando assim a nota para o diário da turma/aluno.