Segmentation d'un rapport

Plutôt que de distribuer un rapport entier à partir d'une procédure de rapport planifiée (FEX), vous pouvez utiliser la fonction de segmentation de ReportCaster pour diviser le rapport en sections, à distribuer séparément vers une destination unique ou plusieurs. L'envoi en rafale vous permet de cibler différentes sections d'un rapport pour les envoyer à des utilisateurs spécifiques. Chaque section du rapport est enregistrée dans un fichier distinct.

Si vous distribuez un rapport tabulaire, la valeur d'envoi en rafale est déterminée par le premier champ BY. Si vous distribuez un tableau de rapport graphique, la valeur d'envoi en rafale est déterminée par le second champ BY. La valeur d'envoi en rafale est automatiquement obtenue par la matrice interne, une zone de mémoire qui enregistre toutes les valeurs de champs de base de données et calcule les valeurs référencées dans la requête TABLE ou GRAPH.

Vous pouvez envoyer plusieurs sections du rapport à un destinataire en précisant l'adresse de ce destinataire (adresses e-mail, emplacements du serveur FTP, et fichier ou imprimantes) pour chaque section que vous souhaitez envoyer. Vous pouvez également envoyer plusieurs sections de rapport vers une seule destination. Les valeurs d'envoi en rafale que vous spécifiez dans la Liste de distribution doivent exister dans la source de données par rapport à laquelle est effectué le reporting.

Remarque : si vous souhaitez ne segmenter qu'un rapport, vous devez activer la segmentation dans la tâche pour une planification. Les valeurs d'envoi en rafale spécifiées dans la colonne Valeur d'envoi en rafale de la Liste de distribution ne sont prises en compte que si l'envoi en rafale du rapport est indiqué dans la tâche.

Vous pouvez spécifier un critère de tri valeurs segmentées et Destinations (adresses email, FTP, ou imprimantes) lorsque vous créez ou modifiez une liste de distribution. L'image suivante montre les valeurs d'envoi en rafale et les adresses email spécifiées dans la fenêtre de Liste de distribution.

A l'aide des valeurs de champ de tri primaire (Ventes Nord-est, Ventes Sud et Ventes Mid-Ouest), l'adresse email de chaque représentant est associée aux données de rapport de ventes concernées. Puisque Chuck Hill n'a besoin que des données sur l'agence de la région Nord-est, la valeur de tri 'Nord-est' est indiquée dans la colonne Valeur segmentée et est associée avec son adresse email, qui se trouve dans la colonne Email.

Toutefois, Tom Gregory travaille à la fois dans la région Mid-ouest et Sud. Puisqu'il a besoin des données des deux régions, son adresse email est répertoriée deux fois dans la colonne Email, à côté de la colonne d'entrée de valeur segmentée pour chaque région.

Remarque : vous pouvez cliquer sur un en-tête de colonne pour trier les données dans cette colonne.

Conseil : vous pouvez spécifier plusieurs adresses email dans une ligne Adresse unique. Pour plus de détails, reportez-vous à Spécification d'adresses email multiples.

Référence : Considérations à prendre lors d'une distribution de rapport de segmentation avec FTP

Lorsque vous distribuez un rapport segmenté à l'aide de FTP,

Lorsque vous utilisez un format HTML, PDF ou EXL2K, une page d'index pour une sortie de segmentation des rapports est alors générée.
La page d'index pour la distribution par FTP ne contient que les valeurs d'envoi en rafale spécifiées dans la Liste de distribution. La sortie n'est distribuée que pour les valeurs d'envoi en rafale spécifiées.
Les liens de la page d'index pour une sortie de segmentation des rapports distribués à l'aide du FTP sont erronés lorsqu'ils définissent BASEURL dans la procédure planifiée. Cela s'explique par le fait que ReportCaster ne fait pas l'analyse ou l'évaluation du code source de la procédure de la tâche planifiée. Déplacez les fichiers distribués au répertoire BASEURL ou précisez l'intégralité du chemin d'accès approprié pour la distribution de la sortie dans la page d'index.
Sur z/OS, une sortie de segmentation distribuée en mode rafale à l'aide de FTP est créée sous forme d'ensembles de données séquentiels ayant les qualificatifs suivants :
- Qualificatifs de haut niveau : identifiant utilisateur spécifié pour le serveur FTP.
- Qualificatifs supplémentaires : valeur d'emplacement dans l'onglet Distribution et fichier(s) fourni(s) dans une liste de distribution.
Pour envoyer une sortie de segmentation vers un ensemble de données partitionné, spécifiez un ensemble existant de données partitionné en tant qu'emplacement et spécifiez les noms des membres, sans extension, dans la colonne Fichier de liste de distribution. Par exemple, highlevelqualilfier.location.file.
Sur z/OS, n'utilisez pas un nom d'index identique au fichier de données (saisie) que vous reportez. Si le nom d'index spécifié est identique au DDNAME dans le DYNAM de votre fichier de données, la sortie remplacera votre fichier de données.
Sur z/OS, la page d'index est générée avec des caractères additionnels précédant les valeurs de segmentation. Les liens des sections de rapports qui se trouvent sur la page sont corrigés.

Considérations et limitations de l'envoi en rafale

Cette section fournit des informations détaillées pour vous assister dans la définition de valeurs de segmentation.

Lorsqu'une tâche planifié spécifie la segmentation d'une procédure de rapport (FEX), toutes les valeurs de données générées pour chaque section segmentée sont renvoyées vers le serveur de génération de rapport.

Pour les méthodes de distribution Managed Reporting et Bibliothèque de rapports, chaque section segmentée est distribuée au référentiel. Le propriétaire du planning doit avoir le droit en écriture vers le dossier du référentiel spécifié dans le planning lorsque la tâche planifiée est exécutée pour que la sortie de rapport soit distribuée avec succès. L'accès aux sections de rapport est contrôlé par les règles de sécurité du référentiel créées lorsque le rapport est distribué.
Pour les méthodes de distribution par email et impression, des sections segmentées spécifiques sont distribuées selon les valeurs de segmentation spécifiées lors de la création de la liste de distribution, le nom du fichier de distribution, d'adresse unique utilisés par la planification.

Voici quelques directives et limitations s'appliquant à la fonctionnalité de segmentation de rapports :

Casse. Les valeurs segmentées sont sensibles à la casse.

Mots clés. Les valeurs segmentées peuvent contenir les mots-clés suivants :

Caractères de remplacement. Utilisez un astérisque (*) et un point d'interrogation (?) comme caractères de remplacement pour représenter des caractères au début, à la fin et au milieu des valeurs segmentées. L'astérisque représente un ou plusieurs caractères, alors que le point d'interrogation représente tout caractère simple. Précéder chaque instance d'une valeur segmentée à l'aide d'un caractère de remplacement avec un mot-clé entre des crochets suivi par un point virgule, [wildcard]:, comme dans les exemples suivants :
[wildcard]:abc* = toutes les valeurs commençant par ‘abc'.

[wildcard]:a?c = tous les trois caractères commençant par ‘a’ et se terminant par ‘c'.

[wildcard]:a?c* = toutes les valeurs commençant par ‘a’ et comprenant la lettre ‘c’ comme troisième caractère.

Remarque : les caractères génériques de liste de distribution ne sont pas pris en charge avec FTP.
Expressions régulières Java. Utilisées pour identifier les chaînes de texte. Précédez chaque instance d'une valeur segmentée utilisant une expression régulière Java avec le mot-clé de l'expression régulière compris dans les crochets suivi par un point virgule, [regexp]:, comme dans les exemples suivants.
[regexp]:[bcr]at = pour les valeurs bat, cat, or rat.

[regexp]:[^bcr]at = toute valeur autre que bat, cat ou rat.
Distribution par défaut. Vous pouvez fournir une destination par défaut pour segmenter des valeurs qui ne sont pas spécifiées dans la Liste de distribution. Pour le faire, entrez les éléments suivants dans la colonne de valeur segmentée de la Liste de distribution.
[elsesend] = rapports pour les valeurs segmentées ne contenant pas de Liste de distribution sera envoyé à un destinataire spécifié.

Les exemples suivants sont des exemples d'entrées dans une liste de distribution par email illustrant l'utilisation de caractère de remplacement et de mots de clé de distribution par défaut dans les valeurs segmentées.

Valeur d'envoi en rafale	Adresse
[wildcard]:an	sml@company.com
England	ray@company.com
[elsesend]:	jt@company.com

Utiliser un scénario où la sortie de rapport d'une procédure de rapport planifiée (FEX) est segmentée dans le champ Pays contenant les valeurs Allemagne, USA, France, Canada, Italie, Chili, Angleterre et Japon, alors:

Les informations de rapport sur Allemagne, France, Canada, Angleterre et Japon seront envoyées à l'adresse sml@company.com.
Les informations de rapport sur Angleterre seront envoyées à ray@company.com.
Les informations de rapport sur Etats-Unis, Italie et Chili seront envoyées à jt@company.com.

Formats. Tous les formats prennent en charge la segmentation sauf XML et EXCEL. Chaque section de segmentation de la sortie du rapport à partir d'une procédure de rapport planifié (FEX) sera nommé burstvalue_filename.format (par exemple, Northeast_Sales.pdf).

Commande ACROSS. Cette commande n'est pas évaluée en tant que critère de tri primaire. Pour segmenter une sortie de rapport à partir d'une procédure de rapport planifié (FEX), vous devez aussi inclure un champ BY. La segmentation est effectuée sur le champ BY.

TABLEF. Aucun traitement de tri interne n'est effectué. Pour spécifier un champ BY il faut que les données soient préalablement triées dans la source de données.

ON TABLE SUBHEAD/ON TABLE SUBFOOT. Crée un SUBHEAD uniquement pour la première page de la sortie de rapport à partir d'une procédure de rapport planifié (FEX), et un SUBFOOT uniquement pour la dernière page de la sortie de rapport à partir d'une procédure de rapport planifié (FEX). Lorsque vous segmentez la sortie d'un rapport à partir d'une procédure de rapport planifié (FEX), le SUBHEAD et SUBFOOT devrait se produire à chaque rupture de tri. Ainsi, vous spécifiez le critère de tri principal à la place de TABLE dans la commande ON. Par exemple :

ON primarysortfield SUBHEAD

Types de champ A n V. La segmentation n'est pas prise en charge avec un champ de type AnV (où n est un nombre entier).