Eticadata Diversos
Diversos
Diversos
Voltar | Lista de Artigos

Editor de Consultas

Última alteração a 09/12/2024
Este artigo é aplicável a:
PT
ES
AO
CV
MZ
ST
GW

É possível editar as consultas.

Editar Consultas

Para editar consultas, deverá primeiramente preencher os campos da janela:

  • Nome da Consulta: Este campo permite indicar o nome da consulta.
  • Comando da Consulta: Este campo permite indicar o comando associado à consulta.
  • Tipo: Este campo permite indicar o tipo deconsulta. Esta pode ser:
    1. Lista
    2. Consulta
    3. Aviso
    4. Dashboard
    5. FrontOffice
      Nota: estas opções não são exclusivas.
  • Permissões Revistas: Indica que existe uma consulta que carece de revisão de permissão. Esta opção só está visível para as novas consultas distribuídas de base, ou seja, em consultas criadas pelo utilizador esta opção não fica visível. Para mais informações, consultar o separador Acessos.
  • Ativa: Ao selecionar esta opção, a consulta passa a estar ativa.
  • Lista por Defeito: Se uma consulta específica for do tipo Lista e se a opção Lista por Defeito estiver selecionada, significa que é a lista por defeito para este tipo de consulta.
  • Subscrição de Avisos: Permite aceder à janela de Subscrições de Avisos, onde são apresentados os avisos já configurados.

De seguida, deverá preencher os diversos campos dos seguintes separadores:

Definições

ID Indica o ID da consulta.
Descrição/Observações Permite registar e consultar as informações consideradas necessárias para a consulta atual.
Orientação p/ PDF Ao exportar para PDF, permite definir a orientação pretendida (vertical ou horizontal).
Base Dados Permite selecionar se a consulta vai ser da base de dados de empresa ou de sistema.
N.º Regs. Pág. p/Def. Permite definir a quantidade de registos que se prentende obter por página. Esta opção tem por base dividir a informação solicitada ao servidor por blocos.
Manter dados em memória durante x minutos Indica se pretende guardar os dados da lista em memória durante os minutos indicados.
Não calcular de Imediato Com esta opção selecionada, a consulta apresenta os parâmetros por defeito (separador Consultas Disponíveis).
Dados pessoais/sensíveis Estando esta opção selecionada, a consulta apresenta dados sensíveis/ pessoais.
Vista p/Defeito Permite definir a vista por defeito (Tabela ou Gráfico).
Report Indica o nome do report que está associado à consulta.
Comando Associação de uma consulta a uma entidade.
Grupo Indica o grupo a que a consulta está associada.
Criado Por Indica o Utilizador que criou a consulta.

Query SQL

Neste separador é possível definir a sintaxe SQL.

Informação Adicional

Parâmetros globais reconhecidos pela aplicação:

  • Data do Início do Ano Atual: %%STARTDATEOFYEAR
  • Exercício Atual: %%EX
  • Secção Atual: %%SEC
  • Data Atual: %%TODAY
  • Utilizador Atual: %%USR
  • Data do Início do Exercício %%STARTDATEOFEX
  • Data do Fim do Exercício: %%ENDDATEOFEX
  • Data do Fim do Ano Atual: %%ENDDATEOFYEAR
  • Data do Início do Mês Atual: %%STARTDATEOFMONTH
  • Data do Fim do Mês Atual: %%ENDDATEOFMONTH
  • Estabelecimento Atual: %%ESTABELECIMENTO
  • Data de Hotelaria: %%DATAHOTELARIA
  • Um mês atrás: %%MONTHSAGO1
  • Dois meses atrás: %%MONTHSAGO2
  • Três meses atrás: %%MONTHSAGO3
  • Seis meses atrás: %%MONTHSAGO6
  • Doze meses atrás: %%MONTHSAGO12
  • Vinte e quatro meses atrás: %%MONTHSAGO24
  • Se é administrador: %%USRADMIN
  • Se é supervisor: %%USRSUPERVISOR
  • Código do grupo de utilizador: %%USRCODEGROUP
  • Código do Plano Base: %%BASECODEPLAN
  • Moeda Base: %%BASECURRENCY

Parâmetros de contexto:

  • Código do Armazém Atual: %%CODARMAZEMACTUAL
  • Código do Artigo Atual: %%CODARTIGOACTUAL
  • Novo Registo: %%NOVOREGISTO
  • Tipo de Documento Atual: %%TIPODOCUMENTOACTUAL

Parâmetros/Filtro

Base
Nome Permite indicar o nome do Parâmetro.
Descrição Permite indicar uma descrição do Parâmetro.
Tipo de Dados Permite indicar o tipo de dados do campo. Os Tipos de Dados que existem são:

  • Nenhum
  • Caixa de Texto
  • Data/Hora
  • Numérico Inteiro
  • Decimal
  • CheckBox
Tamanho Permite indicar o tamanho do parâmetro.

Nota: Esta opção só está disponível quando o Tipo de Dados é Caixa de Texto.

Casas Decimais Permite indicar as casas decimais do parâmetro.

Nota: Esta opção só está disponível quando o Tipo de Dados é Caixa de Texto.

Introdução Permite indicar o tipo de Introdução do parâmetro. Os tipos de Introdução são:

  • Nenhum
  • Livre
  • Com Validação
  • Sem Validação
  • Não Editável
  • Oculto

Nota: Esta opção só está disponível quando o Tipo de Dados é Caixa de Texto.

Valor por Defeito Permite indicar um valor que será subsituído pela variável na Sintaxe SQL.
Valor de Teste Permite indicar um valor que será substituído pela variável na Sintaxe SQL quando for utilizada a opção Testar Consulta.
Placeholder Definição da linha de comentário a apresentar aquando do preenchimento do campo.
Lista
Tipo Dados Lista Permite indicar o tipo de origem dos dados da lista. Os Tipos de Dados que existem são:

  • Nenhum
  • Valores Fixos
  • Query SQL
  • Tabela
 Dados Lista Campo que permite introduzir os valores da lista.
Tabela Campo que permite indicar a tabela que pretende.
Valor Visível Permite indicar o valor visível na lista.
Valor Filtro Permite indicar o valor para filtro na lista.
Tam. das colunas Permite indicar o tamanho (em %) das colunas na lista, separadas por ";". Exemplo: 25;72 ou 0;100

Formatação

Largura em Medidas Fixas, Percentagem
Base
Campo Permite indicar o nome da coluna.
Cabeçalho Permite indicar o nome que será apresentado na coluna.
Chave Permite indicar se o campo é chave da tabela.
Campo Chave Permite indicar o número da ordem do campo na chave do registo.
Visível Permite indicar se a coluna está visível.
Grupo Permite indicar se a coluna é agrupadora.
Ordem (Grupo) Permite indicar a ordem no agrupamento das colunas.
Totalizar Permite indicar se a coluna é totalizadora.
Descritivo Permite indicar se o campo é a descrição da tabela.
Formato/Texto
Largura Permite indicar a largura a aplicar à coluna.
Tipo de Coluna Permite indicar o tipo de dados da coluna.
Formato Permite indicar o formato para aplicar à coluna.
Tipo de Letra Permite indicar o tipo de letra para aplicar à coluna.
Cor Permite indicar a cor da letra para aplicar à coluna.
Alinhamento Permite indicar o alinhamento para aplicar à coluna.
Operador por Defeito Permite indicar o tipo de filtro para aplicar à coluna.
Hiperligação
Hiperligação Permite indicar se a coluna é uma hiperligação.
Comando Permite indicar um comando para associar à hiperligação. Este comando é executado sempre em ambiente WEB. Em ambiente integrado é executado após execução da script desktop (no caso de estar preenchida).
Chaves Permite indicar as chaves para a execução do comando.
Script Desktop / Script Web Permite indicar um comando para associar à hiperligação. Este comando apenas é executado em ambiente integrado ou web.

Formatação Condicional

Definições da Condição
Campo Permite indicar o nome da coluna para a condição.
Respeitar M/m Permite indicar se a condição respeita maiúsculas/minúsculas.
Complemento Permite indicar se a condição é complemento de outras condições.
Aplicar a toda a linha Permite indicar se a condição é aplicada a toda a linha.
Operador Permite indicar um operador para a condição.
Valor Permite indicar um valor para a condição. O valor pode ser uma coluna da grelha ou um valor fixo.
Valor Fixo Permite indicar um valor fixo para a condição.
Formato da Célula
Formato Permite indicar o formato para aplicar à célula.
Cor Letra Permite indicar a cor para aplicar ao tipo de letra da célula.
Cor Fundo Permite indicar a cor para aplicar ao fundo da célula.

Gráfico

Usar Gráfico Permite indicar se deve usar gráfico.
Título Indica um título para o gráfico.
Séries Permite indicar o tipo de séries (por linhas ou por colunas)
Tipo de Gráfico Permite indicar o tipo de gráfico.
Campo Categoria Permite indicar a categoria a aplicar ao gráfico.
Consulta encadeada Permite que, a partir de um gráfico, seja possível aceder a outro gráfico.
Parâm. p/ Categ./ Série No caso de consulta encadeada, a 2.ª consulta deve ter um parâmetro adicional (categoria ou série), permitindo o refinamento da mesma.
Paleta Permite indicar o tipo de paleta.
Somatório Permite indicar o tipo de somatório a aplicar ao gráfico.
Eixo X
Legenda Permite indicar a legenda do eixo dos x em que o gráfico será apresentado.
Formato Indica o formato do eixo dos x em que o gráfico será apresentado.
Mínimo Indica o mínimo do eixo dos x em que o gráfico será apresentado.
Máximo Indica o máximo do eixo dos x em que o gráfico será apresentado.
Rotação Permite indicar a rotação do eixo dos x em que o gráfico será apresentado.
Ordem - Inverter Ordem Permite indicar a ordem do eixo dos x em que o gráfico será apresentado.
Eixo Y
Legenda Permite indicar a legenda do eixo dos y em que o gráfico será apresentado.
Formato Indica o formato do eixo dos y em que o gráfico será apresentado.
Mínimo Indica o mínimo do eixo dos y em que o gráfico será apresentado.
Máximo Indica o máximo do eixo dos y em que o gráfico será apresentado.
Rotação Permite indicar a rotação do eixo dos y em que o gráfico será apresentado.
Ordem - Inverter Ordem Permite indicar a ordem do eixo dos y em que o gráfico será apresentado.
Composição
Campo Indica o nome da coluna.
Legenda Indica o nome que será apresentado na coluna.
Tipo de Gráfico Permite indicar o estilo em que o gráfico será apresentado.
Etiqueta Valores Permite indicar onde os valores serão apresentados.
Etiquetas Permite indicar os campos que serão apresentados na legenda do gráfico.

Relações

Campo Precedente Permite indicar o campo que fará a ligação com o campo da subtabela.
Sub-Consulta Permite indicar a subconsulta.
Campo Sub-Consulta Permite indicar o campo da subtabela que fará a ligação com o campo precedente.
Nome Relação Permite indicar um comando.

Entidades

A cada uma das entidades, permite associar a uma estatística.

Comando Definição da entidade pretendida.
Parâmetro(s) Chave Parâmetro(s) que vai estar ligado à entidade. (clique em "..." para aceder a um assistente de construção de chaves)
Ordem Ordem de renderização desta consulta, no universo de consultas para esta entidade. (clique em "..." para visualização do conjunto das consultas em causa)

Acessos

Neste separador, é possível definir permissões por empresa, grupo ou utilizador para visualizar esta consulta.

Nas novas consultas que vão sendo distribuídas, ficam visíveis apenas os utilizadores administradores ou utilizadores com permissões para edição das consultas, até serem revistas as permissões.

Quando um utilizador (com permissões) entrar nas consultas, será avisado de que existem consultas com permissões por rever. Se o utilizador responder Sim, irá posicionar-se na janela Editor de Consultas com o grupo Consultas com Permissões por Rever aberto. Ao selecionar o nodo de cada consulta a rever, será aberta a respetiva consulta, posicionada neste separador (Acessos).
Basta alterar uma das permissões, para a opção Permissões Revistas ficar selecionada.

As alterações realizadas ao nível das permissões de consultas por utilizador (Admin | Editar Grupos e Utilizadores) não alteram a marca das consultas que ainda estão por rever.

Exportação

Exportação CSV Permite indicar as configurações específicas para a exportação para ficheiros CSV.

Quando esta configuração está ativa, para os campos disponíveis para configuração, caso não tenham nenhuma opção selecionada (ou seja, estejam em < vazio > (em branco, null)), são aplicadas, por defeito, as definições da cultura do sistema (configurações regionais e de idioma definidas no sistema operativo onde a aplicação está a ser executada), sendo utilizadas para cada tipo de campo.

Encoding Permite indicar o tipo de codificação de texto a utilizar na exportação de ficheiros para formato CSV. O encoding selecionado assegura que os caracteres sejam interpretados corretamente, especialmente em idiomas que utilizam acentos ou caracteres especiais. Opções disponíveis : < vazio > (em branco, null); ANSI; UTF-8; UTF-8 with BOM; UTF-16 BE BOM; UTF-16 LE BOM.
Separador de campos Permite indicar o separador de texto a ser utilizado na exportação de ficheiros para formato CSV. Opções disponíveis: < vazio > (em branco, null); < TAB >; <.> (ponto); <,> (vírgula); <;> (ponto e vírgula)
Separador decimal Permite indicar o separador decimal a ser utilizado em valores numéricos a utilizar na exportação de ficheiros para formato CSV.  O separador decimal selecionado é essencial para garantir a compatibilidade com sistemas e formatos regionais. Opções disponíveis: < vazio > (em branco, null); <,> (vírgula); <.> (ponto).
Delimitador de campo texto Permite indicar o delimitador de campos texto a ser utilizado na exportação de ficheiros para formato CSV. Opções disponíveis: < vazio > (em branco, null); <"> (aspas); <'> (plica)
Datas - Formato Permite indicar o formato de data a ser utilizado na exportação de ficheiros para formato CSV. O formato de data é essencial para garantir a compatibilidade com sistemas e padrões regionais. Opções disponíveis: < vazio > (em branco, null); dd/MM/yyyy; dd.MM.yyyy; dd-MM-yyyy; yyyy/MM/dd; yyyy.MM.dd; yyyy-MM-dd.
Datas - Separador Permite definir o separador a ser utilizado no formato de data selecionado, que será aplicado na exportação de ficheiros para formato CSV. Opções disponíveis são: < vazio > (em branco, null); < / > (barra); <.> (ponto); <-> (hifen)

Notas:

  1. Deverá ter em atenção a definição dos separadores selecionados, para evitar a criação de um CSV inválido e problemas na importação do ficheiro;
  2. Caso esteja definido um formato de datas e o separador de datas não coincida com o definido nesse formato, o separador de datas selecionado não será considerado, prevalecendo o separador definido no formato de datas.

Operações Disponíveis

Estão disponíveis as seguintes operações:

Navegação

Botões de Navegação: Permite navegar entre consultas.

Navegação Avançada

  • Marcado: Ao selecionar este botão, o registo fica marcado como sendo favorito.
  • Navegar em...: Permite navegar em: Todos os registos, Registos marcados, Exceto registos marcados, Alterados após..., Navegação por filtro definido na própria janela.

Operações Comuns

  • Gravar: Permite gravar as alterações efetuadas à consulta atual.
  • Novo: Permite criar uma nova consulta.
  • Remover: Permite remover uma consulta.
  • Repetir: Permite criar uma réplica da consulta.

Operações

  • Validar Consulta: Valida a query da consulta
  • Pré-Visualizar Consulta: Permite a pré-visualização da consulta.
  • Importar/Exportar: Permite importar uma consulta ou exportar a consulta em edição.

Gerir Grupos (Grupos de Consultas)

  • Criar Novo Grupo: Permite criar um novo grupo.
  • Editar Nome: Permite editar o nome do grupo.
  • Novo Subgrupo: Permite criar um novo subgrupo.
  • Eliminar Grupo: Permite eliminar o grupo.

SQL

Diagrama: Possibilita a edição do diagrama SQL, quando a consulta não se encontra bloqueada.

Guardar ou partilhar este artigo
Esta página foi útil?
Obrigado pelo seu voto.
Artigos Relacionados
Atualização da Base de Dados Alterar a Chave de Acesso ao Servidor Auditoria/Logs Custeios por Armazém Novo Grupo/Utilizador