Manuel d'implémentation › Implémentation › Création de livrables (gestionnaire de contrats) › Création de rapports › Rapports au format libre

Rapports au format libre

Les rapports au format libre permettent aux utilisateurs de générer des rapports d'après des requêtes SQL de la base de données CA Business Service Insight ou d'une autre source de données externe, qui peut être accédée via une connexion du serveur CA Business Service Insight. Cela inclut également tout autre type de source de données à laquelle il est possible d'accéder via ODBC, comme Excel, Access, Lotus Notes, les fichiers texte, etc. Les rapports au format libre sont souvent utilisés pour configurer des rapports statistiques d'après des données créées par les commandes de logique applicative Tools.SaveRecord et Tools.SaveFields.

Les rapports au format libre se connectent via une chaîne de connexion à une base de données sélectionnée et exécutent une requête SQL sur la base de données en utilisant une chaîne de requêtes. Il est possible d'ajouter des paramètres aux deux chaînes afin de créer des rapports dynamiques qui permettent à l'utilisateur de saisir ou de sélectionner des valeurs spécifiques à inclure dans la requête, comme le nom et le mot de passe de l'utilisateur pour se connecter à la base de données.

Les rapports au format libre sont affichés dans les onglets Graphique, Donnée et Filtrer comme le sont les rapports générés à l'aide de l'assistant de création de rapports.

Remarque : Les rapports au format libre peuvent inclure des graphiques, uniquement si toutes les colonnes, en dehors de la première colonne, sont numériques. Les données figurant dans la première colonne permettent de nommer l'axe X. Le nom des colonnes est utilisé pour les autres titres.

Du fait que les rapports au format libre utilisent un accès direct à une base de données et à une requête SQL ouverte, la maintenance est problématique. La plus grande prudence s'impose pour ne pas affecter les données sous-jacentes qui servent de source pour les rapports au format libre. Lorsque les rapports sont générés à partir d'une source de données externe, il est recommandé de configurer un processus de notification pour assurer que ces sources de données ne sont pas sujettes à modifications sans d'abord avoir consulté le gestionnaire de contrats responsable des rapports de données au format libre.

Informations générales à garder à l'esprit lors de la création de rapports au format libre.

• En raison de problèmes de formatage international des dates, il est souvent utile de préciser le format exact pour la date en créant une formule personnalisée dans la logique applicative. Cela permet de convertir la date en une chaîne du même format chaque fois et évite les problèmes de formatage de dates entre les Etats-Unis et l'Union européenne. Cette méthode doit être utilisée pour les dates inscrites dans la table T_SLALOM_OUTPUTS via les commandes Tools.SaveFields ou Tools.SaveRecord. La formule modèle est fournie ci-dessous :

Fonction FormatDate(DateField)

    If DateField = "" Then
      FormatDate = ""
    Else
      Dim PeriodYear, PeriodMonth, PeriodDay, PeriodHour,
  PeriodMinute, PeriodSecond
      PeriodYear    = DatePart("yyyy",DateField)
      PeriodMonth   = DatePart("m",DateField)
      PeriodDay     = DatePart("m",DateField)
      PeriodHour    = DatePart("m",DateField)
      PeriodMinute  = DatePart("m",DateField)
      Periodsecond  = DatePart("s",DateField)
      FormatDate  = PeriodDay&"/"&PeriodMonth&"/"&PeriodYear& _
 " "&PeriodHour&":"&PeriodMinute&":"&Periodsecond
    End If
End Function

• Lors de l'emploi du paramètre heure des gestionnaires d'événements de la logique applicative ou de tout horodatage de l'objet eventDetails, tenez toujours compte de l'impact du changement horaire. Soyez conscient que, lors du report de dates dans la table, l'heure peut être fournie au format UTC plutôt qu'en heure locale. Il vous faudra peut-être utiliser la fonction Tools.GetLocaleTime() pour y remédier.
• Vous pouvez toujours utiliser l'utilitaire de conception de rapport (lorsqu'un rapport au format libre produit un graphique) pour personnaliser l'aspect.
• Les options d'exportation au format PDF pour le rapport au format libre sont personnalisables via la section Paramètres de rapport de la fenêtre de configuration du format libre. Vous pouvez, par exemple, personnaliser la mise en page (portrait ou paysage).
• Vous pouvez incorporer du code HTML dans les rapports pour exécuter différentes fonctionnalités, comme ajouter des liens hypertexte ou changer les couleurs de colonne et de ligne, les polices ou les paramètres d'affichage.
• Vous pouvez créer des vues de base de données (fonctionnalité Oracle) dans la table T_SLALOM_OUTPUTS, afin de simplifier le langage SQL requis pour les rapports.
• Lors de la spécification de paramètres pour les rapports, vous pouvez les définir de diverses façons. Par exemple : texte libre, numérique (valider), mot de passe (caractères masqués - utile pour les mots de passe des connexions de base de données), date (en utilisant le sélecteur de dates fourni) et listes (créées en spécifiant une instruction SQL pour remplir la liste).
• Les valeurs de paramètre spécifiées dans la section SQL du rapport au format libre doivent être remplacées par le nom de paramètre, précédé du symbole @. Par exemple : @PARAM1. L'utilisation de guillemets pour encadrer cette valeur de paramètre peut être exigée s'il s'agit d'une chaîne.