Índice

---

       

Índice
exclude .*ndice:

Objetivo

---

       O O objetivo deste documento é apresentar a ferramenta Visões de Dados e suas funcionalidades.

Introdução

---

       Utilizando Utilizando a Visões de Dados é possível criar uma variedade de consultas SQL, partindo da simples a mais complexas. Não importando se o apresentado será uma simples lista de registros ou um resumo agrupado de funcionários por seção.       As

As consultas SQL podem ficar disponíveis para Objetos Gerenciais, então, crie Relatórios, Cubos, Planilhas entre outros. Agende o envio de dados gerados em tempo real.

Funcionalidades

 

---

Informações
icon false

Section
border true
Column width 10%15% Parâmetros Column width 10%8% Padrão Column width 25% Descrição

Section
border true
Column width 10%15% 1 - Nova Consulta Column width 10%8% - Column width 25% Permite ao usuário criar novas consultas SQL. O aceso ao ícone é concedido no(s) perfil(s) associado(s) ao usuário.

Section
border true
Column width 10%15% 2 - Exclusão Column width 10%8% - Column width 25% Permite ao usuário excluir consultas SQL. O aceso ao ícone é concedido no(s) perfil(s) associado(s) ao usuário. Nota: Consultas SQL associadas a outros processos como objetos gerência e anexos da visão não poderão ser excluídas.

Section
border true
3 - Atualizar Column width 10% 15% 4 - Código Column width 8% Em branco Column width 25% Código da consulta SQL. Nota: Não é permitido caracteres especiais como ?>- etc.

Section
border true
Column width 15% 5 - Título Column width 8% Em branco Column width 25% Campo destinado para informar o título da consulta SQL.

Section
border true
Column width 10%15% 6 - Visível a todas Coligadas Column width 8% False Column width 25% Opção que habilita e desabilita a consulta SQL como Consulta SQL Global. Nota: A opção "Visível a todas Coligadas" marcada habilita a visualização da consulta SQL em todas as demais coligadas que seu usuário possui acesso. Caso seja mantido a opção default do parâmetro a consulta estará dispensável somente para coligada corrente da sua criação.

Section
border true
Column width 15% 7 - Segurança por linha e por coluna na Consulta SQL Column width 8% False Column width 25% Esta opção permite determinar, para cada consulta, se ela deve considerar ou não a segurança por perfil/usuário ou segurança de campos.

Section
border true
Column width 15% 8 - Aplicação Column width 8% Módulo Corrente Column width 25% Demostra qual o aplicativo a consulta SQL está associada. Nota: Uma vez salvo os dados não é possível trocar o sistema.

Section
border true
Column width 15% 9 - Editor de Query Column width 8% Em branco Column width 25% Editor de Query é o principal campo do cadastro de consultas SQL onde é possível criar e/ou dar manutenção nas consultas SQL.  Nota:  O "SET LANGUAGE" não deve ser utilizado em consultas SQL pois o mesmo influencia no contexto da aplicação que está compartilhando daquela conexãoAtualiza as informações no formulário.

Section
border true
Column width 10%15% 4 10 - Código Conexões Externas Column width 10%8% Em branco Column width 25% Código da consulta SQL. Nota: Não é permitido caracteres especiais como ?>- etc. Permite configurar uma conexão externa para que a consulta SQL busque informações em outras bases de dados.

Section
border true
Column width 15% 11 - Disponibilidade Column width 8% True Column width 25% Permite que a consulta SQL criada esteja disponível/visível em visões, filtros, relatórios, menus e portal.

Schema da consulta

Para o correto funcionamento da funcionalidade de Visão de Dados é necessário que o sistema consiga recuperar o schema da consulta SQL ao salvá-la. Caso seja retornado um erro na recuperação do schema, entre em contato com o seu DBA para análise e reescrita da consulta.

É importante lembrar que para outros executores de consultas SQL conseguir recuperar o schema de uma consulta não é requisito. No RM é necessário, pois existem validações de segurança (de campos, por perfil, por usuário...) entre outras funcionalidades que necessitam dele para funcionar como esperado.

Ao editar uma consulta SQL, é necessário validar todas as referências através do botão "Procurar Referências".

Caso tenha adicionado ou removido campos da consulta, será necessário editar a consulta em todos os objetos referenciados para que os campos sejam atualizados.

Limitações

As visões de dados têm como objetivo apenas retornar dados.
Por isso, existem as seguintes limitações:

• Obrigatoriedade de uma cláusula SELECT.
• Não são permitidas as cláusulas ALTER, DELETE, DROP,INSERT, e UPDATE.
• Não é permitida a utilização dos métodos EXEC e EXECUTE [ver nota abaixo]
• Termo DECLARE, não é recomendado o uso.

Podem existir também outras limitações específicas de cada SGBD.

Parâmetros e Variáveis

A utilização de parâmetros deve seguir o modelo de COLUNA = :NOME_DO_PARAMETRO, onde o valor a ser atribuído pelo filtro na clausula WHERE deve ser substituído pelo parâmetro, precedido de :(Dois pontos). A consulta SQL pode não suportar declarações de constantes e variáveis conforme o padrão PL/SQL, modelo usado diretamente no SGDB.

Para obter uma lista de variáveis aceitas na Consulta SQL, veja aqui: Variáveis Dinâmicas

Exemplo de uma consulta SQL utilizando dois parâmetros, :CIDADE e :PAIS

Image Added

Na execução da consulta os parâmetros são apresentados para informar o valor.

Image Added

Image Added

Em alguns casos pode ocorrer que alguma diretiva ou palavra reservada do SGDB não seja aceita pela Consulta SQL.

Exemplo não suportado, onde o termo "define" não é reconhecido.
O código abaixo pode ser executado diretamente pelo SGDB, mas não pela Consulta SQL.

define CIDADE = 'Belo Horizonte';
define PAIS = 'Brasil';

SELECT EMAIL, RUA, NUMERO, PAIS, CIDADE
FROM GCOLIGADA
WHERE CIDADE = '&CIDADE' AND PAIS = '&PAIS'

Fórmula como parâmetro

Em uma consulta SQL é possível utilizar uma Fórmula RM, como parâmetro em um filtro na clausula Where, isso possibilita somar à consulta todos os recursos da Fórmula e enriquecer a funcionalidade.

Exemplo de duas Fórmulas simples, uma retorna um valor do tipo String e outra um número.

Image AddedImage Added 

Na consulta SQL o nome do parâmetro é informado com o prefixo FRM_ acrescido do Nome da Fórmula, definido pelo campo código no cadastro da Fórmula.

Image Added

Na execução da consulta o parâmetro da Fórmula foi adicionado diretamente no filtro, e não precisa ser apresentado ao usuário.

Image Added

Comentários

São suportados comentários na sentença SQL, entretanto deve ser utilizado com cuidado para não interferir e gerar erros de interpretação da consulta.
Em SQL Server e Oracle são aceitos dois tipos básicos de comentários, por bloco e por linha:

Comentário por Bloco deve começar com /* e finalizar com */, pode conter quebra de linha.

Comentário por Linha deve iniciar com -- , tudo a direita na linha poderá ser comentado. Não suporta quebra de linha.

/* Bloco incial usado para comentários */

SELECT * FROM GCOLIGADA -- Comentário de linha

/* 
  Bloco final usado como comentários
 */

SELECT * FROM GCOLIGADA
WHERE CODCOLIGADA IN 
(1,2,
3 -- Comentário dentro da cláusula
,4 -- Comentário entre parênteses -- Mais outro comentário... ;)
)