manual para implantaÇÃo do gestÃo do …€¦ · para configurar o openmq como serviço do...

Documento: Documento Implantação do Gestão de Ponto (2)

Modelo: Versão Página 1 de 48

MANUAL PARA IMPLANTAÇÃO DO GESTÃO DO PONTO

Elaboração: Código:

Homologado: Revisão:

Data: Início

Treinamento:

Em Vigor:

Aplicação

Áreas Cargos, Funções e Papéis

Quadro de Revisões

Data Versão Descrição Autor

01/04/2010 1 Criação do Documento Tomaz

06/08/2010 2 Atualização devido troca Servidor Aplicação (GlassFish) Tomaz

24/08/2012 3 Adaptação para ambiente Porto Tomaz

27/09/2012 4 Detalhando instalação/configuração Rodrigo Wessler

18/09/2012 5 Refinamento das configurações, acrescentado ambiente de customização.

Rodrigo Wessler

17/07/2013 6 Alterações para tornar o documento genérico para todos clientes Tomaz

03/09/2013 7 Arquivo adaptado para o uso do instalador e workflow Denise Brandt

13/11/2013 8 Ajustes referente a atualização do SeniorDeveloper e a nova forma de instalação com processo embarcado do Workflow

Fernando de Paula



Conteúdo 1. OBJETIVO ............................................................................................................................................................................... 3

1.1. DEFINIÇÕES .......................................................................................................................................................................... 3 1.2. REFERÊNCIAS ....................................................................................................................................................................... 3

2. PRÉ-REQUISITOS .................................................................................................................................................................. 4

3. AMBIENTE .............................................................................................................................................................................. 4

3.1. REPOSITÓRIO DE INSTALAÇÃO .............................................................................................................................................. 5 3.2. JAVA ..................................................................................................................................................................................... 5 3.3. OPENMQ .............................................................................................................................................................................. 6 3.4. SERVIDOR DE APLICAÇÃO ..................................................................................................................................................... 6

3.4.1. Instalação Glassfish .................................................................................................................................................. 6 3.4.2. Iniciar/Parar o Glassfish ........................................................................................................................................... 7 3.4.3. Criar domínio domain2 ............................................................................................................................................. 7 3.4.4. Criar serviço iniciar/parar glassfish ......................................................................................................................... 8 3.4.5. Configuração da JVM ............................................................................................................................................... 8 3.4.6. Configurar Serviço de Mensagens (JMS) .................................................................................................................. 8

3.4.6.1. JMS Hosts ..................................................................................................................................................................... 8 3.4.7. Configurações HTTP Service .................................................................................................................................. 10

3.4.7.1. Thread Count ............................................................................................................................................................... 10 3.4.7.2. HTTP Listener ............................................................................................................................................................. 11

3.4.8. Configurar serviço do Windows .............................................................................................................................. 12 3.4.9. Configurações de Segurança ................................................................................................................................... 13

4. INSTALAÇÃO DO GESTÃO DE PONTO ......................................................................................................................... 14

4.1. EXECUTAR O INSTALADOR .................................................................................................................................................. 14 4.2. CONFIGURAR GESTÃO DO PONTO ....................................................................................................................................... 23

4.2.1. Configurar colaboradores do módulo Gestão do Ponto ......................................................................................... 23 4.2.2. Configurar ajuda ..................................................................................................................................................... 24 4.2.3. Configurar processos batch ..................................................................................................................................... 24 4.2.4. Configurar autenticação .......................................................................................................................................... 25 4.2.5. Configurar aplicação JEE ....................................................................................................................................... 25

4.2.5.1. Configurar Pool de conexões ...................................................................................................................................... 26 4.2.6. Configurar serviço de terceiro ................................................................................................................................ 27 4.2.7. Serviços internos...................................................................................................................................................... 29

4.3. PUBLICAR CUSTOMIZAÇÕES DO GESTÃO DO PONTO ........................................................................................................... 31 4.4. INSTALAÇÃO MANUAL DO GESTÃO DE PONTO ................................................................................................................... 36

5. PARAMETRIZAÇÃO DO GESTÃO DO PONTO ............................................................................................................ 37

5.1. IMPLANTAÇÃO .................................................................................................................................................................... 37 5.1.1. Configurações das Pendências do Acerto ............................................................................................................... 37 5.1.2. Definir Regras de Apuração .................................................................................................................................... 37 5.1.3. Configurar Totalizadores ........................................................................................................................................ 38

5.2. PARÂMETROS POR "ONDA" ................................................................................................................................................. 38 5.2.1. Permissão para perspectivas (telas) do Gestão do Ponto ....................................................................................... 38

5.3. CUSTOMIZAÇÃO DE RELATÓRIOS ....................................................................................................................................... 39 5.4. CUSTOMIZAÇÃO DE NOTIFICAÇÃO POR EMAIL ................................................................................................................... 41

6. CONFIGURAR WORKFLOW ............................................................................................................................................ 43

6.1. EDITAR FLUXO EMBARCADO ............................................................................................................................................... 43 6.2. CONFIGURAR PROPRIEDADES .............................................................................................................................................. 47 6.3. CONFIGURAR FLUXO NO SISTEMA ....................................................................................................................................... 47 6.4. DEFINIR CRIPTOGRAFIA ...................................................................................................................................................... 48

7. CONFIGURAR GESTÃO DO PONTO NO PORTAL ...................................................................................................... 48



1. Objetivo

O Objetivo deste documento é descrever o processo de liberação do Gestão do Ponto para o

cliente.

1.1. Definições

1.1.1 Serviço do Windows: Um serviço do Windows é uma aplicação que inicia quando o

Windows é carregado e roda em segundo plano enquanto o Windows estiver em

execução.

1.1.2 GlassFish: Servidor de aplicação baseado na plataforma JEE completamente escrito na

linguagem de programação Java.

1.1.3 EAR: Enterprise Archive é um arquivo padrão da plataforma JEE usado para

empacotar um ou mais módulo de uma aplicação.

1.1.4 Deploy: termo usado para instalação da sua aplicação em um servidor de aplicações,

ou seja, instalar a aplicação para disponibilizar ela para seus usuários.

1.1.5 Repositório de Instalação: Pasta compartilhada que contem os software e arquivos

necessários para instalação do projeto.

1.2. Referências

Documento Título Local Link

PQ-040 MSDS – Metodologia Senior de

Desenvolvimento Sistemas

Intranet link

PQ-010 Controle de Versão Intranet link

Glossário G6 Glossário de Processos da G6 Intranet link

http://sitesg6:82/sites/pmo/sepg/processosg6/Processos/vigentes/MSDS/PQ040.html

http://portalsenior/sgq/DocumentosSGQ/Procedimentos/PQ010.html

http://sitesg6:82/sites/pmo/sepg/processosg6/Processos/Glossario.aspx



2. Pré-requisitos

Acesso ao FTP senior: o ftp://ftp.senior.com.br/downloads/ .... TODO

Java JDK 1.6 64 bits instalado o Executar no prompt do windows o comando java -version

Glassfish Ronda G5 versão 5.8.2 Configurações

o Acesso ao SeniorConfigCenter Acesso ao CBDS

o Usuário com permissão para criar tabelas. Usuário do Ronda G5 com as seguintes permissões:

o Criar serviços; o Agendar processos o Acessar central de segurança

Usuário Ronda G6 com permissões para: o Customizações o Administrador do sistemas o Usuário com abrangência para todos os colaboradores

Diretórios compartilhados (dentro do diretório onde a G5 foi instalada): o Diretório para publicar customizações

Deve ser adicionado a rotina de backup;

Precisa permissão de escrita. o Diretório para publicar as bibliotecas utilizadas na customização; o Diretório para publicar o tema utilizado.

LoadBalancer o Configuração de afinidade de sessão o Verificar porta, precisa alterar para 80

OpenMQ o Liberar a porta 6677 para acesso através das máquinas onde estão os servidores

glassfish.

3. Ambiente

O ambiente de configuração varia de acordo com a carga de usuários necessária. Essa

informação determina a quantidade de servidores necessários

No ambiente exemplo temos três servidores para o sistema de Gestão de Ponto. Vai existir

um balanceador de carga para distribuir o acesso entre os usuários. Diariamente alguns processos

automáticos serão tratados pelo middleware Senior que irá invocar serviços disponíveis nos

servidores de Acerto.

A imagem a seguir, mostra uma topologia com as máquinas envolvidas no ambiente usado

na senior.

ftp://ftp.senior.com.br/downloads/



3.1. Repositório de Instalação

Os arquivos para a instalação do Gestão do Ponto estão no FTP disponibilizado para cada

cliente.

3.2. Java

O Gestão do Ponto necessita que seja instalado o Java JDK 1.6 (64 bits), nos servidores que o

sistema irá rodar.

Se este não estiver instalado, copie a instalação disponível no FTP (softwares\jdk-6u35-

windows-x64.exe) e execute o instalador, preferencialmente a instalação deve ser feita no diretório

(C:\Senior\Java).



3.3. OpenMQ

Para instalar o OpenMQ, copie a instalação disponível no FTP (softwares\openmq4_5-binary-

WINNT.zip) e descompacte em (C:\senior\gestaoponto\mq) do servidor dedicado ao Acerto

(maquina).

Para configurar o OpenMQ como serviço do Windows utilizar os comandos abaixo: [OpenMQ_Dir] = Diretório de instalação do OpenMP; [JDK_DIR] = Diretório de instalação do Java;

# instala o OpenMQ como service

SET IMQSVC=[OpenMQ_Dir]\mq\bin\imqsvcadmin

SET JAVA_HOME=[JDK_DIR]

%IMQSVC% install -javahome "%JAVA_HOME%" -vmargs "-Xmx256m -Xms64m" -args "-port

6677"

3.4. Servidor de aplicação

O Gestão do Ponto utiliza o Glassfish 3 como servidor de aplicação, a seguir detalhes sobre sua

instalação e configuração, estes procedimentos devem ser feitos em todas as máquinas que vão

rodar o Gestão do Ponto.

3.4.1. Instalação Glassfish

Para instalar o Glassfish, copie a instalação disponível no FTP (softwares\glassfish-3.1.2.2-

windows.exe) para o diretório (F:\Senior\Acerto62) do servidor onde o Gestão de Ponto será

instalado.

Após isto, execute o arquivo a seguir:

glassfish-3.1.2.2-windows.exe

Na tela de instalação desmarque a opção "Instalar Ferramenta de Atualização".



3.4.2. Iniciar/Parar o Glassfish

Para iniciar o glassfish execute o comando a seguir dentro da pasta raiz da instalação (ex:

F:\Senior\gestaoponto\glassfish):

bin\asadmin start-domain domain1

Para parar o Glassfish execute o comando a seguir dentro da pasta raiz da instalação (ex:

F:\Senior\gestaoponto\glassfish):

bin\asadmin stop-domain domain1

3.4.3. Criar domínio domain2

Por padrão, ao instalar o glassfish, é criado um domínio chamado domain1. É necessário criar

um segundo domínio chamado domain2. Nesse segundo domínio ficará o Workflow Para isso, deve

ser executado o comando abaixo:

asadmin create-domain --adminport 4747 domain2

É importante que o domain1 já tenha sido iniciado para que não seja usada as mesmas portas

do domain1.

Após criar o domain2, o mesmo deve ser inciado por meio do comando do item anterior.



3.4.4. Criar serviço iniciar/parar glassfish

Executar os comandos abaixo para criar serviços para do Windows para iniciar/parar domínios do glassfish. No lugar de “Glassfish_Dir” usar o diretório do Glassfish:

[Glassfish_Dir]\bin> asadmin create-service domain1

[Glassfish_Dir]\bin> asadmin create-service domain2

3.4.5. Configuração da JVM

As configurações a seguir são feitas no painel de administração do Glassfish e devem ser feitas

para os domain1 e domain2, conforme imagem abaixo:

As seguintes opções devem ser adicionadas a configuração da JVM, caso alguma

propriedade que possua valor já esteja configurada, este deve ser ajustado para

os valores abaixo:

-Xrs=true

-server

-XX:+UseConcMarkSweepGC

-XX:+UseParNewGC

-Xms3g

-Xmx6g

-XX:MaxPermSize=512m

IMPORTANTE: O valores em vermelho devem ser ajustados conforme memória disponível em

cada servidor.

A seguinte propriedade deve ser removida:

-client

IMPORTANTE: Para ter efeito as alterações feitas devem ser salvas e o Glassfish reiniciado.

3.4.6. Configurar Serviço de Mensagens (JMS)

O Gestão do Ponto utiliza JMS em algumas de suas funcionalidades, para isto as seguintes

configurações devem ser feitas.

3.4.6.1. JMS Hosts



O OpenMQ vem junto com o glassfish e como default é configurado no modo embedded. É

necessário alterar esta configuração para utilizar o servidor de mensagem instalado a parte,

utilizando o modo remoto. Assim em cada glassfish instalado deve ser ajustado as seguintes

configurações do Java Message Service:

Primeiro deve ser criado um JMS Host apontando para a maquina onde o OpenMQ foi

instalado, esta configuração é feita pelo painel de administração conforme imagem abaixo:

A porta default é 6677 e o usuário/senha é admin, a máquina/porta onde o openMQ foi

instalado precisa ser acessível a todos os servidores glassfish do Gestão do Ponto, abaixo tela de

configuração.

Após criar o novo host, o host default deve ser removido:


Modelo: Versão

Página 10 de 48

Agora, deve ser alterado para o JMS utilizar o novo host e o modo remoto, ver figura abaixo:

IMPORTANTE: Para ter efeito as alterações feitas devem ser salvas e o Glassfish reiniciado.

3.4.7. Configurações HTTP Service

3.4.7.1. Thread Count

O número de Thread Count deve ser de 5 por CPU (núcleo), está configuração deve ser

alterada pelo painel de administração do GlassFish conforme imagem abaixo:


Modelo: Versão

Página 11 de 48

3.4.7.2. HTTP Listener

Deve ser alterada a porta do http-listener-1 e http-listener-2 (http e https), para seus valores

padrões (80 e 443), conforme imagens abaixo. Fazer isso para apenas o domain1.


Modelo: Versão

Página 12 de 48

Para que os arquivos enviados para o browser sejam compactados deve ser configurado o

http-listener-1 e http-listener-2 (http e https), conforme abaixo:

Valores:

compression=on

compressableMimeType=text/html,text/xml,text/plain,text/javascript,text/css

compressionMinSize=10

Ficará conforme a imagem abaixo.

3.4.8. Configurar serviço do Windows

Para instalar o Gestão do Ponto como serviço do Windows utilizar os comandos abaixo:

# instala o glassfish como serviço

asadmin create-service domain1


Modelo: Versão

Página 13 de 48

# cria dependência dos serviços para que o OpenMQ fique disponível ao iniciar o glassfish

sc config AcertoG6 depend= MQ4.5_Broker

Após iniciar o openMQ é possível testar a conexão do JMS através do painel de administração

do Glassfih, este procedimento deve ser feito em todas as instalações do Glassfish, verificar imagem

abaixo:

3.4.9. Configurações de Segurança

É necessário alterar algumas configurações de segurança do glassfish3 para utilizar o

instalador da Senior. Para isso, navegar para a opção Server-Config -> HTTP Services -> Http

Listeners - > admin-listener e clicar no link Secure Administration.


Modelo: Versão

Página 14 de 48

Clicar no Enable Secure Admin.

4. Instalação do Gestão de Ponto

Segue uma lista de passos para verificar durante o processo de instalação do Gestão do Ponto

4.1. Executar o instalador

Executar o arquivo SeniorInstaller.exe, que está no diretório da mídia.

Abaixo a imagem do arquivo a ser executado:

Conforme imagem abaixo, informar os diretório onde será feita a instalação e as demais

configurações. Clicar em Anvançar.


Modelo: Versão

Página 15 de 48

Marcar os produtos que serão instalados conforme imagem abaixo e clicar em Avançar.


Modelo: Versão

Página 16 de 48

Ler os contratos de licença e marcá-los como lidos. Avançar.

Marcar O Gerenciador do Middleware e o Gerenciador de Aplicativos. Marcar para instalar como

serviço.

Avançar.


Modelo: Versão

Página 17 de 48

Informar o usuário e senha de rede. Avançar.

Clicar em “Incluir” para incluir o domínio existente.


Modelo: Versão

Página 18 de 48

Informar os dados do domain1 do servidor glassfish instalado anteriormente. Clicar em OK.

Clicar novamente em Incluir. Informar os dados do domain2 do servidor glassfish instalado

anteriormente. Clicar em OK e em Avançar.


Modelo: Versão

Página 19 de 48

Marcar o Gestão de Pessoas e informar o domain1. Avançar.

Marcar o Controle de Ponto e Refeitório. Avançar.

Clicar em incluir para informar o contexto para cada produto do SeniorTools. Este processo

será feito três vezes, uma para cada produto.


Modelo: Versão

Página 20 de 48

Informar o nome do contexto “GestaoPonto” e adicionar o produto Gestão do Ponto. Informar

o domain1. Clicar em OK.

Informar o nome do contexto “WorkflowContainer” e adicionar o produto Workflow Container.

Informar o domain2. Clicar em OK.

Clicar sobre o workflow na grid de contextos e alterar.


Modelo: Versão

Página 21 de 48

Informar o domain2 para o Workflow. Clicar em OK.

Ao final, existirão três contextos cadastrados conforme imagem abaixo:

Marcar o Central de Monitoramento Senior e selecionar o domain1.


Modelo: Versão

Página 22 de 48

Selecionar a base de dados Gestão de Pessoas. Clicar em Instalar.

Após iniciar o processo de instalação, será requisitado a base de dados. Caso já exista uma

base de dados criada, selecionar a terceira opção conforme a imagem abaixo:


Modelo: Versão

Página 23 de 48

Após isso, informar os dados da base de dados, clicar em Testar conexão para garantir que os

dados foram informados corretamente e clicar em Concluir. Ver a imagem a seguir:

Ao final da instalação, será exibida uma mensagem de acordo com a imagem abaixo. É

necessário reiniciar o glassfish.

4.2. Configurar Gestão do Ponto

4.2.1. Configurar colaboradores do módulo Gestão do Ponto


Modelo: Versão

Página 24 de 48

Para configurar os colaboradores que fazem parte do módulo Gestão do Ponto, pode ser usada

a tela do Ronda G5: Colaboradores > Ficha Cadastral > Indicação Módulos.

Nesta tela, selecionar o módulo Gestão do Ponto e marcar as pessoas que farão parte desse

módulo. Ver imagem abaixo.

4.2.2. Configurar ajuda

Deve ser configurado o endereço do servidor onde o help do Gestão do Ponto está publicado,

por padrão todo Glassfish com o Gestão do Ponto possui a documentação do caminho

http://servidor:8080/ronda-help/#HON/, é recomendado utilizar um servidor que seja dedicado

para o Gestão do Ponto.

Todos os servidores que possuem o Gestão do Ponto, vão utilizar acessar esta configuração de

help.

4.2.3. Configurar processos batch

O Gestão do Ponto permite executar processos agendados, para isto deve ser informado o

usuário que será utilizada para executar os mesmos, este usuário deve ter acesso completo a base e

possuir abrangência para todos os colaboradores.

http://servidor:8080/ronda-help/#HON/


Modelo: Versão

Página 25 de 48

4.2.4. Configurar autenticação

O Gestão do Ponto permite duas formas de autenticação o "Logon proprietário Senior" e o

"Logon com validação do usuário via LDAP".

A configuração do LDAP é feita em "Opções de segurança", ou seja, utiliza a mesma

configuração dos demais sistemas Senior.

4.2.5. Configurar aplicação JEE

O Gestão do Ponto permite configurar algumas propriedades do servidor de aplicação para um

melhor desempenho.

O "Tempo máximo de inatividade de uma thread" indica a quantidade de tempo que este

recurso permanece ativo esperando um requisição de usuário, após esse determinado tempo se

nenhuma requisição for recebida a thread é destruída liberando recursos, recomendasse utilizar 10

minutos.

A "Quantidade máxima de threads" define a quantidade de requisições de usuários que podem

ser processadas em paralelo, recomenda-se configurar 14 por CPU (núcleo).


Modelo: Versão

Página 26 de 48

4.2.5.1. Configurar Pool de conexões

O Gestão do Ponto utiliza um pool de conexões para otimizar os recursos de banco de dados,

liberado/compartilhando conexões quando não estão sendo utilizadas, as configurações destes pool

devem ser feitas em “configurações avançadas”.

Pode ser alterado o valor da "Quantidade máxima para o pool de conexões:" para 250

conexões, conforme imagem abaixo.


Modelo: Versão

Página 27 de 48

4.2.6. Configurar serviço de terceiro

O Gestão do Ponto disponibiliza alguns serviços que devem ser agendados através do client do

vertorh. Esses serviços devem ser importados e configurados conforme ambiente que a geração foi

instalada.

Os serviços disponíveis para o funcionamento do Gestão do Ponto são:

Serviço Localização do Serviço Descrição

Agendamento da Apuração

gestaoponto.AgendadorApuracao

Cálculo diário do Gestão do Ponto

Expiração de

Pendência

gestaoponto. ExpiracaoPendenciasAcerto Diariamente roda o processo que verifica se as

pendências estão expirando (não é usado quando tem workflow).

Envio e-mail colaboradores

gestaoponto. NotificacaoPendenciasAcerto Envia e-mails notificando os colaboradores sobre a existência de pendências.

Envio e-mail gestores

gestaoponto.NotificacaoGestoresPonto Envia e-mails notificando os gestores sobre a existência de pendências.

Cache Tabelas do Ronda

gestaoponto.ClearCacheRondaWs Serviço que limpa cache do sistema (Usado quando uma tela de SGI precisa atualizar informações).

Fechamento do Banco de Horas

gestaoponto.FechamentoBanco Realiza o fechamento do banco de horas verificando as horas a pagar a descontar para cada colaborador.

Migração de Banco de Horas

gestaoponto.MigrarBancoHoras Migra o saldo de horas de um saldo de situações ou banco de horas para o novo banco de horas, zerando o saldo no antigo e criando lançamento com o saldo no banco novo.

Recálculo da Apuração

gestaoponto.RecalculoApuracao Realiza o recáclulo da Apuração.

Execução de processo automático

gestaoponto.ServicoProcessoAutomatico Executa o processamento do processp automático de cálculo ou recáclulo da apuração.

Geração de alertas de apuração

gestaoponto.ServicoGeracaoAlerta Realiza a geração de alertas de apuração do sistema para os colaboradores conforme o período e abrangência informada.

Os serviços descritos acima devem ser criados dentro de um servidor de terceiro. Esse servidor

deve apontar para o URL servidor do Gestão do Ponto e informar o contexto “g6-senior-services” no

contexto.

Para configurar os serviços, deve ser criado um novo Provedor, que está disponível em

Recursos > Implementações > Editor de Web Services.


Modelo: Versão

Página 28 de 48

Após adicionar o provedor, o mesmo deve ser configurado conforme imagem abaixo, variando

apenas o nome do servidor e a porta:

Importante: o nome do provedor deve ser o mesmo dado para o contexto do Gestão do

Ponto durante a instalação.

Após isso, selecionar o provedor GestaoPonto criado acima e clicar em importar conforme a

imagem a seguir:

Selecionar o arquivo disponível em:


Modelo: Versão

Página 29 de 48

<Diretório instalação>/GestaoPonto/provedorGestaoPonto.ssf

Clicar em Executar.

4.2.7. Serviços internos

Para agendar a execução dos serviços do item anterior, é necessário criar um web service que

executa o serviço. Esse web service deve ser criado com um código semelhante a regra abaixo:

@ Agendamento para notificar email – Colaborador @

Definir GestaoPonto.gestaoponto.NotificacaoPendenciasAcerto.enviarEmail enviarEmail;

enviarEmail.token = "senior";

enviarEmail.executar();

@ Agendamento para notificar email – Gestor @

Definir GestaoPonto.gestaoponto.NotificacaoGestoresPonto.enviarEmail enviarEmailGes;

enviarEmailGes.token = "senior";

enviarEmailGes.executar();

@ Agendamento Expiração Pendências @

Definir ACERTO62.gestaoponto.ExpiracaoPendenciasAcerto.expirar vServico;

Definir Numero xDatHoj;

Definir Numero xDia;


Modelo: Versão

Página 30 de 48

Definir Numero xMes;

Definir Numero xAno;

Definir Alfa xDatStr;

Definir Alfa xRetorno;

DataHoje (xHoje);

DecodData(xHoje, xDia, xMes, xAno);

IntParaAlfa (xDia, xRetorno);

xDatStr = xRetorno + "/";

IntParaAlfa (xMes, xRetorno);

xDatStr = xDatStr + xRetorno + "/";

IntParaAlfa (xAno, xRetorno);

xDatStr = xDatStr + xRetorno;

vServico.dataInicial = xDatStr;

vServico.dataFinal = xDatStr;

vServico.executar();

O web service da Senior vai invocar o web service de terceiro. Dessa forma pode ser feito o

agendamento através da tela de agendamento de serviços.

Também é necessário habilitar o agendador de processos automáticos conforme imagem

abaixo:

Para os serviços de envio de e-mail, é necessário configurar as propriedades abaixo conforme

o ambiente existente:


Modelo: Versão

Página 31 de 48

4.3. Publicar customizações do Gestão do Ponto

As regras na G6 são desenvolvidas e publicadas através da ferramenta Senior Developer.

Copie o arquivo SeniorDeveloper.zip do FTP e descompacte do diretório de sua preferência.

Para iniciar o Senior Developer execute o arquivo "SeniorDeveloper.exe" dentro da pasta

"SeniorDeveloper".

Para utilizar a ferramenta de customização é necessário possuir um usuário administrador ou

com permissão para "Montar ambiente de customização Senior Developer" e "Efetuar deploy de

customização Senior Developer". As permissões devem ser configuradas no SGU acessando o menu

"Segurança / Direitos gerais..." conforme imagem a seguir.

Ao executar pela primeira vez, será exibida uma tela para selecionar o workspace a ser

utilizado. Escolha um diretório de sua preferência e clique em "OK", conforme imagem abaixo.


Modelo: Versão

Página 32 de 48

Para importar o projeto de customização clique no respectivo botão no menu superior,

conforme imagem abaixo.

Será exibida uma janela com os ambientes já cadastros. Para cadastrar um ambiente novo

clique em "criar um novo ambiente" conforme imagem seguir.


Modelo: Versão

Página 33 de 48

Agora deve ser preenchida as informações do servidor do ambiente:

Nome = NomeAmbiente

URL = URL do sistema (exmplo: http://rhacertohm/GestaoPonto)

Usuário/Senha = Usuário administrador ou com permissões de customização.

CFG = Arquivo cfg de configuração do sistema.

Verificar imagem abaixo.


Modelo: Versão

Página 34 de 48

Após inserir todos os valores clique em "Concluir". Será exibida novamente a tela de seleção

de ambientes com o ambiente novo cadastrado, selecione este e clique em "Concluir", conforme

imagem a seguir.


Modelo: Versão

Página 35 de 48

Neste momento o projeto de customização será criado e as bibliotecas e regras (caso existam)

serão baixadas para este projeto, conforme imagem a seguir.

Agora basta alterar ou criar as regras desejadas e publicar as alterações no servidor.


Modelo: Versão

Página 36 de 48

Para publicar as customizações clique com o botão direito sobre o projeto e selecione o item

Senior>Publicar, caso queira baixar novamente o ambiente do servidor, sobrescrevendo as

alterações locais clique em Senior>Atualizar, conforme imagem a seguir.

4.4. Instalação Manual do Gestão de Ponto

É possível fazer a instalação manual do gestão de ponto fazendo o deploy manualmente no

servidor de aplicação. O EAR do gestão de ponto fica localizado na pasta:

\senior\SeniorTools\environments\[nome do ambiente]\contexts\gestaoponto\gestaoponto.ear

Se for uma instalação é necessário executar os comando abaixo para criar as filas e tópicos da

aplicação gestão de ponto:

asadmin create-jms-resource --port <porta adm> --restype javax.jms.Queue jms/RONDAG6Queue


Modelo: Versão

Página 37 de 48

asadmin create-jms-resource --port <porta adm> --restype javax.jms.ConnectionFactory jms/RONDAG6ConnectionFactory

asadmin create-jms-resource --port <porta adm> --restype javax.jms.TopicConnectionFactory jms/SeniorTopicFactory

asadmin create-jms-resource --port <porta adm> --restype javax.jms.Topic jms/SeniorTopic

Após execução dos comandos sigo o procedimento do item 3.4.6, este procedimento configura

qual servidor jms o domínio do glassfish irá utilizar.

Após a criação das filas e configuração do servidor jms, siga os passos para completar o

deploy da aplicação:

entrar na pasta \glassfish3\glassfish do servidor a ser instalado

[se for atualização] favor o undeploy: bin\asadmin undeploy –-port <porta

administrativa> gestaoponto.ear

executar o comando: bin\asadmin deploy –-port <porta administrativa>

gestaoponto.ear

informe usuário e senha do administrador do glassfish se solicitado.

Caso seja uma atualização é necessário fazer o undeploy antes dos procedimentos acima.

5. Parametrização do Gestão do Ponto

Esse capítulo descreve as parametrizações necessárias para o funcionamento do Acerto G6.

5.1. Implantação

As configurações a seguir devem ser feitas apenas na implantação do sistema.

5.1.1. Configurações das Pendências do Acerto

O Gestão do Ponto permite configurar o controle das pendências de acerto através de uma tela

de configuração na G5.

5.1.2. Definir Regras de Apuração

As regras usadas pelo acerto G6 são definidas através da tela “Definições Apuração” do

Ronda G5, através da aba Regras G6.


Modelo: Versão

Página 38 de 48

5.1.3. Configurar Totalizadores

Para os totalizadores de situação ficarem visíveis na tela de acertos do gestor deve assinalar o

campo mostrar totalizadores na tela de Totalizador.

5.2. Parâmetros por "Onda"

A implantação do Gestão do Ponto será feita em ondas, as configurações a seguir devem ser

revistas/atualizadas a cada onda.

5.2.1. Permissão para perspectivas (telas) do Gestão do Ponto

As permissões de acesso as telas do Gestão do Ponto podem ser alteradas através da Central

de Segurança da G5 (Diversos > Usuários > Central de Segurança) na aba Perspectivas.

A tela de Gestores se chama "Acerto de ponto - Gestor" e a tela para os colaboradores

"Acerto de ponto - Colaborador".

O grupo de líderes deve possuir permissão paras as duas telas, conforme imagem abaixo:

O grupo de colaboradores deve possuir permissão apenas para a tela de " Acerto de ponto -

Colaborador", conforme imagem a seguir.


Modelo: Versão

Página 39 de 48

5.3. Customização de Relatórios

As telas de Acerto do gestor e colaborador permitem configurar links para relatórios do

sistema Gestão de Pessoas. O sistema utiliza os relatórios do Web 5.0.

Para mostrar os relatórios na tela o customizador precisar configurar dois arquivos:

O arquivo workset.repository serve para identificar qual é o arquivo de link que vai ser

utilizado. Segue o conteudo deste arquivo:

{ links : ["linksCustomSenior"] }

O outro arquivo deve ter a extensão “.link” e serve para configurar quais os relatórios que irão

ser apresentados nas telas de gestor e colaborador. Abaixo um exemplo de configuração de

relatórios no arquivo linksCustomSenior.link:

{ templates : [{ name : "template_periodo", type : "REPORT", params : [{ name : "dado_EDatInr", value : "${datIni}" }, { name : "dado_EDatFir", value : "${datFim}" }] }, { name : "template_periodo2", type : "REPORT", params : [{ name : "dado_EDatIni", value : "${datIni}" }, { name : "dado_EDatFim", value : "${datFim}" }] }], links : [{ // Relatório Apuração para Gestor name : "HRAP001.APU.GESTOR", template : "template_periodo", title : "Relatório de Apuração", tags : ["gestor"],


Modelo: Versão

Página 40 de 48

productName : "ronda", moduleName : "HR", resource : "HRAP001.APU", skipParamsScreen : false, params : [] }, { // Relatório Ocorrências TODOS name : "HRAU204.GER.TODOS", template : "template_periodo2", title : "Ocorrências na Apuração", tags : ["colaborador gestor"], productName : "ronda", moduleName : "HR", resource : "HRAU204.GER", skipParamsScreen : false, params : [] }]

}

O arquivo acima foi configurado para apresentar os relatórios HRAP001.APU e HRAU204.GER.

O primeiro será mostrado apenas na tela do gestor, pois foi identificado a tag ‘gestor’ na

configuração. Já o modelo HRAU204.GER será apresentado nas duas telas.

Segue algumas das principais propriedades utilizadas para montagem dos relatórios:

Propriedade Definição Obrigatório

name Define o identificador único do link, este não pode se repetir dentro do

arquivo. Sim

title Define o título do link que será utilizado para apresentação no menu do

sistema. Sim

resource

Depende do tipo do link, caso for URL deve ser informar a url completa

(Ex.: http://www.senior.com.br(. Caso for o tipo REPORT deve ser

informado o nome do relatório (Ex.: HRTA013.GER).

Sim

tags Lista das tags (etiquetas) associadas ao link, utilizadas para agrupar

links referentes a um mesmo assunto. Não

template

Template importado pelo link, as propriedades não declaradas no link

são lidas do template, com exceção dos parâmetros que são somados aos declarados no template.

Não

params Lista de parâmetros do link. Os parâmetros podem ter valores fixos ou

variáveis dinâmicas ("${nome_variavel}"). Não

productName Nome do produto onde o relatório desejado se encontra. Sim

moduleName Nome do modulo onde o relatório desejado se encontra. Sim

skipParamsScreen Define se a tela de entrada de parâmetros deve ser aberta caso algum parâmetro do relatório não seja informado.

Sim

Após a configuração dos arquivos e realizado o deploy através do SeniorDeveloper o resultado

é o link de relatórios visível na tela de acertos do Gestão de Ponto:

http://nqteste02/stdn62/Content/HON/FRC/camada_interface/area_trabalho/link/frc_configurar_links.htm#conf_temp


Modelo: Versão

Página 41 de 48

5.4. Customização de Notificação por Email

O Gestão de Ponto permite customizar os e-mail de notificação de pendências dos gestores e

colaboradores. Os e-mails são disparados através dos serviços de terceiros e podem ser agendados:

Nome do Serviço Descrição

gestaoponto.NotificacaoPendenciasAcerto Envia e-mail para o colaborador sinalizando a existência de pendências de ponto

gestaoponto.NotificacaoGestoresPonto Envia e-mail com o resumo de pedências que estão com o gestor, incluindo as dos seus liderados.

O agendamento dos serviços deve ser feito através de serviço de regras, onde a regra LSP

implementada deve chamar um dos dois serviços de terceiro citados na tabela acima. A

periodicidade de execução fica a critério do cliente.

O resultado da execução dos serviços é o envio de e-mail para os colaboradores com

pendências. O template padrão do serviço do gestor é baseado neste modelo:

Há pendência(s) de Acerto de Ponto de seu(s) liderados(s) referente ao período de dd/mm/aaaa à dd/mm/aa

Liderado(s) com pendência(s): 323 João 23323 Maria

A data limite para tratamento das pendências é dd/mm/aaaa

Para acessar as pendências clique aqui.

Observe os prazos para evitar impactos na folha de pagamento e oriente seu(s) liderado(s).

O template padrão do serviço dos colaboradores é baseado neste modelo:

Você possui pendência(s) de Acerto de Ponto referente ao período de dd/mm/aaaa à dd/mm/aaaa

Data da pendência Data limite

01/01/2013 05/01/2013

Para acessar as pendências clique aqui.

Observe os prazos para evitar impactos em sua folha de pagamento.

Para modificar o template padrão, o customizador utiliza o SeniorDeveloper implementa a

geração do email conforme sua necessidade criado uma classe Java Customizada. O customizador

pode reaproveitar recursos da implementação usando herança de classes. Abaixo segue os nomes

das classes para customização e implementação padrão de cada serviço:

Nome do Serviço Classe Java Customizada Classe Implementação Padrão


Modelo: Versão

Página 42 de 48

gestaoponto.NotificacaoPendenciasAcerto custom.DadosEmailGestorCustomizado DadosEmailLiderado

gestaoponto.NotificacaoGestoresPonto custom.DadosEmailLideradoCustomizado DadosEmailGestor

Após a construção das classes o customizador teria um estrutura de artefatos conforme

estrura abaixo:

A classe DadosEmailGestorCustomizado define qual o titulo do email, um arquivo template que

representa o corpo do email e uma implementação de como buscar o gestor e seus liderados. Se o

cliente utiliza rotina de chefias, não é necessário fazer a implementação da busca do liderado. Segue

abaixo um exemplo da classe implementada:

public class DadosEmailGestorCustomizado extends DadosEmailGestor { @Override public String getTitutloEmail() { return "Pendências acerto de ponto da empresa ABC"; } @Override public String getTemplateEmail() { return "custom/TemplateEmailLideradoSenior.vm"; } }

O template informado na classe é um arquivo texto/html que descreve como o corpo do e-

mail vai aparecer para o gestor. Segue um exemplo:

#macro(description $item) #pad($item.numcad) #end <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=Windows-1252"> <style type="text/css"> p{font-family: Verdana;font-size: 12px;color: #000000;font-weight: normal;} b.vermelho{font-family: Verdana;font-size: 12px;color: #FF0000;font-weight: bold;} td.subTitulo{font-family: Verdana;font-size: 12px; color: #000000;font-weight: bold;text-align: left;padding: 3px;height: 15px;} table{border-collapse: collapse;} table td{padding: 0px;border: 1px solid #FFFFFF;} td.dado {font-family: Verdana;font-size: 12px;color: #000000;font-weight: bold;text-align: left;padding-right: 5px;} </style> </head> <body> <p>Há pendência(s) de Acerto de Ponto de seu(s) liderados(s) referente ao período de <b>${itemEmailPendencia.dataIniciPeriodoPendente.toString("dd/MM/yyyy")}</b> à <b>${itemEmailPendencia.dataFimPeriodoPendente.toString("dd/MM/yyyy")}</b>.</p> <p>Liderado(s) com pendência(s): <p> <table width="500px"> #foreach($item in $itemEmailPendencia.pendencias) <tr> <td class="dado">$item.NumCad</td> <td class="dado">-</td> <td class="dado">$item.Nome</td> </tr> #end </table> <p>A data limite para tratamento das pendências é <b class="vermelho">${itemEmailPendencia.dataLimite.toString("dd/MM/yyyy")}</b>.</p>


Modelo: Versão

Página 43 de 48

<p>Para acessar as pendências <a href="https://www62.senior.com.br/g6-ronda/?perspective=com.senior.apuracao.acerto.sintetico.acertoPontoTotais" target="_parent" class="lnk">clique aqui.</a></p> <p>Observe os prazos para evitar impactos na folha de pagamento e oriente seu(s) liderado(s).</p> </body>

</html>

Algumas funções são utilizadas no template acima para obter as informações dinâmicas tais

como formatação de datas, dados dos colaboradores e estruturas de loops e condições. Maiores

detalhes da utilização da API podem ser obtidas neste link: http://velocity.apache.org/engine/devel/user-guide.html

A classe DadosEmailLideradoCustomizado segue a mesma lógica de implementação onde é

definido o titulo, corpo do email através de um template.

6. Configurar Workflow

6.1. Editar fluxo embarcado

A partir da versão 6.2.26, o fluxo do workflow AcertoPonto62 já vem embarcado na instalação,

sendo necessário apenas editar o servidor e porta do fluxo.

Para editar o processo embarcado no SeniorDeveloper, seguir os seguintes passos:

Ter um projeto customizado configurado previamente. Para mais detalhes ver o item 4.3.

Clicar com o botão direito do mouse dentro do Explorador de Pacote e selecionar a opção

Novo>Outras...

http://velocity.apache.org/engine/devel/user-guide.html


Modelo: Versão

Página 44 de 48

Selecionar a opção Senior>Processo Embarcado e clicar em Avançar.

Selecionar seu ambiente customizado e clicar em Ok.


Modelo: Versão

Página 45 de 48

Selecionar o processo embarcado e clicar em Concluir.

Abrir o arquivo processo.wpm. Nele está definido o fluxo do workflow.


Modelo: Versão

Página 46 de 48

Ajustar o caminho do servidor das seguintes caixas do fluxo:

Atualizar o status inicial (amarelo)

Atualizar o status (amarelo)

Atualizar o status (vermelho)

Atualizar o status (verde)

Atualizar o status final (verde)

Atualizar o status não permite encaminhar (amarelo)

Para alterar essa informação é necessário abrir a visão de Propriedades. Para abri-la, acessar Janela > Mostrar visão > Propriedades. Dentro da visão Propriedades, selecionar a guia execução. Agora é necessário alterar o host de onde está instalado o Gestão do Ponto. Ver imagem abaixo:

Salvar as alterações, clicar com o botão direito sobre o projeto e selecionar Senior>Publicar.


Modelo: Versão

Página 47 de 48

Após confirmar, o processo já irá fazer parte do sistema.

6.2. Configurar propriedades

No SeniorConfigCenter, adicionar as seguintea propriedades:

Propriedade contento o servidor do Workflow. É usada da tela de substituto do workflow. No

lugar do “ServidorWorkflow”, informar o nome do servidor onde foi instalado o workflow. No lugar

da “Porta”, informa a porta onde está rodando o workflow.

com.senior.workflow.url=http://<ServidorWorkflow>:<Porta>

6.3. Configurar fluxo no sistema

Para o sistema considerar o fluxo publicado no cockpit, é necessário informar o seu nome no Ronda

G5 em Cálculo > Apuração > Definições > Gerais. Informar no campo Nome do fluxo o valor

AcertoPontoG6, conforme a seguinte imagem:


Modelo: Versão

Página 48 de 48

6.4. Definir criptografia

Existe a necessidade de habilitar o logon integrado com criptografia no SeniorConfigCenter. A

chave deve ser a 3950:

7. Configurar Gestão do ponto no Portal

Para acessar as telas do Gestão do ponto a partir do Portal, deve ser configurado o link

conforme abaixo:

<servidor do portal>/SLoginPortlet/g6generic?g6context=<servidor do gestão do ponto>/<contexto da

instalação do gestão do ponto>&g6path=/?perspective=<caminho da tela que será aberta>

Exemplo:

https://www2.senior.com.br/SLoginPortlet/g6generic?g6context=https://www62.senior.com.br/gestaoponto/

&g6path=/?perspective=com.senior.apuracao.acerto.sintetico.acertoColaboradorSinteticoWF

Neste exemplo, foi feito o link para acessar a tela de acerto do colaborador.

https://www2.senior.com.br/SLoginPortlet/g6generic?g6context=https://www62.senior.com.br/gestaoponto/&g6path=/?perspective=com.senior.apuracao.acerto.sintetico.acertoColaboradorSinteticoWF

https://www2.senior.com.br/SLoginPortlet/g6generic?g6context=https://www62.senior.com.br/gestaoponto/&g6path=/?perspective=com.senior.apuracao.acerto.sintetico.acertoColaboradorSinteticoWF

manual para implantaÇÃo do gestÃo do …€¦ · para configurar o openmq como serviço do...

Documents