O objetivo desta integração é permitir realizar a integração do fluxo de aprovação de processos do módulo Gestão de Quadro de Pessoal (HCM) do produto TOTVS linha Datasul, com o TOTVS ECM. Essa integração substitui a integração do GQP com Webdesk que foi descontinuado em 2011. A integração está disponível a partir do TOTVS 11.2.1 em diante.
Cadastro de Pessoa Física (FP1440):
É necessário que a pessoa física relacionada ao funcionário, que fará parte do processo aprovação de solicitações, tenha seu e-mail atualizado. Para mais detalhes, consultar a função Manutenção de Pessoa Física (FP1440) do Manual de Referência do produto TOTVS.
Cadastro de Funcionário (FP1500):
É necessário que as pessoas que farão parte do processo de aprovação de solicitações sejam funcionários. Para mais detalhes, consultar a função Manutenção de Funcionários (FP1500) do Manual de Referência do produto TOTVS.
Estrutura Reporte (GD0008):
A empresa deverá possuir uma Estrutura Reporte definida para que seja possível criar o fluxo de aprovação de cada tipo de movimentação. Para mais detalhes, consultar função Manutenção Estrutura Reporte do Manual de Referência do produto TOTVS.
Ambiente ECM instalado ou convertido:
Para que essa integração aconteça, é necessário a instalação do TOTVS ECM ou ainda para os clientes que possuem Webdesk 2.04, esse deverá ser convertido. Para mais detalhes, consultar Guia de Instalação ou Conversão do ECM localizado no diretório de documentação do ECM.
Serviço Progress (appserver) configurado para comunicação do ECM com o HCM:
É necessária a configuração de appserver Progress para que o serviço seja configurado no ECM. Mais detalhes consultar guia de Integração ByYou ECM, localizado no diretório de documentações do ECM.
Geração de Arquivo Proxy Progress:
O primeiro passo para que seja possível executar rotinas em Progress 4GL é criar a biblioteca cliente, o que é feito com o uso do aplicativo ProxyGen. Essa biblioteca cliente será utilizada para configuração do serviço Progress no ECM. Para gerar o proxy, é necessário que a máquina que está sendo gerado tenha a instalação do Progress. Executar o seguinte passo a passo para a geração deste arquivo:
Ao selecionar o botão “Generate”, será demonstrada a seguinte tela. No campo Appserver, deverá ser informado o nome do appserver que foi configurado para a integração. O campo Output dir é o local onde será gerado o proxy, poderá ser mantido o diretório que é demonstrado abaixo:
A pasta “Java” deverá permanecer conforme demonstrado na tela abaixo:
Ao Pressionar o botão OK, será realizada a geração do proxy. Ao finalizar a geração, será demonstrada a seguinte mensagem:
Para maiores detalhes da geração do proxy, consulte o “Guia de Integração ECM” localizado no diretório de documentações do ECM, item “Expondo código 4GL com ProxyGen”.
Parâmetros de Gestão de Quadro de Pessoal (GQ0000):
O módulo de Gestão de Quadro de Pessoal necessita ser parametrizado para que seja possível utilizar a integração com ECM. O campo Workflow deverá estar obrigatoriamente assinalado. Para mais detalhes deste programa, consulte a função Parâmetros de Gestão de Quadro de Pessoal.
Parâmetros de Workflow (WF0000):
O módulo Workflow necessita ser parametrizado. O campo Estrutura Reporte deverá ser informado com o código da Estrutura Reporte referente aos níveis de aprovação do módulo Gestão de Quadro de Pessoal. É necessário selecionar o campo Tipo de Integração como ECM e informar os campos empresa, usuário, senha, URL do WebService, tipo de senha padrão e se o campo tipo de senha padrão estiver selecionado como informado, informar a senha padrão. Para mais detalhes deste programa, consulte a função Parâmetros de Workflow do Manual de Referência.
Responsáveis por Área (WF0010):
A empresa poderá cadastrar áreas responsáveis para participar do processo de aprovação ou notificação das solicitações. Para mais detalhes, consulte a função Responsáveis por Área (WF0010) no Manual de Referência do produto TOTVS.
Cadastro de Usuários (sec/sec000aa.w):
Os funcionários que participarão de inicialização, aprovação e notificação de solicitação deverão possuir usuários cadastrados com complemento RH, sendo que o tipo de acesso para Visão Descentralizada (campo tipo de acesso diferente de Estabelecimento).
Movimentações Disponíveis (GQ0003):
Para que a solicitação seja enviada para os aprovadores da solicitação, é necessário o cadastro de movimentações e níveis de aprovação de cada solicitação. Para mais detalhes, consulte a função Movimentações Disponíveis (GQ0003) no Manual de Referência do produto TOTVS.
Sincronização de Usuários (WF0030):
Para que as solicitações sejam integradas com o ECM, é necessário que os usuários do processo de aprovação de solicitações do HCM sejam iguais ao do ECM. Este programa deverá ser executado para que os usuários com tipo de acesso para Visão Descentralizada sejam criados no ECM com senha padrão definida no programa Parâmetros Workflow (WF0000). Para mais detalhes, consultar a função Sincronização de Usuários (WF0030).
Cadastro de Ambiente Progress:
Necessário o cadastro de ambiente Progress para a chamada de procedures Progress por meio de eventos de processos com código JAVA. Anexar no Cadastro e Ambiente os arquivos .JAR que estão em <diretório de instalação Progress>\java e <diretório de instalação Progress>\java\ext. A seguir arquivos .jar a serem utilizados e exemplo de configuração de ambiente:
Cadastro de Serviço do GQP_HCM:
Necessário o cadastro do serviço Progress para a utilização a integração de solicitações do ECM com o HCM. Abaixo exemplo da parametrização necessária para a configuração do serviço. Os seguintes campos deverão ser informados:
Código: é o código do serviço que deverá ser obrigatoriamente GQP_HCM.
Descrição: é a descrição do serviço que pode ser informada como na tela abaixo.
URL: é a URL a qual o Appserver foi configurado.
Tipo: selecionar o tipo como Progress.
Objeto Remoto: é o objeto proxy que será utilizado. Deverá ser parametrizado conforme o print abaixo.
Usuário: usuário de conexão com o appserver.
Senha: senha de conexão com o appserver.
Ambiente: selecionar o ambiente que foi configurado no tópico anterior.
OBS: os arquivos anexados deverão ser copiados para a pasta <instalação ECM>\server\default\lib. É necessário parar o serviço antes de efetuar a cópia e reiniciá-lo em seguida.
Pasta Arquivo Proxy:
Para maiores detalhes, consultar o processo Configurando o Serviço no documento Integração ECM que se encontra no diretório de documentação da pasta do produto ECM.
Incluir Templates de e-mail customizados:
É necessário incluir templates utilizados para o envio de e-mail para os notificados cadastrados no programa Movimentos Disponíveis GQ0003 do produto TOTVS. O exemplo abaixo é relativo ao e-mail em português. Abaixo descrição dos campos:
Código: código do template que deverá ser parametrizado obrigatoriamente como tplgq001.
Descrição: descrição do template. Poderá ser igual à utilizada na tela abaixo.
Idioma: Português.
Arquivo: realizar o upload do arquivo de template tplgqp001-pt.htm do diretório de expedição do produto TOTVS da pasta \prghur\wfp\integr-ecm. Renomear o arquivo para .html e adicionar assinalado como principal.
Nota: Para clientes que desejam utilizar e-mail no idioma inglês ou espanhol, deverão ser incluídos novos templates com o mesmo código e a respectiva descrição com o idioma. Deve ser selecionado o idioma que deseja e realizar o upload do arquivo tplgqp001-en.htm ou tplgqp001-es.htm conforme o idioma cadastrado. E por fim renomear o arquivo para .html e adicionar como principal.
Cadastro de Mecanismo de Atribuição:
É necessário incluir o mecanismo de atribuição que retornará os aprovadores parametrizados no produto TOTVS. Abaixo descrição dos campos do mecanismo:
Código: código do mecanismo de atribuição que deverá ser informado obrigatoriamente como Hierarquia RH como demonstrado na tela abaixo:
Nome: nome do mecanismo de atribuição. Deverá ser informado conforme o print abaixo.
Descrição: descrição detalhada do mecanismo de atribuição. Pode ser informada a descrição abaixo ou outra mais detalhada.
Tela de Configuração: para este mecanismo não é necessário informa a tela de configuração.
Programa de Controle: poderá ser mantido o padrão que é demonstrado quando incluído o mecanismo.
Descrição da Configuração: código javascript que executará os programas Progress para retornar os aprovadores. Necessário colar neste campo o conteúdo do arquivo mecanismoatribuicao.js que se encontra na pasta de instalação do TOTVS em hcm\prghur\wfp\integr-ecm.
Importação de Processos:
É necessária a importação dos processos para Integração do módulo Gestão de Quadro de Pessoal do HCM com o ECM. É necessário importar os processos:
Código do Processo | Descrição do Processo |
---|---|
RDO | Requisição de Pessoal |
ADM | Admissão de Pessoal |
CNC | Cancelamento de Requisição de Pessoal |
TRF | Transferência de Pessoal |
TRV | Transferência de Pessoal com Mudança no Orçamento |
CAR | Inclusão /Alteração de Cargos |
MPO | Mudança de Posição |
MPV | Mudança de Posição com Mudança no Orçamento |
PRO | Promoção |
AUM | Aumento Salarial |
DES | Desligamento de Pessoal |
ENQ | Enquadramento Salarial |
FER | FER Simulação de Férias |
Para a importação de processos, o processo Importação de Processos no ECM deverá ser acessado os seguintes passos executados:
Realizar o upload dos arquivos XML: estes arquivos encontram-se no diretório de instalação do produto TOTVS na pasta hcm\prghur\wfp\integr-ecm\. Cada processo relacionado no quadro acima possui seu respectivo arquivo XML no diretório informado. Realizar o upload de todos os arquivos para poder continuar o processo de importação.
Importar Processo: para cada processo que foi realizado upload assinalar o campo Novo Processo e informar no campo "Código do Novo Processo" com o código do processo informado no quadro acima, como por exemplo, RDP. Depois disso, pressionar o botão Ok.
Liberar Versão: o processo de liberação de versão é necessário para integração das solicitações. Para realizar a liberação de processo é necessário acessar o processo Configuração de Processos, posicionar nos processos importados e acionar o botão Editar. Na pasta versão selecionar o link Nova Versão. Confirmar a liberação. Realizar este procedimento para todos os processos importados.
Processo de Integração
Abaixo os programas que poderão ser acessados para iniciar solicitação pela visão descentralizada:
GQ0010 – Requisição de Pessoal.
GQ0020 – Admissão de Pessoal.
GQ0030 – Cancelamento de Requisição de Pessoal.
GQ0040 – Mudança de Posição /Transferência com ou sem Orçamento de Pessoal.
GQ0060 – Solicitação de Desligamento.
GQ0070 – Promoção / Aumento / Enquadramento Salarial.
GQ0100 – Inclusão /Alteração de Cargos.
Para acessar o FP1802 – Simulação de Férias o usuário deverá ter acesso ao Quiosque eletrônico.
GQ0010 – Solicitação de Requisição de Pessoal:
GQ0020 – Solicitação de Admissão de Pessoa:
Pré-Requisitos para iniciar solicitação de Admissão de Pessoal:
Iniciar Solicitação:
Admitir Candidato (depois o processo de aprovação da requisição concluído):
GQ0030 – Solicitação de Cancelamento de Requisição de Pessoal:
Iniciar Solicitação:
GQ0040 – Solicitação de Mudança de Posição/Transferência:
Pré-Requisitos para iniciar solicitação de Mudança de Posição/Transferência:
Iniciar Solicitação de Transferência (TRF):
Nota: Lembrando que, para o movimento de transferência, quando possui níveis superiores parametrizados, os primeiros aprovadores são os da posição destino, depois das áreas e times de trabalho e só então os da posição origem.
Iniciar Solicitação de Transferência (TRV): lembrando que deverá ter posição de destino em planilha orçamentária.
Nota: Lembrando que, para o movimento de transferência, quando possui níveis superiores parametrizados, os primeiros aprovadores são os da posição destino, depois das áreas e times de trabalho e só então os da posição origem.
Iniciar Solicitação de Mudança de Posição (MPO):
Nota: Lembrando que, para o movimento de transferência, quando possui níveis superiores parametrizados, os primeiros aprovadores são os da posição destino, depois das áreas e times de trabalho e só então os da posição origem.
Iniciar Solicitação de Mudança de Posição (MPV):
Nota: Lembrando que, para o movimento de transferência, quando possui níveis superiores parametrizados, os primeiros aprovadores são os da posição destino, depois das áreas e times de trabalho e só então os da posição origem.
GQ0060 - Solicitação de Desligamento:
GQ0100 - Solicitação de Cargos:
GQ0070 - Solicitação de Promoção Salarial:
GQ0070 - Solicitação de Aumento Salarial:
GQ0070 - Solicitação de Enquadramento Salarial:
ECM – Aprovar Solicitação:
Pré-requisitos:
O pré-requisito da aprovação de solicitação é a sua inicialização por meio da visão descentralizadora. Para testar os programas que são executados no mecanismo de atribuição e eventos do ECM podem ser realizadas as seguintes parametrizações:
Aprovar:
Nota: Executar este processo de aprovação até finalizar o fluxo.
ECM – Reprovar Solicitação:
ECM - Cancelar Solicitação:
Erro | Mensagem | Solução |
---|---|---|
Não se aplica | Usuário inexistente. | Sincronizar usuário com ECM por meio do Programa WF0030. |
Não se aplica | Processo Inexistente. | Importar processo no ECM. |
Não se aplica | Registro de integração com o ECM não foi encontrado. | Acessar o programa WF0000 e parametrizar as informações solicitada para o tipo de integração ECM. |
Não se aplica | Não foi possível estabelecer comunicação com o serviço do ECM! | Informar a URL no WF0030. Verificar se o ECM está iniciado acessando a URL. |
Não se aplica | Não foi possível executar o serviço ColleagueService do ECM! | Informar a URL no WF0030. Verificar se o ECM está iniciado acessando a URL. |
Não se aplica | Não informado e-mail para Pessoa Física do usuário. (wf0030) | Informar o e-mail da pessoa física do usuário (FP1440) |