Impressions > Visualisation de requêtes 

Cette fonction permet de visualiser le résultat des requêtes paramétrées par la fonction de création de requêtes, ou de requêtes SQL et déjà exécutées précédemment, ou de les ré-exécuter en modifiant les critères d'exécution avant de les visualiser. A partir des résultats de cette requête, présentés au niveau du détail le plus fin, il est possible de zoomer sur des objets liés, de regrouper les lignes interrogées en fonction des zones de rupture définies dans la requête, de déclencher l'affichage d'un graphe, ou d'exporter le résultat vers un tableur.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

Ecran de saisie

Présentation

Si l'entrée dans la fonction se fait sans avoir imposé de requête particulière, un écran de saisie préliminaire permet de la choisir.

On voit alors apparaître un écran composé d'un seul onglet, dans lequel se trouvent un ensemble de colonnes contenant les données issues de l'interrogation (elles sont stockées dans la table ALISTER).

En tête se trouvent les informations relatives à la dernière exécution de la requête.

L'exécution peut alors se faire par la touche  , qui permet de déclencher un rafraîchissement de façon générique (elle est aussi utilisée pour les listes de gauche), ou par Fichier/Rafraîchir. Elle peut également se faire en saisissant des critères à l'aide du bouton idoine.

Pour qu'une exécution puisse être faite, il faut que l'utilisateur soit habilité (ceci permet, quand les requêtes sont partagées, de n'autoriser que des consultations sur des requêtes déjà faites).

Dans le tableau qui suit, on retrouve les colonnes issues de l'interrogation avec des lignes de détail. En positionnant le curseur sur une ligne, on peut, par clic droit, zoomer sur les fiches relatives aux informations dont les clés sont affichées sur la ligne. Par exemple, si on imagine une requête donnant par pays, puis par client, puis par ligne de commande le détail des articles et des quantités correspondantes, on peut zoomer sur la fiche client correspondant au client de la ligne, sur la fiche pays, sur l'article... (mais pas sur la commande si le numéro de commande n'apparaît pas dans la ligne).

On peut également naviguer de page en page avec les bouton magnétophone situés dans la ligne de menu supérieure, et utiliser les boutons de bas de page décrits ci-dessous.

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

Ce code permet d'identifier une requête.

  • champ DES

Intitulé associé au code précédent

  • Dernière génération (champ DAT)

Indique la date et l'heure de la dernière génération. Ces champs sont vides si aucune génération n'a encore été faite.

  • champ TIM

 

  • champ USR

Définit le code du dernier utilisateur ayant exécuté la requête (lorsque la requête est partagée, l'utilisateur peut être différent de l'utilisateur courant).

Bloc numéro 2

  • Temps (champ TEMPO)

Précise le temps d'exécution (en secondes) nécessaire à la dernière exécution de la requête.

Lorsqu'une exécution longue est en cours, on voit s'afficher le nombre de secondes passées au fur et à mesure de l'exécution.

  • Niveau (champ NIVP)

Ce champ définit le niveau courant de détail et le nombre de niveaux maximum (au départ, on est au niveau maximum : on verra donc s'afficher 4/4 si le nombre maximum de niveaux est 4, par exemple). Les boutons de gestion de niveaux permettent ensuite de naviguer d'un niveau à l'autre.

  • Lignes (champ LIG)

Indique le nombre de lignes créées par la requête lors de sa dernière exécution.

Lorsqu'une exécution longue est en cours, on voit s'afficher le nombre de lignes trouvées au fur et à mesure de l'exécution.

  • Page (champ PAGP)

Donne un numéro de page et le nombre de pages maximum sur laquelle la requête est affichée (ceci dépend du nombre de lignes maximum affichées dans l'écran, paramétré à la définition de la requête).

Tableau

 

Icône Actions

Zooms vers les fiches de base

Par clic droit sur les lignes, on peut trouver, selon le contexte lié à la requête, un ensemble de zooms permettant de remonter par tunnel aux données liées à la requête.

Gestion des objets de base
Gestion des objets de base
Gestion des objets de base
Gestion des objets de base
Gestion des objets de base
Gestion des objets de base
Gestion des objets de base
Gestion des objets de base

 

 

Boutons spécifiques

Permet de changer d'interrogation.

Permet de relancer l'exécution (c'est équivalent à un rafraîchissement).

Permet la modification des critères d'interrogation. En validant ces critères, la requête est exécutée, puis son résultat est affiché.

Permet, lorsqu'on a navigué d'un niveau donné à un niveau moins fin par le bouton Niveau -, de réaliser l'opération inverse (descente à un niveau de détail plus fin). Une remarque importante doit être faite : lorsqu'on navigue ainsi de niveau en niveau, la ligne courante est utilisée pour déterminer la page courante. Imaginons par exemple qu'une interrogation a créé 10.000 lignes, paginées par 100 (on a donc 100 pages d'interrogation). Si on est remonté au niveau de zoom le élevé, et que l'on se positionne sur la 15ème ligne (aucune pagination n'est alors nécessaire, puisqu'à ce niveau seule une ligne par agrégat est affichée), le fait de redescendre en changeant de niveau jusqu'au détail va nous positionner sur la première ligne de détail associée à la  15ème valeur du premier critère (on peut donc directement se retrouver à la page numéro 45 de l'interrogation, cette pagination étant assurée automatiquement).
  

Permet de remonter à un niveau de détail moins fin, en agrégeant les lignes sur le dernier critère pour lequel l'indicateur Groupe est égal à Oui, puis sur les suivants si l'opération est répétée. Seules les informations qui restent valides apparaissent encore dans le tableau, les zones pour lesquelles on a demandé un cumul apparaissant cumulées. Cette navigation en niveaux n'est pas possible sur des requêtes faites avec le requêteur SQL.

Illustrons cette fonction par un exemple tiré de la gestion commerciale. Si on a demandé une requête :

  • par code pays (ce champ ayant l'attribut Groupe égal à Oui)
  • affichant ensuite le nom du pays (dans le groupe 1)
  • puis par client commandeur extrait de l'en-tête de commande (ce champ ayant l'attribut Groupe égal à Oui)
  • affichant ensuite le nom du client (dans le groupe 2)
  • puis par article extrait de la ligne de commande (ce champ ayant l'attribut Groupe égal à Oui)
  • en affichant  le numéro de la commande, une quantité et un prix extraits de la ligne de commande (dans le groupe 4, ces deux derniers champs étant en cumul)

On va obtenir les affichages successifs suivants :

  • tout d'abord, on verra le détail des lignes, le niveau affiché étant 4/4
  • en remontant d'un niveau, on verra une ligne par article et par client. Les champs code pays, nom du pays, code client, nom du client, article resteront affichés. Le numéro de commande sera vide, les informations quantité et prix étant cumulées pour toutes les lignes de commande concernant l'article et le client. Le niveau affiché sera égal à 3/4.
  • en remontant encore d'un niveau, on verra une ligne par client. Les champs code pays, nom du pays, code client, nom du client, resteront affichés. Les champs article et numéro de commande ne sont plus significatifs et ne sont donc plus affichés. Les cumuls concerneront à présent toutes les lignes de commande du client, le niveau affiché étant égal à 2/4.
  • en remontant encore d'un niveau, on verra une ligne par pays. Seuls les champs code pays, nom du pays restent affichés (et bien entendu les cumuls quantité et prix, qui sont maintenant égaux au cumul par pays). Le niveau affiché est à présent 1/4.

Permet de créer, sur le poste client, un fichier au format csv (exploitable par tableur). On donne simplement le chemin du fichier (sans préciser chemin réseau, le poste client étant celui utilisé par défaut). Il est aussi possible de créer le fichier sur un serveur en ligne (pourvu que ce serveur intègre un run-time adonix), grâce à la syntaxe serveur@chemin. Le format du fichier créé est défini par les valeurs de paramètres RQTFMT et RQTSEP.

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Erreur d'écriture

La tentative de création du fichier au format csv a échoué.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre