TWT Info

Esse manual tem como objetivo auxiliar os colaboradores internos da TWT quanto a análise e manuseio de planilhas dinâmicas.

Não é aconselhável enviar este manual para os clientes, pois ele contêm senhas e procedimentos que precisam ser realizados pelos colaboradores da TWT.  

1. CONFIGURAR CONEXÃO COM BANCO DE DADOS
   1. Em novas Planilhas

As novas planilhas desenvolvidas possuem o botão “Configurar” na primeira aba da planilha (geralmente é a aba “Índice” ou “Início”). Para configurar o apontamento da planilha com o servidor de banco de dados, basta clicar no botão “Configurar Servidor” e informar os dados de conexão.

• Preencha o campo “IP ou nome do servidor” com os dados de acesso ao servidor de banco de dados. Se tiver dúvidas, coloque o mesmo apontamento do Advwin (arquivo DB.ADV).
• Preencha o campo “Base de Dados” com o nome da base de dados que a planilha deverá ser atualizada (geralmente é a base Advwin).

Geralmente as planilhas antigas não possuem o botão “Configurar Servidor” ou um local para informar os dados de conexão com o servidor de banco de dados. Para realizar a configuração do servidor, vá na aba “Índice” > clique com o botão direito dou mouse sobre o botão “Atualizar” > clique em “Atribuir Macro”.

Será aberto uma janela semelhante a imagem abaixo. Clique em “Editar”

Será solicitado uma senha para visualizar a macro. Tente a senha do usuário SIX ou “Twt2knet”.

Localize na macro onde está sendo definido a conexão com o servidor de banco de dados. Altere as informações necessárias.

Após alterações, clique no menu “Arquivo” > “Fechar e voltar para Microsoft Excel”. Salve e atualize a planilha.

As planilhas dinâmicas permitem que o usuário selecione quais colunas, filtros, linhas e etc devem ser apresentadas, por meio da lista de campos.

Para ver os campos disponíveis, clique com botão direito do mouse em algum dado da planilha dinâmica > clique em “Mostrar Lista de Campos”.

Será apresentado os campos disponíveis na planilha dinâmica. É possível definir quais campos serão filtrados, quais campos precisam ser somados, o que será linha, coluna e etc.   Para isso, basta arrastar os campos para as áreas desejadas.

Obs: Os campos apresentados na “Lista de Campos” são apresentados de acordo com a aba “Dados” (esta aba será explicada no tópico 5 deste manual). 

As abas dinâmicas da planilha são vinculadas a alguma outra aba que possui conexão com o banco de dados para execução da procedure, view ou select.

Para identificar a qual aba a dinâmica está vinculada, clique em algum dado da aba dinâmica > clique em “Analisar”  

Clique em “Alterar Fonte de Dados”.

O Excel direcionará automaticamente para a aba que está vinculada a aba dinâmica (geralmente é a aba Dados).

Aba Dados é a aba “Mãe”, ou seja, ela que possui a conexão com o banco de dados e faz a execução da procedure para atualização de toda a planilha dinâmica. Caso esta aba seja excluída ou tenha o nome alterado, a planilha irá apresentar erros ao ser atualizada.  Por este motivo que geralmente esta aba fica oculta, para que não corra o risco dos usuários alterarem.

Uma planilha pode ter várias abas “Dados” (com nome diferente, claro), ou seja, várias abas com conexão com o banco de dados, executando diferentes procedures.  

As colunas apresentadas na aba “Dados” são originárias da procedure. Em alguns casos pode ter colunas que não foram definidas na procedure (como colunas com fórmulas específicas). Mas a maioria das colunas desta aba são originárias da procedure.

Para visualizar todas as conexões com o banco que a planilha possui, clique na guia “Dados” > “Consulta e Conexões”

Será aberto um menu lateral no lado esquerdo da tela, apresentando todas as conexões que a planilha possui. Dê dois cliques sobre alguma conexão.

Uma nova janela será aberta. Vá na aba “Definição” > no campo “Texto do Comando” será exibido o nome da procedure e os parâmetros de pesquisa que estão sendo usados na executados.

Caso queira ver a procedure de uma “Dados” específica, pode ser feito de duas maneiras:

Vá na aba “Dados” > clique com botão direito do mouse em cima dos dados dentro desta aba > clique em “Tabela” > “Editar Consulta”.

Clique em “Ok”.

Clique no botão “SQL”. Uma nova janela será aberta, exibindo a procedure e parâmetros que estão sendo executados.

Vá na aba “Dados” > clique na guia “Dados” do Excel > “Consultas e Conexões”. O menu lateral irá abrir destacando qual a conexão com o banco de dados. Daí é só dar dois cliques sobre a conexão > clicar na aba “Definição” > localizar procedure e parâmetros no campo “Texto do Comando” (conforme explicado no início deste tópico 5).

Caso queira visualizar a procedure que está vinculada a aba “Dados”, acesse o banco de dados > clique na base de dados em que a planilha foi atualizada > expanda a guia “Programação” > expanda a guia “Procedimentos Armazenados”.

Localize a procedure > clique com botão direito do mouse sobre a procedure > clique em “Modificar”.

Exibição da procedure, com todos os campos, cálculos, parâmetros de pesquisa e condições.

Ao atualizar a planilha, podem ocorrer erros, conforme imagem abaixo. Estes erros são genéricos, não dá pra saber qual o real motivo do erro por esta tela.

Só é possível identificar o real motivo do erro, se o botão “Depurar” estiver habilitado. Quando o botão estiver desabilitado igual a imagem acima, clique em “Fim” > volte na aba “Índice” > clique sobre o botão “Atualizar” > vá em “Atribuir Macro”.

Clique em “Editar Consulta”

Digite a senha da macro. Geralmente é a senha do usuário six ou “Twt2knet”.

Vá no menu “Arquivo” > Fechar e voltar para Microsoft Excel”

Atualize a planilha novamente. Desta vez o botão “Depurar” está habilitado.

Neste exemplo, o nome da aba “Dados” foi alterado para “Dados_Teste”.  

Quando a atualização da planilha for realizada, o erro genérico será apresentado (tela apresentada no início deste tópico).

Para analisar o erro, é preciso clicar no botão “Depurar” (item 7.1). O Excel destacou que a aba “Dados” não foi encontrada (pode ser que ela foi excluída ou teve seu nome alterado).

Solução: Voltar o nome da aba “Dados_Teste” para “Dados”, ou alterar na macro, onde estiver “Dados” para o novo nome da aba.  Caso a aba tenha sido excluída, é preciso cria-la novamente com a conexão correta ou enviar a planilha original para o cliente.

Neste outro exemplo, ao clicar em “Depurar”, o Excel destacou a linha “Refresh False”. Com este erro, não é possível saber ainda qual o real problema.  

Para identificar a causa do erro, clique em “Arquivo” > Voltar para Microsoft Excel .

O Excel irá direcionar automaticamente para a aba que está com problemas. Neste caso, é a aba “Dados”.

Após localizar a aba com problemas, clique com o botão direito sobre alguma informação da planilha > clique em “Tabela” > “Editar Consulta”.

Clique em “Ok”.

O real motivo do erro é que a procedure não foi localizada no banco de dados em que a planilha foi atualizada.

Solução: Criar a procedure na base do cliente.

Assim como o item 7.3 (Exemplo 2 – Procedure não localizada), o excel destacou a linha “Refresh False”.

Clique em “Arquivo” > Voltar para Microsoft Excel .

Novamente a aba com problemas é a aba “Dados”. Clique em “Tabela” > “Editar Consulta” (ver item 7.3). O erro apresentado foi de conversão de data/hora.

Geralmente este erro pode ser causado por 3 motivos:

Para conferir o formato de datas que o Excel está executando, após o erro da imagem acima, clique em “Ok”. Daí clique no botão “SQL”. Será exibido o formato de datas que está sendo usado.

Neste caso, o filtro de datas era 20/09/2018 a 28/09/2018. Mas como o Excel está usando o formato de mm/dd/aaaa, a execução da procedure está como 09/20/2018 e 09/28/2018. Como não existe mês maior que 12, o Excel apresenta erro de conversão.

Solução 1:  Vá na aba “Índice” > clique em “Configurar Servidor” > clique em “Padrão de Datas”.

Digite o usuário e senha do “Six” > altere o formato de datas. Se estiver como dd/mm/aaaa altere para mm/dd/aaaa e vice-versa.

Atualize a planilha novamente e verifique se o problema foi resolvido.

Solução 2: Em alguns casos, o problema de conversão de data/hora pode estar relacionado a versão do Excel que o usuário se encontra.

Abra a macro (clique com botão direito do mouse sobre o botão “Atualizar” > “Atribuir Macro” > clique em “Editar” > coloque a senha da macro).  No final da macro, confira se a linha destaca abaixo existe. Caso não, inclua a linha e tente atualizar a planilha novamente.

1. Algum problema na conversão de data/hora na procedure
2. Algum dado (Ft, debite, cpr e etc) que estão com data/hora inválidos.

Para os motivos 2 e 3 será preciso analisar com o setor de BD o motivo do erro.

Este documento contém informações confidenciais e/ou privilegiadas e é de propriedade de Grupo TWT Info. Se você não for o destinatário ou a pessoa autorizada a receber este documento, não deve usá-lo, copiá-lo ou divulgar as informações nele contidas ou tomar qualquer ação baseada nessas informações.