...
| Expandir |
|---|
|
| Expandir |
|---|
| Para utilizar a integração é necessário realizar a instalação do Projeto, seguindo as orientações, descritas na página de Release Notes. |
| Expandir |
|---|
| title | Liberação na árvore de perfil |
|---|
| Para que os usuários tenham acesso a customização, é necessário a liberação nas permissões de perfil dos usuários. Para permitir o acesso siga este caminho abaixo: Serviços Globais | Segurança | Perfil | Selecione o Sistema: Educacional | Acesso a menus | Sistema Industria | Integrações | ThriveDX, conforme exemplo a abaixo:
Após a liberação no perfil do usuário, o mesmo poderá acessar o módulo: TOTVS Educacional | Sistema Industria | Integrações | ThriveDX A customização estará liberados para acesso, conforme imagem abaixo:
|
| Parâmetros da Integração | | A integração requer que algumas informações já tenham sido previamente inseridas no SGE, Sendo elas: - Cadastro do Curso de Segurança Cibernética (contexto Educação Continuada);
- Cadastro de alunos com CPF (alunos que não possuem CPF, serão tratados pelo SESI, diretamente na plataforma, sem ação da customização)
- Cadastro das turmas deste curso, bem como os vínculos:
- Turmas disciplinas
- Professores
- Alunos matriculados no Curso de Segurança Cibernética,
- Alunos do curso de Segurança Cibernética, deverão estar matriculados também na Educação Básica, no 8º ou 9º ano do Ensino Fundamental (regra definida pelo SESI)
|
O usuário deverá estar logado no contexto da Educação Continuada para realizar as parametrizações, disponíveis no Menu:  Image Removed
Ao acessar o Menu, será apresentado da tela e configurações com as abas: - Dados de conexão
- Cursos (com um anexo: Público alvo)
- Situação de matrícula
As orientações para configuração estão descritas nos tópicos abaixo |
Nesta tela o usuário deverá informar os dados para conexão com o Web Service do ThriveDX.
Todos os campos são de preenchimento obrigatório. O usuário deverá obrigatoriamente informar todos campos, para conseguir salvar o cadastro.
Image Removed
Endereço do WebService: Endereço de acesso ao webservice, disponibilizado pela ThriveDX.Clientkey: chave de identificação para recuperação de Token JWT. Secret: segredo de autenticação para recuperação de Token JWT.
| Expandir |
|---|
| title | Parâmetros da Integração |
|---|
|
O usuário deverá estar logado no contexto da Educação Continuada para realizar as parametrizações, disponíveis no Menu:
Image Added
Ao acessar o Menu, será apresentado da tela e configurações com as abas: - Dados de conexão
- Cursos (com um anexo: Público alvo)
- Situação de matrícula
As orientações para configuração estão descritas nos tópicos abaixo | Dados de Conexão |
| Expandir |
|---|
| title | CursosDados de Conexão |
|---|
|
Nesta tela será informado o curso que será exportado para a plataforma.o usuário deverá informar os dados para conexão com o Web Service do ThriveDX. Todos os campos são de preenchimento obrigatório. O usuário deverá obrigatoriamente informar todos campos, para conseguir salvar o cadastro. Image Added - Endereço do WebService: Endereço de acesso ao webservice, disponibilizado pela ThriveDX.
- Clientkey: chave de identificação para recuperação de Token JWT.
- Secret: segredo de autenticação para recuperação de Token JWT.
|
| Expandir |
|---|
|
Nesta tela será informado o curso que será exportado para a plataforma. Ao clicar em inserir, será apresentada a tela com o campo Curso. Este campo é um lookup, que trás a lista de todos os cursos cadastrados na base, considerando o contexto que o usuário está logado. Ao clicar em inserir, será apresentada a tela com o campo Curso. Este campo é um lookup, que trás a lista de todos os cursos cadastrados na base, considerando o contexto que o usuário está logado. | Aviso |
|---|
O SESI definiu que, apenas o Curso de Segurança Cibernética será integrado. Sendo assim o usuário deverá estar logado no contexto da Educação continuada e parametrizar apenas o curso citado. |
 Image Removed
Após inserir é necessário salvar o registro, para que ele seja visualizada no grid.  Image Removed
O cadastro não impedi a inclusão de outro curso. O usuário deve se atentar a NÃO incluir outro curso, para estar de acordo com a regra do SESI: | Aviso |
|---|
|
|---|
O SESI definiu que, apenas o Curso de Segurança Cibernética será integrado. Sendo assim o usuário deverá estar logado no contexto da Educação continuada e parametrizar apenas o curso citado. |
|
| Expandir |
|---|
|
Image Added Após inserir é necessário salvar o registro, para que ele seja visualizada no grid. Image Added | Aviso |
|---|
O cadastro não impedi a inclusão de outro curso. O usuário deve se atentar a NÃO incluir outro curso, para estar de acordo com a regra do SESI: O SESI definiu que, apenas |
Neste anexo, será registrado o público alvo, para o curso Segurança Cibernética. | Aviso |
|---|
| Para o Curso de Segurança Cibernética será integrado. Sendo assim o usuário deverá estar logado no contexto da Educação continuada e parametrizar apenas o curso citado. |
|
| Expandir |
|---|
|
Neste anexo, será registrado o público alvo, para o curso Segurança Cibernética. | Aviso |
|---|
| Para o Curso de Segurança Cibernética, o SESI definiu que o público alvo, , o SESI definiu que o público alvo, serão alunos do 8º e 9º ano do Ensino Fundamental. Não haverá regra customizada para validar essa definição, ficará sob a responsabilidade do usuário definir neste anexo apenas matrizes correspondentes ao 8° e 9° ano. |
O anexo está disponível na aba Cursos, da parametrização. 
Para incluir um público alvo, é necessário informar a Matriz aplicada, desejada. Conforme imagens abaixo:
Na tela de seleção, o cadastro deverá ser seguido considerando as relações: - Curso: Lookup com os cursos cadastrados na Coligada.
- Série: Lookup com as séries cadastradas para o curso selecionado.
- Matriz Curricular: Lookup com todas as matrizes curriculares cadastradas para o curso e série selecionados, desde que a Matriz esteja ativa ou atual.
- Turno: Lookup comos turnos associados a matriz Curricular selecionada.
- Situação de matrícula: Lookup com todas as situações de matrícula do nível de ensino do curso selecionado.Informar neste campo qual situação de matrícula será considerada para os alunos do público alvo.
O usuário poderá selecionar uma Matriz Aplicada por vez, mas poderão ser associadas N Matrizes neste cadastro. Após salvo o registro será apresentado no grid:
| Informações |
|---|
- Para a exportação, será validado se o aluno matriculado no curso (8º ou 9º ano do Ensino Fundamental), estiver em um período vigente. Considerando período vigente a matrícula cuja a data início e fim do período letivo e turma compreenda a data corrente (data fim vazia considera ainda vigente).
|
| Aviso |
|---|
O cadastro do público alvo não impede a inclusão de uma matriz aplicada que NÃO seja do 8º ou 9º ano. O usuário deve estar atento a essa etapa, para estar de acordo com a regra do SESI. |
|
| Expandir |
|---|
| title | Situação de Matrícula |
|---|
|
Nesta aba, o usuário deverá informar as Situações de Matrícula que serão considerados durante a Exportação das Entidades para a plataforma TDX bem como para a Importação de resultados da plataforma para o SGE. 
Para exportação: O usuário deverá definir quais são as situações de matricula, que serão consideradas durante a Exportação de matrículas para a plataforma TDX. 
- Cód. Status: Neste campo o usuário deve informar a situação de matricula que ele deseja considerar na exportação.
- Status indica: Neste campo será selecionado o Status indica = ‘Matriculado no Curso’. Desta forma ele garante que a situação de matricula informada no campo anterior será considerada na exportação.
- Cód. Motivo alteração: Para este caso o campo ficará desabilitado.
O usuário poderá selecionar um status de matrícula por vez, mas poderão ser cadastrados N status de matrícula neste cadastro. Para importação:O usuário deverá definir quais são as situações de matricula, que serão consideradas durante a Importação de Resultados da plataforma TDX para o SGE.  
- Cód. Status: Neste campo o usuário deve informar a situação de matricula que ele deseja gravar no SGE, após a importação dos resultados.
- Status indica: Neste campo será selecionado o Status indica = ‘Considera Conclusão de Curso’ ou ‘Considera NÃO Conclusão de Curso’.
- Cód. Motivo alteração: Neste campo o usuário seleciona o motivo da alteração de acordo com o que informou no campo Status indica.
Todos os registros, serão apresentados no grid, conforme imagem abaixo: 
| Informações |
|---|
- Campo motivo alteração: Neste campo o usuário seleciona o motivo da alteração de acordo com o que informou no campo Status indica. Quando a importação consultar o resultado do aluno na plataforma TDX, os resultados e situação de matricula nas disciplias serão disciplinas serão alterados, considerando os status indicados acima. Nativamente, sempre que um desses campos são alterados na matricula do aluno é necessário informar o motivo da alteração.
- O usuário poderá selecionar apenas UMA situação de matricula que indique : ‘Considera Conclusão de Curso’ ou ‘Considera NÃO Conclusão de Curso’.
|
|
| Expandir |
|---|
|
Após finalizadas todas as parametrizações e cadastros, o usuário pode executar o processo de Exportação de Dados. Através desse processo as Integração com a Plataforma TDX será iniciada. O processo pode ser agendado ou executado através do Menu: TOTVS Educacional | Sistema Industria | Integrações | ThriveDX | Exportação de Dados.
O resultado do processo de exportação é apresentado na tela (quando executado manualmente), conforme exemplo abaixo: 
Todas os registros exportados com sucesso ou que apresentaram erros, serão registrado no Menu : Monitor de log.
| Aviso |
|---|
- Não está previsto atualizações para essa Integração: Após a exportação dos registros, caso haja alteração/atualização no SGE, ainda que o processo de exportação seja executado novamente, a plataforma não receberá atualizações.
- A exportação segue o que foi determinado nos parâmetros, esteja certo das configurações.
- Alunos sem CPF NÃO serão exportados. Esses casos, devem ser tratados pelo SESI diretamente na plataforma TDX (seguindo as orientações do SESI DN).
|
|
| Expandir |
|---|
|
| Expandir |
|---|
|
Quando o curso é finalizado na Plataforma TDX e os alunos já possuem certificação, o usuário deverá realizar a importação dos resultados da plataforma para o SGE. |
O processo de Importação de resultados, retorna para o SGE a informação de conclusão ou não conclusão do aluno no Curso de Segurança Cibernética. Este processo deverá ser executado manualmente através do menu: TOTVS Educacional | Sistema Industria | Integrações | ThriveDX | Importação de Resultados .
Ao acessar o menu, será exibida a tela para seleção da turma, que o usuário deseja importar o resultado. 
O lookup apresentado, terá a lista de turmas que já foram exportadas à plataforma TDX. 
Ao selecionar a turma, o usuário garante que a mesma, já está finalizada e certificada na plataforma TDX. Ao executar o processo será apresentada um mensagem de alerta ao usuário: 
O resultado do processo de imprtação é apresentado na tela , conforme exemplo abaixo: 
Todas os registros importados com sucesso ou que apresentaram erros, serão registrado no Menu : Monitor de log. | Aviso |
|---|
- Não está previsto atualizações para essa Integração: Caso o usuário selecione uma turma que não tenha certificado na plataforma, a integração seguirá o fluxo de registro de resultados, considerado todos alunos da turma como "não concluintes''. Ainda que o processo seja executado novamente, a integração não fará atualização dos registros no SGE.
- O processo de importação não será agendado.
|
|
| Expandir |
|---|
| Expandir |
|---|
| title | Resultados gravados no SGE |
|---|
|
Após o processo de importação ser executado, a customização fará as seguintes alterações no SGE, considerando as regras: Certificados identificados na plataforma TDX (Alunos concluintes): - O resultado nas disciplinas, será alterado para a situação de matrícula definida como ‘Considera Conclusão de Curso’ informado pelo usuário nos parâmetros.
- O resultado na matrícula do período letivo também será alterado para a situação de matrícula definida como ‘Considera Conclusão de Curso’ informado pelo usuário nos parâmetros.
- Será chamado o serviço nativo de alteração de situação de matrícula, que atualizará a situação de matrícula das disciplinas, para a situação de matrícula definida como ‘Considera Conclusão de Curso’ com o motivo de alteração também informado no parâmetro.
Certificados NÃO identificados na plataforma TDX (Alunos NÃO concluintes): - O resultado nas disciplinas, será alterado para a situação de matrícula definida como ‘Considera NÃO Conclusão de Curso', informado pelo usuário nos parâmetros.
- O resultado na matrícula do período letivo também será alterado para a situação de matrícula definida como ‘Considera NÃO Conclusão de Curso’ informado pelo usuário nos parâmetros
- Será chamado o serviço nativo de alteração de situação de matrícula, que atualizará a situação de matrícula das disciplinas, para a situação de matrícula definida como ‘Considera não Conclusão de Curso’ com o motivo de alteração também informado no parâmetro.
Exemplo de um aluno concluinte: Matricula na disciplina 
Matricula no Período letivo 
Motivo da alteração registrado: 
| Aviso |
|---|
Caso o usuário selecione uma turma que não tenha certificado na plataforma, a integração seguirá o fluxo de registro de resultados, considerado todos alunos da turma como "não concluintes''. Ainda que o processo seja executado novamente, a integração não fará atualização dos registros no SGE. Não está previsto atualizações para essa Integração. |
|
...
| Expandir |
|---|
|
Dados técnicos da exportação: Campo ThriveDX | Tipo | Obrig | Descrição | Integração - SGE | Dados do DR | identifier | Body | string | Sim | Id único do modelo de entidade - Definido por um provedor externo | {SiglaDR}{NúmerosCNPJColigada} | name | Body | string | Sim | Nome do Grupo/Curso | {SiglaDR} - {NomeFantasia} | parentIdentifier | Body | string | Não | Id do grupo pai, definido por um provedor externo. O Grupo que seja filho é obrigatório o preenchimento | Não será filho de nenhum outro Grupo. | subAccountName | Body | string | Não | Nome da Sub-conta | Não será enviado | type | Body | string | Sim | Tipo do Grupo de acordo com a hierarquia | Fixo: “Departamento Regional” | Dados do Escola | identifier | Body | string | Sim | Id único do modelo de entidade - Definido por um provedor externo | {SiglaDR}{CodColigada}{CodFilial} EX.: PR330001 | name | Body | string | Sim | Nome do Grupo/Curso | {NomeFantasia} | parentIdentifier | Body | string | Não | Id do grupo pai, definido por um provedor externo. O Grupo que seja filho é obrigatório o preenchimento | {SiglaDR}{NúmerosCNPJColigada} | subAccountName | Body | string | Não | Nome da Sub-conta | Não será enviado | type | Body | string | Sim | Tipo do Grupo de acordo com a hierarquia | Fixo: “Unidade Escolar” |
Campo ThriveDX | Tipo | Obrig | Descrição | Integração - SGE | Dados do Curso | identifier | Body | string | Sim | Id único do modelo de entidade - Definido por um provedor externo | {SiglaDR}{CodColigada}{CodFilial}{CodCurso} EX.: CT3001ECOSEGCY | name | Body | string | Sim | Nome do Grupo/Curso | {NomeCurso} | parentIdentifier | Body | string | Não | Id do grupo pai, definido por um provedor externo. O Grupo que seja filho é obrigatório o preenchimento | {SiglaDR}{CodColigada}{CodFilial} | subAccountName | Body | string | Não | Nome da Sub-conta | Não será enviado | type | Body | string | Sim | Tipo do Grupo de acordo com a hierarquia | Fixo: “Curso” | Dados da Turma | identifier | Body | string | Sim | Id único do modelo de entidade - Definido por um provedor externo | {SiglaDR}{CodColigada}{CodFilial}{IdPerLet}{CodTurma} | name | Body | string | Sim | Nome do Grupo/Curso | {CodTurma} - {NomeReduzidoTurma} | parentIdentifier | Body | string | Não | Id do grupo pai, definido por um provedor externo. O Grupo que seja filho é obrigatório o preenchimento | {SiglaDR}{CodColigada}{CodFilial}{CodCurso} | subAccountName | Body | string | Não | Nome da Sub-conta | Não será enviado | type | Body | string | Sim | Tipo do Grupo de acordo com a hierarquia | Fixo: “Turma” |
Campo ThriveDX | Tipo | Obrig | Descrição | Integração - SGE | Dados do Aluno | identifier | Body | string | Sim | Identificador único | {CPFdoAluno} | isActive | Body | bool | Não | Status do Usuário. Padrão: true | Não será enviado. Não iremos controlar a inativação de usuários neste escopo. | username | Body | string | Não | Usuário | {CPFdoAluno} | email | Body | string | Não | E-mail de usuário | E-mail principal do cadastro de pessoa | firstName | Body | string | Não | Primeiro nome | Primeiro nome do cadastro de pessoa. Se preenchido o Nome Social ele substitui. | lastName | Body | string | Não | Ultimo nome | Sobrenome do cadastro de pessoa | password | Body | string | Não | Senha do usuário | Não será enviado | phone | Body | string | Não | Número de telefone | Telefone Principal do cadastro da pessoa | possibleRoles | Body | enum | Não |
| Learner | customAttributes | Body | object | Não |
| Não será enviado |
Dados do Professor | identifier | Body | string | Sim | Identificador único | {CPFdoProfessor} | isActive | Body | bool | Não | Status do Usuário. Padrão: true | Não será enviado. Não iremos controlar a inativação de usuários neste escopo. | username | Body | string | Não | Usuário | {CPFdoProfessor} | email | Body | string | Não | E-mail de usuário | E-mail principal do cadastro de pessoa | firstName | Body | string | Não | Primeiro nome | Primeiro nome do cadastro de pessoa. Se preenchido o Nome Social ele substitui. | lastName | Body | string | Não | Ultimo nome | Sobrenome do cadastro de pessoa | password | Body | string | Não | Senha do usuário | Não será enviado | phone | Body | string | Não | Número de telefone | Telefone Principal do cadastro da pessoa | possibleRoles | Body | enum | Não |
| INSTRUCTOR | customAttributes | Body | object | Não |
| Não será enviado |
|
| Expandir |
|---|
|
Aqui você encontra uma seção de perguntas frequentes: Alunos sem CPF serão integrados? Resposta: Não. Em situações envolvendo alunos sem CPF, esses casos serão tratados separadamente pelo SESI em comunicação direta com a TDX.
É necessário que o Curso seja cadastrado com um código especifico? Resposta: Para integração não será necessário. O Curso deverá ser cadastrado, seguindo as regras já definidas pelo SESI.
|
