Création d'une requête de rapport sur les journaux Enterprise

La création d'une requête est la première étape de la création d'un rapport personnalisé. Le processus de création d'une requête pour générer des rapports personnalisés dans le système implique de sélectionner le type de rapport, de définir des filtres et de générer du code SQL afin d'extraire les données pertinentes.

Pour créer des requêtes, procédez comme suit :

Sur la page d'accueil, sélectionnez Application, puis sélectionnez le rapport (par exemple, Rapports de non-consolidation).
Dans l'onglet Requêtes, sélectionnez Nouveau.
Sur l'écran Nouvelle requête, saisissez un nom et une description (facultative).
Dans Type, sélectionnez l'une des options suivantes :
- Requête de paramètre
  
  Une requête de paramètre sert à présenter une liste d'options que vous pouvez définir pour la valeur du paramètre. Une requête de paramètre vous permet de présenter une liste d'options à utiliser pour indiquer la valeur d'un paramètre pour une requête de rapport. Elle sert dans les cas où la liste d'options n'est pas un simple attribut déjà défini mais une requête complexe que vous devez définir.
- Requête de rapport
  
  Sélectionnez les enregistrements à inclure dans le rapport. Vous pouvez appliquer un filtre de sécurité afin que les utilisateurs ne puissent consulter que les données qu'ils sont autorisés à voir d'après leurs rôles et les rapports auxquels ils sont affectés. Pour appliquer un filtre de sécurité à une requête de rapport, ajoutez la syntaxe suivante à la fin de l'instruction de la clause WHERE dans la requête.
  
  $FCC_SECURITY_CLAUSE$
Cliquez sur Générer la requête pour créer la requête. La fenêtre Générer la requête vous aide à créer une requête sur la base de données en vous permettant de sélectionner dans le produit un attribut existant pour lequel effectuer une recherche ou un filtrage. Cette fenêtre comporte trois sections : Sélectionner un type, Sélectionner des colonnes et Sélectionner des filtres. Le système génère alors le code SQL correspondant aux attributs et filtres indiqués, code que vous pouvez alors modifier et améliorer.
1. Dans Sélectionner un type, sélectionnez les éléments suivants :
  - Dans Module, sélectionnez Journaux Enterprise.
  - Dans Requête, sélectionnez Workflow.
  - Facultatif : cochez la case Appliquer la sécurité pour appliquer automatiquement le filtre de sécurité utilisateur à la requête générée. Ceci applique le jeton de sécurité à la requête, pour qu'elle présente l'instruction SQL correcte lors de la génération du rapport.
2. Cliquez sur Suivant.
3. Dans Sélectionner des colonnes, sélectionnez les colonnes à afficher dans la requête, puis cliquez sur Suivant.
4. Dans Sélectionner des filtres, cliquez sur Créer une condition ou sur Créer un groupe de conditions et sélectionnez les conditions afin de créer les filtres en vue de la création de la requête.
Pour générer un exemple de fichier XML à partir de la requête, cliquez sur Générer le fichier XML exemple.
Cliquez sur Enregistrer.
Pour vérifier que la requête ne comporte pas d'erreurs, procédez comme suit :
- Cliquez sur Valider dans la boîte de dialogue Nouvelle requête. Vous pouvez également sélectionner Valider dans la liste déroulante.
  
  La requête s'affiche dans l'onglet Requêtes.
  
  Remarque :
  Vous pouvez facilement supprimer ou dupliquer une requête à l'aide du menu Actions.
- Cliquez sur Valider et générer un plan d'explication dans la liste déroulante afin de valider la requête et de générer le plan d'exécution pour cette dernière. Un fichier .txt portant le même nom que la requête est généré. Vous pouvez afficher ou télécharger le plan généré.
  Ouvrez ce fichier afin d'afficher le plan généré qui contient la séquence des étapes effectuées pour exécuter cette requête. Si les performances d'une requête ne sont pas optimales, vous pouvez utiliser ce plan pour comprendre la cause du problème et déterminer la meilleure façon de les améliorer.