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)cardCriação do Estudante (Usuário)cardCriação do Docente (Usuário)
Card
defaulttrue

Criação do Canal (Turma)

Para a

Toggle Cloak
exclusivetrue
id2
Criação do

Canal

Departamento Regional (

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)

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:

title
Expandir
title
Cloak
visibletrue
id1

Para a Criação do Canal (Turma) é 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

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

    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 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;
      • 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
      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
      • Inicial e Final da Turma, considerando que
      o Período Letivo
      • a turma não tem fim determinado quando a data
      Fim
      • Final não está preenchida
      .
      Importante: a exportação não
      • ;
      • 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
      label
      id4

      Para a Criação

      da Turma

      do Curso (Grupo) é necessário atender:

      expandtitle

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

      Cloak
      label
      id5

      Para a Criação

      do Estudante

      da Turma (

      Usuáriotitle
      title

      Grupo) é necessário atender:

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

        • Criação do Departamento Regional (Coligada);
        • Criação da Unidade Escolar (Filial);
        • Criação do Curso (Grupo).
        Expandir
        Matrícula em
        Elegível para exportar:
          Ter
          • 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
          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

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

          Cloak
          label
          id6

          Para a Criação do

          Docente

          Estudante (Usuário)

           é

          é necessário atender:

          titletitle
          Expandir

          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.

          Expandir

          Elegível para exportar:

            Estar vinculado
            • Ter Matrícula em Turma
            pela Turma/disciplina a qual
            • que 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
            • 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
            Turma vinculada 
            • Matricula não pode estar Encerrado;
            • O período do Período Letivo que pertence
            a Turma vinculada deve
            • 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

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