Professional Documents
Culture Documents
Fevereiro/2015
Sumrio
1.
2.
3.
4.
5.
TOTVS (HCM)
API Inicia Solicitao
WebServices Fluig
Fluig
Appserver
Aprovadore
s
API HCM
Eventos Atividade ECM
API - HCM
Mecanismo
Atribuio
O objetivo desta integrao permitir realizar a integrao do fluxo de aprovao de processos do mdulo Gesto de Quadro de
Pessoal (HCM) do produto TOTVS linha Datasul, com o Fluig. A integrao est disponvel a partir do TOTVS 12.1.4 em diante.
Ateno: A integrao entre o mdulo GQP e o Fluig homologada somente SEM a utilizao de Identity.
No canto superior esquerdo, posicionado na opo Servidor, clique com o boto direito no mouse, selecione a opo Novo e
depois na opo Fluig Servidor.
Criar o caminho c:\GQPXECM\fontes\prghur\wfp e copiar do diretrio de instalao TOTVS linha Datasul em \prghur\wfp os
programas wfapi200.r, wfapi300.r, wfapi301.r, wfapi302.r para dentro do diretrio criado.
Criar o diretrio c:\GQPXECM\proxy e baixar arquivo hcmproxies.doc do diretrio de instalao TOTVS linha Datasul, pasta
prghur/wfp/integr-ecm.
Renomear este arquivo para hcmproxies.xpxg.
Executar dois cliques para abrir o arquivo hcmproxies.xpxg. Na pasta AppObject deve estar parametrizado como a tela
abaixo:
Ao selecionar o boto Generate, ser demonstrada a seguinte tela. No campo Appserver, dever ser informado o nome do
appserver que foi configurado para a integrao. O campo Output dir o local onde ser gerado o proxy, poder ser mantido
o diretrio que demonstrado abaixo:
Ao Pressionar o boto OK, ser realizada a gerao do proxy. Ao finalizar a gerao ser demonstrada a seguinte
mensagem:
Compacte a pasta com que foi gerada no diretrio c:\GQPXECM\proxy com o nome HCMproxies.zip e renomeie o arquivo
gerado para HCMproxies.jar.
Copiar do diretrio de instalao do TOTVS (hcm/prghur/wfp/integr-ecm) o arquivo gqp_hcm.zip para uma pasta temporria.
Descompactar o arquivo gqp_hcm.zip.
Acessar o Fluig Studio e selecionar no menu Arquivo e aps a opo Importar.
Selecionar a opo Projetos Existentes no Espao de Trabalho conforme figura abaixo:
Por meio do boto Procurar, selecionar a pasta descompactada gqp_hcm, certificando-se que o projeto gqp_hcm se
encontra selecionado em Projetos, conforme figura abaixo:
E ao final pressionar o boto Concluir para que o projeto seja importado com sucesso. Na figura a seguir demonstra o
projeto importado na pasta mais esquerda no Fluig Studio:
10
Cdigo: cdigo nico que ir identificar o servio do Sistema. Ser utilizado nos cdigos JavaScript para ter acesso
ao servio. Obrigatrio informar GQP_HCM.
Descrio: texto que descreve o servio de dados. Informar a descrio da tela abaixo.
URL: Identifica a URL de acesso ao servio AppServer, como por exemplo AppServer://<servidor>/<nome_servio>;
No caso de no estar utilizando o NameServer padro deve ser informada a porta de acesso ao NameServer. Ex.:
AppServer://<servidor>:<porta_NameServer>/<nome_servio>.
Observe que dependendo da configurao do servio e/ou da forma de conexo, a URL pode sofrer alteraes.
Verifique a documentao do Open AppServer para mais informaes.
Tipo: Identifica o tipo de servio (Progress ou WebService). Deve ser selecionado Progress.
Objeto Remoto: Identifica a classe de acesso do proxy. Esta classe normalmente formada pelo nome do pacote
utilizado para a gerao das classes Proxy, mais o nome do projeto no ProxyGen. Informar
com.totvs.ecm.hcm.HCMproxies.
Usurio: Usurio utilizado na conexo ao servio, conforme definido nas configuraes no AppServer.
Senha: Senha utilizada na conexo ao servio, conforme definida nas configuraes no AppServer.
Parmetros Extras: Parmetros extras (e opcionais) utilizados para conexo ao AppServer. Verifique a
documentao do Open AppServer para verificar as opes disponveis em cada verso do Progress; Neste caso
no necessrio configurar.
Diretrio do arquivo de Proxy: Arquivo .JAR contendo as classes geradas pelo ProxyGen; Deve ser utilizado o
boto Selecionar Arquivo para localizar ele. Adicionar o arquivo HCMproxies.jar gerado marcando ele como principal.
Processo de Integrao
Abaixo os programas que podero ser acessados para iniciar solicitao pela viso descentralizada:
GQ0010 Requisio de Pessoal
GQ0020 Admisso de Pessoal
GQ0030 Cancelamento de Requisio de Pessoal
GQ0040 Mudana de Posio /Transferncia com ou sem Oramento de Pessoal
GQ0060 Solicitao de Desligamento
GQ0070 Promoo / Aumento / Enquadramento Salarial
GQ0100 Incluso /Alterao de Cargos
12
Para acessar o Simulao de Frias (FP1802), o usurio dever ter acesso ao Quiosque eletrnico.
GQ0010 - Solicitao de Requisio de Pessoal:
Iniciar Solicitao:
No GQ9999, verificar se o aprovador correto est aparecendo e confirmar por meio do boto OK.
Resultado Esperado: mensagem informando que solicitao foi iniciada com sucesso. Movimento criado e com status em
aprovao (GQ0002). Acessar o Fluig com o usurio aprovador e verificar se a solicitao est disponvel para aprovao.
Se a estrutura de aprovao possuir nvel superior, as posies do nvel superior da origem/destino devero possuir
ocupantes e estes devero estar relacionados aos usurios com complemento RH do tipo estrutura reporte (sec/sec000aa.w),
para que seja possvel selecionar o funcionrio que ir ser transferido pelo viso descentralizada.
Tanto a posio de origem quando a de destino do funcionrio a ser transferido devero estar cadastradas na estrutura
reporte (GD0008).
O cargo dever estar ativo (CA0001).
Quando o tipo de solicitao for TRV e MPV devero existir planilhas oramentrias cadastradas/geradas com a configurao
das devidas posies que esto mudando de posio ou transferidas.
14
Confirmar a transferncia.
Confirmar a seleo do aprovador (verificar se o aprovador est correto conforme o GQ0003).
Nota:
Lembrando que, para o movimento de transferncia, quando possui nveis superiores parametrizados, os primeiros aprovadores
so os da posio destino, depois das reas e times de trabalho e s ento os da posio origem.
Resultado esperado: dever ser emitida uma mensagem informando que a solicitao foi iniciada com sucesso. Movimento
criado com status Em Aprovao, o aprovador dever ser quem iniciou o fluxo e o aprovador dever ser a pessoa que o
prximo aprovador (GQ0002). Acessar o Fluig com o usurio aprovador, a solicitao dever estar disponvel para aprovao
na Central de Tarefas.
Iniciar Solicitao de Transferncia (TRV): lembrando que dever ter posio de destino em planilha oramentria.
Nota:
Lembrando que, para o movimento de transferncia, quando possui nveis superiores parametrizados, os primeiros aprovadores
so os da posio destino, depois das reas e times de trabalho e s ento os da posio origem.
Resultado esperado: dever ser emitida uma mensagem informando que a solicitao foi iniciada com sucesso. Movimento
criado com status Em Aprovao, o aprovador dever ser quem iniciou o fluxo e o aprovador dever ser a pessoa que o
prximo aprovador (GQ0002). Acessar o Fluig com o usurio aprovador, a solicitao dever estar disponvel para aprovao
na Central de Tarefas. Dever ter um movimento de Entrada por Transferncia na planilha oramentria e um movimento de
Sada por Transferncia pendente de aprovao para o usurio do oramento de pessoal.
Nota:
Lembrando que, para o movimento de transferncia, quando possui nveis superiores parametrizados, os primeiros aprovadores
so os da posio destino, depois das reas e times de trabalho e s ento os da posio origem.
Resultado esperado: dever ser emitida uma mensagem informando que a solicitao foi iniciada com sucesso. Movimento
criado com status Em Aprovao, o aprovador dever ser quem iniciou o fluxo e o aprovador dever ser a pessoa que o
prximo aprovador (GQ0002). Acessar o Fluig com o usurio aprovador, a solicitao dever estar disponvel para aprovao
na Central de Tarefas.
Nota:
Lembrando que, para o movimento de transferncia, quando possui nveis superiores parametrizados, os primeiros aprovadores
so os da posio destino, depois das reas e times de trabalho e s ento os da posio origem.
Resultado esperado: dever ser emitida uma mensagem informando que a solicitao foi iniciada com sucesso. Movimento
criado com status Em Aprovao, o aprovador dever ser quem iniciou o fluxo e o aprovador dever ser a pessoa que o
prximo aprovador (GQ0002). Acessar o Fluig com o usurio aprovador, a solicitao dever estar disponvel para aprovao
na Central de Tarefas. Dever ter um movimento de Entrada por Transferncia na planilha oramentria e um movimento de
Sada por Transferncia pendente de aprovao para o usurio do oramento de pessoal.
16
Somente o nvel superior aprova: assinalar o campo Nvel Superior no programa WF0000.
Nvel Superior 3 + Nvel Superior 2 + Nvel Superior 1.
Nvel Superior 3 + Nvel Superior 2 + Nvel Superior 1 + rea Responsvel.
Nvel Superior 1 + rea Responsvel 1 + rea Responsvel 2.
Nvel Superior 1 + rea Responsvel 1 Time de Trabalho.
rea Responsvel + Nvel Superior 2 + Nvel Superior 1.
Somente rea Responsvel.
Somente Time de Trabalho.
Somente Nvel Superior 1.
Aprovar:
18
Resultado esperado: ao acessar a solicitao, quando houver prximos aprovadores, as atividades que devem estar
disponveis para o usurio so "Aprovar" e "Reprovar", e o prximo aprovador dever ser demonstrado na lista. No caso de
ser o ltimo aprovador, as atividades disponveis devero ser "Finalizar" e "Reprovar", e no dever ser demonstrado a lista
de aprovadores. Depois acionar "Enviar a solicitao" no dever estar mais disponvel para este aprovador e sim para o
aprovador demonstrado na lista. Se o aprovador que enviou a solicitao for o ltimo, a solicitao dever estar finalizada
(verificar GQ0002- status aprovado) e os usurios notificados (pasta notificados GQ0003 do movimento) devero receber email de processo finalizado. Se no for o ltimo aprovador a solicitao dever estar como "Em aprovao" e o aprovador
como o demonstrado no (GQ0002).
Nota:
Executar este processo de aprovao at finalizar o fluxo.
Fluig Reprovar Solicitao:
Mensagem
Soluo
No se aplica
Usurio inexistente.
No se aplica
Processo Inexistente.
No se aplica
Registro de integrao com o ECM no foi Acessar o programa WF0000 e parametrizar as informaes
encontrado.
solicitada para o tipo de integrao Fluig.
No se aplica
No se aplica
No se aplica
No informado e-mail para Pessoa Fsica do Informar o e-mail da pessoa fsica do usurio (FP1440).
usurio. (wf0030)
20