Parametrização > Exploração > Impressões > Query SQL 

Os softwares em tecnologia SAFE X3 integram um requerente permitindo criar os ecrãs de interrogação a partir dos períodos exprimidos sob a forma de uma lista de campos emitidos de tabelas de base, estas tabelas estando ligadas por defeito, seja por relações explicitas nomeadas. Esta aproximação permite a um utilizador criar rapidamente os pedidos sem utilizar a linguagem particular, em tendo simplesmente um conhecimento das tabelas de base, conhecimento que pode ser guiado pelas documentações tecnicas em linha (MCD nomeadamente). Obtém em outro uma interface conviva de interrogação nos ecrãs multi-colunas com as possibilidades de túnel.

Este requerente apresenta todavia alguns limites, na medida onde os pedidos complexos não podem ser forçosamente exprimidos sob a forma de uma lista de campos. Assim, para os utilizadores tendo um perfil mais técnico e conhecendo a linguagem SQL, este requerente não permite obter facilmente os resultados desejados.

É porque foi criado um utilitário complementar, o requerente SQL, que permitre de exprimir os pedidos em utilizando a linguagem SQL clássico. Este requerente SQL não se distingue do requerente precedente que pelo seu ecrã de parametrização. Com efeito, os ecrãs criados por este requerente são chamados pela mesma função deexecução de pedidos que aqueles utilizados pelo requerente habitual.

Isto significa que, como requerente, o requerente SQL funciona por extração temporária de dados numa tabela (a mesma que o requerente clássico), depois por consulta desta tabela. Por outro lado, a consulta não se pode fazer que sobre um nível, as ruturas e acumulados não sendo possíveis a este nível.

Assim que o requerente clássico, a estrutura desta tabela temporária faz que cada utilizador conserve os resultados do último pedido feito, e a utilização desta funcinalidade implica três etapas diferentes :

  • definição do pedido por esta função, depois Validação afim de criar o ecrã de consulta correspondente.
  • lançamento do pedido (seja pelo botão, seja por entrada na função de interrogação e pedido de refrescamento dos dados)
  • interrogação do requerente se já foi executada.

Pré-requisitos

SEEREFERTTO Consulte a docuemntação de Implementação

Gestão do ecrã

Cabeçalho

Apresentação

Em cabeçalho, encontramos as informações permitindo o pedido e alguns parâmetros de levar geral.

Fechar

 

Campos

Os seguintes campos estão presentes neste separador :

Bloco número 1

Ce code permet d'identifier une requête.

  • Descr. (campo INTIT)

Permet de définir un intitulé associé à chaque fiche.

  • Desc. curta (campo INTITSHO)

Este intitulado permite dar uma designação à ficha.
é utilizado em certos ecrãs ou listas quando não se teve suficiente local para visualizar o intitulado longo.

  • Activo (campo ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

  • les autres enregistrements, comme les documents et paramètres,
  • les traitements en masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

Características

  • Tipo de pedido (campo ALLUSR)

Utilisez ce champ pour gérer l'affichage d'une requête en consultation, avec les comportements suivants :

  • Requête normale : le résultat de la requête est affiché si la requête a déjà été consultée par l'utilisateur. En effet, chaque utilisateur lançant la requête crée un jeu de données qui lui est propre, et qui ne peut pas être vu par d'autres.
  • Requête partagée : le résultat de l'exécution de cette requête par un utilisateur peut être consulté par d'autres utilisateurs. L'intérêt d'avoir des requêtes partagées réside dans le fait qu'une requête lourde, lancée à un moment donné par un seul utilisateur, permet ensuite à un ensemble d'utilisateurs de disposer d'une information commune. Il est recommandé, pour ce genre de requête, que seul un utilisateur puisse exécuter la requête, les autres y ayant accès en consultation. En outre, il est parfaitement loisible de calculer ce type de requête en batch si elle est particulièrement lourde à constituer ; le code de la tâche batch correspondante s'appelle en effet CALALH.
  • Requête recalculée : le résultat de la requête ne s'affiche jamais automatiquement. Il faut appuyer sur le bouton rafraîchir ou saisir les critères. L'intérêt de ce type de requête est d'éviter de recharger des données si on sait qu'elles se périment rapidement.
  • Representação (campo REPGRA)

Cet indicateur définit comment les données sont représentées à l'écran. Les possibilités sont les suivantes :

  • Caractère : les données sont uniquement représentées sous la forme d'un tableau.
  • Car. ou Graph. : les données sont présentées sous l'un des deux modes. Le mode par défaut est déterminé par le champ Affichage par défaut défini dans les paramètres graphiques de la fiche.
  • Car. et Graph. : les données sont présentées sous les deux modes simultanément. La position du graphique par rapport au tableau est déterminée par le champ Position de la section Graphique.
  • Graphique : les données sont uniquement présentées sous la forme d'un graphique.
  • campo OPTGRA

Utilisez ce champ pour organiser la relation entre le caractère et le graphique, lorsque le mode de représentation des données autorise les deux. Selon le contexte :

  • Si la représentation est Car. ou Graph., la valeur par défaut est appliquée à la représentation.
  • Si la représentation est Car. et Graph., la position du graphique dépend du tableau des données.

Fechar

 

Separador Parametrização

Apresentação

O primeiro separador permite então de registar o pedido e alguns parâmetros gerais.

Vai-se assim poder dar, no quadro titulo Colunas, das informações permitindo dispor de uma apresentação mais precisa. Com efeito, na execução, o pedido reenvia uma lista de valores que vão preencher um quadro. Na ausência de informações mais precisas :

  • as colunas do quadro não terão de título.
  • elas serão tipificadas alfanumericamente, numérico, ou datas, sem mais precisão, em função dos tipos de dados reenviados.

De mais, um pedido SQL não fixa forçosamente muito interesse. falta poder introduzir os parâmetros que serão registados no momento do seu lançamento. É o que permite o quadro com o título Parâmetros.

Fechar

 

Campos

Os seguintes campos estão presentes neste separador :

Bloco número 1

Définit le code d'un état qui sera associé à la fonction Fichier / Liste à partir de la consultation des requêtes. S'il n'est pas renseigné, on utilise l'état ALISTE, qui proposera une mise en page par défaut. Il est possible de dupliquer cet état générique (il ne sera en principe nécessaire que de modifier la mise en page) pour créer des états parfaitement adaptés à la requête ainsi définie.

Le code état saisi ici peut être associé à un ensemble de codes impression via la fonction dédiée.

Utilisez ce champ pour lier les autorisations d'accès à la requête aux autorisations données sur la fonction.

Le principe en est le suivant : à l'entrée dans la requête, on vérifie que la fonction liée est autorisée à l'utilisateur (pour au moins un site, si l'habilitation sur cette fonction se fait par site). Cette vérification est faite  uniquement dans le cas où cette requête n'est pas partagée.

En effet, si la requête est partagée, on part du principe que les habilitations de la personne ayant calculé la requête s'appliquent et se propagent à tous ceux qui ont le droit de la visualiser. Il est donc nécessaire de définir avec précaution les habilitations aux requêtes partagées, lorsqu'elles concernent des données sensibles. Ceci est possible via le code d'accès situé dans cette section.

Ce code d'accès permet d'interdire l'accès à la fiche courante pour certains utilisateurs.

Si le champ est alimenté, seuls les utilisateurs qui ont des droits de lecture sur ce code d'accès peuvent visualiser l'enregistrement ; et seuls les utilisateurs avec des droits d'écriture peuvent le modifier.

Le droit d'exécution contrôle le fait que l'on puisse exécuter la requête en question (en rafraîchissant la requête ou en modifiant les paramètres et en la ré-exécutant).

  • Nr.de linhas (campo NBRLIG)

Permet de définir un nombre de lignes par page logique dans l'écran de consultation généré par le requêteur. Si ce nombre de lignes excède le nombre de lignes physiques affichables, un ascenseur apparaît à droite du tableau. Des boutons situés en haut de l'écran permettront de naviguer entre pages logiques (visualiser la suivante, précédente, dernière, première).

  • Máximo linhas (campo MAXLIG)

Le nombre de lignes maximum correspond à un paramètre de la requête (maxrows) qui arrête la recherche lorsqu'un nombre de lignes satisfaisant aux conditions a été trouvé dans la base (ces lignes seront ensuite triées, mais la base ne garantit pas que les N lignes trouvées sont les N premières dans l'ordre de tri). Il s'agit d'une optimisation permettant de limiter la charge pour la base de données.

  • Grupo (campo GRP)

Utilisez ce champ pour créer une classification des critères disponibles pour les requêtes.

  • Nr.Colunas fixas (campo NBRCOL)

Permet de figer les x premières colonnes d'un tableau en cas de pagination horizontale.

  • Tempos máx. (campo MAXTIM)

Utilisez ce champ pour arrêter la recherche après la période de temps indiquée (en secondes). Ceci permet d'éviter d'attendre trop longtemps dans le cas du paramétrage d'une nouvelle requête par exemple.

Remarque : Contrairement au nombre maximum de lignes, cette information n'est pas transmise à la base de données. Le temps maximum peut donc pas être dépassé si la durée de la requête est trop importante.

Querie SQL

  • campo TEXTE

Permite definir o pedido ele mesmo sob uma forma SQL clássico compreensível pela base de dados.

Quaisquer observações ao sujeito deste pedido :

  • Todo o pedido Select compreendido complexo pode ser escrito aqui, prevê que reenvia um número de campo inferior ao máximo admissível
  • falta se lembrar que o campo NOMCHAMP(índice), gera na tabela NOMTABLE, é definido, na base de dados, como o campo NOMCHAMP_indice na tabela NOMTABLE, índice valendo 0, 1, 2... N-1, N sendo a dimensão do campo

Assim, por exemplo, poder-se-á escrever :

Select LOGIN_0, CHEF_2 From AUTILIS
Where USR_0 like %1%
Order by CREDAT_0

  • Num pedido deste tipo, é possível de definir os parâmetros pela sintaxe %N%, que se refere ao parâmetro número N definido no quadro dos parâmetros (%1% no exemplo acima). Os parâmetros serão registados pelo meio do botão No momento da execução do pedido.

Quadro Colunas

  • Descr. (campo COLTIT)

Este Tipo de dados permite indicar como deve se fazer a apresentação do dado. No caso de um menu local, indicar-se-á o número do menu local utilizado. Se o tipo de dados utilizado está ligado a um objecto, será possível de passar por túnel em gestão do objecto no momento da consulta.

  • Menu (campo COLNUM)

Permite definir um número de menu local a utilizar para apresentar o valor numérico da coluna corrrespondente reenviada pelo pedido.

  • Tipo de gráfico (campo GRA)

Este campo não pode ser registado que se o modo de representação escolhido no cabeçalho não é Caracter. Permite indicar a maneira cuja representação gráfica vai ser colocada em obra.

Pode tomar os valores seguintes :

  • Nenhum ou Literal se o campo da linha é de tipo alfanumérico. O campo utilizando o valor Título vai ser utilizado como título do gráfico. Atenção, apenas uma linha de quadro pode ter este valor, se está já presente sobre uma linha, falta então modificar o valor da linha levando o valor Título para lhe re-dar o valor Nenhum antes de poder afectar este valor a uma outra linha do quadro.
  • Nenhum, Valorou Defeitose o campo da linha é de tipo numérico. A regra é a seguinte :
    • Nenhum significa que o campo não será nunca apresentado no gráfico.
    • Se o gráfico define no último separador permite fazer aparecer várias séries, todas as séries correspondente a campos marcados Defeitoserão visualizados (eleas o serõa toda se ennhuma não está assim em avanço).
    • Se o gráfico define no último separador permite fazer aparecer várias séries, todas as séries correspondente a campos marcados Defeitoserão visualizados (elas o serão toda se ennhuma está assim em avanço).
  • Representação (campo REP)

Este campo não pode ser qualificado manualmente.

  • se o modo de representação escolhida no cabeçalho não o está Caracter.
  • sobre os campos numéricos cujo se decidiu afixar o valor.

Permite gerar as combinações de gráficos se o tipo de gráfico definido nos parâmetros graficos permite fazer aparecer várias séries independentes de tipo diferente (está ignorado nos outros casos). Na prática, as combinações utilizáveis são as seguintes :

  • Tipo = multi gráfico :, Gráfico por defeito =Linhas, Representação =multi :
  • Tipo = multi gráfico :, Gráfico por defeito =Barras, Representação =multi :

A regra é a então a seguinte :

  • Defeitosignifica que a apresentação gráfica da série corresponde ao gráfico por defeito do último separador (Barras, ou Linhasno caso que nos interessam).
  • Barraou linha permite forçar o modo de apresentação correspondente para série em questão.

Quadro Parâmetros

  • Descr. (campo PARTIT)

Se este campo está preenchido, um parâmetro cujo título corresponde a este campo poderá ser registada antes a execução do pedido (via o botão ).

Este parâmetro poderá ser utilizado no corpo do pedido pelo meio da sintaxe %N%, onde N é o número de linha correspondente no quadro dos parâmetros.

Este tipo de dados permite facilitar o registo do parâmetro correspondente. Com efeito, se um tipo está definido :

  • os controlos de formato são realizados
  • Se o tipo de dados utilizado éstá ligado a um objeto, é possível de utilizar a janela de seleção correspondente.
  • Menu (campo PARNUM)

Permite definir um número de menu local a utilizar para registar o valor do parâmetro.

  • Valor por defeito (campo VALDEB)

 

Fechar

 

Separador Gráfico

Apresentação

Este separador não pode ser preenchido que se uma apresentação gráfica é possível para o pedido. Define-se então a maneira cujos dados são apresentados sobre o gráfico.

Fechar

 

Campos

Os seguintes campos estão presentes neste separador :

Gráfico

  • Tipo (campo TYPGRA)

Ce champ est utilisé lorsqu'il existe plus d'une valeur numérique dans le tableau pouvant être représentée sous forme graphique. Ce champ peut afficher deux valeurs :

  • Graphique simple : une seule colonne de valeurs peut être affichée à la fois (un sélecteur est disponible)
  • Multi-graphiques : toutes les colonnes s'affichent, combinées selon la valeur du paramètre Représentation.
  • Representação (campo FSHGRA)

Lorsque plusieurs séries sont représentées dans le graphique (à condition que la présentation de toutes les séries soit identique et non par 'secteur'), vous pouvez indiquer comment les valeurs des séries sont combinées, selon les valeurs suivantes :

  • L'option multiple permet de présenter les valeurs de chaque série côte à côte (une couleur par série)
  • L'option cumulative permet de présenter les valeurs sous forme de total vertical.
  • L'option comparative permet de présenter les valeurs sous forme de comparaison relative (la hauteur du graphique est constante).
  • Gráfico p/defeito (campo DEFGRA)

Ce champ définit la représentation graphique appliquée aux données présentées (Barres, Lignes, Aires, Secteurs). Une image s'affiche, en fonction du choix effectué, illustrant le type de présentation obtenu.

Si une seule série de valeurs est disponible, la représentation graphique est fixée par défaut par ce paramètre.

Si plusieurs séries de valeurs sont disponibles, il est possible de mélanger les modes de présentation (une série en barres, une autre en lignes, par exemple). Dans ce cas, la représentation de chaque série de valeurs dépend du champ Représentation du tableau des champs :

  • Pour les Barres ou Lignes, le mode de représentation est appliqué aux séries de valeurs compatibles avec la représentation graphique par défaut (les secteurs ne peuvent pas être mélangés avec les barres ou les lignes).
  • Pour le mode Par défaut, la représentation graphique par défaut est appliquée aux séries.

Si la représentation des séries est homogène (une seule série existe dans le graphique), un sélecteur est disponible pour le type de graphique, vous permettant de sélectionner un mode de présentation différent.

Bloco número 3

  • campo IMAG

Image détaillant les informations saisies précédemment.

Bloco número 2

Bloco número 4

Fechar

 

Observação importante :

De referir que nenhuma filtragem ligada às habilitações foi realizada (o que seja as habilitações por papel, por estabelecimento, ou por código de acesso) com requerente SQL. É então aconselhado de proteger os pedidos deste tipo por um código acesso para limitar os direitos de visualização e ainda mais de execução destes pedidos. Assim, o acesso a esta função deve normalmemnte ser limitado a uma lista restringe os utilizadores.

Botões específicos

gera o ecrã de consulta associado, e verifica a exatitude do pedido em o submetido à base de dados para verificação sintaxica e semantica.

Permite o lançamento do pedido corrente. A execução se desencadeia em atualizando uma tabela temporária, e cadeia sobre a função de visualização dos pedidos, que permite visulizar o resultado do pedido.

Os seguintes campos estão presentes na janela aberta por este botão :

Bloco número 1

  • campo OBJET

 

  • campo CLES

 

Bloco número 2

  • A partir do dossier (campo DOSORG)

Use this field to define the folder from which the record will be copied. The possible syntaxes are described in the Dedicated appendix.

  • Todos dossiers (campo TOUDOS)

Use this option to copy the record to all the folders defined in the dictionary (ADOSSIER table of the current solution).

  • Para o dossier (campo DOSDES)

Use this field to define the folder to which the record will be copied. The possible syntaxes are described in the Dedicated appendix.

Fechar

Este botão permite de recopiar a definição da transação depois ou versus um outro dossier.

Mensagens de erro

Para além das mensagens genéricas, as seguintes mensagens de erro podem aparecer durante o reg. :

Pedido incorrecto

[ descrição de erro reenviado pela base de dados]

O pedido não está correcto, do ponto de vista da base de dados. Seja não está correcto do ponto de vista sintaxico, seja um elemento não existe. A descrição complementar dá o título de erro reenviado pela base de dados.

Acesso impossível a esta ficha

Tenta-se aceder a um pedido do requerente clássico com o requerente SQL (os códigos de um pedido de requerente SQL não podem ser utilizados para nomear um pedido clássico, e vice versa).

Excesso de zonas

O requerente lançado reenvia um grande número de colunas. De referir que o número de colunas susceptível de serem lidos pelo requerente SQL está limitado a 120.

Tabelas consideradas

SEEREFERTTO Consulte a docuemntação de Implementação