Requêteur graphique

• Code (champ COD)

Ce code permet d'identifier une requête.

• Intitulé (champ INTIT)

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

• Intitulé court (champ INTITSHO)

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

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

• champ CLBFL

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

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

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.

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

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

• Type de requête (champ 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.

• Groupe (champ GRP)

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

• Code d'accès (champ 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).

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

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

• Représentation (champ 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.

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

• champ IMAG

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

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

• Représentation (champ 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).

• Graphique par défaut (champ 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.