Paramètres Report.cfg

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.

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 .

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 du fichier à joindre.

Exemple : image/jpeg

Emplacement et nom du fichier à joindre.

Exemple : c:\myimage.jpg

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 .

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.

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é.

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

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

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.

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 .

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.

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 .

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.

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.

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 forme de fichiers Excel Microsoft . 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 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.

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 .

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 .

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.

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.