Paramètres Report.cfg

Informations sur les paramètres Report.cfg.

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

Si vous devez ajouter des paramètres supplémentaires à un Report.cfg fichier, 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 fichiersReport.cfg existants.

Remarque

Les paramètres de ce tableau sont répertoriés par ordre alphabétique. Lorsque vous ouvrez le Report.cfg fichier dans les Outils de données, les vecteurs sont répertoriés par ordre alphabétique, suivi des paramètres individuels répertoriés par ordre alphabétique.

Paramètre Description
Seuil d'alerte

Facultatif. Ce paramètre s’applique uniquement aux rapports avec des 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 est évaluée à une flèche vers le haut/bas ou à un X. Si plusieurs mesures sont surveillées dans le rapport, vous pouvez sélectionner le nombre d’indicateurs de mesure à évaluer avec une flèche vers le haut/vers le bas ou 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 est évaluée sur une flèche vers le haut/bas ou sur un X.
  • Si le seuil est défini sur 2, les deux mesures doivent être évaluées sur une flèche vers le haut/bas ou sur un X avant la génération du rapport.

Pour plus d’informations sur les indicateurs de mesure, consultez le Guide de l’utilisateur des outils dedonnées.

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 les créez ou les modifiez. Les options sont true ou false. Si ce paramètre est défini sur true, la création ou la modification d’un espace de travail de rapport entraîne la régénération du rapport par le serveur de rapports pour l’exécution la plus récente.

Remarque : Si vous modifiez le fichier .cfg , le serveur de rapports 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 qui accompagnent les rapports distribués par courrier électronique, y compris le nombre de pièces jointes.

Pour ajouter une nouvelle pièce jointe :

  1. Ouvrez le fichier .cfg dans Outils de données.
  2. Cliquez avec le bouton droit 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 modèle de couleurs à utiliser pour les fichiers .png . 0 correspond à 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 ) à 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 de 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 N 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 au cours de l’exécution. Les options sont true et false. La valeur par défaut est false.
Date de fin

Facultatif. Date et heure auxquelles vous souhaitez que le rapport s'exécute en dernier. Cette heure est basée sur l’heure A partir du moment 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 HAE

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

Tous les Fréquence de la génération du jeu de rapports : jour, semaine ou mois.
Délai d’expiration du module de surveillance Excel (secondes)

Facultatif. nombre de secondes pendant lesquelles le serveur de rapports doit attendre que Microsoft Excel réponde lors de la génération d’un rapport sous la forme d’un fichier Excel avant que le serveur de rapports ne décide qu’Excel ne répond pas et interrompt le processus. L’utilisation de ce paramètre permet au serveur de rapports 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 définie est suffisamment longue pour permettre l’exportation 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 de création de filtres .

Correction gamma

Paramètre Gamma pour la sortie du 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 des rapports. Les options sont true ou false . Si la valeur est définie sur false , votre rapport est généré avec le logo du rapport. The default is 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 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 électroniques des destinataires du rapport. Un rapport pour un élément donné de la colonne 1 est envoyé à l’adresse électronique sur la même ligne de la colonne 2. Vous pouvez entrer plusieurs adresses électroniques en les séparant par des virgules (sans espace). 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 dimension.

Notification uniquement Ce paramètre Serveur de rapports vous permet de configurer l’outil de données 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 Courrier

Identifiant de section pour la distribution des rapports par courrier électronique. Pour distribuer les rapports par courrier électronique, renseignez les paramètres suivants pour l’entrée Rapport par courrier . Tous les rapports du jeu de rapports sont envoyés par courrier électronique dans un message aux adresses électroniques spécifiées dans le paramètre Destinataires.

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

Pour activer l’envoi par courriel des rapports, vous devez exécuter 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 des listes de distribution par courrier électronique.

Modèle XSL de contenu

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 le courrier électronique distribué plutôt que sous forme de pièces jointes. Le texte qui en résulte est utilisé comme corps du message électronique.

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

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

Destinataires Adresses électroniques des personnes auxquelles 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.
Sujet Facultatif. Objet décrivant le courrier électronique à envoyer.
Notification uniquement Vous permet de configurer l’outil de données 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 reliant 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 qu’il génère des rapports sur un portail, définissez la racine de sortie sur la racine de document du serveur Web utilisé pour le portail.

Précharger le filtre de requête

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

Nom du filtre à appliquer à la requête qui doit être exécutée pour déterminer les N principaux é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 rompue , consultez le Guide de l’utilisateur des outils dedonnées.

Types de rapports

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

  • 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 par courrier électronique. Voir Génération de rapports sous 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 des 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 X de la miniature et Y de la miniature.

Pour ajouter un nouveau type de rapport lors de la modification de .cfg dans l’outil de données, cliquez avec le bouton droit de la souris sur Types de rapports , cliquez sur Ajouter un nouvel enfant , puis sélectionnez le type de rapport souhaité.

Date de début

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

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

Pour plus d’informations sur les paramètres de fuseau horaire, voir le Guide de configuration des jeux dedonné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 le 08/08/2006 à 12:00 HNE, les rapports s’exécutent pour les données avec un horodatage de 08/08/2006 à 12:00 HNE et versions ultérieures.

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

La mesure Heure du rapport affecte les N dernières dimensions des rapports, telles que "7 derniers jours", "Hier" et "3 semaines auparavant". Pour les requêtes dans le serveur de rapports, la mesure Heure du rapport ( Heure du rapport.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 les outils de données, la mesure Heure du rapport est basée sur minuit de la mesure A partir de ( A partir de.metric ). En raison de la différence entre les définitions de la mesure Heure du rapport, si vous interrogez un espace de travail qui utilise une dimension N dernier, vous pouvez recevoir des résultats différents dans les outils de données et le serveur de rapports 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 tant que 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 N valeur principale.

Remarque : Si vous saisissez une valeur dans ce paramètre, vous devez en saisir une dans le paramètre Nom de dimension et N valeur principale.

N valeur supérieure

Facultatif. Lorsque ce paramètre est renseigné, le serveur de rapports 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 Nom de dimension, en comptant par la mesure spécifiée dans le paramètre Mesure N supérieure.

Exemple : Si vous saisissez Page dans le paramètre Nom de 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 pages principales ayant le plus grand nombre de sessions.

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

Utiliser un exemple local uniquement Facultatif. Indique si vous souhaitez que le serveur de rapports 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 de l’outil de données) afin d’afficher l’aspect de la sortie sans prendre tout le temps nécessaire pour traiter les données. Cette fonction 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 copie unique des espaces de travail qui doivent être générés et distribués de plusieurs manières, à l’aide des fichiers .cfg pour plusieurs jeux de rapports. Le répertoire racine de ce chemin d’accès peut être n’importe quel dossier de profil. N’entrez 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 .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 .cfg , vous devez définir le paramètre Chemin d’accès à l’espace de travail sur le nom deprofil \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 d’accès du fichier de modèle XSL à appliquer à l’index du rapport. Le fichier .xml transformé résultant est écrit dans le fichier de sortie XSL spécifié . Voir Fichiers d’exemple de rapport pour consulter un exemple de fichier.

Remarque : A 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 courrier électronique sous forme de pièces jointes.

Sur cette page