Páginas filhas
  • Manual Operacional da Customização- Integração ThriveDX - Curso de Segurança Cibernética

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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


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

...

Expandir
titleParâ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
titleDados 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
titleCursos

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
titleAnexo -Público Alvo

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

Aviso
iconfalse

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
titleSituaçã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 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’.

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.

Expandir
titleExportação
Informações
titlePremissas
Section
bordertrue
Column
width30

Toggle Cloak
exclusivetrue
id1

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. 

Deck of Cards
idFuncionalidadesExportacao
tabLocationleft
effectTypefade
labelcardCriação do Curso (Grupo)cardCriação da Turma (Grupo)
Card
defaulttrue

Criação do Canal (Turma)

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

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

Expandir
titleElegí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.

Card
labelCriação do Departamento Regional (Coligada)

Toggle Cloak
exclusivetrue
id2
Criação do Departamento Regional (Coligada)

Toggle Cloak
exclusivetrue
id3
Criação da Unidade Escolar (Filial)

Toggle Cloak
exclusivetrue
id4
Criação do Curso (Grupo)

Toggle Cloak
exclusivetrue
id5
Criação da Turma (Grupo)

Toggle Cloak
exclusivetrue
id6
Criação do Estudante (Usuário)

Toggle Cloak
exclusivetrue
id7
Criação do Docente (Usuário)

Toggle Cloak
exclusivetrue
id8
Vínculo do Docente ao Canal

Toggle Cloak
exclusivetrue
id9
Vínculo da Turma ao Canal

Toggle Cloak
exclusivetrue
id10
Matrícula do Aluno na Turma (Grupo)

Column
width70

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

Expandir
title
Cloak
visibletrue
id1

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

title
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

Expandir

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:
    • 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.

    Card
    labelCriação da Unidade Escolar (Filial)
    • 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

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

    Expandir
    titleItens que devem ser integrados/existir no TDX primeiro..
    • Criação do Departamento Regional (Coligada).
    Expandir
    titleElegí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
    • Início e Fim do Período Letivo, considerando que
    a turma
    • o Período Letivo não tem fim determinado quando a data
    Final
    • Fim 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

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

    Cloak
    label
    id2

    Para a Criação do

    Curso

    Departamento Regional (

    Grupo

    Coligada)

     é

    é necessário atender:

    title
    Expandir
    Expandir
    title

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

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

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

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

      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
      do Curso na
      • da Filial, não pode estar Encerrado;
      • O período do Período Letivo que pertence alguma Turma
      do Curso na
      • 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

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

      Cloak
      label
      id4

      Para a Criação

      da Turma

      do Curso (Grupo) é necessário atender:

      expand

      titletitle
      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)
      • .
      Expandir
      Elegível para exportar:
      • Alguma Turma do Curso na Filial deve pertencer a um Curso parametrizado;
      • O período
      da Turma
      • 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

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

      O processo pode ser agendado ou executado através do Menu: TOTVS Educacional Sistema Industria  |  Integrações  |  ThriveDX | Exportação de Dados.

      Image Removed

      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.

      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
      titleImportação
      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
      titleResultados 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
      titleMonitor 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

      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

      Image Removed

      Expandir
      titleReenvio 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.

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

      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.

      Cloak
      id5

      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
      id6

      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
      id7

      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
      id8

      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
      id9

      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
      id10

      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

      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
      titleImportaçã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
      titleResultados 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
      titleMonitor 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

      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

      Image Added


      Expandir
      titleReenvio 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.

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

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

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

      Expandir
      titleFAQ

      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.


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