WecDB - Latromi

WecDB
WecDB – Consulta Web Facilitada ao Banco de Dados
-1-
WecDB (Web Easy Consultation Database) é uma ferramenta para criação e disponibilização de
consultas à Bancos de Dados na Internet. É composto principalmente por dois projetos:
WecDB Client e WecDB Web. O primeiro deles é uma aplicação Desktop onde são
centralizados os cadastros e as principais configurações da ferramenta, e o segundo é um
Portal WEB onde as consultas serão exbidas, mediante LOGIN.
Primeiro Acesso ao Sistema
O primeiro acesso deve ser realizado pelo aplicativo Desktop, pois é nele onde serão
realizadas as configurações fundamentais para o funcionamento do programa.
Ao realizar o primeiro acesso, será exibidada a mensagem abaixo, e logo em seguinda, será
aberta a tela para que seja definida a Origem dos Dados de Usuário (Conexão de Segurança).
Na tela de Configurações de Segurança são necessárias 3 configurações:
WecDB
1 – Informar o Comando SQL para buscar os dados de Usuário
2 – Informar os Dados de Conexão com o banco de Dados.
-2-
WecDB
-3-
3 – Configurar o relacionamento entre as colunas da Query informada e os campos de usuário
utilizados pelo sistema.
Após realizar a configuração da Conexão de Segurança, o usuário será automaticamente
redirecionado para a tela de Login.
WecDB
-4-
Tela Principal
Esta é a tela principal do WecDB Client. É nela onde é realizada a manutenção de todas as
consultas, o que torna a inteface do sistema extramente pratica de se usar.
Cabeçalho da Consulta
No topo da tela, ao centro, está localizado o quadro com as informações do cabeçalho da
consulta.
Sequência: Este campo é gerado automaticamente ao gravar uma consulta, por tanto, não é
permitido que seja manipulado.
Privacidade: Este campo será Privado para consultas criadas por usuários de perfil ROOT ou
MASTER e Público para os demais usuários.
Descrição: Descrição da consulta que está sendo cadastrada.
WecDB
-5-
Parâmetros
No canto superior direito (Layout Padrão) ficam os Cadastros de Parâmetros, Constantes e
Restrições. Os Parâmetros são utilizados como filtro para a consultas. São campos que serão
preenchidos pelo usuário na interface WEB para filtrar os resultados.
Nome: Nome do Parâmetro, sem espaço ou caracteres especiais
Descrição do Parâmetro: É a descrição que será exibida a esquerda do parâmetro na interface
WEB.
Tipo: Os parâmetros podem ser dos tipo Numério, Alfanumérico, Data, Caixa de Opções e
Lookup.
Preenchimento Obrigatório: Se marcado, o preenchimento do parâmetro será obrigatório, e a
consulta não será executada até que o mesmo seja preenchido.
WecDB
-6-
Queries
No canto superior esquerdo (Layout Padrão) fica o cadastro de Queries, peça fundamental na
construção das Consultas. O resultado da query é o que será exibido na interface WEB.
No topo da tela são o informados o nome e a descrição da consulta. A direita temos os
Parâmetros, Constantes e Dados de Sessão para utilizar na Construção da Query. Ao centro,
está o campo onde o comando SQL deve ser escrito.
Para utilizar os Parâmetros, Constantes ou Dados de Sessão, basta selecionar a informação
desejada e dar um duplo clique. Uma marcação será inserida na query indicando qual
informação deve ser substituida antes da execução da query.
Por exemplo “{?PARAM pDataInicial}” vai ser substituído pelo valor informado no Parâmetro
de Data Incial da Interface WEB
WecDB
-7-
Na aba conexões deve ser informodos os dados de conexão com o banco de dados. São aceitas
conecões com PostgreSql, SQL Server, ORACLE, MySql, e ODBC. No caso de conexões ODBC,
basta informar o nome do DSN.
Na aba Saída, a consulta pode ser configurada para ser utilizada como Grade ou Gráfico, Sendo
em Grade, pode ser Com ou sem Paginação e Com ou sem Quebras de texto. Se for Grafico, o
tipo pode ser Barras ou Pizza. Neste exemplo, vamos utilizar a saída padrão (GRADE).
WecDB
-8Ao confirmar consulta, a mesma será executada para fins de validação, e as colunas retornadas
serão exibidas na tela principal para que sejam configuradas.
Gravando os Dados
Após colocar a descrição adequada nas colunas e ajusta a largura das mesmas, já temos o
suficiente para exibir a consulta na Interface WEB.
Para gravar, vá até o menu Arquivo > Gravar, ou utilize o atalho Ctrl + S.
WecDB
Note que a sequência “1” foi gerada e carregada na Consulta.
Simulador Desktop
Este recurso serve para validar os dados que serão exibidos na WEB sem a necessidade de
abrir o Portal.
-9-
WecDB
Uma tela será aberta, com um campo correspondente a cada parâmetro cadastrado na
Consulta. Informeos e clique em Executar Consulta.
Os dados serão exibidos em Grade.
Atenção: Mesmo que a consulta estiver configurada para sair em Grafico, será exibida em
grade no simulador.
- 10 -
WecDB
- 11 -
Cadastro de Menus
Para a consulta ser exibida na Inteface WEB é necessário que seja cadastrado um. Vá no menu
Configurações\Cadastro de Menus.
A tela de Menus será aberta. Clique com o botão direito do mouse sobre a area branca a
esquerda. Utilize a opção Adicionar > Menu ROOT para criar o primeiro nível do menu.
Essa operação só poderá ser realizada por um usuário de previlégio ROOT.
WecDB
- 12 -
WecDB
- 13 Criado o Menu ROOT, é possível criar infinitas ramificações através do Pop Up Menu Adicionar
> Sub-Menu. Depois definir a estrutura do menu, a consulta deve ser adicionada, utilizando a
opção Adicionar > Consulta.
Uma tela será aberta, exibindo todas as Consultas cadastradas. Selecione a consulta que você
deseja adicionar no menu.
Abaixo, um exemplo, utilizando a estrutura TESTE (ROOT) / Notas Fiscais (Sub-Menu) /
Consulta de Notas Fiscais (Consulta)
WecDB
- 14 -
Permissões de Acesso
Após criar um Menu, é necessário configurar as permissões de acesso do mesmo. Por padrão,
o acesso de um menu recém criado é restrito à usuários com previlégio ROOT. Para atribuir
permissão de acesso de acesso a outros usuários, utilize o menu Configurações > Permissões
de Acesso.
Na tela de Permissões de Acesso, estão os Menus Criados (Esquerda) e a lista de Usuários
(Direira).
WecDB
- 15 Para conceder acesso ao Menus, basta selecioná-lo à esquera e em seguida clicar sobre os
usuários que terão acesso.
Para conceder acesso a todos os usuários, basta desmarcar a opção “Com restrição”.
WecDB
- 16 -
WecDB Web
Este é o Portal Web para disponibilização das Consultas. Na tela inicial, será solicitado o Login,
que deve ser realizado conforme os dados configurados nas “Configurações de Segurança”
Ao efetuar o Login, o usuário será redimensionado para a tela principal do Portal.
À esquerda, ficam os Menus cadastrados e com as permissões de acesso concedidas no WecDB
Client. Ao clicar em uma consulta do menu, os filtros de tela serão exibidos para que o usuário
preencha e efetue a Consulta.
WecDB
- 17 -
WecDB
- 18 -
Configurações / Personalização
No menu Configurações > Gerenciar, ficam algumas configurações da Emprsa e do usuário que
não estão no WecDB Client. Por enquanto, existem apena configurações de Personalização da
Página.
A personalização da página pode ser a nível de Empresa(definido pelo administrador) ou a
nível de Usuário (definido pelo proprio usuário).
Nas configurações da Empresa, é possível alterar o Logo Principal, as cores do topo da página
(com a possibilidade de formar um degradê de duas cores) e o tema.
Após configurar o estilo da págin, basta clicar em Salvar e em Aplicar para visualizar as
alterações.
WecDB
- 19 -
A personalização de usuário será aplicada apenas ao usuário que a configurou. Todos os otros
continuam sujeitos ao estilo utilizado pela Empresa, até que configurem seus proprios estilos.
Ou seja, a personalização feita pelo usuário, sobreescreve a personalização da Empresa.
Execução da Consulta
Veremos agora a “materialização” da consulta criada no WecDB Client. Ao selecionar uma
consulta no Menu à esquerda, os filtros serão exibidos. O usuário deve preencher
adequadamente os filtros e clicar em “Confirmar”.
WecDB
- 20 -
Ao clicar no botão “Confirmar”, a consulta será executado no Banco de Dados e exibida em
uma Grade Paginada.
A direita da Grade, existem dois painéis de deslize. No painel Config, podemos modificar a
apresentação da consulta corrente.
WecDB
Seguem abaixo as opções disponíveis:
Usar Paginação: Se estiver marcada, a consulta é gerada com paginação. Caso contrário a
paginação é removida.
Expandir Consulta: Esconde automáticamente os painíes de Menu e Filtros da Consulta,
maximizando a Consulta gerada em Grade.
- 21 -
WecDB
- 22 -
Eportação para Excel
No cabeçalho da Grade da Consulta, estão os botões de Refresh e Exportação para Excel. A
exportação para Excel não depende de nenhuma versão do Office instalada na máquina
Cliente (que está acessando a página) ou no Servidor, portanto apesar de algumas limitações, é
livre de incompatibilidades.
WecDB
Abaixo, um exemplo da Consulta Exportada para Excel:
- 23 -
WecDB
- 24 -
Agrupamento de Colunas
O agrupamento de colunas é um recurso extramente útil do wecDB, que permite uma visão
aninhada dos dados apresentados.
Para agrupar uma coluna, basta clicar sobre o cabeçalho da coluna que deseja agrupar e
arrastar até a barra superior, onde diz “Drag a column header and drop if here to group by that
column”
O número de colunas a serem agrupadas é ilimitado. Os agrupamentos subsequentes são
subordinados ao agrupamento anterior.
Abaixo um exemplo da consulta criada como exemplo, agrupada pela coluna de “Razão Social
do Cliente”.