Pré-requisitos

Não se aplica.

Descrição do processo

Processo customizado responsável por realizar a integração de Docentes entre HCM e TOTVS Educacional. Esta integração não será on-line pelo cadastro de Docente no HCM ou Protheus, sendo necessário acessar a funcionalidade de cadastro de Docente customizada disponibilizada no SGE para que ocorra a integração do cadastro de Professor

Detalhamento do processo

Para inclusão / alteração de Docente no SGE o usuário deverá acessar o menu “TOTVS Educacional | Customização | Cadastro de Docente”. O acesso a este menu será viabilizado via permissão por perfil (Serviços globais | Segurança | Perfis).

Ao acessar esta tela estará à disposição do usuário o campo de preenchimento obrigatório: “CPF”.

No momento que o usuário clicar em Avançar, a customização acionará o WebService do HCM para tentar recuperar os dados do Docente.

Caberá ao WebService do HCM retornar somente registros pertinentes de acordo com suas regras: (1) cargos do HCM podem ministrar aula (SESI: Professores, pedagogos e Profissional de Libras) – SENAI: Instrutores, Técnicos de Educação, Pedagogos, Especialistas em Serviço Tecnológico e CREF); (2) deverá ser um colaborador do quadro ATIVO. (Os cargos habilitados para dar aula deverão ser verificados na solução do HCM de Famílias / Subfamílias).

No momento que o WebService for acionado os seguintes cenários serão possíveis:

• • CPF consultado existe no HCM e não existe no SGE.
    
    

Os dados do Docente encontrados no HCM serão exibidos na tela (os dados não poderão ser alterados pelo usuário na tela customizada) e ao clicar em Concluir a customização utilizará estes dados para gravá-lo na base do SGE como Pessoa e Docente do Quadro (SPROFESSORCOMPL.QUADRO = 0). Informações complementares existentes em campos de anexos do Professor serão cadastradas pela funcionalidade nativa do SGE não cabendo à customização inserir estes dados por esta rotina.

O usuário será criado para este Docente de acordo com as parametrizações determinadas em TOTVS Educacional | Ambiente | TOTVS Educacional | Geração de usuários | Professor. Os campos “Ativo” e “Sempre válido” do cadastro do usuário deverão estar marcados.

• • CPF consultado existe no HCM e existe no SGE como Pessoa mas não é Docente

Os dados do Docente encontrados no HCM serão exibidos na tela (os dados não poderão ser alterados pelo usuário na tela customizada) e ao clicar em Concluir a customização utilizará estes dados para atualizar o registro da Pessoa no SGE e incluí-lo na base do SGE como Docente do Quadro (SPROFESSORCOMPL.QUADRO = 0). Informações complementares existentes em campos de anexos do Professor serão cadastradas pela funcionalidade nativa do SGE não cabendo à customização inserir estes dados por esta rotina.

Caso não exista usuário, o mesmo será criado para o Docente considerando as parametrizações determinadas em TOTVS Educacional | Ambiente | TOTVS Educacional | Geração de usuários | Professor. Os campos “Ativo” e “Sempre válido” do cadastro do usuário deverão estar marcados.

Se houver, o usuário será  tendo em vista que já existe o usuário na base do SGE, porém a customização deverá confirmar que os campos “Ativo” e “Sempre válido” estejam marcados.

• • CPF consultado existe no HCM e existe no SGE como Pessoa e Docente

Os dados do Docente encontrados no HCM serão exibidos na tela (os dados não poderão ser alterados pelo usuário na tela customizada) e ao clicar em Concluir a customização utilizará estes dados para atualizar o registro da Pessoa no SGE e atualizá-lo na base do SGE como Docente do Quadro (SPROFESSORCOMPL.QUADRO = 0). Informações complementares existentes em campos de anexos do Professor serão cadastradas pela funcionalidade nativa do SGE não cabendo à customização inserir estes dados por esta rotina.

Nesta situação não será criado usuário para o Docente tendo em vista que já existe o usuário na base do SGE, porém a customização deverá confirmar que os campos “Ativo” e “Sempre válido” estejam marcados.

• • CPF consultado não existe no HCM e não existe no SGE

Customização habilita pergunta: Docente é do Quadro ou Extraquadro?

Se o usuário informar que é do Quadro, a customização emitirá a mensagem: “Docente do quadro deve ser cadastrado inicialmente no RH para posterior cadastro no SGE” e a operação é interrompida.

Se o usuário informar que é Extraquadro, customização deve habilitar os campos para preenchimento manual. Ao clicar em Concluir o registro deverá ser gravado na base do SGE sendo que o campo complementar “Quadro” do Docente será registrado como SPROFESSORCOMPL.QUADRO = 1.

No momento da inclusão, o Docente Extraquadro será associado a Filial que está cadastrando, porém o mesmo ficará nesse momento com status de inativo na referida filial (Anexo Filiais do Professor do cadastro de Docente do SGE).

O usuário será criado para este Docente de acordo com as parametrizações determinadas em TOTVS Educacional | Ambiente | TOTVS Educacional | Geração de usuários | Professor. Os campos “Ativo” e “Sempre válido” do cadastro do usuário deverão estar desmarcados. Além disso o campo “Expiração da validade” deverá ser preenchido com a data da criação do usuário, pois se este campo não estiver preenchido, o sistema marca o campo “Sempre Válido”. A ativação do usuário se dará apenas no momento em que for associado o contrato do professor extraquadro com a filial através da integração com o módulo de cadastro de fornecedores PF do Protheus. O detalhamento desta rotina de associação de contratos ao Docente está definida no Req. 02. Este processo customizado deverá marcar o campo “Ativo” e preencher o campo “Expiração da validade”.

• • CPF consultado não existe no HCM e existe no SGE como Pessoa mas não é Docente.

Customização habilita pergunta: Docente é do Quadro ou Extraquadro?

Se o usuário informar que é do Quadro, customização deve emitir mensagem “Docente do quadro deve ser cadastrado inicialmente no RH para posterior cadastro no SGE” e a operação é interrompida.

Se o usuário informar que é Extraquadro, customização deve carregar as informações atuais e permitir a alteração dos mesmos manualmente. Ao clicar em Concluir a customização utilizará estes dados para atualizar o registro da Pessoa no SGE e incluí-lo na base do SGE como Docente Extraquadro (SPROFESSORCOMPL.QUADRO = 1). Informações complementares existentes em campos de anexos do Professor serão cadastradas pela funcionalidade nativa do SGE não cabendo à customização inserir estes dados por esta rotina.

Caso não exista usuário, o mesmo será criado para o Docente considerando as parametrizações determinadas em TOTVS Educacional | Ambiente | TOTVS Educacional | Geração de usuários | Professor. Os campos “Ativo” e “Sempre válido” do cadastro do usuário deverão estar desmarcados. Além disso o campo “Expiração da validade” deverá ser preenchido com a data da criação do usuário, pois se este campo não estiver preenchido, o sistema marca o campo “Sempre Válido”. A ativação do usuário se dará apenas no momento em que for associado o contrato do professor extraquadro com a filial através da integração com o módulo de cadastro de fornecedores PF do Protheus. O detalhamento desta rotina de associação de contratos ao Docente está definida no Req. 02. Este processo customizado deverá marcar o campo “Ativo” e preencher o campo “Expiração da validade”.

• • CPF consultado não existe no HCM e existe no SGE como Pessoa e Docente.

Customização habilita pergunta: Docente é do Quadro ou Extraquadro?

Se o usuário informar que é do Quadro, customização deve emitir mensagem “Docente do quadro deve ser cadastrado inicialmente no RH para posterior cadastro no SGE” e a operação é interrompida.

Se o usuário informar que é Extraquadro, customização deve carregar as informações atuais e permitir a alteração dos mesmos manualmente. Ao clicar em Concluir a customização utilizará estes dados para atualizar o registro da Pessoa no SGE e atualizá-lo na base do SGE como Docente Extraquadro (SPROFESSORCOMPL.QUADRO = 1). Informações complementares existentes em campos de anexos do Professor serão cadastradas pela funcionalidade nativa do SGE não cabendo à customização inserir estes dados por esta rotina.

Nesta situação não será criado usuário para o Docente tendo em vista que já existe o usuário na base do SGE, porém a customização deverá confirmar que os campos “Ativo” e “Sempre válido” estejam desmarcados. Além disso o campo “Expiração da validade” deverá ser preenchido com a data da criação do usuário, pois se este campo não estiver preenchido, o sistema marca o campo “Sempre Válido”. A ativação do usuário se dará apenas no momento em que for associado o contrato do professor extraquadro com a filial através da integração com o módulo de cadastro de fornecedores PF do Protheus. 

Pré-requisitos

Não se aplica.

Descrição do processo

Processo customizado responsável por consultar os contratos dos Docentes Extraquadro no Protheus e então ativar os usuários correspondentes de acordo com a extensão dos contratos.

Detalhamento do processo

No momento que houver a criação de um Docente Extraquadro no SGE à partir da rotina customizada de criação de Docente o usuário do Docente será criado com o campo “Ativo” desmarcado e o campo “Expiração da validade” igual à data da criação do registro. O processo customizado detalhado neste requisito será responsável por marcar o campo “Ativo” e aplicar uma nova data para o campo “Expiração da validade”.

O usuário deverá acessar o menu TOTVS Educacional | Currículo e Oferta | Professores | Anexo Filiais do Professor | Consultar contratos. Neste instante a customização acionará um WebService do Protheus passando o CPF do Docente como parâmetro que consultará o cadastro de fornecedores PF.

O WebService retornará  o “Contrato de RPCI” do docente extraquadro, assim como a “Data de início” e “Data de término” do referido contrato, “Código do RPCI”, “Código do Serviço Prestado” (Código do serviço de instrutor) e Filial. O Registro dessas informações ficará visível através do Anexo “Contrato de RCPI” (TOTVS Educacional | Currículo e Oferta | Professores | Anexo Filiais do Professor | Anexo) que conterá uma grid com todo o histórico de contratos do Professor por Filial. Será possível abrir cada um dos registros, porém os dados serão apenas para visualização.

A consulta ao WebService dos contratos vigentes do Professor Extraquadro deverá ser realizada manualmente por um usuário pelo processo customizado.

Baseado na informação registrada no campo “Data de término” a customização deverá preencher o campo “Expiração da validade” e marcar o campo “Ativo” do usuário vinculado ao Docente que está sendo consultado.

Caso o WebService retorne mais de um contrato para o Docente seja para a mesma Filial ou não, a customização deve verificar a maior “Data de término” para que esta data seja aplicada ao campo “Expiração de validade” do usuário.

Pré-requisitos

Não se aplica.

Descrição do processo

Validação na inclusão de uma nova Filial para um Docente.

Detalhamento do processo

Ao incluir ou alterar algum registro do anexo “Filiais do professor”, se o Docente for do Quadro (SPROFESSORCOMPL.QUADRO = 0) somente será permitido que o usuário adicione uma nova Filial ao Docente se a Filial do contexto do usuário logado seja igual à Filial registrada no campo complementar do Docente (SPROFESSORCOMPL.CODFILIAL).

Caso contrário será emitida a mensagem ao salvar: “Filial do Docente é diferente da Filial do contexto. Não será possível salvar o registro”.

Ao clicar no botão Excluir da Matriz Curricular a customização acionará um Web Service do Gestor de Serviços caso identifique que já exista um Serviço associado à esta Matriz. O retorno dado pelo Web Service permitirá ou não a conclusão da exclusão da Matriz no SGE. Caso o Gestor de Serviços não permita a exclusão do registro, será emitida a mensagem retornada pelo Web Service.

Pré-requisitos

Não se aplica.

Descrição do processo

JobServer customizado que consultará o HCM em busca de atualizações na situação dos Docentes.

Detalhamento do processo

A periodicidade de execução deste JobServer deverá ser configurada pela interface Atualização de Docentes disponibilizada em TOTVS Educacional | Customização.

No momento que o WebService do HCM for consultado, serão retornados todos os Docentes ativos no HCM na Unidade de negócio (Filial) enviada como parâmetro do WebService. Mediante os dados retornados a customização encontrará as seguintes possibilidades:

• • Docentes do Quadro que foram desligados

Caso o retorno do WebService não informe os dados de certo Docente que existe no SGE como do Quadro, a customização deverá desmarcar o campo “Ativo” do cadastro do usuário relacionado ao docente (GUSUARIO.STATUS). Além disso, deverá preencher o campo “Término de validade” com a data que o desligamento foi realizado (GUSUARIO.DATAEXPIRACAO) e desmarcar o campo Ativo relacionado à Filial do Professor.

• • Docentes do Quadro que permanecem ativos

Caso o retorno do WebService informe os dados de certo Docente que existe no SGE como do Quadro, a customização deverá mantê-lo nas condições atuais registradas no SGE.

• • Docentes Extraquadro se torna do Quadro

Caso o retorno do WebService informe os dados de certo Docente que estava registrado como Extraquadro no SGE, a customização deverá atualizar o campo complementar do Docente SPROFESSORCOMPL.QUADRO para igual a 1 e marcar os campos “Ativo” e “Sempre válido” do cadastro de Usuário. Além disso, a Filial retornada pelo HCM deverá ser registrada no Anexo Filiais do Professor como ativa.