Projeto: FS008981-Integração ThriveDX - Curso de Segurança Cibernética

Nome do Cliente: Confederação Nacional da Indústria - SESI

...

Expandir

title	Premissas

Expandir

title	Instalação

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:

Image RemovedImage Added

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:

Expandir

title	Cadastro Cadastros no SGE

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).

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:

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.

Expandir

title	Dados de Conexão

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.

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.

Informações
Os dados de conexão são disponibilizados ao SESI DN, pela ThriveDX.

Expandir

title	Cursos

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.

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.

Após inserir é necessário salvar o registro, para que ele seja visualizada no grid.

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 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

title	Anexo -Público Alvo

Neste anexo, será registrado o público alvo, para o curso Segurança Cibernética.

Aviso

icon	false

Para o Curso de Segurança Cibernética, 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.

Image RemovedImage Added

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 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’.

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.

Image Removed

O resultado do processo de exportação é apresentado na tela (quando executado manualmente), conforme exemplo abaixo:

Image Removed

Todas os registros exportados com sucesso ou que apresentaram erros, serão registrado no Menu : Monitor de log.

Expandir

title	Exportação

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

title	Importação

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 .

Image Removed

Ao acessar o menu, será exibida a tela para seleção da turma, que o usuário deseja importar o resultado.

Image Removed

O lookup apresentado, terá a lista de turmas que já foram exportadas à plataforma TDX.

Image Removed

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:

Image Removed

O resultado do processo de imprtação é apresentado na tela , conforme exemplo abaixo:

Image Removed

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

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

Image Removed

Matricula no Período letivo

Image Removed

Motivo da alteração registrado:

Image Removed

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

title	Monitor de Log e Reenvio

Monitor de log armazena informações de dados exportados e/ou importados da plataforma ThriveDX, com detalhes dos dados enviados, dados recebidos, status e datas de processamento. O Monitor de log também será a referência do usuário para identificar casos que tenham necessidade de reenvio de dados.

A interface estará disponível em: TOTVS Educacional | Sistema Industria | Integrações | ThriveDX | Monitor de Log

Image Removed

Na tela de log estarão disponíveis os seguintes campos:

Id Log: Identificador sequencial de Log.
Cód. Filial: Filial em que o processo foi executado.
Módulo: Código da Integração
Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
Valores Chave: Chave primária do registro integrado.
Status: Situação da Integração (Sucesso ou Erro).
Número de tentativas de Reenvio: Quantidade de vezes que um registro já foi reenviado.
Descrição do Módulo: Nome da integração
Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Envio de matricula do aluno na turma).
Data de Criação: Data de Criação do registro.
Criador por: Usuário responsável pela inclusão do registro.
Alterado Por: Usuário responsável pela alteração do registro.
Data da última alteração: Data da última alteração do registro.

Image Removed

Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:

Item Log: Identificador sequencial de log.
Log: Identificador sequencial de log.
Mensagem: Mensagem com o status da integração do item.
Status: Situação da integração do item selecionado.
Dados Enviados: Relação dos dados enviados para integração.
Dados Recebidos: Relação dos dados recebidos.
Data de Criação: Data de criação do registro.
Data da última Alteração: Data da última alteração do registro.

Image Removed

Expandir

title	Reenvio de Log

O Processo de reenvio de dados permite o envio dos registros que não foram exportados com sucesso. Esse processo poderá ser executado manualmente ou poderá ser agendado pelo menu de Processos de Monitor de Log, por registro (com status de erro ou pendente) e a integração efetuará a exportação dos registros novamente.

Image Removed

O usuário deverá selecionar um ou vários registros com o status de Erro para executar o processo.

Ao ser acionado o processo customizado de reenvio de dados, a customização tentará realizar novamente o envio dos dados. Caso seja processado corretamente, o status do registro passará para Sucesso.

Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio.

Informações

title	Premissas

Section

border	true

Column

width	30

Toggle Cloak
exclusive true
id 1
Criação do Canal (Turma)

Toggle Cloak
exclusive true
id 2
Criação do Departamento Regional (Coligada)

Toggle Cloak
exclusive true
id 3
Criação da Unidade Escolar (Filial)

Toggle Cloak
exclusive true
id 4
Criação do Curso (Grupo)

Toggle Cloak
exclusive true
id 5
Criação da Turma (Grupo)

Toggle Cloak
exclusive true
id 6
Criação do Estudante (Usuário)

Toggle Cloak
exclusive true
id 7
Criação do Docente (Usuário)

Toggle Cloak
exclusive true
id 8
Vínculo do Docente ao Canal

Toggle Cloak
exclusive true
id 9
Vínculo da Turma ao Canal

Toggle Cloak
exclusive true
id 10
Matrícula do Aluno na Turma (Grupo)

Column

width	70

Cloak

visible	true
id	1

Para a Criação do Canal (Turma) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Para a Criação do Canal é necessário que o Master Curso com ID "CYBER_SECURITY_2023-06-06-043214" esteja cadastrado corretamente na plataforma TDX - Este item é uma premissa, porém não é necessária nenhuma ação pelo regional, pois este é mantido pelo DN para todos os regionais

Elegível para exportar:

Turma deve pertencer a um Curso parametrizado;
O período da Turma deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence não pode estar Encerrado;
O período do Período Letivo que pertence deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

Importante: a exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	2

Para a Criação do Departamento Regional (Coligada) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Como este é o primeiro agrupador do Regional no TDX não há necessidade de nenhum cadastro/integração prévio

Elegível para exportar:

Parâmetro Sigla DR deve estar corretamente parametrizado nos Parâmetros Gerais do Sistema Indústria.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	3

Para a Criação da Unidade Escolar (Filial) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Criação do Departamento Regional (Coligada).

Elegível para exportar:

Alguma Turma da Filial deve pertencer a um Curso parametrizado;
O período de alguma Turma da Filial deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence alguma Turma da Filial, não pode estar Encerrado;
O período do Período Letivo que pertence alguma Turma da Filial, deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	4

Para a Criação do Curso (Grupo) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Criação do Departamento Regional (Coligada);
Criação da Unidade Escolar (Filial).

Elegível para exportar:

Alguma Turma do Curso na Filial deve pertencer a um Curso parametrizado;
O período de alguma Turma do Curso na Filial deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence alguma Turma do Curso na Filial, não pode estar Encerrado;
O período do Período Letivo que pertence alguma Turma do Curso na Filial, deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	5

Para a Criação da Turma (Grupo) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Criação do Departamento Regional (Coligada);
Criação da Unidade Escolar (Filial);
Criação do Curso (Grupo).

Elegível para exportar:

Turma deve pertencer a um Curso parametrizado;
O período da Turma deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence não pode estar Encerrado;
O período do Período Letivo que pertence deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	6

Para a Criação do Estudante (Usuário) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Como o Usuário no TDX não tem dependências, não há necessidade de nenhum cadastro/integração prévio.

Elegível para exportar:

Ter Matrícula em Turma que deve pertencer a um Curso parametrizado e com Situação de Matrícula correspondente a situação parametrizada como "Matriculado no Curso";
Ter Matrícula em Turma que atenda ao Público Alvo parametrizado, inclusive com a Situação de Matrícula parametrizada no Público Alvo;
O período da Turma Matriculada deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence a Matricula não pode estar Encerrado;
O período do Período Letivo que pertence a Matricula deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	7

Para a Criação do Docente (Usuário) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Como o Usuário no TDX não tem dependências, não há necessidade de nenhum cadastro/integração prévio.

Elegível para exportar:

Estar vinculado em Turma pela Turma/disciplina a qual deve pertencer a um Curso parametrizado;
O período da Turma vinculada deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence a Turma vinculada não pode estar Encerrado;
O período do Período Letivo que pertence a Turma vinculada deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	8

Para a Vínculo do Docente ao Canal é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Criação do Canal (Turma);
Criação do Docente (Usuário).

Elegível para exportar:

Ser o Professor:

Vinculado em Turma pela Turma/disciplina a qual deve pertencer a um Curso parametrizado;
O período da Turma vinculada deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence a Turma vinculada não pode estar Encerrado;
O período do Período Letivo que pertence a Turma vinculada deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	9

Para a Vínculo da Turma ao Canal é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Criação do Canal (Turma);
Criação da Turma (Grupo).

Elegível para exportar:

Sempre que a Turma e o Canal tiverem exportados com sucesso.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

Cloak

id	10

Para a Matrícula do Aluno na Turma (Grupo) é necessário atender:

Itens que devem ser integrados/existir no TDX primeiro..

Criação da Turma (Grupo);
Criação do Estudante (Usuário).

Elegível para exportar:

Ter Matrícula em Turma que deve pertencer a um Curso parametrizado e com Situação de Matrícula correspondente a situação parametrizada como "Matriculado no Curso";
Ter Matrícula em Turma que atenda ao Público Alvo parametrizado, inclusive com a Situação de Matrícula parametrizada no Público Alvo;
O período da Turma Matriculada deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Inicial e Final da Turma, considerando que a turma não tem fim determinado quando a data Final não está preenchida;
O Período Letivo que pertence a Matricula não pode estar Encerrado;
O período do Período Letivo que pertence a Matricula deve estar vigente - A data corrente deve compreender o período que cabe entre a Data Início e Fim do Período Letivo, considerando que o Período Letivo não tem fim determinado quando a data Fim não está preenchida.

Importante

A exportação não reenvia item - Itens com erro devem ser enviados pelo Reenvio de item no Log.

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.

Image Added

O resultado do processo de exportação é apresentado na tela (quando executado manualmente), conforme exemplo abaixo:

Image Added

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

title	Importação

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 .

Image Added

Ao acessar o menu, será exibida a tela para seleção da turma, que o usuário deseja importar o resultado.

Image Added

O lookup apresentado, terá a lista de turmas que já foram exportadas à plataforma TDX.

Image Added

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:

Image Added

O resultado do processo de imprtação é apresentado na tela , conforme exemplo abaixo:

Image Added

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

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

Image Added

Matricula no Período letivo

Image Added

Motivo da alteração registrado:

Image Added

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

title	Monitor de Log e Reenvio

Monitor de log armazena informações de dados exportados e/ou importados da plataforma ThriveDX, com detalhes dos dados enviados, dados recebidos, status e datas de processamento. O Monitor de log também será a referência do usuário para identificar casos que tenham necessidade de reenvio de dados.

A interface estará disponível em: TOTVS Educacional | Sistema Industria | Integrações | ThriveDX | Monitor de Log

Image Added

Na tela de log estarão disponíveis os seguintes campos:

Id Log: Identificador sequencial de Log.
Cód. Filial: Filial em que o processo foi executado.
Módulo: Código da Integração
Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
Valores Chave: Chave primária do registro integrado.
Status: Situação da Integração (Sucesso ou Erro).
Número de tentativas de Reenvio: Quantidade de vezes que um registro já foi reenviado.
Descrição do Módulo: Nome da integração
Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Envio de matricula do aluno na turma).
Data de Criação: Data de Criação do registro.
Criador por: Usuário responsável pela inclusão do registro.
Alterado Por: Usuário responsável pela alteração do registro.
Data da última alteração: Data da última alteração do registro.

Image Added

Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:

Item Log: Identificador sequencial de log.
Log: Identificador sequencial de log.
Mensagem: Mensagem com o status da integração do item.
Status: Situação da integração do item selecionado.
Dados Enviados: Relação dos dados enviados para integração.
Dados Recebidos: Relação dos dados recebidos.
Data de Criação: Data de criação do registro.
Data da última Alteração: Data da última alteração do registro.

Image Added

Expandir

title	Reenvio de Log

O Processo de reenvio de dados permite o envio dos registros que não foram exportados com sucesso. Esse processo poderá ser executado manualmente ou poderá ser agendado pelo menu de Processos de Monitor de Log, por registro (com status de erro ou pendente) e a integração efetuará a exportação dos registros novamente.

Image Added

O usuário deverá selecionar um ou vários registros com o status de Erro para executar o processo.

Ao ser acionado o processo customizado de reenvio de dados, a customização tentará realizar novamente o envio dos dados. Caso seja processado corretamente, o status do registro passará para Sucesso.

Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio.

Informações
Para informações sobre Alteração Status Logs com Erro e o processo de Exclusão de Logs no monitor, acesse o Manual Operacional da Customização - LIB DN

Expandir

title	Dados Técnicos

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
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
possibleRoles	Body \| enum	Não		INSTRUCTOR
customAttributes	Body \| object	Não		Não será enviado

HTML

<style>
.aui-tabs.vertical-tabs>.tabs-menu{
	width: 30% !important;
}
.plugin_pagetree_children_list{
    margin: 0 10px;
}
.plugin_pagetree_children_list li{
    border-radius: 2px;
    border: 0;
    font-size: 15px;
    line-height: 15px;
	padding: 5px
}
.sectionMacroWithBorder .columnMacro{
 	border-style: solid;
	border-color: rgba(202, 202, 202, 1);
	border-radius: 5px;
	padding: 10px;
 }

.plugin_pagetree_children_span:hover{
    font-weight: bolder;
}
.plugin_pagetree_children_list li:hover{
	background: rgb(240,240,240);
}
 
.cloakToggle strong {
	border-radius:8px;
	display:inline-block;
	cursor:pointer;
	color:#ffffff !important;
	font-size:16px;
	font-weight:bold;
	padding: 8px 32px;
	text-decoration:none;
	margin: 1px;
	width: 86%;
 	min-width: 50%; 
	max-width: 600px;  
    text-decoration: none;
}

.cloakToggle strong:active {
	position:relative;
	top:1px;
} 
.cloakToggle:has(.cloakDefaultClose) strong {
	position:relative;
	top:1px;
} 
 span.cloakToggle{
	display: none;
}
.cloakToggle strong {
  	background-color:#09B261; 
}  
.cloakToggle:has(.cloakDefaultClose) strong {
	background-color:#078F4D;
	text-decoration: none;
} 

.cloakToggle strong:hover {
	background-color:#078F4D;
	text-decoration: none;
}
</style>

Dados técnicos da exportação:

Expandir

title	FAQ

Expandir

title	Dados Técnicos

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

title	FAQ

Image Added

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
.

É 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.

No processo de importação, selecionei uma turma que não foi finalizada ou não possui certificados na Plataforma, e todos os alunos aparecem como 'reprovados'. O que devo fazer?
Resposta: Nesse cenário, a correção deve ser feita manualmente, obedecendo às orientações do SESI para a alteração individual de cada resultado. Isso é importante para evitar qualquer impacto em outras soluções, como o envio ao SCAE. A customização não tem ações nesse caso.

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 9

Nova versão Atual

Chave

Para importação:

Toggle Cloak
exclusive true
id 1
Criação do Canal (Turma)

Toggle Cloak
exclusive true
id 2
Criação do Departamento Regional (Coligada)

Toggle Cloak
exclusive true
id 3
Criação da Unidade Escolar (Filial)

Toggle Cloak
exclusive true
id 4
Criação do Curso (Grupo)

Toggle Cloak
exclusive true
id 5
Criação da Turma (Grupo)

Toggle Cloak
exclusive true
id 6
Criação do Estudante (Usuário)

Toggle Cloak
exclusive true
id 7
Criação do Docente (Usuário)

Toggle Cloak
exclusive true
id 8
Vínculo do Docente ao Canal

Toggle Cloak
exclusive true
id 9
Vínculo da Turma ao Canal

Toggle Cloak
exclusive true
id 10
Matrícula do Aluno na Turma (Grupo)

Aqui você encontra uma seção de perguntas frequentes:

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 9

Nova versão Atual

Chave

Para importação:

Toggle Cloakexclusivetrueid1Criação do Canal (Turma)

Toggle Cloakexclusivetrueid2Criação do Departamento Regional (Coligada)

Toggle Cloakexclusivetrueid3Criação da Unidade Escolar (Filial)

Toggle Cloakexclusivetrueid4Criação do Curso (Grupo)

Toggle Cloakexclusivetrueid5Criação da Turma (Grupo)

Toggle Cloakexclusivetrueid6Criação do Estudante (Usuário)

Toggle Cloakexclusivetrueid7Criação do Docente (Usuário)

Toggle Cloakexclusivetrueid8Vínculo do Docente ao Canal

Toggle Cloakexclusivetrueid9Vínculo da Turma ao Canal

Toggle Cloakexclusivetrueid10Matrícula do Aluno na Turma (Grupo)

Aqui você encontra uma seção de perguntas frequentes:

Toggle Cloak
exclusive true
id 1
Criação do Canal (Turma)

Toggle Cloak
exclusive true
id 2
Criação do Departamento Regional (Coligada)

Toggle Cloak
exclusive true
id 3
Criação da Unidade Escolar (Filial)

Toggle Cloak
exclusive true
id 4
Criação do Curso (Grupo)

Toggle Cloak
exclusive true
id 5
Criação da Turma (Grupo)

Toggle Cloak
exclusive true
id 6
Criação do Estudante (Usuário)

Toggle Cloak
exclusive true
id 7
Criação do Docente (Usuário)

Toggle Cloak
exclusive true
id 8
Vínculo do Docente ao Canal

Toggle Cloak
exclusive true
id 9
Vínculo da Turma ao Canal

Toggle Cloak
exclusive true
id 10
Matrícula do Aluno na Turma (Grupo)