Serviço de Comunicação REP
- Introdução
- Instalação do Serviço no cliente
- Painel de Controle do Serviço REP
- Processo de Coletas
- Instalação Microsoft .NET
1. Introdução
O ServicoRep é composto por dois ambientes – Cliente e Flow – e tem a função de fazer a comunicação entre os dois. Este serviço está disponível para os coletores Control Id, Dimep ou através de arquivos padrão AFD.
Para executar o procedimento de Instalação, clique aqui para realizar o donwload do pacote.
1.1. Cliente
Neste ambiente roda o ServiçoREP propriamente dito. É neste ambiente que são realizadas as Coletas das Marcações, o Envio de Funcionários para os REPS.
Existe ainda, neste ambiente, a rotina “PainelDeControleDoServicoRep.exe” que fica permanentemente ativa no Gerenciador de Tarefas fazendo o Leva & Trás de informações entre os dois ambientes.
O que é necessário existir neste ambiente?
- SQL Server Management Studio instalado no servidor local e disponibilizado acesso. É de responsabilidade do Cliente deixar o ambiente com os recursos necessários;
- Criação do Banco ServicoRep que obrigatóriamente deve ser criado no Microsoft SQL Server que é de responsabilidade do Cliente deixar o ambiente com os recursos necessários;
- Computador com memória RAM de 4 GB disponível;
- Microsoft ASP.Net Framework 4.5 ou superior;
- Criar Site no IIS local aonde será instalado o ServiçoRep. Como padrão utiliza C:\Meta\ServicoRep
- Devart instalado Versão 6.30 ou superior. Para download clique aqui.
- Poderá existir VPN dependendo do cliente para comunicação com REPs fora da rede de instalação do Serviço REP;
2. Instalação do Serviço no cliente
Crie um novo site no IIS para o Serviço REP que será instalado, informando o local onde deverá ser instalado.
2.1. Passos para criação do site
- Criar a pasta C:\meta
- Descompactar o pacote de instalação em uma pasta qualquer e copiar a pasta WebServiceREP existente no diretorio que foi descompactado o arquivo para C:\meta\
- Renomear a pasta C:\meta\WebServiceREP para ServicoREP
- Aperte as teclas Win + R.
- No atalho para executar, digite INETMGR e clique no botão Ok.
- Abrir as subpastas conforme prints abaixo.
- Para instalar o novo Site, clique com botão direito do Mouse posicionando sobre Default Web Site e escolha a opção Adicionar Aplicativo conforme demonstra o Print a seguir.
- No campo Alias, informe: ServicoRep
- No caminho Físico, informe: c:\Meta\servicorep. Se a pasta ServicoRep ainda não existir, deve-se criar
Para obter informações avançadas, clique com botão direito sobre o novo site criado (ServicoRep), escolha Configurações Avançadas.
Importante! É necessário observar no IIS a Delegação de Recursos. Todos devem estar com opção de Leitura/Gravação.
2.2. Iniciando processo de Instalação
Para fazer a instalação do serviço no cliente, deverá ser utilizado o instalador que está dentro da pasta descompactada do pacote do Serviço.
2.3. Executando o instalador
- Certifique-se que a pasta C:\Meta\ServicoRep existe e está com os arquivos dentro;
- Certifique-se que o banco ServicoREP esteja em branco ou vazio;
- Clique sobre o executável e com botão Direito, escolha a opção Executar como administrador;
Atenção! No ambiente do cliente, o item Instalação do Serviço Rep no destino (ambiente SaaS) deverá ficar desmarcado.
2.4. Configurar a conexão com o Banco de Dados local
Para buscas as informações necessárias para conexão, acessar o IIS do servidor Cliente.
Banco: Obrigatoriamente SQL Server;
Servidor: Nome do servidor ande foi instalado o ServiçoRep;
Base: ServicoRep;
Usuário e senha.
O ServicoRep permite inclusão de mais de uma conexão ( servidores diferentes). Para cada conexão, deve-se identificar um usuário e uma senha.
Atenção! Estas informações (usuário e senha) serão utilizadas no Módulo de Frequência ao configurar Web Service conforme sessão.
E na sequência a finalização do processo de instalação, se aparecer erros (assinalados em Vermelho) devem ser sanados e repetir o processo.
Atenção! Se por algum motivo qualquer for executado mais de uma vez o processo de instalação, ao término vai aparece erro como este do exemplo a seguir.
Para resolver a situação deve-se renomear ou deletar o arquivo que está em:
Meta\ServicoREP\Migracoes\Conecctionstrings.config
2.4. Publicação para Acesso Externo ao Serviço REP
Após finalizar a instalação do Serviço REP no ambiente do cliente, solicitar para que o TI do cliente realize a publicação DNS ou criação de regra NAT redirecionando para o IP e Porta do Servidor que foi instalado o Serviço REP.
Atenção! Solicite ao TI do cliente que por segurança deve restringir que somente os IPs 177.69.6.225 e 8.243.45.218 devem conseguir se conectar na porta que será liberada para acesso ao Serviço REP.
Também solicite a um analista de desenvolvimento da Metadados que realize a Instalação do Serviço REP no ambiente Flow. Assim que o mesmo concluir deverá lhe informar o link de acesso para configuração no Frequência.
2.4. Testando Comunicação do Web Service
Para testar a comunicação entre os Web Services basta copiar as URLs e colar em um browser. Todas deverão responder conforme exemplo abaixo.
Deverá aparecer as seguintes informações:
Clicando em TestarConexão irá retornar:
Clique em Invoke. Retornado True significa que a comunicação está ok.
Após concluir os testes de Acessos aos links disponibilizados nos dois ambentes. Você deve proceder com mais duas etapas:
3. Painel de Controle do Serviço REP
No ambiente do cliente, na pasta do ServiçoREP, terá o executável do Painel de Controle chamado PainelDeControleDoServicoRep.exe.
O Painel de Controle do Serviço REP possui as seguintes funcionalidades e devem ser testadas.
-
Testar Comunicação: Funcionalidade disponível para testar a comunicação entre os Web Services.
-
Sincronizar Configurações: Essa opção busca todos os REPs cadastrados no Metadados e insere no Banco de Dados local. É necessário fazer a sincronização para ter os equipamentos cadastrados na base local.
- Status do Coletor: Opção para retornar o Status do Coletor.
- Coletar Marcações: As coletas poderão ser feitas por Pendentes ou por Data.
Os processos efetuados serão exibidos no grid logo abaixo. Logs mais completos são gerados na pasta onde o serviço foi instalado.
Atenção! O Painel de Controle do Serviço REP deverá ficar sempre aberto. Caso seja finalizado os processos não serão executados.
3.1. Agendamento de Tarefas
Na guia Agendamento de Tarefas é possível programar os horários para as coletas de marcações
Sempre serão coletadas as marcações PENDENTES.
Adicionar um coletor de cada vez com intervalo de um minuto. O processo de coleta é realizado um coletor de cada vez e só inicia a coleta do próximo quando terminar o que estava sendo executado.
3.2. Configurações Painel de Controle - Cliente
Na guia Configurações é possível visualizar as configurações que foram cadastradas no Metadados e sincronizadas com o Painel de Controle do Serviço REP.
Se utilizar coletas via arquivo padrão AFD, informar o caminho/nome do arquivo.
Todos os processos executados pelo Painel de Controle do Serviço REP são logados no arquivo PainelDeControleDoServicoRep.log localizado na pasta de instalação do Serviço.
Na pasta ServicoRep executar o aplicativo ColetorREPConexaoCriptografia.exe:
- Usuário: Informar o usuário do ServicoRep;
- Senha: Senha do ServicoRep;
- Servidor: Nome do servidor ServicoRep.
Observação: São as mesmas informações contidas no MDE.
Para executar, clicar em Gerar Arquivo. Na sequência, gravar em C:\Meta\servicoREP
Em que situações deve-se executar este programa?
- No processo de instalação;
- Em caso de alteração da senha do banco de dados;
- Em caso de alteração da criptografia.
ColetorREPConexaoCriptografia.exe
3.3. Como transformar o aplicativo em um Serviço Windows
Para tornar o aplicativo em Serviço Windows é necessário:
- Copiar o arquivo ServicoPainelControleREP.exe para pasta ServicoRep;
- Copiar o arquivo ServicoPainelControleREP.exe.config para pasta ServiçoREP;
- Marque a opção conforme exemplo a seguir;
- Salve;
- Depois de salvo, o serviço começará a executar automaticamente.
Indicativo que o Serviço Windows está em execução. Neste caso, o painel de controle pode ser fechado.
Indicativo que o Serviço Windows está parado.
Observação:
- Este serviço não pode ser iniciado diretamente na tela do Serviço do Windows a não ser que tenha sido parado.
- Ao alterar de Serviço para Aplicação, o serviço que roda no Windows será automaticamente parado.
3.4. Última coleta realizada
Na hipótese dos coletores já estarem sendo utilizados pelo processo tradicional, então neste caso será necessário incluir um registro para cada coletor na tabela RHULTCOLETAREP porque esta tabela não faz parte do processo de sincronização.
4. Processo de coletas
O ServicoRep está disponível para coletas dos Modelos Dimep, Control Id e Arquivo AFD. No entanto, não é possível na mesma Tarefa “misturar” coletas por Arquivos com coletas por REPs.
4.1. Coletas através de arquivos padrão AFD
A extensão dos arquivos a serem importados, é .TXT. Após a importação, o sistema renomeia o arquivo atribuindo um numero sequencia de forma que o mesmo arquivo não seja importado outras vezes.
Quais informações são validadas para importação?
- Tipo Registro: Obrigatoriamente todo arquivo deve conter o registro tipo 1;
- Número de fabricação do REP: Obrigatoriamente deve existir um REP cadastrado na tabela de coletores para cada variação existente;
- Data de Início: A data deve estar no formato dd/mm/aaaa;
- Data de Término: A data deve estar no formato dd/mm/aaaa.
4.2. Estrutura de Pastas
Ao utilizar modalidade de coleta por Arquivos, o sistema automaticamente direciona os arquivos processados em pastas deixando o diretório principal sempre Limpo. São duas pastas, uma para importações com sucesso e outra com arquivos que apresentaram algum erro. Estes devem ser corrigidos e remanejados para a pasta principal novamente a fim que sejam processados novamente.
- Pasta principal de importação dos arquivos AFD
- Pasta Arquivos Importados com sucesso
- Serão removidos para pasta PROCESSADOS
- Subpasta formato AAAA_MM
- Pasta Arquivos NÃO Importados
- Serão removidos para pasta COM_ERROS
- Subpasta formato AAAA_MM
4.3. Exibindo coletores padrão AFD
No Painel de Controle aparece apenas a informação 0000 – Arquivos AFD. Isso porque não é possível selecionar um ou mais coletores padrão AFD. O sistema importará TODOS os arquivos que estiverem na pasta padrão de importação independentemente do coletor.
Agora, se você desejar saber quais são os coletores AFD existentes, basta posicionar o cursor na sessão coletores e clicar com botão direito do mouse. Esta operação vai exibir todos coletores cadastrados modelo WS.
4.4. Consulta aos Logs
5. Como instalar o Microsoft .NET Framework
A Versão do DotNet Framework deverá ser 4.7 ou superior.
Passos para instalação
- Executar o programa dotnet_47.exe;
- Escolha a opção conforme ilustração abaixo.
- Ao clicar na opção conforme representado na imagem anterior, o sistema vai fazer download do aplicativo ndp48-web.exe para pasta Download. Se necessário, escolha outra pasta;
- Na sequência deverá aparece a tela conforme exemplo a seguir. Executar opção Instalar.
- Após a instalação você poderá verificar na pasta C:\Windows\Microsoft.NET\Framework64 deverá aparecer algo parecido com esta imagem.
5.1. Como criar Banco ServicoREP
Para criar o banco ServiçoREP siga os passos a seguir:
- Abrir o Microsoft SQL Server Management Studio conforme exemplo abaixo;
- Na pasta Banco de Dados, clique com botão direito do mouse;
- Escolher opção Novo Banco de Dados;
- Informar o nome, como padrão, ServicoREP;
- Confirmar a criação clicando em OK.
Criação do Novo Banco de Dados