Segmentation de rapports : vue d'ensemble

Lorsqu'un rapport simple est segmenté en fichiers HTML multiples, chacun de ces fichiers comprend toutes les informations demandées relatives à une valeur particulière du champ de tri. En fournissant l'accès direct aux différentes sections de votre rapport, cette technique vous permet de :

Remarque : lorsque vous segmentez des rapports dans Developer Studio, vous devez exécuter la requête à distance par rapport à un serveur WebFOCUS.

Syntaxe : Segmenter des rapports en fichiers HTML multiples

ON sortfield PCSEND LOCATION dir [AS burstname] FORMAT HTML

où :

sortfield

Spécifie le champ de tri selon quelle segmentation s'effectue. La sortie de chaque fichier segmenté est relative à un seul groupe de tri.

Vous pouvez segmenter des rapports selon la valeur du premier champ de tri seulement. Vous ne pouvez pas segmenter le rapport selon la valeur des critères de tri subséquents.

Un rapport peut être segmenté en un maximum de 10 000 fichiers différents. Par conséquent, vous ne pouvez segmenter un rapport que si le nombre de valeurs individuelles du premier champ de tri ne dépasse 10 000.

PCSEND

Lance la segmentation. Une requête ne peut comprendre qu'une seule commande PCSEND.

dir

Spécifie l'emplacement sur le serveur web où sont stockés le fichier d'index HTML et les fichiers de rapport. Le paramètre LOCATION est nécessaire et doit spécifier un répertoire depuis lequel le serveur lit les fichiers HTML. Il n'y a pas de valeur par défaut.

Sur UNIX, Windows et les plateformes VMS ouvertes, la valeur de répertoire doit spécifier un chemin de répertoire qualifié.

Note aux utilisateurs de MVS Web390 : sur une plate-forme MVS, la valeur de répertoire doit indiquer le ddname d'un PDS attribué. Aucune attribution dynamique d'ensembles de données n'est fournie. Le format PDS est ajouté à un ddname différent du Web390 standard WWWHTM. Le ddname alternatif doit être WWWxxx,où xxx représentent trois caractères alphanumériques. Le serveur Web Web390 exige une entrée dans son tableau MIME afin de reconnaître le PDS comme ayant de la sortie HTML.

Si le paramètre LOCATION spécifie un répertoire non valable ou un répertoire auquel l'on ne peut pas écrire, un message d'erreur est renvoyé.

burstname

Spécifie le nom du fichier d'index HTML, qui comprend une liste d'hyperliens vers les fichiers de rapport HTML segmentés. Ces hyperliens sont numérotés de 0 à 9999. Si aucun nom de fichier n'est spécifié pour le fichier d'index HTML, le nom par défaut est HOLD.

Chaque rapport HTML segmenté utilise les quatre premiers caractères du nom de fichier d'index, suivis des numériques 0000 à 9999.

Remarque : la requête de rapport peut comporter des champs d'affichage avec des valeurs manquantes. Elle peut également comprendre des champs NOPRINT. Pour plus d'informations, consultez Gestion d'enregistrements avec des valeurs de champs manquantes.

Référence : Règles pour les en-têtes et pieds de page des pages d'index et rapports segmentés

Pour inclure un en-tête ou un pied de page sur la page d'index HTML, utilisez les commandes :
```
ON TABLE SUBHEAD
```
et
```
ON TABLE SUBFOOT
```
Ces en-têtes et pieds de page peuvent comprendre des champs intégrés. L'en-tête et le pied de page ne sont pas compris sur les pages de sortie du rapport HTML. Le style par défaut s'applique à la page d'index HTML.
Pour inclure un en-tête ou un pied de page standards sur toutes les pages de sortie du rapport HTML, utilisez les commandes :
```
HEADING
```
et
```
FOOTING
```
Ces en-têtes et pieds de page peuvent comprendre des champs intégrés. Le style par défaut s'applique aux pages de sortie du rapport HTML.
Pour inclure des en-têtes et pieds de page qui se modifient chaque fois que les champs de tri se modifient, utilisez les commandes :
```
ON sortfield SUBHEAD
```
et
```
ON sortfield SUBFOOT
```
Ces en-têtes et pieds de page peuvent comprendre des champs intégrés, tels que le champ de tri utilisé dans la commande PCSEND. Le style par défaut s'applique aux pages de sortie du rapport HTML.

Pour plus de détails sur l'insertion d'en-têtes et de pieds de page dans des rapports, consultez Utilisation d'en-têtes, pieds de page, titres et étiquettes.

Haut de page

Exemple : Segmentation d'un rapport

La procédure de rapport suivante crée un fichier de sortie de rapport HTML pour chaque valeur REGION différente dans la source de données GGSALES. Les fichiers de sortie de rapport sont appelés test0000.html, test0001.html, test0002.html et ainsi de suite. La page d'index HTML est appelé test.html et comprend un hyperlien pour chaque valeur de données REGION. Le répertoire que vous sélectionnez dépend d'où WebFOCUS est installé. Dans cet exemple, la page d'index est stockée dans le répertoire e:\ibi\WebFOCUS435\temp.

TABLE FILE GGSALES
HEADING
"Regional Report"
SUM UNITS AND DOLLARS
BY REGION BY STCD BY CATEGORY
ON TABLE SET PAGE NOPAGE
ON TABLE SUBHEAD
"Year-end Sales:"
"Regional Summary by Store"
ON REGION PCSEND LOCATION E:\IBI\WebFOCUS435\temp AS TEST FORMAT HTML
END

Après le lancement du rapport, aucune sortie n'est renvoyée, mais le message suivant s'affiche si la requête a réussi :

The bursted files were successfully created.

Différents fichiers HTML sont créés pour chaque valeur du champ de tri principal REGION et ils sont stockés dans l'emplacement spécifié dans la requête.

Ce qui suit est la page d'index HTML créée par la procédure :

Sélectionner le hyperlien « Midwest » affiche le rapport HTML suivant :

Regional Report
Region	Store ID	Category	Unit Sales	Dollar Sales
Midwest	R1019	Coffee	113253	1393610
		Food	107615	1351523
		Gifts	78869	969845
	R1020	Coffee	109581	1398779
		Food	118068	1522847
		Gifts	79932	1002775
	R1250	Coffee	109943	1386124
		Food	115731	1463901
		Gifts	72053	911261

Notez que les en-têtes spécifiés dans la commande ON TABLE SUBHEAD s'affichent sur la page d'index HTML. Consultez Règles pour les en-têtes et pieds de page des pages d'index et rapports segmentés.