Requêteur

• 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é 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 WW

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

• Table (champ TBL)

Définit la table à partir de laquelle le champ à visualiser doit être extrait. Il est possible d'afficher des champs appartenant à plusieurs tables à condition qu'il existe un lien logique entre eux. Ce lien peut être déterminé automatiquement à partir des liens décrits dans le dictionnaire des données, ou défini dans l'onglet suivant.

• Champ (champ FLD)

Définit le nom du champ que l'on désire visualiser. Ce champ est issu de la table précédente. Si ce champ est non renseigné, on renseignera une expression dans la colonne correspondante.

Le champ peut être écrit sous la forme CHAMP(indice), indice étant une constante variant de 0 à N, si on a affaire à un champ qui a plusieurs occurrences. C'est par exemple le cas du champ CHEF dans la table AUTILIS; on pourra alors écrire CHEF(2) dans le tableau des champs.

• Intitulé (champ INTITLIG)

Permet de définir l'intitulé de la colonne tel qu'il sera affiché à l'exécution de la requête.

Par défaut, lorsqu'un champ d'une table est utilisée, son intitulé (tel qu'il est stocké dans le dictionnaire) est proposé. Dans un contexte multilingue, cet intitulé est affiché à l'exécution dans la langue de connexion de l'utilisateur, les textes du dictionnaire étant gérés dans toutes les langues de connexion.

Ceci suppose que l'on puisse définir des traductions pour un intitulé modifié, ou correspondant à une expression calculée pour laquelle aucune traduction ne peut être définie.

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.

• Expression (champ CLC)

Permet de définir une expression calculée qui sera affichée à l'exécution de la requête.

Ce champ ne peut être saisi que si aucun nom de champ n'a été donné.

L'expression peut intégrer tout champ de l'une des tables en ligne dans la requête, des constantes, des fonctions, des variables globales... L'éditeur de formules est accessible pour faciliter la définition de la formule.

• Type (champ CODTYP)

Ce type de données permet de préciser comment doit se faire la présentation de la donnée. Dans le cas d'un champ, le type associé au champ est proposé par défaut (mais il est modifiable). Dans le cas d'une expression, il doit être précisé (ce peut être un type générique tel une chaîne de caractères A, un menu local M, un entier court C, une date D, un décimal DCB, un entier long L...). Dans le cas d'une chaîne de caractères, on précisera sa longueur maximale sur le champ Longueur qui suit ; dans le cas d'un menu local, on précisera à la fois la longueur d'affichage et le numéro du menu local utilisé. Si le type de données utilisé est lié à un objet, il sera possible de passer par tunnel en gestion de l'objet lors de la consultation.

• Long (champ LNG)

Permet de définir la longueur d'un champ lorsque ce champ utilise un type de données générique dont la longueur n'est pas fixée. C'est le cas notamment pour les types A et DCB.

Pour les blob, comme pour les clob, il faut saisir la longueur qui sera une longueur maximale de stockage. La codification est la suivante :

• Menu (champ NOLIB)

Définit le numéro de menu local associée au champ défini sur la ligne.

Lorsqu'un champ est de type menu local, il est stocké sous la forme d'une valeur numérique (de 1 à 255) correspondant au rang d'un intitulé dans une table appelée menu local, stockée dans la table des messages APLSTD.

En saisie ou en affichage, on voit, selon les choix faits sur l'interface utilisateur :

• soit un intitulé pouvant être choisi dans une liste déroulante communément appelée combo box
• soit une liste de boutons de choix.

L'intérêt de ce type de saisie est que la liste des choix est présentée dans la langue de connexion de l'utilisateur.

Chaque numéro de menu local caractérise la liste des intitulés possibles. Par exemple, le menu local 1 correspond au choix Non / Oui dans cet ordre. Dans ce cas particulier, l'interface utilisateur peut aussi être la case à cocher.

• Borne (champ STREND)

Trois choix sont possibles dans cette zone :

• Non saisiesignifie qu'aucune borne de début-fin pour ce champ ne sera saisie au lancement de la requête.
• Saisiesignifie qu'une borne de début-fin pour ce champ pourra être saisie au lancement de la requête.
• Non transféréesignifie qu'une borne de début-fin pourra être saisie pour ce champ au lancement de la requête, mais que ce champ ne sera pas transféré dans l'écran pour affichage.

• Cumul (champ CUM)

Ce champ ne peut être renseigné que si le champ est numérique. S'il est égal à Oui, un cumul de valeur sera affiché pour les différents niveaux de rupture induits par les critères de groupage.

• Tri (champ SRT)

Les données issues de la requête peuvent être triées selon un ou plusieurs champs, c'est-à-dire présentée dans l'ordre croissant (pour un tri ascendant) ou décroissant (pour un tri descendant) des valeurs de ce champ.

L'ordre de tri est l'ordre numérique pour les champs numériques, chronologique pour les dates, et l'ordre du codage utilisé pour les caractères dans les champs alphanumériques (sur les codes alphabétiques, c'est l'ordre lexicographique).

Si plusieurs critères de tri sont demandés, le tri se fera prioritairement sur le champ apparaissant en premier dans le tableau puis, à égalité de valeur sur le 2ème critère et ainsi de suite.

• Groupe (champ GRP)

Ce champ permet de réaliser un niveau de rupture.Si on renseigne ce champ par Oui, un regroupement des champs qui suivent pourra être fait par rupture sur le champ courant, et d'éventuelles valeurs cumulées seront affichées au niveau du regroupement. 

Ce champ ne peut être saisi que si un tri a été défini sur la ligne courante (Ascendantou Descendant au choix).

Par exemple, si on définit une liste d'utilisateurs triés par profil, une rupture par profil permettra de regrouper sur une seule ligne tous les utilisateurs liés à un profil, et de faire apparaître des données cumulées liées au regroupement (par exemple leur nombre si on a un champ égal à 1 que l'on cumule).

• Niveau (champ NIV)

Correspond au niveau de détail désiré pour l'affichage de l'information.

Le niveau 1 signifie que l'information est affichée au niveau 1 d'agrégation (le plus élevé) et à tous les niveaux successifs, le niveau 2 signifie que l'information ne sera pas affichée au niveau 1, mais au niveau 2 et à tous les niveaux plus détaillés, etc. Le niveau le plus élevé correspond donc au détail le plus fin de la consultation, qui est celui affiché par défaut quand on entre dans la consultation.

Ce niveau est affecté par défaut à 1 sur la première ligne, et incrémenté à chaque fois qu'une rupture est demandé (Groupe=oui) sur le champ précédent. Il peut être modifié si on désire afficher un montant à un niveau d'agrégation différent. Par exemple, lorsqu'on trie et regroupe les informations sur un code tel que le code utilisateur, et que l'on désire afficher le nom de l'utilisateur dans la colonne suivante, il est clair que ce nom doit être affiché au même niveau que le code qui lui correspond et pas seulement sur des niveaux plus détaillés.

• Tunnel (champ TUN)

• Type de graphe (champ GRA)

Ce champ ne peut être saisi que si le mode de représentation choisi dans l'en-tête n'est pas Caractère. Il permet de préciser la façon dont la représentation graphique va être mise en oeuvre.

Il peut prendre les valeurs suivantes :

• Aucun ou Libellé si le champ de la ligne est de type alphanumérique. Le champ utilisant la valeur Libelléva être utilisé comme intitulé du graphe. Attention, seule une ligne du tableau peut avoir cette valeur; si elle est déjà présente sur une ligne, il faudra d'abord modifier la valeur de la ligne portant la valeur Libellépour lui redonner la valeur Aucun avant de pouvoir affecter cette valeur à une autre ligne du tableau.
• Aucun, Valeurou Défautsi le champ de la ligne est de type numérique. La règle est la suivante :
• Aucun signifie que le champ ne sera jamais présenté dans le graphe.
• Si le graphique défini dans le dernier onglet permet de faire apparaître plusieurs séries, toutes les séries correspondant à des champs marqué Défautseront visualisées (elles le seront toute si aucune n'est ainsi mise en avant).
• Si le graphique défini dans le dernier onglet ne permet de faire apparaître qu'une série, la colonne correspondant au premier champ marqué Défautsera visualisée (ce sera la première si aucune n'est ainsi mise en avant).

• Représentation (champ REP)

Ce champ ne peut être saisi que :

• si le mode de représentation choisi dans l'en-tête n'est pas Caractère.
• sur les champs numériques dont on a décidé d'afficher la valeur.

Il permet de gérer des combinaisons de graphes si le type de graphique défini dans les paramètres graphiques permet de faire apparaître plusieurs séries indépendantes de type différent (il est ignoré dans les autres cas). En pratique, les combinaisons utilisables sont les suivantes :

• Type = Multi graphe, Graphique par défaut=Lignes, Représentation=Multi
• Type = Multi graphe, Graphique par défaut=Barres, Représentation=Multi

La règle est alors la suivante :

• Défautsignifie que la présentation graphique de la série correspond au graphique par défaut du dernier onglet (Barres, ou Lignesdans les cas qui nous intéressent).
• Barre ou Ligne permet de forcer le mode de présentation correspondant pour la série en question.

• Valeur par défaut (début) (champ VALDEB)

On saisit ici la valeur du paramètre, sous la forme d'une expression calculée faisant intervenir des variables liées au contexte de lancement. Si le paramètre est une borne de début/fin, on saisit deux valeurs.

• Valeur par défaut (fin) (champ VALFIN)

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

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.

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

• champ IMAG

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