Aide - Rapport interactif

Owned by Jessica Legault
Dec 30, 2022
8 min read

Aide de l'état interactif

Les états interactifs permettent aux utilisateurs finals de personnaliser les états. Les utilisateurs peuvent modifier la mise en page des données d'état en choisissant des colonnes, en appliquant des filtres, en mettant des valeurs en évidence et en les triant. Ils peuvent également définir des sections, des agrégations, des graphiques, ainsi que des regroupements et ajouter des calculs personnalisés. Ils peuvent aussi définir un abonnement pour l'envoi par courriel d'une version HTML de l'état à un intervalle défini. Il est possible de créer plusieurs versions d'un état et de les enregistrer sous forme d'états nommés, pour une utilisation publique ou privée.

Les sections qui suivent récapitulent les méthodes de personnalisation d'un état interactif. Pour en savoir plus, reportez-vous à "Using Interactive Reports" dans le manuel Oracle Application Express End User's Guide.

Barre de recherche

Une région de recherche se trouve dans la partie supérieure de chaque page d'état. Cette région (ou barre de recherche) fournit les fonctionnalités suivantes :

 

  • L'icône Sélectionner des colonnes permet d'indiquer les colonnes sur lesquelles doit porter la recherche (ou toutes les colonnes).

  • La zone de texte permet d'entrer des critères de recherche sans distinction entre les majuscules et les minuscules (les caractères génériques sont implicites).

  • Le bouton OK permet de lancer la recherche. Si vous appuyez sur la touche Entrée, la recherche sera également exécutée lorsque le curseur se trouve dans la zone de recherche de texte.

  • L'option Etats permet d'afficher les autres états par défaut, et les états enregistrés privés ou publics.

  • Le menu Actions permet de personnaliser un état. Reportez-vous aux sections qui suivent.

Menu Actions

Le menu Actions se trouve à droite du bouton Exécuter dans la barre de recherche. Utilisez ce menu pour personnaliser un état interactif.

Sélectionner des colonnes

Utilisé pour modifier les colonnes affichées. Les colonnes situées sur la droite sont affichées, tandis que celles situées sur la gauche sont masquées. Vous pouvez re-trier les colonnes affichées à l'aide de la flèche située à droite. Les colonnes calculées sont précédées par **.

Filtrer

Active l'état en ajoutant ou modifiant la clause WHERE de la requête. Vous pouvez filtrer par colonne ou par ligne.

Si vous filtrez par colonne, vous devez sélectionner une colonne (pas nécessairement une de celles affichées), choisir un opérateur Oracle standard (=, !=, n'est pas dans, entre), puis saisir une expression à comparer. Les expressions font la distinction entre les majuscules et les minuscules. Vous pouvez utiliser le caractère générique % (par exemple, STATE_NAME like A%).

Si vous filtrez par ligne, vous pouvez créer des clauses WHERE complexes à l'aide d'alias de colonne et de toute fonction ou tout opérateur Oracle (par exemple, G = 'VA' ou G = 'CT', où G est l'alias de CUSTOMER_STATE).

Lignes par page

Définit le nombre d'enregistrements à afficher par page.

Format

L'élément Format permet de personnaliser l'affichage d'un état. Il comprend les sous-menus suivants :

  • Trier

  • Commande BREAK

  • Mise en évidence

  • Calculer

  • Agrégat

  • Graphique

  • Grouper par

  • Pivot

Trier

Utilisé pour modifier les colonnes à utiliser pour trier et déterminer si le tri doit être croissant ou décroissant. Vous pouvez également indiquer comment gérer les valeurs NULL. Le paramètre par défaut affiche toujours les valeurs NULL en premier ou en dernier. Le tri résultant est affiché à droite des en-têtes de colonnes dans l'état.

Commande BREAK

Utilisé pour créer un groupe de section sur une ou plusieurs colonnes, ce qui extrait les colonnes de l'état interactif et les affiche comme enregistrements maître.

Mettre en évidence

Permet de définir un filtre. Les lignes correspondant aux critères du filtre sont mises en évidence à l'aide des caractéristiques associées au filtre. Les options disponibles sont les suivantes :

  • Nom est utilisé uniquement pour l'affichage.

  • Séquence identifie la séquence utilisée pour l'évaluation des règles.

  • Activé indique si la règle est activée ou non.

  • Mettre le type en évidence indique si la ligne ou la cellule doit être mise en évidence. Si vous sélectionnez la cellule, la colonne référencée sous Conditions de mise en évidence sera mise en évidence.

  • Couleur d'arrière-plan indique la nouvelle couleur d'arrière-plan pour les zones mises en évidence.

  • Couleur du texte indique la nouvelle couleur de texte pour les zones mises en évidence.

  • Conditions de mise en évidence définit vos conditions de filtrage.

Calculer

Permet d'ajouter des colonnes calculées à votre état. Il peut s'agir de calculs mathématiques (comme NBR_HOURS/24) ou de fonctions Oracle standard appliquées à des colonnes existantes (certaines sont affichées comme exemple tandis que d'autres, telles que TO_DATE, peuvent également être utilisées). Les options disponibles sont les suivantes :

 

  • Calcul permet de sélectionner un calcul prédéfini à modifier.

  • En-tête de colonne désigne l'en-tête de la nouvelle colonne.

  • Masque de format désigne un masque de format Oracle à appliquer à la colonne (par exemple, S9999).

  • Calcul désigne le calcul à exécuter. Dans le calcul, les colonnes sont référencées à l'aide des alias affichés.

Sous le calcul, les colonnes de votre requête sont affichées avec leur alias associé. Si vous cliquez sur un nom de colonne ou un alias, celui-ci sera inscrit dans le calcul. En regard des colonnes, un clavier fournit simplement des raccourcis pour les touches fréquemment utilisées. A droite se trouvent les fonctions.

Voici un exemple de calcul permettant d'afficher la rémunération totale :

CASE WHEN A = 'SALES' THEN B + C ELSE B END

(où A est ORGANIZATION, B est SALARY et C, COMMISSION)

 

Agréger

Les agrégats sont des calculs mathématiques réalisés sur une colonne. Ils sont affichés après chaque commande BREAK et à la fin de l'état dans la colonne où ils sont définis. Les options disponibles sont les suivantes :

 

  • Agrégation permet de sélectionner un agrégat prédéfini à modifier.

  • Fonction est la fonction à exécuter (exemple : SUM, MIN).

  • Colonne permet de sélectionner la colonne à laquelle appliquer la fonction mathématique. Seules les colonnes numériques seront affichées.

Graphique

Vous pouvez définir un graphique par état interactif. Une fois que vous l'avez défini, vous pouvez basculer de la vue du graphique à celle de l'état à l'aide des icônes de vue situés sous la barre de recherche. Les options disponibles sont les suivantes :

 

  • Type de graphique indique le type de graphique à inclure. Sélectionnez A barres horizontales, A barres verticales, A secteurs ou A courbes.

  • Libellé permet de sélectionner la colonne à utiliser comme libellé.

  • Titre de l'axe pour le libellé indique le titre qui apparaîtra sur l'axe associé à la colonne définie comme libellé. Cette option n'est pas disponible pour les graphiques à secteurs.

  • Valeur permet de sélectionner la colonne à utiliser comme valeur. Si votre fonction est de type COUNT, il est inutile de sélectionner une valeur.

  • Titre de l'axe pour la valeur indique le titre qui apparaîtra sur l'axe associé à la colonne définie comme valeur. Cette option n'est pas disponible pour les graphiques à secteurs.

  • Fonction est une fonction facultative à exécuter sur la colonne sélectionnée comme valeur.

  • Trier permet de trier l'ensemble de résultats.

Grouper par

Vous pouvez définir une vue Grouper par pour chaque état enregistré. Une fois défini, vous pouvez basculer entre la vue Grouper par et la vue d'état à l'aide des icônes de vue situées en dessous de la barre de recherche. Pour créer une vue Grouper par, vous sélectionnez :

 

  • les colonnes sur la base desquelles former le groupe

  • les colonnes à agréger, ainsi que la fonction à exécuter (moyenne, somme, nombre, etc.)

Permutation lignes vers colonnes

Vous pouvez définir une vue de permutation lignes vers colonnes pour chaque état enregistré. Cela permet ensuite de basculer entre la vue de permutation lignes vers colonnes et la vue d'état à l'aide des icônes d'affichage de la barre de recherche. Pour créer une vue de permutation lignes vers colonnes, vous devez sélectionner :

 

  • les colonnes sur lesquelles effectuer la permutation lignes vers colonnes ;

  • les colonnes à afficher en tant que lignes ;

  • les colonnes à agréger, ainsi que la fonction à exécuter (moyenne, somme, décompte, etc.).

Flashback

Une requête Flashback vous permet de visualiser les données telles qu'elles existaient à un moment donné. Par défaut, l'opération Flashback permet de remonter à 3 heures (ou 180 minutes) mais la durée réelle sera différente en fonction de la base de données.

Enregistrer un état

Enregistre l'état personnalisé en vue d'une utilisation ultérieure. Vous devez indiquer un nom, pouvez entrer une description et rendre l'état accessible au public (à savoir, à tous les utilisateurs pouvant accéder à l'état par défaut principal). Vous pouvez enregistrer quatre types d'état interactif :

  • Val. par défaut du principal (développeur uniquement) : l'état par défaut principal est celui qui est affiché initialement. Les états de ce type ne peuvent être ni renommés, ni supprimés.

  • Etat de remplacement (développeur uniquement) : permet aux développeurs de créer différentes mises en page d'état. Seuls les développeurs sont autorisés à enregistrer, renommer et supprimer ce type d'état.

  • Etat public (utilisateur final) : ce type d'état peut être enregistré, renommé et supprimé par l'utilisateur final l'ayant créé. Les autres utilisateurs peuvent visualiser et enregistrer la mise en page, comme pour les autres états.

  • Etat privé (utilisateur final) : seul l'utilisateur final ayant créé l'état est autorisé à le visualiser, l'enregistrer, le renommer et le supprimer.

Lorsque vous enregistrez des états personnalisés, un sélecteur d'états apparaît dans la barre de recherche à gauche du sélecteur de lignes (à condition que cette fonctionnalité soit activée).

Réinitialiser

Réinitialise l'état pour retrouver les paramètres par défaut, ce qui enlève toute personnalisation effectuée.

Télécharger en local

Permet le téléchargement de l'ensemble de résultats en cours. Les formats de téléchargement seront différents en fonction de votre installation et de la définition d'état, et pourront inclure CSV, HTML, courriel, XLS, PDF ou RTF.

Abonnement

Lorsque vous ajoutez un abonnement, vous fournissez une adresse électronique (ou plusieurs adresses électroniques séparées par des virgules), un objet de courriel, une fréquence, et des dates de début et de fin. Les courriels obtenus seront une version HTML de l'état interactif contenant les données en cours utilisant les paramètres d'état présents lors de l'ajout de l'abonnement.

Menu d'en-tête de colonne

Si vous cliquez sur un en-tête de colonne, cela affiche un menu d'en-tête de colonne. Les options disponibles sont les suivantes :

 

  • Icône de tri par ordre croissant : permet de trier les états par ordre croissant.

  • Icône de tri par ordre décroissant : permet de trier les états par ordre décroissant.

  • Masquer la colonne : permet de masquer une colonne. Les colonnes ne peuvent pas toutes être masquées. Si une colonne ne peut pas l'être, cette icône n'est pas disponible.

  • Colonne de section (BREAK) : permet de créer un groupe de section sur la colonne, ce qui extrait la colonne de l'état comme enregistrement maître.

  • Informations de colonne : permet d'afficher l'aide de la colonne, si elle existe.

  • Zone de texte : permet de saisir des critères de recherche, sans distinction entre les majuscules et les minuscules (caractères génériques inutiles). Si vous saisissez une valeur, cela réduira la liste de valeurs au bas du menu. Vous pourrez ensuite sélectionner une valeur du bas du menu et cette valeur sera créée en tant que filtre grâce à l'opérateur '=' (par exemple, colonne = 'ABC'). Vous pouvez également cliquer sur l'icône représentant une torche pour que la valeur saisie soit créée en tant que filtre avec le modificateur 'LIKE' (par exemple, colonne LIKE '%ABC%').

  • La liste de valeurs uniques contient les 500 premières valeurs uniques correspondant à vos filtres. Si la colonne est une date, une liste de plages de dates s'affiche à la place. Si vous sélectionnez une valeur, un filtre sera créé avec l'opérateur '=' (par exemple, colonne = 'ABC').

Paramètres d'état

Si vous personnalisez un état interactif, les paramètres d'état seront affichés en dessous de la barre de recherche et au-dessus de l'état. Cette zone peut être réduite et développée à l'aide de l'icône de gauche.

Pour chaque paramètre d'état, vous pouvez effectuer les opérations suivantes :

  • Modifier un paramètre en cliquant sur le nom.

  • Désactiver/Activer un paramètre en cochant ou en désélectionnant la case Activer/Désactiver. Ceci permet d'activer et de désactiver temporairement le paramètre.

  • Enlever un paramètre en cliquant sur l'icône Enlever.

Si vous avez créé un graphique, un regroupement ou un pivot, vous pouvez basculer entre eux et l'état de base via les liens de vue d'état, Vue de graphique, Vue Grouper par et Vue de pivot sur la droite. Si vous visualisez le graphique, le regroupement ou le pivot, vous pouvez également utiliser le lien Modifier pour modifier les paramètres.