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

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

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

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

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

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

• champ IMAG

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