Desenvolvimento Millen-30330 – Ajustar Counters – Nova Versão do Programa
Release 104
Versão 5
Autor Jaciara Silva
Motivação
Para tornar mais rápido e simples o atendimento dos clientes do e-Millennium, foi desenvolvida uma nova versão do programa de ajuste para Counters.
Agora a ferramenta já faz o select no banco de ajusta automaticamente o valor, sem que ele tenha que acessar o banco de fazer um select. Antes o analista tinha que localizar qual o número correto no banco de dados, para descobrir o valor a colocar no Counters.
Esta ferramenta será utilizada para ajustar os contadores do sistema. Caso o sistema utilize o arquivo de contadores, o arquivo será atualizado. Caso o sistema já utilize a tabela, ela será atualizada (consequentemente o broker sobe e atualiza o arquivo quando necessário também).
Por padrão esta ferramenta estará configurada para vir na instalação base do sistema (sem necessidade de instalar nenhum módulo), conforme arquivos abaixo:
Parâmetros
Para versões anteriores a 5.103, instalar o módulo millenium!counters.minst. Para informações sobre como fazer a instalação de módulos no e-Millennium acesse o Manual de instalação de módulos no e-Millennium.
Entradas
Após a instalação do módulo, verifique na pasta wts se foram ciados os arquivos:
- Counters.nsulocal
- Counters.DePara
- millenium!counters.wts
- millennium_counters.dll
- nsuman.exe
Como utilizar a ferramenta
- Tire o broker do ar, caso contrário será emitida uma mensagem de alerta, solicitante que ele seja desativado;
- Rodar o executável nsuman.exe;
- Acione o botão Ajustar Contadores, que fará tudo automaticamente. O próprio nsuman.exe subirá o serviço do broker, para poder acessar o método da dll/wts do Server e obter as tabelas para atualizar os contadores.
Em c:wts\trace, faça uma consulta e verifique que foi criado um log referente à atualização.
Como a atualização ocorre
- Ele irá buscar no diretório raiz o arquivo Counters.DePara. (Caso não encontre, será emitida uma mensagem de alerta, uma vez que o arquivo é obrigatório para a execução do processo.)
- Encontrando o arquivo Counters.DePara, será aberta a janela para preenchimento.
Este arquivo vai servir para configurar as tabelas que estão com suas nomenclaturas fora do padrão.
Por exemplo: Tabelas com a estrutura com o nome no plural e a chave no singular serão encontradas, como abaixo:
Tabela PRODUTOS, chave primária PRODUTO
Então, será aplicado o tratamento no nome da tabela, removendo o plural para tentar encontrar sua chave.
Para aquelas que fugirem deste padrão, serão adicionadas no arquivo "depara", como abaixo:
Tabela PEDIDO_VENDA e sua chave é PEDIDOV
Esta deve estar no arquivo "depara", a fim de ser verificado seu contador e para que seja atualizada.
Alguns exemplos:
O nsuman.exe vai funcionar da seguinte maneira:
1 - Obtemos uma listagem de todas as tabelas da base, para descobrir qual o tipo do banco de dados consultamos pelo wtsdatasources no dbtype.
2 - Vamos rodar em todas as tabelas removendo os plurais (S, ES, OES), fazendo um select max neste resultado. Exemplos:
Tabela PRODUTOS, tratamos para PRODUTO e testamos para ver se existe este campo como chave primaria (SELECT MAX(PRODUTO) FROM PRODUTOS)
Se retornar um número maior que 1 para o campo PRODUTO, atualizamos este contador, caso exista no arquivo, ou na tabela WTSSYS_COUNTERS. Mesmo que não exista esta chave, faremos um INSERT (Apenas na tabela).
E uma segunda tentativa, vamos colocar o prefixo de COD_ + nome sem plural, como exemplo : COD_PRODUTO e verificar da mesma maneira se existe. Para atualizar ou inserir(apenas na tabela).
Atualização para o sistema que utiliza arquivo counter.nsulocal
Validações e Saídas
Atualização da tabela ou do arquivo, quando o sistema identificar divergência entre os nomes das tabelas e campos.