Exécution d'une procédure de rapport ou de fichier feuille de style avec -INCLUDE

Grâce à la commande -INCLUDE, vous pouvez insérer une procédure de rapport (FEX) ou un fichier de feuille de style (STY) au sein d'une autre procédure de rapport (FEX). Pour les informations relatives à la création des requêtes de rapport et des fichiers de feuilles de style, consultez le manuel Création de rapports en langage WebFOCUS.

Quand vous créez une procédure de rapport dans le chemin de dossier contenu référentiel, un chemin et un nom de fichier uniques sont créés pour référence, basés sur le dossier dans lequel le rapport est créé et sur le nom et le type de fichier spécifiés. Notez que certaines règles pour la désignation de fichiers peuvent faire remplacer les caractères non-alphanumériques et modifier le nom de fichier.

Le chemin complet est la valeur à spécifier lors du référencement d'une procédure de rapport ou d'un fichier de feuilles de style dans une commande -INCLUDE. L'information chemin IBFS complet, y compris le nom de fichier, peut être obtenu en sélectionnant le rapport puis l'option Propriétés.

Remarque : les procédures de rapport WebFOCUS 7.x migrées avec des commandes -INCLUDE, codées avec les HREFs internes du référentiel 7.x Managed Reporting, sont prises en charge dans WebFOCUS 8. Ceci est possible parce que les références HREF internes de WebFOCUS 7.x sont migrées avec les informations de propriétés pour un élément (par exemple, un rapport ou un fichier de feuilles de style). Les éléments créés dans WebFOCUS 8 doivent obligatoirement être référencés avec leur chemin IBFS complet.

L'image ci-dessous montre la fenêtre de dialogue Propriétés pour une procédure de rapport (FEX) avec le chemin complet.

Syntaxe : Incorporer une procédure de rapport (FEX) ou un fichier de feuille de style (STY) avec -INCLUDE

Le code suivant illustre comment incorporer une procédure de rapport (FEX) en utilisant un chemin IBFS avec la commande -INCLUDE.

Remarque : dans les versions précédentes à WebFOCUS 8, une procédure ou un fichier de feuille de style sur le serveur de génération de rapports peut être intégré au sein de la procédure Managed Reporting, en utilisant la commande -MRNOEDIT avant la commande -INCLUDE. La commande -MRNOEDIT -INCLUDE est prise en charge dans WebFOCUS 8.

-INCLUDE IBFS:/path/filename

où :

IBFS:/path/filename: Est le chemin complet, incluant le nom de fichier, de la procédure de rapport (FEX) ou le fichier filename.sty de feuille de style. L'extension de fichier est optionnelle quand une procédure de rapport (FEX) est référencée.

Pour intégrer une procédure sur le serveur de génération de rapports en utilisant les commandes -MRNOEDIT et -INCLUDE, entrez :

-MRNOEDIT -INCLUDE appname/filename.ext

où :

appname: Est le chemin de répertoire d'application sur le serveur de génération de rapports dans lequel se trouve la procédure du serveur (FEX) ou le fichier feuille de style (STY). S'il n'est pas spécifié, le fichier doit être obligatoirement placé sur le chemin d'application du serveur de génération de rapports.
filename.ext: Est le nom de la procédure située sur le serveur d'applications L'extension de fichier est optionnelle quand une procédure de rapport (FEX) est référencée. Lors de l'intégration du fichier de feuille de style, spécifiez l'extension STY.

Référence : Inclure une procédure ou un fichier de feuille de style du serveur de génération de rapports dans une procédure Managed Reporting avec un chemin IBFS

Pour inclure une procédure située dans un répertoire d'application sur un serveur de génération de rapports en utilisant le chemin IBFS WebFOCUS, entrez :

-INCLUDE IBFS://EDA/nodename/appname/filename.ext

où :

nodename: Est le noeud de serveur de génération de rapports défini dans la configuration du client WebFOCUS. Le chemin IBFS://EDA/spécifie que la procédure ou le fichier de feuille de style se trouve sur le serveur de génération de rapports. Le traitement Managed Reporting retire IBFS://EDA/nodename de la requête Managed Reporting soumise au serveur de génération de rapports ; le traitement du serveur de génération de rapports va utiliser son chemin d'application pour trouver la procédure ou le fichier de feuille de style.
appname: Est le répertoire d'application sur le serveur de génération de rapports dans lequel se trouve la procédure du serveur ou le fichier feuille de style. S'il n'est pas spécifié, le fichier doit être obligatoirement placé sur le chemin d'application du serveur de génération de rapports.
filename.ext: Est le nom de la procédure ou du fichier de feuille de style sur le serveur d'applications L'extension de fichier est optionnelle quand une procédure de rapport (FEX) est référencée. Lors de l'intégration du fichier de feuille de style, spécifiez l'extension STY.

Référence : Comment inclure une procédure ou un fichier de feuille de style du serveur de génération de rapports dans une procédure Managed Reporting avec -MRNOEDIT et -INCLUDE

Une bonne pratique dans le cadre du développement d'applications dans WebFOCUS8 consiste à centraliser la configuration de l'environnement et de la mise en forme, y compris les JOIN et les DEFINE, en les stockant dans un domaine commun et en définissant les permissions de sécurité de façon à ce que les utilisateurs puissent les lire et les exécuter, mais pas les éditer ni les modifier. Cependant, les applications natives vont vraisemblablement requérir des fichiers de feuilles de style et de procédures de rapport qui soient placés dans un répertoire d'application sur le serveur de génération de rapports. Les informations de cette section concernent les applications natives qui ont été migrées.

L'exemple suivant illustre l'intégration d'une procédure de serveur de génération de rapports ou d'un fichier de feuille de style au sein d'une procédure Managed Reporting en utilisant les commandes -MRNOEDIT et -INCLUDE.

La procédure salesrptsetup, qui contient les commandes suivantes pour créer un champ utilisé en général pour les rapports de ventes produits, se trouve dans le répertoire /ibi/apps/ibisamp du serveur de génération de rapports.

DEFINE FILE GGSALES
PROFIT/D12.3= DOLLARS - BUDDOLLARS;
INVENTORY/D12 = UNITS - BUDUNITS;
END

La feuille de style salesrptstyle.sty qui contient les commandes de mise en forme suivantes se trouve dans le répertoire /ibi/apps/ibisamp du serveur de génération de rapports.

TYPE=REPORT,COLOR=NAVY,FONT='ARIAL',SIZE=9,GRID=OFF,$
TYPE=HEADING,LINE=1,STYLE=BOLD,SIZE=12,JUSTIFY=CENTER,$
TYPE=TITLE,BACKCOLOR=RGB(45 111 205),COLOR=WHITE,STYLE=UNDERLINE+BOLD, $
TYPE=DATA,BACKCOLOR=(WHITE RGB(235 235 255)),$
TYPE=SUBTOTAL,BACKCOLOR=RGB(163 200 236),STYLE=BOLD,$

La procédure Managed Reporting intègre la procédure salesrptsetup et la feuille de style salesrptstyle situées sur le serveur de génération de rapports.

-MRNOEDIT -INCLUDE ibisamp/salesrptsetup 
TABLE FILE GGSALES
"Regional Inventory and Profit Report"
SUM BUDUNITS UNITS INVENTORY AS 'Inventory'
BUDDOLLARS DOLLARS PROFIT AS 'Profit'
BY REGION
BY CATEGORY 
-MRNOEDIT -INCLUDE ibisamp/salesrptstyle.sty
END

Référence : Éléments à prendre en compte pour l'utilisation de -INCLUDE avec ReportCaster

Pour chaque tâche au sein d'un planning du serveur de génération de rapports, ReportCaster prend en charge la réception d'un jeu de réponses unique, tel que un rapport, un graphique ou un fichier HTML. Par conséquent, lorsque vous utilisez -INCLUDE pour intégrer une procédure dans une autre, cette dernière étant planifiée dans ReportCaster, un seul jeu de réponse devrait être créé. Si vous avez besoin de distribuer plusieurs rapports dans un seul document, utilisez la fonction Rapport Composé. Pour plus d'informations sur l'identification de composants de rapport, consultez le guide Création de rapports en langage WebFOCUS.