Última alteração a 09/12/2024
É 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:
- Lista
- Consulta
- Aviso
- Dashboard
- 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:
- 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;
- 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