Création d'un composant de rapport PDF avec des liens de zoom transversal PDF

Dans cette section :

Comment :

Référence :

Une technique courante pour créer des rapports d'affaires est la création de deux rapports liés :

Le zoom transversal fournit une moyenne facile de lier les données dans ces deux types de rapports. Par exemple, un utilisateur qui lit rapidement un compte de rapport peut voir une figure peu commun dans un des comptes, ce qui requiert l'examen des données relatives à cette figure.

Il existe deux formes de rapports à zoom transversal :

Dans les deux types de rapports composé de zoom tranversal, la syntaxe pour créer des liens hypertexte entre les rapports dans le fichier PDF sont exactement les mêmes.


Haut de page

x
Référence : Comparaison entre zoom transversal et zoom en profondeur

Le zoom en profondeur permet de construire un rapport récapitulatif dans lequel le clic sur un hyperlien affiche des données de détail. Le zoom en profondeur est implémenté dynamiquement. Cliquer sur un lien hypertexte a pour résultat l'exécution d'un nouveau rapport. Le rapport détaillé n'affiche générallement que les données de détail d'un champ particulier dans le rapport récapitulatif.

Contrairement, les rapports de zoom transversal sont statiques. Le zoom transversal crée un document PDF contenant le rapport récapitulatif en plus du rapport détaillé, où celui-ci contient toutes les données de détail des champs spécifiés dans le rapport récapitulatif. Cliquer sur un lien hypertexte de zoom transversal entraîne une navigation interne dans un fichier PDF. Aucun rapport supplémentaire n'est exécuté. Vous pouvez enregistrer le fichier PDF vers un disque ou le distribuer à l'aide de ReportCaster. Lorsqu'il est ouvert avec Adobe Reader, le fichier retient toute sa fonctionnalité de zoom en profondeur.

Le zoom transversal permet une certaine souplesse en ce qui concerne l'apparence des rapports et l'emplacement des liens hypertexte :


Haut de page

x
Référence : Utilisation avec d'autres fonctionnalités

Le zoom transversal peut être utilisé conjointement avec d'autres fonctionnalités.


Haut de page

x
Comment : Créer un zoom transveral dans un rapport PDF de disposition composée

Pour créer un zoom transversal dans un rapport PDF de disposition composée :

  1. Créez le rapport de synthèse avec un lien hypertexte DRILLTHROUGH.
  2. Créez le rapport détaillé avec des valeurs de tri qui correspondent aux valeurs des champs.
  3. Créez le rapport de disposition composée avec les mises en pages pour chaque rapport de composant, et définissez un attribut DRILLMAP dans le rapport d'appel pour spécifier les cibles des liens hypertexte de zoom transversal.

Haut de page

x
Comment : Créer un zoom transversal dans un rapport PDF composé

Pour créer un zoom transversal dans un rapport PDF composé :

  1. Créez le rapport de synthèse.
  2. Créez le rapport détaillé.
  3. Faites connecter les rapports avec des hyperliens.
  4. Fusionnez les rapports récapitulatifs et détaillés en un rapport PDF composé.

Haut de page

x
Syntaxe : Spécifier des liens hypertexte de zoom transversal
TYPE=type, [element,] [styling_attributes,]
     DRILLTHROUGH={DOWN|FIRST}(link_fields) , $

où :

type
Indique l'un des types de feuille de style suivants :
  • DATA
  • TITRE
  • FOOTING
  • SUBHEAD
  • SUBFOOT
  • SUBTOTAL
  • RECAP
element
Est un ou plusieurs élément(s) autorisé(s) dans un rapport WebFOCUS de feuille de style ou de zoom transversal. Un élément peut décrire une colonne particulière (par exemple, COLUMN=PRODUCT) ou un élément d'en-tête (par exemple, LINE=2, OBJECT=field, ITEM=3).
styling_attributes
spécifient facultativement l'aspect du lien hypertexte (par exemple, COLOR=RED, STYLE=BOLD).
DOWN
crée un lien vers le rapport suivant.
FIRST
crée un lien vers le premier rapport de zoom transversal dans la séquence.
link_fields
spécifie des paires de champs de lien délimités par des blancs au format suivant :
T1=S1 T2=S2 T3=S3...
T1, T2 et T3 représentent des références de colonne dans le rapport cible (le rapport lié), et S1, S2 et S3 représentent des références de colonne dans le rapport source (le rapport actuel). Il peut y avoir plus de trois paires.

Une référence de colonne peut être le nom d'un champ ou de tout autre symbole valide dans la syntaxe de feuille de style WebFOCUS (par exemple, Bn, Cn, Pn, Nn, An, nom de champ souscrit, et ainsi de suite).

L'ordre de la syntaxe est semblable à la syntaxe de zoom en profondeur, dans laquelle les paires de paramètres spécifient la référence à la colonne dans le rapport actuel (source) sur la droite et le nom de la variable du Gestionnaire de dialogues dans la procédure Zoom en profondeur (cible) sur la gauche.

Si la référence de colonne dans le rapport cible est identique à la référence de colonne dans le rapport source, vous pouvez utiliser une référence de colonne unique, par exemple, COUNTRY au lieu de COUNTRY=COUNTRY.



Exemple : Spécifier les liens hypertexte de zoom transversal

La déclaration Feuille de style suivante place un lien hypertexte sur le champ PRODUCT de chaque ligne DATA, spécifie que les champs à relier au rapport suivant sont CATEGORY et PRODUCT, spécifie l'action DOWN de façon à ce qu'un clic sur un lien hypertexte vous dirige vers l'emplacement dans le rapport suivant qui contient les valeurs correspondantes aux deux champs de lien, et utilise l'aspect par défaut pour les liens hypertexte, qui est du texte bleu, souligné. Comme les noms des champs cibles dans le rapport détaillé sont pareils dans le rapport de synthèse, vous pouvez utiliser la notation CATEGORY au lieu de CATEGORY=CATEGORY.

TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $

Haut de page

x
Syntaxe : Spécifier quels rapports de disposition composée seront reliés via les liens hypertexte

Le rapport cible est spécifié dans l'attribut DRILLMAP de la déclaration COMPONENT pour le rapport d'appel.

DRILLMAP=((L1 targetreport))

où :

L1
est l'identifiant de lien.
targetreport
est le nom du composant de la destination du lien hypertexte.

Remarque : les parenthèses doubles autour des valeurs DRILLMAP sont requises.



Exemple : Déclarations de l'exemple de composant avec attributs DRILLMAP

La déclaration COMPONENT suivante pour REPORT1 spécifie un attribut DRILLMAP qui pointe vers REPORT2 :

COMPONENT='REPORT1', TEXT='REPORT1', TOC-LEVEL=2, 
DRILLMAP=((L1 REPORT2)), POSITION=(0.750 1.083), DIMENSION=(7.000 3.167),
METADATA='Z-INDEX: 100; LEFT: 0.75in; OVERFLOW: auto; WIDTH: 7in;
POSITION: absolute; TOP: 1.083in; HEIGHT: 3.167in', $

La déclaration COMPONENT suivante pour REPORT2 spécifie un attribut DRILLMAP qui pointe vers REPORT1 :

COMPONENT='REPORT2', TEXT='REPORT2', TOC-LEVEL=2, 
DRILLMAP=((L1 REPORT1)), POSITION=(0.500 0.667), DIMENSION=(7.417 7.000),
METADATA='Z-INDEX: 100; LEFT: 0.5in; OVERFLOW: auto; WIDTH: 7.417in;
POSITION: absolute; TOP: 0.667in; HEIGHT: 7in', $

Haut de page

x
Référence : Notes d'utilisation pour Zoom transversal

Haut de page

x
Echantillonner des rapports PDF composés de zoom transversal

Référence :

Les exemples suivants illustrent comment utiliser la syntaxe Zoom transversal pour créer un rapport composé avec un rapport de synthèse ou détaillé et naviguer entre ceux-ci.



Exemple : Création du rapport de synthèse (Etape 1)

La syntaxe suivante génère un exemple de rapport de synthèse :

TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF
END

La sortie est :



Exemple : Création du rapport détaillé (Etape 2)

La syntaxe suivante génère un exemple de rapport détaillé :

La première page de sortie est :

SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END



Exemple : Liaison de rapports à l'aide de liens hypertexte (Etape 3)

Cet exemple illustre ce qui suit :

Le rapport de synthèse :

Le rapport de synthèse est :

TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $
ENDSTYLE
END

Le rapport de détails :

Le rapport de détails est :

SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END

L'étape suivante est la seule étape différente pour la création d'un rapport de disposition composée ou d'un rapport composé hérité.



Exemple : Créer le rapport de disposition composée (Etape 4)

Réalisez cette version de l'étape 4 si vous créez un rapport de disposition composée.

Pour créer le rapport de disposition composée :

SET HTMLARCHIVE=ON
COMPOUND LAYOUT PCHOLD FORMAT PDF
UNITS=IN, $
SECTION=section1, LAYOUT=ON, METADATA='0.5^0.5^0.5^0.5', MERGE=OFF,
   ORIENTATION=PORTRAIT, PAGESIZE=Letter,  $
PAGELAYOUT=1, NAME='Page layout 1', text='Page layout 1', TOC-LEVEL=1,
   BOTTOMMARGIN=0.5, TOPMARGIN=0.5, METADATA='BOTTOMMARGIN=0.5,
   TOPMARGIN=0.5,LEFTMARGIN=0,RIGHTMARGIN=0, $
COMPONENT='REPORT1', TEXT='REPORT1', TOC-LEVEL=2,
DRILLMAP=((L1 REPORT2)), POSITION=(0.750 1.083), DIMENSION=(7.000 3.167),
   METADATA='Z-INDEX: 100; LEFT: 0.75in; OVERFLOW: auto; WIDTH: 7in;
   POSITION: absolute; TOP: 1.083in; HEIGHT: 3.167in', $
PAGELAYOUT=2, NAME='Page layout 2', text='Page layout 2', TOC-LEVEL=1,
   BOTTOMMARGIN=0.5, TOPMARGIN=0.5, METADATA='BOTTOMMARGIN=0.5,
   TOPMARGIN=0.5,LEFTMARGIN=0,RIGHTMARGIN=0, $
COMPONENT='REPORT2', TEXT='REPORT2', TOC-LEVEL=2,
DRILLMAP=((L1 REPORT1)), POSITION=(0.500 0.667), DIMENSION=(7.417 7.000),
   METADATA='Z-INDEX: 100; LEFT: 0.5in; OVERFLOW: auto; WIDTH: 7.417in;
   POSITION: absolute; TOP: 0.667in; HEIGHT: 7in', $
END
-* Add Report1 code and SET COMPONENT command
SET COMPONENT='REPORT1'
TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $
ENDSTYLE
END
-* Add report2 code and SET COMPONENT command
SET COMPONENT='REPORT2'
SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END
COMPOUND END


Exemple : Fusion des rapports récapitulatifs et détaillés en un rapport PDF composé (Etape 4)

Réaliez cette version de l'étape 4 si vous créez un rapport composé hérité.

L'étape suivante sert à fusionner les rapports en un seul rapport composé PDF. Vous pouvez :

Le zoom transversal ne supporte pas l'option NOBREAK, qui affiche des rapports composés sans sauts de page intervenants.

Cet exemple utilise les options OPEN et CLOSE sur la commande PCHOLD FORMAT PDF :

TABLE FILE GGSALES
SUM UNITS DOLLARS BY CATEGORY BY PRODUCT
ON TABLE PCHOLD FORMAT PDF OPEN
ON TABLE SET STYLE *
TYPE=DATA, COLUMN=PRODUCT, DRILLTHROUGH=DOWN(CATEGORY PRODUCT), $
ENDSTYLE
END
SET SQUEEZE=ON
TABLE FILE GGSALES
SUM UNITS BUDUNITS DOLLARS
BY CATEGORY NOPRINT BY PRODUCT NOPRINT
ON CATEGORY PAGE-BREAK
HEADING CENTER
"Category: <CATEGORY"
" "
ON PRODUCT SUBHEAD
"**** Product: <PRODUCT"
ON PRODUCT SUBFOOT
" "
"<25 **** Return to Summary ****"
ON PRODUCT PAGE-BREAK
BY REGION BY CITY
ON TABLE PCHOLD FORMAT PDF CLOSE
ON TABLE SET STYLE *
TYPE=SUBFOOT, LINE=2, ITEM=1, DRILLTHROUGH=FIRST(CATEGORY PRODUCT),
COLOR=RED, $
END


Exemple : Exécuter le rapport de zoom transversal (Etape 5).

Exécutez le rapport composé. La première page de la sortie contient le rapport de synthèse avec les liens hypertexte des produits seuls, en bleu et soulignés :

Cliquez sur le lien hypertexte Croissant pour la catégorie Food. Vous sautez alors aux informations détaillées correspondantes. Dans le rapport de détails, le lien hypertexte derrière le rapport de synthèse est en rouge est souligné :

Cliquez sur le lien hypertexte Revenir au résumé pour revenir à la première page (rapport de synthèse).



x
Référence : Directives pour les liens de FIRST

Les directives suivantes sont applicables :



x
Référence : Règles pour les liens hypertexte de zoom transversal

Les rapports liés avec le zoom transversal doivent suivre certaines règles afin de garantir le fonctionnement correcte de leurs hyperliens. Voici les concepts clé :

La terminologie source et cible fait référence à chaque paire de rapports liés. Par exemple, s'il y a trois rapports liés avec le zoom transversal, le deuxième rapport est généralement le rapport cible du premier rapport, et aussi le rapport source du troisième rapport.

Pour traiter un rapport comme zoom transversal, il faut identifier les champs de lien dans le rapport source ayant rapport au rapport cible :


WebFOCUS