CONTEÚDO
- Visão Geral
- Arquitetura
- Instalação ambiente Matriz
- Instalação ambiente Filial
- Plug-in CDD Manager
01. VISÃO GERAL
O Concentrador de Dados Distribuídos - CDD é uma aplicação, responsável por disponibilizar o serviço Web Service, para envio e recebimento de informações entre filial e matriz.
02. Arquitetura
A arquitetura da aplicação, se divide no ambiente Servidor ( Matriz ) e Cliente ( Filiais ).
No ambiente Matriz temos as seguintes aplicações:
- Banco de dados MongoDB: usado para armazenar os scripts da logTransmissao.
- Plugin Robot: Ele ficará automaticamente rodando no servidor lendo os dados da tabela LOGTRANSMISSAO, montando os scripts e gravando na base mongo. Com isso a tarefa da API ficará menos sobrecarregada não precisando ir a base de dados central nem montar os scripts quando requisitada, pois o serviço de mensageria já terá tratado dessa tarefa.
- API CDD: Fará a leitura dos scripts no MongoDB para entregá-los as filiais. Quando a Filial enviar dados de Hóspedes para a Central, esses serão processados diretamente na base de dados central.
- Hotal Monitor: Serviço encarregado de monitorar a API CDD e o Plugin Robot. Caso algum desses serviços saia do ar, o Monitor se encarregará de iniciá-lo novamente.
No ambiente Filial temos as seguintes aplicações:
- Plugin Robot: ficará consultando na API CDD os dados a serem processadas para a filial parametrizada e também enviando para a Matriz os seus dados para serem replicados.
- Hotal Monitor: Serviço encarregado de monitorar o Plugin Robot. Caso o Plugin Robot saia do ar, o Monitor se encarregará de iniciá-lo novamente.
03. INSTALAÇÃO AMBIENTE MATRIZ
A Instalação deverá ser feita no ambiente Matriz.
1 - INSTALAÇÃO API CDD
Importante que o executável "WSPluginCDD.exe" seja configurado para executar como Admnistrador.
Ao executar o Plug-in, são necessárias as configurações:
Porta do Serviço (Essa porta deve ser alinhada com o responsável da Rede e deve ficar aberta na internet).
Gerenciador de Conexão (Parâmetros de conexão com o banco de dados. No caso da API do CDD o usuário e senha do Sistema não são necessários. Por padrão a API se conecta pelo usuário CMCENTRALIZA.
Os campos de Conta e Senha do Windows não são necessários.
Após realizar a configuração, clique no botão "Conectar", para salvar as configurações.
Clique no botão "Instalar".
O sistema criará o serviço Hotal WSPlugin CDD Service.
Nesse momento, a API já estará pronta para ser iniciada como Serviço de Windows e a aplicação poderá ser finalizada. O Nome do Serviço na lista é Hotal WSPlugin CDD Service.
Com o serviço iniciado, teste a seguinte url no browser: http://localhost:211/wsplugincdd/hotal-api/transmissao/test
A API deverá retornar com o status = "Em Execução".
2 - Instalação MongoDB v4.2
Link para Download: https://fastdl.mongodb.org/win32/mongodb-win32-x86_64-2012plus-4.2.5-signed.msi
A Instalação pode ser padrão, atento apenas para a tela MongoDB Compass, onde deve ser desmarcada a opção Install MongoDB Compass.
3 - Instalação e configuração do Plugin Robot.
A Instalação do Plugin Robot, junto com a instalação do Hotal Monitor, podem ser conferidas no link a seguir Plug-In - Robô.
Na Matriz, o Robot executa 3 tarefas: CDD Mensageria, CDD Mensageria Filiais Ociosas, CDD Mensageia Status Atual.
- CDD Mensageria: faz a leitura da tabela LOGTRANSMISSAO, processa os dados e insere na base MongoDB, limpando a base da Matriz.
- CDD Mensageria Filiais Ociosas: Envia por email quais filiais não fazem sincronismo a mais de 2 horas.
- CDD Mensageria Status Atual: Envia por email o status Atual do CDD. Informa pra cada filial, qual foi o ultimo sincronismo, quantos registros pendentes e quantos erros.
A configuração deve estar de acordo com a imagem abaixo.
- Configuração do CDD Mensageria no PluginRobot.ini
- Configuração do CDD Mensageria Filiais Ociosas no PluginRobot.ini
- Configuração do CDD Mensageria Status Atual no PluginRobot.ini
04. INSTALAÇÃO AMBIENTE FILIAL
1 - Instalação e configuração do Plugin Robot
A Instalação do Plugin Robot, junto com a instalação do Hotal Monitor, podem ser conferidas no link a seguir Plug-In - Robô.
No Arquivo de configuração do Robot devem estar configurados os seguintes campos:
- api: endereço e porta da api no ambiente matriz. (Ex.: http://localhost:211/)
- empresas: id da filial e seu respectivo schema. (Ex.: idEmpresa: 72, schema: IT)
A configuração deve estar parecida com a imagem abaixo:
05. PLUGIN CDD MANAGER
Responsável pelo monitoramento de informações pendentes de processamento e as que deverão ser enviadas para as Filiais.
Aba "Pendentes"
Informações que foram recebidas pelas filiais e ocorreram erro na execução.
Aba "Em Processamento"
Informações que estão disponíveis para serem processadas.
Aba "Últimos Processamentos"
Verificação da última execução do CDD nas empresas filiais.
Após a instalação da API Hotal WSPlugin CDD Service, o Plug-in Robô deverá ser instalado nas filiais.