Requêteur graphique

• Code (champ COD)

Ce code permet d'identifier une requête.

• Intitulé (champ INTIT)

[object Object]

• Intitulé court (champ INTITSHO)

Cet intitulé permet de donner une désignation à la fiche.
Il est utilisé dans certains écrans ou états lorsqu'il n'y a pas assez de place pour visualiser l'intitulé long.

• Actif (champ ENAFLG)

Cette case à cocher permet d'activer ou de désactiver la fiche courante sans pour autant perdre son contenu.

Une fiche désactivée ne peut pas être utilisée (par appel de son code) dans d'autres fiches (documents, paramétrages...), ou lors de traitements de 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, et est modifiable uniquement par un utilisateur autorisé, ou via un circuit de signature défini par Workflow.

• champ CLBFL

• Nombre lignes (champ NBRLIG)

• Maximum lignes (champ 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.

• Nb colonnes fixes (champ NBRCOL)

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

• Temps maximum (champ MAXTIM)

Permet d'arrêter la recherche au bout de ce temps (exprimé en secondes). Ceci permet d'éviter d'attendre trop longtemps dans le cas notamment de paramétrage d'une nouvelle requête.

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

• Etat (champ 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ères de sélection (champ 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.

• Expression de lien (champ LNK)

Il faut définir ici les liens qui ne sont pas définis dans le dictionnaire ou qui doivent être pris 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. Via clic droit, on a accès à la fonction Choix table, qui propose la liste de toutes les tables présentes dans le premier onglet. La sélection d'une des tables provoque l'affichage du premier index de la table. Si on désire utiliser un autre index, il est possible de le faire à l'aide de la fonction Choix d'un index, toujours accessible via clic droit, qui 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). On dispose par ailleurs de 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 permet de remplir successivement toutes les parties manquantes. Il est à noter que l'on peut 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 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...

• Type de requête (champ ALLUSR)

Permet de 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ée 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.

• Groupe (champ GRP)

Permet de disposer d'un critère de classification des requêtes.

• Code d'accès (champ ACS)

Ce code d'accès permet de restreindre l'accès à la fiche courante à certains utilisateurs.
Si la zone est renseignée, seuls les utilisateurs disposant de ce code d'accès dans leur profil peuvent visualiser et modifier cette fiche.

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

• Objet (champ 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 forcément de la table principale de la requête : par exemple, une requête sur des lignes de documents peut très bien être filtrée par rapport à des autorisations données sur des champs de 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.

• Fonction (champ FCTLNK)

Permet de lier les autorisations d'accès à la requête aux autorisations données sur la fonction.

Le principe est le suivant : on vérifie, à l'entrée dans la requête, 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). Mais cette vérification se fait  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 convient donc de définir de façon très soigneuse les habilitations aux requêtes partagées, lorsqu'elles concernent des données sensibles. Ceci est fait via le code d'accès situé dans cet onglet.

• Représentation (champ REPGRA)

Cet indicateur définit la façon dont la représentation des données va être faite à l'écran. Les possibilités offertes 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 l'onglet Graphique.
• Graphique :  les données sont uniquement présentées sous la forme d'un graphique.

• champ OPTGRA

Permet d'organiser la cohabitation entre caractère et graphique, lorsque le mode de présentation des données permet les deux. Selon les cas :

• si la représentation est Car ou Graph, on choisit la valeur par défaut de la représentation.
• si la représentation est Car et Graph, on donne la position du graphique par rapport au tableau de données.

• champ IMAG

Image explicative d'informations précédemment saisies.

• Type (champ TYPGRA)

Ce champ est utile dès que l'on a plus d'une valeur numérique dans le tableau susceptible d'être présenté sous forme graphique. Il peut prendre deux valeurs :

• Graphe simple : dans ce cas, on ne voit qu'une colonne de valeurs à la fois (un sélecteur permet de choisir laquelle)
• Multi-graphe : dans ce cas, on voit toutes les colonnes affichables, combinées selon le paramètre défini par le paramètre Représentation.

• Représentation (champ FSHGRA)

Lorsque l'on présente plusieurs séries dans le graphe (sous réserve que la présentation de toutes les séries soit identique et ne soit pas de type secteur), il est possible de préciser comment on combine les séries de valeurs à l'affichage, en saisissant la valeur suivante  :

• Multipermet de présenter les valeurs de chaque série côte à côte (une couleur par série)
• Cumulatif permet de présenter les valeurs en cumul vertical.
• Comparatif permet de les présenter en comparaison relative (la hauteur du graphe est constante).

• Graphique par défaut (champ DEFGRA)

Définit la représentation graphique utilisée pour les données à présenter (parmi les choix Barres, Lignes, Aires, Secteurs). Une image affichée en fonction du choix fait illustre le type de présentation obtenu.

Si on ne présente qu'une seule série de valeurs, la représentation graphique par défaut est fixée par ce paramètre.

Si on présente plusieurs séries de valeurs, il est possible de mixer les modes de présentation (une série sous forme de barre, une autre sous forme de ligne, par exemple). Dans ce cas, chaque série de valeurs est représentée en fonction du champ Représentationsitué dans le tableau des champs :

• s'il vaut Barreou Ligne, ce mode de représentation est utilisé pour la série de valeurs concernée s'il est compatible avec la représentation graphique par défaut (il n'est pas possible de mixer des secteurs avec des barres ou des lignes).
• s'il vaut Défaut, on utilise le mode de représentation graphique par défaut pour la série.

A l'utilisation, si la représentation des séries est homogène (a fortiori s'il n'y a qu'une série dans le graphe), on dispose d'un sélecteur de graphiques pour passer dans un autre mode rede présentation.