Paramètres Report.cfg

Informations sur les paramètres Report.cfg.

L’exemple Report.cfg illustré dans Configurer le jeu de rapports contient uniquement les paramètres inclus dans le fichier Report.cfg par défaut. Le tableau suivant fournit une description de tous les paramètres de fichier Report.cfg disponibles.

Si vous devez ajouter des paramètres supplémentaires à un fichier Report.cfg, vous devez le faire à l’aide d’un éditeur de texte. Pour connaître les étapes à suivre, y compris des exemples de définition de chaque entrée de paramètre, voir Modification des fichiers Report.cfg existants.

REMARQUE

Les paramètres de ce tableau sont classés par ordre alphabétique. Lorsque vous ouvrez le fichier Report.cfg en Data Workbench, les vecteurs sont répertoriés dans l’ordre alphabétique, suivi des paramètres individuels répertoriés dans l’ordre alphabétique.

Paramètre Description
Seuil d’alerte

Facultatif. Ce paramètre s’applique uniquement aux rapports avec indicateurs de mesure. Nombre d’indicateurs de mesure qui doivent apparaître dans la feuille de calcul avant l’envoi d’un rapport d’alerte.

Si une seule mesure est surveillée dans la feuille de calcul de l’indicateur de mesure, définissez le seuil sur 1. Le rapport est généré lorsque la mesure dans la feuille correspond à une flèche vers le haut/vers le bas ou à un X. Si plusieurs mesures sont surveillées dans le rapport, vous pouvez sélectionner le nombre d’indicateurs de mesures à évaluer à l’aide d’une flèche vers le haut/vers le bas ou d’un X avant la génération du rapport. Par exemple, si deux mesures sont surveillées :

  • Si le seuil est défini sur 1, le rapport est généré si l’une des mesures de la feuille prend la valeur d’une flèche haut/bas ou d’un X.
  • Si le seuil est défini sur 2, les deux mesures doivent correspondre à une flèche haut/bas ou à un X avant la génération du rapport.

Pour plus d’informations sur les indicateurs de mesure, consultez le Guide de l’utilisateur du Data Workbench.

Autoriser la régénération des rapports

Indique si le serveur de rapports génère ou régénère automatiquement des rapports particuliers lorsque vous créez ou modifiez ces rapports. Les options sont true ou false. Si la valeur est définie sur true, la création ou la modification d’un espace de travail de rapport entraîne le serveur de rapports à régénérer ce rapport pour l’exécution la plus récente.

Remarque : Si vous modifiez le fichier Report.cfg , Report Server régénère tous les rapports contrôlés par ce fichier Report.cfg .

Pièces jointes

Facultatif. Identifiant de section pour le nom et le type de contenu de toutes les pièces jointes contenant des rapports distribués par email, y compris le nombre de pièces jointes.

Pour ajouter une nouvelle pièce jointe :

  1. Ouvrez le fichier Report.cfg en Data Workbench.
  2. Cliquez avec le bouton droit de la souris sur Pièces jointes et cliquez sur Ajouter un nouvel enfant > Pièce jointe .

Type de contenu

Type de contenu du fichier à joindre.

Exemple : image/jpeg

Nom de fichier

Emplacement et nom du fichier à joindre.

Exemple : c:\myimage.jpg

Jeu de couleurs Identifie le jeu de couleurs à utiliser pour les fichiers .png . 0 est destiné à un arrière-plan noir ; 1 est destiné à un arrière-plan blanc ; et 2 correspond à une image en niveaux de gris.
Commande À Exécuter Facultatif. Commande par lot ou exécutable qui s’exécute après la génération du jeu de rapports. Si le lancement de l’interpréteur de commandes shell est requis, faites précéder la commande de cmd /c.
Modèle Excel par défaut

Facultatif. Nom de fichier du fichier de modèle Excel générique ( .xls ou .xlsx ) que vous souhaitez utiliser lors de la génération de rapports sous forme de fichiers Excel. Ce paramètre prend en charge les chemins d’accès aux fichiers complets, tels que c:\templates\mytemplate.xls .

Ce fichier est utilisé pour tous les rapports Excel, sauf si un modèle a été défini spécifiquement pour un rapport particulier. Voir Utilisation d’un fichier modèle .

Nom de la dimension Facultatif. Nom de la dimension pour laquelle vous souhaitez générer dynamiquement un rapport. Si vous saisissez un nom de dimension dans ce paramètre, vous devez saisir une valeur dans le paramètre Fichier de recherche ou dans les paramètres Mesure N supérieure et Valeur N supérieure . La dimension nommée dans ce paramètre doit exister dans le jeu de données pour lequel des rapports sont créés.
Courrier électronique uniquement si parfait Facultatif. Permet à l’utilisateur de spécifier qu’un jeu de rapports ne doit être envoyé que lorsqu’aucune erreur ne s’est produite lors de l’exécution. Les options sont true et false. La valeur par défaut est false.
Date de fin

Facultatif. Date et heure de dernière exécution du jeu de rapports. Cette fois est basée sur l’heure "À partir de" du jeu de données.

Format : Fuseau horaire MM/JJ/AAAA hh:mm, en utilisant la syntaxe de 24 heures pour l’heure

Exemple : 08/01/2007 12:01 EDT

Pour plus d’informations sur les paramètres de fuseau horaire, consultez le Guide de configuration des jeux de données.

Tous les Fréquence de génération des jeux de rapports : jour, semaine ou mois.
Délai d’expiration d’Excel Watchdog (secondes)

Facultatif. Nombre de secondes pendant lesquelles Report Server doit attendre que Microsoft Excel réponde lors de la génération d’un rapport sous la forme d’un fichier Excel avant Report Server , qui décide qu’Excel ne répond pas et interrompt le processus. L’utilisation de ce paramètre permet à Report Server d’arrêter Excel lorsqu’il ne répond plus et de continuer à traiter vos rapports non Excel. La valeur par défaut est 300.0. Pour désactiver cette fonctionnalité, définissez ce paramètre sur 0.0.

Assurez-vous que la valeur que vous définissez est suffisamment longue pour permettre l’export du rapport vers Excel. Sinon, le serveur de rapports peut mettre fin prématurément à Excel et votre rapport ne sera pas généré.

Formule de filtre

Facultatif. Filtre appliqué à chaque espace de travail du jeu de rapports.

Pour plus d’informations, voir la syntaxe pour la création de filtres .

Correction Gamma

Paramètre Gamma pour la sortie de fichier .png . La valeur par défaut est de 1.6.

Remarque : Adobe recommande de ne pas modifier cette valeur.

Masquer les logos Indique si le serveur de rapports masque les logos lors de la génération de vos rapports. Les options sont true ou false . S’il est défini sur false , votre rapport est généré avec le logo du rapport. La valeur par défaut est false .
Fichier de recherche

Facultatif. Lorsque ce paramètre est renseigné, le serveur de rapports s’exécute en mode dynamique et génère des rapports pour chaque élément de la dimension spécifié dans le paramètre Nom de la Dimension. Ce fichier doit contenir deux colonnes délimitées par des tabulations, sans ligne d’en-tête.

  • La colonne 1 contient une liste d’éléments de dimension.
  • La colonne 2 contient les adresses email des destinataires du rapport. Un rapport pour un élément donné de la colonne 1 est envoyé à l’adresse email sur la même ligne de la colonne 2. Vous pouvez saisir plusieurs adresses électroniques en les séparant par des virgules (sans espaces). Si les rapports ne doivent pas être envoyés par courriel, cette colonne peut être vide, mais doit exister.

Remarque : Si vous saisissez une valeur dans ce paramètre, vous devez en saisir une dans le paramètre Nom de la Dimension .

Notification uniquement Ce paramètre Serveur de rapports vous permet de configurer Data Workbench pour envoyer un courrier électronique lorsqu’un rapport est généré. La définition de cette valeur sur true n’envoie pas le rapport, mais envoie plutôt un courrier électronique informant l’utilisateur abonné que le rapport a été généré.
Rapport de messagerie

Identifiant de section pour la diffusion des rapports par email. Pour distribuer les rapports par email, renseignez les paramètres suivants pour l'entrée Rapport de messagerie . Tous les rapports du jeu de rapports sont envoyés par courriel, en un seul message, aux adresses électroniques spécifiées dans le paramètre Destinataires .

Remarque : Le serveur de rapports n’envoie un courrier électronique que lorsqu’il a généré au moins un rapport.

Pour activer l'envoi des rapports par courrier électronique, vous devez renseigner au moins les paramètres suivants pour cette entrée :

  • Serveur SMTP
  • Destinataires
  • Adresse de l’expéditeur
  • Notification uniquement

Remarque : Pour envoyer des rapports par courrier électronique après avoir recréé un jeu de rapports, voir Modification de fichiers Report.cfg existants .

La valeur Notification uniquement est disponible dans les versions 5.4x et 5.5x.

Pour qu’un grand nombre de destinataires soient avertis (plus de 20), il est vivement recommandé d’utiliser les listes de distribution d’emails.

Modèle XSL Body

Facultatif. Chemin du fichier de modèle XSL à appliquer au fichier reports.xml . L’utilisation de ce paramètre permet au serveur de rapports d’envoyer vos rapports dans l’e-mail distribué plutôt que sous forme de pièces jointes. Le texte obtenu est utilisé comme corps du message électronique.

Voir Fichiers d’exemple de rapport pour un fichier d’exemple.

Pour plus d’informations sur le langage XSLT (Extensible Stylesheet Language), voir The Extensible Stylesheet Language Family .

Destinataires Adresses électroniques des personnes à qui vous souhaitez envoyer le rapport.
Adresse de l’expéditeur Adresse électronique de l’expéditeur.
Nom de l’expéditeur Facultatif. Nom de l'expéditeur.
Serveur SMTP Adresse du serveur SMTP et mot de passe et nom d’utilisateur requis pour l’authentification.
Objet Facultatif. Objet décrivant l'email à envoyer.
Notification uniquement Permet de configurer Data Workbench pour envoyer un courrier électronique lorsqu’un rapport d’arrière-plan est généré. La définition de cette valeur sur True n’envoie pas le rapport, mais envoie plutôt un courrier électronique liant l’utilisateur abonné à l’emplacement du rapport.
Racine de sortie

Facultatif. Emplacement de sortie des jeux de rapports générés. La valeur par défaut est le dossier <nom du profil>\Reports dans le répertoire d’installation du serveur de rapports.

Pour configurer le serveur de rapports afin de générer les rapports sur un portail, définissez la racine de sortie sur la racine du document du serveur web utilisé pour le portail.

Filtre de requête de préchargement

Facultatif. Ce paramètre s’applique uniquement au type de rapport Elément Dimension supérieure .

Nom du filtre à appliquer à la requête qui doit être exécuté pour déterminer les N premiers éléments de dimension avant la génération du rapport. La valeur par défaut est Broken_Session_Filter . Pour plus d’informations sur le filtre de session endommagé , consultez le Guide de l’utilisateur du Data Workbench.

Types de rapports

Format(s) dans lequel vous souhaitez générer votre sortie. Vous pouvez utiliser l’une ou l’autre des options suivantes pour générer simultanément un jeu de rapports dans plusieurs formats :

  • Excel crée un classeur Excel avec une visualisation par feuille de calcul. En règle générale, utilisez des fichiers Excel pour la distribution des emails. Voir Génération de rapports sous la forme de fichiers Microsoft Excel . Pour plus d’informations sur l’utilisation d’un fichier de modèle, voir Utilisation d’un fichier de modèle .
  • png crée des fichiers Portable Network Graphic. En règle générale, utilisez les fichiers .png pour l’affichage dans un navigateur web (portail).
  • La miniature crée une miniature ( fichier .jpg ) de l’espace de travail. La taille par défaut est de 240 x 180. Pour modifier la taille par défaut, modifiez les paramètres Miniature X et Miniature Y .

Pour ajouter un nouveau type de rapport lors de la modification de Report.cfg dans Data Workbench, cliquez avec le bouton droit de la souris sur Types de rapports , cliquez sur Ajouter un nouvel enfant et sélectionnez le type de rapport souhaité.

Date de début

Date et heure auxquelles vous souhaitez que le jeu de rapports s’exécute pour la première fois. Cette fois est basée sur l’heure "À partir de" du jeu de données.

Format : Fuseau horaire MM/JJ/AAAA hh:mm, en utilisant la syntaxe de 24 heures.

Pour plus d’informations sur les paramètres de fuseau horaire, consultez le Guide de configuration des jeux de données.

Remarque : Les rapports commencent à s’exécuter lorsque les horodatages des données du profil correspondent à la date et à l’heure spécifiées.

Exemple :

Si la date de début est 08/08/2006 12h00 (heure de l’Est), les rapports s’exécutent pour les données avec un horodatage de 08/08/2006 12h00 (heure de l’Est) et versions ultérieures.

  • Les rapports quotidiens s’exécuteront pour 08/08/2006, puis chaque jour pour les données avec hh:mm = 12:00 HNE.
  • Les rapports hebdomadaires s’exécuteront pour 08/08/2006 et, chaque 7e jour par la suite, pour les données dont hh:mm = 12:00 HNE.
  • Les rapports mensuels s’exécuteront pour 08/08/2006 et pour le 8e jour de chaque mois par la suite pour les données avec hh:mm = 12:00 HNE.

La mesure Heure du rapport affecte les dimensions de rapport "N derniers", telles que "7 derniers jours", "hier" et "3 semaines auparavant". Pour les requêtes du serveur de rapports, la mesure Report Time ( Report Time.metric ) identifie la date et l’heure d’exécution des rapports. Il s’agit initialement de la date et de l’heure spécifiées dans le paramètre Date de début , qui est ensuite incrémenté selon la période spécifiée par le paramètre Chaque . Pour les requêtes dans Data Workbench, la mesure Report Time est basée sur minuit de la mesure A partir de ( As Of.metric ). En raison de la différence entre les définitions de la mesure Temps du rapport, si vous interrogez un espace de travail qui utilise une dimension N dernier, vous pouvez recevoir des résultats différents dans Data Workbench et Report Server pour le même espace de travail.

Miniature X Facultatif. Entier contrôlant la taille (en pixels) de l’axe X des miniatures générées en sortie.
Miniature Y Facultatif. Entier contrôlant la taille (en pixels) de l’axe Y des miniatures générées en tant que sortie.
Mesure N supérieure

Facultatif. Voir la description du paramètre Top N Value .

Remarque : Si vous saisissez une valeur dans ce paramètre, vous devez saisir une valeur dans le paramètre Nom de la Dimension et le paramètre N valeur supérieure .

Valeur N supérieure

Facultatif. Lorsque ce paramètre est renseigné, Report Server s’exécute en mode dynamique et génère des rapports pour le nombre supérieur (spécifié dans ce paramètre) d’éléments pour la dimension spécifiée dans le paramètre du nom de la Dimension, en comptant la mesure spécifiée dans le paramètre de la mesure N supérieure.

Exemple : Si vous entrez Page dans le paramètre Nom de la Dimension , Sessions dans le paramètre Mesure N supérieure et 5 dans ce paramètre, le rapport généré répertorie les cinq premières pages avec le nombre de sessions le plus élevé.

Remarque : Si vous saisissez une valeur dans ce paramètre, vous devez en saisir une dans le paramètre Nom de la Dimension et le paramètre Mesure N supérieure .

Utilisation d’un exemple local uniquement Facultatif. Indique si vous souhaitez que Report Server génère des rapports en utilisant uniquement l’échantillon local du jeu de données. La définition de ce paramètre sur true vous permet d’afficher un exemple du jeu de rapports (sans charger sur un serveur Data Workbench) pour voir à quoi ressemble la sortie sans prendre tout le temps nécessaire pour traiter entièrement les données. Cela fonctionne comme une fonction de test. Les options sont true ou false. La valeur par défaut est false.
Chemin de l’espace de travail

Facultatif. Emplacement d’une collection d’espaces de travail pour un jeu de rapports donné. Cela s’avère utile pour gérer une seule copie des espaces de travail qui doivent être générés et distribués de plusieurs manières, à l’aide des fichiers Report.cfg pour plusieurs jeux de rapports. Le répertoire racine de ce chemin d’accès peut être n’importe quel dossier de profil. Ne saisissez pas de barre oblique (\) au début de la chaîne de chemin.

Exemple : Vous pouvez enregistrer les espaces de travail communs pour les jeux A et B dans le dossier Reports\Common , puis définir les fichiers Report.cfg pour deux jeux de rapports différents, chacun avec des paramètres de génération et de distribution différents. Dans les deux fichiers Report.cfg , vous définiriez le paramètre Chemin d’accès à l’espace de travail sur nom du profil\Reports\Common.

Fichier de sortie XSL Facultatif. Chemin du fichier de sortie créé lorsque le modèle XSL est appliqué à l’index du rapport.
Modèle XSL

Facultatif. Chemin du fichier de modèle XSL à appliquer à l'index du rapport. Le .xml transformé qui en résulte est écrit dans le fichier de sortie XSL spécifié . Voir Fichiers d’exemple de rapport pour un fichier d’exemple.

Remarque : À moins que vous n’utilisiez un modèle .xsl lors de la génération de vos rapports, tous les rapports sont distribués par e-mail sous forme de pièces jointes.

Sur cette page