Query

• Cód. (campo COD)

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.

• campo WW

• 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.

• Tabela (campo TBL)

Define a tabela a partir da qual o campo a visualizar deve estar extraído. É possível de afixar os campos pertencendo a várias tabelas na condição que existe uma ligação lógica entre eles. Esta ligação pode ser determinada automaticamente a partir das relações descritas no dicionário dos dados, ou definido no separador seguinte.

• Campo (campo FLD)

Define o nome do campo que se deseja visualizar. Este campo está emitido da tabela precedente. Se este campo não está registado, preencher-se-á uma expressão na coluna corrrespondente.

O campo pode estar escrito sob a forma CHAMP(indice), índíce sendo uma constante variando de 0 a N, se um assunto a um campo que tem várias ocorrências É por exemplo no caso do campo CHEFE na tabela AUTILIS; poder-se-á então escrever CHEFE(2) no quadro dos campos.

• Descr. (campo INTITLIG)

Permite definir o intitulado da coluna tal que será afixada na execução do pedido.

Por defeito, quando um campo de uma tabela foi utilizada, o seu intitulado (tal que foi guardado no dicionário) foi proposto. Num contexto multi-língue, este título está afixado na execução na língua de conexão do utilizador, os textos do dicionário sendo gerados em todas as línguas de conexão.

Este supõe que se possa definir as traduções por um título modificado, ou correspondente a uma expressão calculada para o qual nenhuma tradução não pode ser definido.

Sur des champs traduisibles tels que celui-ci, vous pouvez saisir un intitulé dans d'autres langues que la langue de connexion courante : cliquez sur Traductions en ligne, depuis l'icône Actions.
 Pour plus d'informations, reportez-vous à : Traduction en ligne d'intitulés.

• Expressão (campo CLC)

Permite definir uma expressão calculada que será afixada na execução do pedido.

Este campo não pode ser registado que se nenhum nome de campo não foi dado.

A expressão pode integrar todo o campo de uma das tabelas em linha do pedido, constantes, funções, variáveis globais... O editor de fórmula está acessível para facilitar a definição da fórmula.

• Tipo (campo CODTYP)

Este tipos de dados permite indicar como se deve fazer a apresentação do dado. No caso de um campo, o tipo associado ao campo está proposto por defeito (mas são modificáveis) No caso de uma expressão deve ser indicado (isto pode ser um tipo genérico tal que uma cadeia de caracteres A, um menu local M, um inteiro curto C, uma data D, um decimal DCB, um inteiro longo L...) No caso de uma cadeia de caracteres, indicar-se-á o seu comprimento máximo sobre o campo Comprimento que segue; no caso de um menu local, indicar-se-á à vez o comprimento de afixação e o número do menu local utilizado. Se o tipo de dados utilizado está ligado a um objeto, será possível de passar por um túnel em gestão do objeto da consulta

• Comp. (campo LNG)

Permite definir o comprimento de um campo este campo utiliza o tipo de dados genérico cujo comprimento não está fixado. É o caso nomeadamnete para os tipos A e DCB.

Para os blob, como para os clob, falta registar o comprimento que será um comprimento máximo de armazenagem. A codificação é a seguinte :

• Menu (campo NOLIB)

Define o número de menu local associado ao campo definido sobre a linha

Quando um campo é de tipo menu local, é guardado sob a forma de um valor numérico (de 1 a 255) correspondente à fila de um título numa tabela chamada menu local, guardado na tabela das mensagens APLSTD.

Em registo ou em afixação, vê-se, segundo as escolhas feitas sobre interface :

• seja um intitulado podendo ser escolhido numa lista deslizante comummente chamada combo box
• seja uma lista de botões de escolha.

O interesse deste tipo de registo é que a lista das escolhas está apresentada na língua de conexão do utilizador.

Cada número de menu local caracteriza a lista dos intitulados possíveis. Por exemplo, o menu local 1 correspondente à escolha Não / Sim nesta ordem. Neste caso particular, o interface utilizador pode ser assim a check box a assinalar.

• Limite (campo STREND)

Três escolhas são possíveis nesta zona :

• Não registado :significa que nenhum limite de início-fim para este campo será registado ao lançamento do pedido.
• Registosignifica que um limite de início-fim para este campo será registado ao lançamento do pedido.
• Não transferidosignifica que um limite de início-fim poderá ser registado para este campo ao lançamento do pedido, mas que este campo não será transferido no ecrã para afixação.

• Acum. (campo CUM)

Este campo não pode ser registado que se o campo é numérico. Se está igual a Sim, um acumulado de valor será afixado para os diferentes níveis de ruptura induzidos pelos critérios de grupagem.

• Ord. (campo SRT)

Os dados emitidos do pedido podem ser triados segundo um ou vários campos, quer dizer apresentado na ordem crescente (para uma ordenação ascendente) ou descrescente para uma ordm descendente) dos valores deste campo

A ordem de ordenação numérica para os campos numéricos, cronologia para as datas, e a ordem da codificação utilizada para os caracteres nos campos alfanuméricas (sobre os códigos alfabéticos, é a ordem lexicográfica)

Se varios critérios de ordenação são pedidos, a ordenação se fará prioritáriamente sobre o campo aparecem em primeiro no quadro depois, na igualidade do valor sobre o 2º critérios e assim de seguida.

• Grupo (campo GRP)

Este campo permite realizar um nível de rutura. Se se regista-se este campo por Sim, um reagrupamento dos campos que seguem poderá ser feito por rutura sobre o campo corrente, e de eventuais valores acumulados serão afixados ao nível de reagrupamento.

Este campo não pode ser registado que se uma ordenação foi definido sobre a linha corrente (Ascendenteou Descendente à escolha).

Por exemplo, se define uma lista de utilizadores ordenados pelo perfil, uma rutura por perfil permitirá reagupar se uma só linha todos os utilizadores ligados a um perfil, e de fazer aparecer os dados acumulados ligados ao reagrupamento (por exemplo o seu número se um campo igual a 1 que se acumula).

• Nível (campo NIV)

Corresponde ao nível de detalhe desejado para a afixação de informação.

O nível 1 significa que a informação está afixada ao nível 1 de agregação (o mais elevado) e a todos os níveis sucessivos, o nível 2 significa que a infomação não será afixada ao nível 1, mas ao nível 2 e a todos os níveis os mais detalhados, etc. O nível o mais elevado corresponde então ao detalhe o mais fino da consulta, que esta estão afixada por defeito quando se entra na consulta.

Este nivel está afetado por defeito a 1 sobre a primerira linha, e incrementado a cada vez que uma rutura está pedida (Grupo=sim) sobre o campo precedente. Pode ser modificado se deseja afixar um montante a um nível de agregação diferente. Por exemplo, quando se ordena e reagrupa as informações sobre um tal código tal que o código utilizador, e que se deseja afixar o nome do utilizador na coluna seguinte, está claro que este nome deve estar afixado ao mesmo nível que o código que lhe corresponde e não somente sobre os níveis mais detalhados.

• Túnel (campo TUN)

• 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.

• Valor por defeito (início) (campo VALDEB)

Regista-se aqui o valor do parêmetro, sob a forma de expressão calculada fazendo intervir as variáveis ligadas ao contexto de lançamento. Se o parãmetro é um limite de início/fim, registam-se dois valores.

• Valor por defeito (fim) (campo VALFIN)

• Nr.de linhas (campo NBRLIG)

Renseignez le nombre de lignes maximum retournées par la requête. La valeur par défaut est 0. Le nombre maximum est 100.

• 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.

• 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.

• Lista (campo RPT)

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.

• Critérios de selecção (campo SEL)

Permet de saisir des critères de sélection, qui sont des expressions logiques portant sur des champs des tables, et pouvant inclure des constantes, des fonctions, des opérateurs. Seuls les lignes des tables satisfaisant à ces conditions seront extraites. L'éditeur de formule permet de simplifier l'écriture de telles expressions.

• Expressão de ligação (campo LNK)

Utilisez ce champ pour définir les liens qui ne sont pas définis dans le dictionnaire, ou qui doivent être considérés en priorité. La structure du lien doit correspondre à la clé du fichier à lier. Il doit y avoir autant de champs séparés par des points-virgules que de parties de clé. En effet, la syntaxe exacte est :

[F:ABV1]CLE=expression1 ; expression2..., où :

    [F:ABV1]CLE est la clé de la table liée. Cliquez sur le menu Actions pour accéder à la fonction Choix table, qui propose la liste de toutes les tables présentes dans la première section. La sélection d'une des tables déclenche l'affichage du premier index de la table. Pour utiliser un autre index, vous pouvez utiliser la fonction Choix d'un index, accessible par le menu Actions, qui vous proposera de choisir parmi la liste de tous les index de la table précédemment sélectionnée.

    expression1, expression2 sont les expressions permettant de donner des valeurs aux différents champs de la clé définie précédemment (si la clé est en une partie, il n'y a qu'une expression, sinon, les expressions sont séparées par un point-virgule). Vous pouvez également utiliser la fonction Choix d'un champ, qui permet de renseigner les différentes valeurs de la clé avec des champs de l'une des tables concernées. Après le choix de la clé, qui fait apparaître le nombre de points-virgules définissant les partie de clé à renseigner, cette fonction vous permet de remplir successivement toutes les parties manquantes. Il est à noter que vous pouvez définir des parties de clés constantes.

Du point de vue de la base de données, cette syntaxe définit des jointures externes gauches. Il est à noter qu'une deuxième syntaxe vous permet de définir des jointures strictes (ce qui peut avoir un intérêt sur le plan des performances). On ajoute alors un tilde (~) à la syntaxe qui devient :

[F:ABV1]CLE=expression1 ; expression2...

• 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.

• Grupo (campo GRP)

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

• Código acesso (campo ACS)

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).

• Assunto (campo OBJLNK)

Permet de déterminer des filtres d'habilitation appliqués à la constitution de la requête. Ces filtres sont les filtres par site, par rôle, et par code accès.

Les principes du filtrage sont les suivants :

• Le code objet permet de déterminer quels les champs code accès et code site sur lesquels un filtre doit être fait.
• Ce filtre est alors réalisé en fonction des sites autorisés et des droits d'accès accordés pour la gestion d'objet à l'utilisateur exécutant la requête.
• De même, le filtre sur les rôles, définis par le code objet, est aussi appliqué.

Ceci suppose bien entendu que la table sur laquelle sont fait les filtres fasse partie de la requête générée. On entend par là la table où se trouvent les champs code accès, code site, et le cas échéant le champ défini par les rôles accordés à l'utilisateur. Il ne s'agit pas nécessairement de la table principale de la requête : une requête sur des lignes de documents peut être filtrée, par exemple, en fonction des autorisations liées aux champs des tables liées à l'en-tête du document.

Attention : ces filtres sont appliqués uniquement lors du calcul de la requête, et en aucun cas lors de la consultation. Ceci peut être sensible si la requête est partagée, par exemple, ou si les filtres par site d'un utilisateur ont évolué entre le moment où la requête a été calculée et le moment où on la visualise.

• Função (campo FCTLNK)

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.

• 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.

• campo IMAG

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