Ajout d'une image à un rapport

Comment :

Référence :

A l'aide d'une feuille de style, vous pouvez ajouter et positionner une image dans un rapport. Une image, telle qu'un logo, attribue l'identité d'une société à un rapport, ou elle améliore son aspect visuel. Vous pouvez ajouter plus d'une image au rapport en créant des déclarations multiples.

Vous pouvez aussi ajouter une image en tant qu'arrière-plan à un rapport. Une image d'arrière-plan est disposée en mosaïque ou répétée, couvrant le tout de la zone où s'affiche le rapport. Une image liée à un rapport entier, ou une image dans un-tête ou un pied de page, peut s'afficher avec une image d'arrière-plan.

Les images doivent être au format de fichier supporté par votre navigateur, tel que GIF (Graphic Interchange Format) ou JPEG (Joint Photographic Experts Group). Les rapports PDF et PostScript prennent en charge les formats GIF et JPEG, ainsi que tous les fichiers SVG créés par le moteur graphique WebFOCUS.

Pour la sortie PDF, HTML, ou DHTML contre les sources de données qui prennent en charge le type de données Binary Large Object (BLOB) (Microsoft SQL Server, DB2, Oracle, Informix et PostgreSQL à l'aide du type de données BYTEA), une image peut être stockée dans un champ BLOB de la source de données.

L'image doit résider sur le serveur de reporting WebFOCUS dans un répertoire appelé EDAPATH ou APPPATH. Si le fichier n'est pas sur le chemin de recherche, fournissez le nom de chemin complet.


Haut de page

x
Référence : Compatibilité navigateur et dispositifs avec les images dans les documents HTML

La prise en charge des images et graphiques présentées dans les rapports composés HTML et DHTML est fournie avec une facilité d'intégration d'images basée sur le navigateur du client. La sortie générée par les navigateurs Internet Explorer ou dans des scénarios où le navigateur est inconnu (par exemple lorsque le rapport est distribué par ReportCaster) prend en charge l'inclusion d'images à travers la création d'un fichier d'archive Web (.mht). Pour tous les autres navigateurs, les images sont codées en 64 bits dans le fichier .htm généré.

SET HTMEMBEDIMG est la commande conçue pour garantir que tous les rapports WebFOCUS peuvent être accédés à partir de tout navigateur ou dispositif. Par défaut, elle est réglée à AUTO qui détermine quel algorithme de cryptage utiliser en fonction du navigateur de l'ordinateur du client qui valide la requête du rapport. Là où le navigateur est identifié comme navigateur Internet Explorer, ou bien le navigateur est inconnu (comme pas exemple les rapports distribués par ReportCaster), WebFOCUS continuera à générer les fichiers d'archive Web (.mht). Pour tout autre navigateur, WebFOCUS cryptera l'image dans un fichier HTML (.htm).

SET HTMLEMBEDIMG={OFF|ON|AUTO}

où :

OFF

N'affecte pas le comportement par défaut. Si HTMLARCHIVE est réglé à ON, les fichiers .mht sont générés.

ON

Crypte les images dans le fichier .htm.

AUTO

Détermine comment gérer les images en fonction du navigateur à partir duquel la requête est envoyée. Pour les requêtes envoyées à partir d'un navigateur Internet Explorer, HTMLARCHIVE sera utilié pour incorporer les images dans un fichier .mht. Pour tous les autres navigateurs, HTMLEMBEDIMG cryptera les informations sur l'image dans un fichier .htm. Si le navigateur est inconnu, comme dans des requêtes de rapport envoyées par ReportCaster, AUTO utilisera le paramètre HTMLARCHIVE actif. AUTO est la valeur par défaut.

L'algorithme de codage qui utilise le codage 64 bits pris en charge pour des images de moins de 32 Ko est pris en charge par Internet Explorer 8. Pour Internet Explorer 8, Information Builders recommande de continuer l'utilisation du format .mht généré par HTMLARCHIVE. Dans Internet Explorer 9 et supérieurs et des navigateurs autres que Internet Explorer, le nouvel algorithme est pris en charge pour les images de toute taille.

Remarque : reportez-vous aux informations sur le fournisseur de navigateur pour confirmer la compatibilité avec le cryptage 64 bits.

Afin de prendre en charge plusieurs navigateurs, Information Builders vous recommande d'utiliser le paramètre AUTO pour permettre au type adéquat de fichier d'être généré en fonction de la configuration utilisateur, où il est connu. La table suivante représente comment HTMLEMBEDIMG interagit avec HTMLARCHIVE sur plusieurs navigateurs.

Explorateur

HTMLEMBEDIMG

HTMLARCHIVE

Fichier généré *

Internet Explorer

ON

ON

.HTM

ON

OFF

.HTM

OFF

ON

.MHT

OFF

OFF

.HTM

AUTO

ON

.MHT

AUTO

OFF

.HTM

Autre que Internet Explorer

ON

ON

.HTM

ON

OFF

.HTM

OFF

ON

.MHT

OFF

OFF

.HTM

AUTO

ON

.HTM

AUTO

OFF

.HTM

Inconnu

ON

ON

.MHT

ON

OFF

.HTM

OFF

ON

.MHT

OFF

OFF

.HTM

AUTO

ON

.MHT

AUTO

OFF

.HTM

* Remarque :pour les extensions de fichier dans la colonne Fichier généré :



x
Référence : Attributs d'image

Attribut

Description

IMAGE

Ajoute une image.

IMAGEALIGN

Positionne une image. Ceci ne s'applique qu'aux rapports HTML.

POSITION

Positionne une image.

IMAGEBREAK

Contrôle la génération d'un saut de ligne après une image. Ceci ne s'applique qu'aux rapports HTML sans feuilles de style en cascade internes.

SIZE

Définit la taille d'une image.

ALT

Fournit une description d'une image pour raisons de conformité avec l'accessibilité Section (loi « Workforce Investment » de 1998). ALT ne s'applique qu'aux rapports HTML.

La description s'affiche aussi sous forme contextuelle lorque vous survolez l'image dans la sortie de rapport avec la souris.

PRESERVERATIO

On spécifie que le ratio d'aspect (ratio de hauteur à largeur) de l'image doit être préservé lorsqu'il est échelonné au paramètre SIZE spécifié. Ceci permet d'éviter la distorsion de l'apparence de l'image. L'image est échelonnée à la taille la plus large possible dans les limites spécifiées par le paramètre SIZE pour lequel le ratio d'aspect peut être maintenu. Pris en charge pour les images dans la sortie de rapport PDF ou PostScript.

BACKIMAGE

Ajoute une image d'arrière-plan.



x
Syntaxe : Ajouter une image à un rapport HTML

Cette syntaxe s'applique aux rapports HTML. Pour plus de détails sur l'ajout d'une image à un rapport PDF, PS ou HTML avec une CSS interne, consultez Ajouter une image à un rapport PDF, PS ou HTML avec une feuille de style en cascade interne.

TYPE={REPORT|heading}, IMAGE={url|(column)} [,IMAGEALIGN=position]
     [,IMAGEBREAK={ON|OFF}] [,ALT='description'], $

où :

REPORT

Intègre une image dans le corps d'un rapport. REPORT est la valeur par défaut.

Remarque : l'option IMAGE=(column) n'est pas supportée avec TYPE=REPORT.

heading

Intègre une image dans un en-tête ou un pied de page. Les valeurs valables sont TABHEADING, TABFOOTING, HEADING, FOOTING, SUBHEAD et SUBFOOT

url

Indique l'URL du fichier d'image. L'image doit être dans un fichier différent au format supporté par votre navigateur, tel que GIF ou JPEG. Le fichier peut résider sur votre serveur web local ou sur tout serveur accessible via votre réseau. Pour plus de détails, consultez Spécification d'un URL.

COLUMN=

Est un champ alphanumérique dans une requête (par exemple, un champ d'affichage ou un champ BY) dont la valeur est un URL se dirigeant vers un fichier d'image. Spécifiez une valeur en utilisant l'attribut COLUMN décrit à la rubrique Désignation de composants de rapport dans la syntaxe de feuille de style WebFOCUS. Mettez column entre parenthèses.

Cette option vous permet d'ajouter différentes images à un en-tête ou un pied de page, selon la valeur du champ. Consultez Utilisation d'un nom de fichier dans un champ de source de données dans un rapport HTML.

IMAGEALIGN = position

Indique la postion de l'image.

Remarque : IMAGEALIGN n'est pas pris en charge avec HTMLCSS=ON. Avec HTMLCSS=ON, vous pouvez positionner les images dans un en-tête ou pied de page à l'aide de l'attribut POSITION pour spécifier une position relative dans le coin supérieur gauche de l'en-tête ou pied de page. Pour plus d'informations sur l'attribut POSITION, consultez Ajouter une image à partir d'un champ BLOB à un rapport PDF, DHTML, ou HTML.

Voici les valeurs valables :

TOP, où le coin supérieur droit de l'image s'aligne avec le texte d'en-tête ou de pied de page. Si l'image est jointe au rapport entier, elle s'affiche en haut du rapport.

MIDDLE, où l'image s'affiche au milieu du texte d'en-tête ou de pied de page. Si l'image et jointe au rapport entier, elle s'affiche au milieu du rapport.

BOTTOM, où le coin inférieur droit de l'image s'aligne avec le texte d'en-tête ou de pied de page. Si l'image est jointe au rapport entier, elle s'affiche en bas du rapport.

LEFT, où l'image s'affiche à gauche du texte d'en-tête ou de pied de page. Si l'image est jointe au rapport entier, elle s'affiche à gauche du rapport.

RIGHT, où l'image s'affiche à droite du texte d'en-tête ou de pied de page. Si l'image est jointe au rapport entier, elle s'affiche à droite du rapport.

IMAGEBREAK

Contrôle la génération d'un saut de ligne après l'image. Voici les valeurs valables :

ON, qui génère un saut de ligne après l'image afin que l'élément qui la suit (tel que le texte d'en-tête de rapport) s'affiche sur la prochaine ligne.

OFF, qui supprime un saut de ligne après l'image afin qu'un élément qui la suit s'affiche sur la même ligne. OFF est la valeur par défaut.

description

Est une description de texte d'une image pour raisons de conformité avec l'accessibilité Section 508. Saisissez la description entre guillemets simples.

La description s'affiche aussi sous forme contextuelle lorque vous survolez l'image dans la sortie de rapport avec la souris.


Haut de page

x
Référence : Spécification d'un URL

Les directives suivantes sont les mêmes que celles de la syntaxe IMAGE=url et IMAGE=(column). Dans le dernier cas, elles s'appliquent à un URL stocké dans un champ de source de données.

Spécifiez un URL en :

Les définitions suivantes s'appliquent :



Exemple : Ajout d'une image GIF à un en-tête de rapport HTML

Cette requête ajoute le logo de Gotham Grinds à un en-tête de rapport. Le logo réside dans un autre fichier d'image identifié par un URL relatif dans l'attribut IMAGE.

TABLE FILE GGORDER
ON TABLE SUBHEAD
"PRODUCTS ORDERED ON 08/01/96"
SUM QUANTITY AS 'Ordered Units' BY PRODUCT
WHERE PRODUCT EQ 'Coffee Grinder' OR 'Coffee Pot'
WHERE ORDER_DATE EQ '08/01/96'
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE * 
TYPE=TABHEADING, IMAGE=/IBI_APPS/IBI_HTML/GGDEMO/GOTHAM.GIF, IMAGEBREAK=ON, $ 
ENDSTYLE
END 

IMAGEBREAK=ON, génère un saut de ligne entre le logo et le texte d'en-tête :



Exemple : Création d'un en-tête de rapport avec une image JPEG intégrée
TABLE FILE EMPLOYEE
ON TABLE SUBHEAD
"Employee Salary Information and Courses"
" "
" "
" "
" "
" "
" "
" "
" "
" "
PRINT CURR_SAL BY COURSE_NAME
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF, $
TYPE=TABHEADING, IMAGE=C:\IBI\APPS\IMAGES\Pencils.jpg, 
POSITION=(.5 .5), SIZE=(.5 .5), $
ENDSTYLE
END

Remarque : l'image utilisée dans la requête n'est pas distribuée avec WebFOCUS.

La sortie est :



Exemple : Utilisation d'un nom de fichier dans un champ de source de données dans un rapport HTML

L'exemple suivant illustre comment incorporer une image dans SUBHEAD (en-tête secondaire), et utiliser une différente image pour chaque valeur du champ BY où SUBHEAD (en-tête secondaire) se présente.

DEFINE FILE CAR
FLAG/A12=
DECODE COUNTRY ( 'ENGLAND' 'uk' 'ITALY' 'italy'
   'FRANCE' 'france' 'JAPAN' 'japan' );
END
TABLE FILE CAR
PRINT FLAG NOPRINT AND MODEL AS '' BY COUNTRY NOPRINT AS '' BY CAR AS ''
WHERE COUNTRY EQ 'ENGLAND' OR 'FRANCE' OR 'ITALY' OR 'JAPAN'
ON COUNTRY SUBHEAD
"                     <+0>Cars produced in <ST.COUNTRY"
HEADING CENTER
"Car Manufacturer Report"
" "
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=SUBHEAD, IMAGE=(FLAG), $
TYPE=REPORT, GRID=OFF, $
TYPE=HEADING, SIZE=12, STYLE=BOLD, $
TYPE=SUBHEAD, STYLE=BOLD, $
ENDSTYLE
END

La sortie est :



Exemple : Fourniture d'une description d'image avec l'attribut ALT

Ce qui suit illustre la façon d'utiliser l'attribut ALT. L'attribut ALT fournit une description d'une image que peuvent interpréter les lecteurs de l'écran pour raisons de complicité avec l'accessibilité Section 508 (loi « Workforce Investment Act ») de 1998. La description s'affiche aussi sous forme contextuelle lorque vous survolez l'image dans la sortie de rapport avec la souris.

TABLE FILE GGSALES
SUM UNITS BY PRODUCT
ON TABLE SUBHEAD
"Report on Units Sold"
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=TABHEADING, IMAGE=gglogo, IMAGEBREAK=ON, POSITION=(.25 .25),
   SIZE=(.5 .5), ALT='Gotham Grinds Logo Image', $
GRID=OFF, $
ENDSTYLE
END

La sortie est :


Haut de page

x
Syntaxe : Ajouter une image d'arrière-plan

Cette syntaxe s'applique aux rapports HTML.

[TYPE=REPORT,] BACKIMAGE=url, $

où :

TYPE=REPORT

Applique l'image au rapport entier. Comme ceci est la valeur par défaut, il n'est pas requis.

url

Est l'URL d'un fichier GIF ou JPEG. Spécifiez un fichier sur votre serveur web local, ou sur un serveur qui est accessible via votre réseau.

L'URL peut être une adresse absolue ou relative. Consultez Attributs d'image.

Lorsque vous spécifiez un fichier GIF, vous pouvez omettre l'extension de fichier.



Exemple : Ajout d'une image d'arrière-plan

Cette requête ajoute une image d'arrière-plan à un rapport. Le fichier d'image CALM_BKG.GIF réside à l'adresse relative indiquée.

TABLE FILE GGSALES
SUM UNITS DOLLARS
BY CATEGORY BY PRODUCT
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=REPORT, STYLE=BOLD, GRID=OFF, $ 
TYPE=REPORT, BACKIMAGE=/IBI_APPS/IBI_HTML/TEMPLATE/CALM_BKG.GIF, $ 
ENDSTYLE
END

L'arrière-plan est disposé en mosaïque sur la zone de rapport :


Haut de page

x
Syntaxe : Ajouter une image à un rapport PDF, PS ou HTML avec une feuille de style en cascade interne

Cette syntaxe s'applique à un rapport PDF, PS ou HTML avec une feuille de style en cascade interne. L'image peut être dans un fichier distinct.

Un rapport avec une feuille de style en cascade interne est une page HTML avec une feuille de style en cascade HTML (CSS) stockée entre les balises de style dans le document HTML.

TYPE={REPORT|heading}, IMAGE={url|file|(column)} [,BY=byfield]
[,POSITION=([+|-]x [+|-]y )] [,SIZE=(w h)] ,$

où :

REPORT

Intègre une image dans le corps d'un rapport. L'image s'affiche en arrière-plan. REPORT est la valeur par défaut.

heading

Intègre une image dans un en-tête ou un pied de page. Les valeurs valables sont TABHEADING, TABFOOTING, FOOTING, SUBHEAD et SUBFOOT.

Laissez assez d'espace blanc dans l'en-tête ou le pied de page afin que l'image ne recouvre pas le texte d'en-tête ou de pied de page. Il est aussi conseillé de positionner le texte d'en-tête ou de pied de page à droite de l'image en utilisant des signes de localisation ou l'attribut POSITION dans la feuille de style.

url

Rapport HTML avec une feuille de style en cascade interne :

Indique l'adresse relative ou absolue du fichier d'image. L'image doit être dans un fichier différent au format supporté par votre navigateur, tel que GIF ou JPEG. Le fichier peut résider sur votre serveur web local ou sur tout serveur accessible via votre réseau. Pour plus de détails, consultez Spécification d'un URL.

file

rapport PDF ou PS :

Est le nom du fichier d'image. Le fichier doit résider sur le serveur de reporting WebFOCUS dans un répertoire appelé EDAPATH ou APPPATH. Si le fichier n'est pas sur le chemin de recherche, fournissez le nom de chemin complet.

Lorsque vous spécifiez un fichier GIF, vous pouvez omettre l'extension de fichier.

COLUMN=

Est un champ alphanumérique dans la source de données qui comprend le nom du fichier d'image. Utilisez l'attribut COLUMN décrit à la rubrique Désignation de composants de rapport dans la syntaxe de feuille de style WebFOCUS. Saisissez column entre parenthèses.

Le champ contenant le nom de fichier ou l'image doit s'agir d'un champ d'affichage ou d'un champ BY référencé dans la requête.

La valeur du champ est interprétée exactement comme si elle a été saisie comme l'URL de l'image dans la feuille de style. Si vous omettez le suffixe, .GIF est fournie par défaut. SET BASEURL peut être utile pour fournir l'URL de base des images. Si vous procédez, la valeur du champ ne doit pas forcément inclure l'URL complète.

Cette syntaxe est utile, par exemple, si vous souhaitez incorporer une image dans un SUBHEAD (en-tête secondaire), et que vous voulez employer une différente image pour chaque valeur du champ BY où SUBHEAD se présente. Consultez Utilisation d'un nom de fichier dans un champ de source de données dans un rapport HTML.

byfield

est le critère de tri qui a généré l'en-tête secondaire ou le pied de page secondaire.

POSITION

Est la position de début de l'image.

+|-

Mesure la distance horizontale ou verticale à partir du coin supérieur gauche du composant de rapport dans lequel l'image est incorporée.

x

Est la position de début horizontale de l'image à partir du coin supérieur gauche de la page de rapport physique, exprimée dans l'unité de mesure spécifiée dans le paramètre UNITS.

Ferme x et y entre parenthèses. Ne saisissez pas de virgules entre les valeurs.

y

Est la position de début horizontale de l'image à partir du coin supérieur gauche de la page de rapport physique, exprimée dans l'unité de mesure de l'attribut UNITS.

SIZE

Indique la taille de l'image. Par défaut, une image est ajoutée à sa taille originale.

w

indique la largeur de l'image, exprimée dans l'unité de mesure du paramètre UNITS.

Femez les valeurs w et h entre parenthèses. Ne saisissez pas de virgules entre les valeurs.

h

indique la hauteur de l'image, exprimée dans l'unité de mesure du paramètre UNITS.



Exemple : Ajout d'une image GIF à un rapport HTML avec une feuille de style en cascade interne

Un URL retrouve le fichier d'image GOTHAM.GIF sur un serveur appelé WEBSRVR1. L'attribut TYPE ajoute l'image à l'en-tête de rapport. POSITION positionne l'image horizontalement à un quart de pouce et verticalement à un dixième de pouce du coin supérieur gauche de la page de rapport. L'image mesure un pouce de largeur ou un pouce de hauteur, comme le spécifie SIZE.

SET HTMLCSS = ON
TABLE FILE GGSALES
SUM UNITS BY PRODUCT
ON TABLE SUBHEAD
"REPORT ON UNITS SOLD"
" "
" "
" "
" "
" "
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE *
TYPE=REPORT, GRID=OFF, $ 
TYPE=TABHEADING, IMAGE=HTTP://WEBSRVR1/IBI_APPS/IBI_HTML/GGDEMO/GOTHAM.GIF,
     POSITION=(.25 .10), SIZE=(1 1), $ 
ENDSTYLE
END

Le logo de la société est positionné et dimensionné dans l'en-tête de rapport :



Exemple : Ajout d'une image GIF à un rapport PDF

Le fichier d'image de cet exemple est GOTHAM.GIF. L'attribut POSITION positionne l'image horizontalement à un quart de pouce et verticalement à un quart de pouce du coin supérieur gauche de la page de rapport. L'image mesure un demi pouce de largeur et un demi pouce de hauteur, comme le spécifie SIZE.

SET ONLINE-FMT = PDF
TABLE FILE GGSALES
SUM UNITS BY PRODUCT
ON TABLE SUBHEAD
"Report on Units Sold"
" "
" "
" "
" "
" "
ON TABLE SET PAGE-NUM OFF
ON TABLE SET STYLE * 
TYPE=TABHEADING, IMAGE=GOTHAM.GIF, POSITION=(.25 .25), SIZE=(.5 .5), $ 
ENDSTYLE
END

Voici le rapport :


Haut de page

x
Syntaxe : Ajouter une image à partir d'un champ BLOB à un rapport PDF, DHTML, ou HTML

Pour la sortie PDF contre les sources de données qui prennent en charge le type de données Binary Large Object (BLOB) (Microsoft SQL Server, DB2, Oracle, Informix et PostgreSQL à l'aide du type de données BYTEA), l'image peut être stockée dans un champ BLOB de la source de données.

Les Feuilles de style WebFOCUS utilisées pour produire la sortie du rapport en format PDF, HTML ou DHTML peuvent accéder à un champ de type BLOB comme source d'image lorsqu'une instance du champ BLOB contient une copie binaire exacte d'une image GIF ou JPEG. Les rapports HTML et DHTML prennent également en charge les images PNG. Les images sous différents formats (GIF, JPEG, PNG) peuvent être mélangées dans le même champ de type BLOB. WebFOCUS peuvt déterminer le format de l'en-tête de l'image. L'image peut être insérée dans les colonnes de rapport, les en-têtes, les en-têtes secondaires, les pieds de page, et les pieds de page secondaires.

Le champ BLOB doit être référencé dans une commande PRINT ou LIST dans la requête (l'agrégation n'est pas prise en charge). Les rapports contenant des images de type BLOB sont pris en charge en tant que composants dans les rapports coordonnés composés.

Avec les commandes SET suivantes, les images BLOB fonctionneront à la fois pour HTML et DHTML dans tous les navigateurs :

TYPE={REPORT|heading}, IMAGE={url|file|(column)} [,BY=byfield]
[,POSITION=([+|-]x [+|-]y )] [,SIZE=(w h)] [,PRESERVERATIO={ON|OFF}],$
TYPE=DATA, COLUMN=imagefield, IMAGE=(imagefield), SIZE=(wh)
[,PRESERVERATIO={ON|OFF}] ,$

où :

REPORT

Intègre une image dans le corps d'un rapport. L'image s'affiche en arrière-plan. REPORT est la valeur par défaut (non prise en charge pour les images stockées dans des champs BLOB, qui sont pris en charge pour une sortie PDF).

heading

Intègre une image dans un en-tête ou un pied de page. Les valeurs valables sont FOOTING, HEADING, SUBHEAD, et SUBFOOT.

Si l'image doit être incorporée dans un en-tête, en-tête secondaire, pied de page, pied de page secondaire au lieu d'une colonne, alors l'instruction de la feuille de style s'occupe de placer l'image dans l'en-tête, l'en-tête secondaire, le pied de page ou le pied de page secondaire. Pour rendre l'image BLOB accessible à la feuille de style, le champ BLOB doit être référencé dans la commande PRINT ou LIST avec l'option NOPRINT. Ne pas référencer le nom du champ BLOB dans l'en-tête ou le pied de page.

Laissez assez d'espace blanc dans l'en-tête ou le pied de page afin que l'image ne recouvre pas le texte d'en-tête ou de pied de page. Il est aussi conseillé de positionner le texte d'en-tête ou de pied de page à droite de l'image en utilisant des signes de localisation ou l'attribut POSITION dans la feuille de style.

file

Est le nom du fichier d'image. Le fichier doit résider sur le serveur de reporting WebFOCUS dans un répertoire appelé EDAPATH ou APPPATH. Si le fichier n'est pas sur le chemin de recherche, fournissez le nom de chemin complet.

Lorsque vous spécifiez un fichier GIF, vous pouvez omettre l'extension de fichier.

COLUMN=

Est un champ BLOB dans la source de données qui contient une copie binaire exacte d'une image GIF ou JPEG. Les formats HTML et DHTML prennent également en charge les images au format PNG. Les images sous différents formats (GIF, JPEG, PNG) peuvent être mélangées dans le même champ de type BLOB. WebFOCUS peuvt déterminer le format de l'en-tête de l'image. L'image peut être insérée dans les colonnes de rapport, les en-têtes, les en-têtes secondaires, les pieds de page et les pieds de page secondaires. Utilisez l'attribut COLUMN décrit à la rubrique Désignation de composants de rapport dans la syntaxe de feuille de style WebFOCUS. Saisissez column entre parenthèses.

Le champ contenant le nom de fichier ou l'image doit s'agir d'un champ d'affichage ou d'un champ BY référencé dans la requête.

byfield

est le critère de tri qui a généré l'en-tête secondaire ou le pied de page secondaire.

imagefield

est toute référence de colonne valide pour le champ BLOB qui contient une image. Notez que le champ BLOB doit être référencé dans une commande PRINT ou LIST dans la requête.

Si elle est omise, la taille par défaut est (1 pouce par 1 pouce.) La largeur de colonne et l'espace entre les lignes sont automatiquement ajustés pour satisfaire l'image.

POSITION

Est la position de début de l'image.

+|-

Mesure la distance horizontale ou verticale à partir du coin supérieur gauche du composant de rapport dans lequel l'image est incorporée.

x

Est la position de début horizontale de l'image à partir du coin supérieur gauche de la page de rapport physique, exprimée dans l'unité de mesure spécifiée dans le paramètre UNITS.

Ferme x et y entre parenthèses. Ne saisissez pas de virgules entre les valeurs.

y

Est la position de début horizontale de l'image à partir du coin supérieur gauche de la page de rapport physique, exprimée dans l'unité de mesure de l'attribut UNITS.

SIZE

Indique la taille de l'image. Par défaut, une image est ajoutée à sa taille originale. Notez que les images stockées dans des champs BLOB sont pris en charge uniquement pour les sorties PDF, HTML, et DHTML.

w

indique la largeur de l'image, exprimée dans l'unité de mesure du paramètre UNITS.

Femez les valeurs w et h entre parenthèses. Ne saisissez pas de virgules entre les valeurs.

h

indique la hauteur de l'image, exprimée dans l'unité de mesure du paramètre UNITS.

Si SIZE est omis, les mesures originales de l'image sont utilisées (toute image GIF, JPEG ou PNG a un original, une taille non échelonnée aux mesures de son image bitmap).

[PRESERVERATIO={ON|OFF}]

Non pris en charge pour les images au format PNG. PRESERVERATIO=ON spécifie que le ratio d'aspect (ration de hauteur à largeur) de l'image doit être préservé lorsqu'il est échelonné au paramètre SIZE spécifié. Ceci permet d'éviter la distorsion de l'apparence de l'image. L'image est échelonnée à la taille la plus large possible dans les limites spécifiées par le paramètre SIZE pour lequel le ratio d'aspect peut être maintenu. Pris en charge pour la sortie PDF et PS. OFF ne maintient pas le ratio d'aspect. OFF est la valeur par défaut.

La taille actuelle de l'image stockée dans un champ BLOB varie d'une image à une autre, et l'échelonnement des images selon une taille spécifiée leur permet d'être mieux incorporer dans des colonnes de rapport. Remarque : les images stockées dans un champ BLOB ne sont prises en charge que par les sorties PDF, HTML, et DHTML.



Exemple : Insérer une image à partir d'un champ BLOB dans une colonne de rapport

La source de données Microsoft SQL Server nommée retaildetail comprend les informations sur le produit pour des vêtements de sport et un détaillant de chaussures. La source de données Microsoft SQL Server nommée retailimage a le même identifiant de champ de produit que retaildetail et contient une image pour chaque produit stocké dans le champ nommé prodimage dont le type de données est BLOB.

Le fichier maître suivant décrit la source de données du serveur SQL Microsoft nommé retaildetail.

FILENAME=RETAILDETAIL, SUFFIX=SQLMSS  , $
  SEGMENT=SEG01, SEGTYPE=S0, $
    FIELDNAME=FOCLIST, ALIAS=FOCLIST, USAGE=I5, ACTUAL=I4, $
    FIELDNAME=PRODUCTID, ALIAS=ProductId, USAGE=A5, ACTUAL=A5,
      MISSING=ON, $
    FIELDNAME=DEPARTMENT, ALIAS=Department, USAGE=A10, ACTUAL=A10,
      MISSING=ON, $
    FIELDNAME=CATEGORY, ALIAS=Category, USAGE=A30, ACTUAL=A30,
      MISSING=ON, $
    FIELDNAME=SPORTS, ALIAS=Sports, USAGE=A30, ACTUAL=A30,
      MISSING=ON, $
    FIELDNAME=GENDER, ALIAS=Gender, USAGE=A10, ACTUAL=A10,
      MISSING=ON, $
    FIELDNAME=BRAND, ALIAS=Brand, USAGE=A25, ACTUAL=A25,
      MISSING=ON, $
    FIELDNAME=STYLE, ALIAS=Style, USAGE=A25, ACTUAL=A25,
      MISSING=ON, $
    FIELDNAME=COLOR, ALIAS=Color, USAGE=A25, ACTUAL=A25,
      MISSING=ON, $
    FIELDNAME=NAME, ALIAS=Name, USAGE=A80, ACTUAL=A80,
      MISSING=ON, $
    FIELDNAME=DESCRIPTION, ALIAS=Description, USAGE=A1000, ACTUAL=A1000,
      MISSING=ON, $
    FIELDNAME=PRICE, ALIAS=Price, USAGE=D7.2, ACTUAL=D8,
      MISSING=ON, $

Le fichier maître suivant décrit la source de données Microsoft SQL Server nommée retailimage, qui a le même identifiant de champ de produit que retaildetail et contient une image pour chaque produit stocké dans le champ nommé prodimage dont le type de données est BLOB.

FILENAME=RETAILIMAGE, SUFFIX=SQLMSS  , $
  SEGMENT=RETAILIMAGE, SEGTYPE=S0, $
    FIELDNAME=PRODUCTID, ALIAS=PRODUCTID, USAGE=A5, ACTUAL=A5, $
    FIELDNAME=PRODIMAGE, ALIAS=F02BLOB50000, USAGE=BLOB, ACTUAL=BLOB,
      MISSING=ON, $

La requête suivante joint les deux sources de données et imprime les noms et les prix de produit avec l'image correspondante. La sortie est générée au format DHTML.

-* Rel 7705 DHTML and HTML supports including Image stored in 
-* BLOB field in report column, heading, footing, subhead, or 
-* subfoot
-* Rel 769 supports PDF format
JOIN PRODUCTID IN RETAILDETAIL TO PRODUCTID IN RETAILIMAGE
TABLE FILE RETAILDETAIL
HEADING CENTER
"Product List"
" "
PRINT NAME/A20 PRICE PRODIMAGE AS 'PICTURE'
BY PRODUCTID NOPRINT
BY NAME NOPRINT
ON NAME UNDER-LINE
ON TABLE SET PAGE NOPAGE
-**************************
-* Lines between asterisk lines required for BLOB image support 
-* for HTML and DHTML formats.
ON TABLE SET HTMLEMBEDIMG AUTO
-* Required to support IE8 with images larger than 32K
ON TABLE SET HTMLARCHIVE ON
-*Required for image positioning in subheads in HTML reports
ON TABLE SET HTMLCSS ON 
-**************************
ON TABLE PCHOLD FORMAT DHTML
ON TABLE SET STYLE *
TYPE=REPORT,COLOR=BLUE,FONT=ARIAL, GRID=OFF,$
TYPE=HEADING, SIZE = 18, COLOR=RED,$
TYPE=DATA,COLUMN=PRODIMAGE,IMAGE=(PRODIMAGE),SIZE=(1 1),$
ENDSTYLE
END

L'image est placée dans la colonne de rapport à l'aide de l'instruction CSS suivante, qui nomme le champ d'image, et établit la taille et la position dans la colonne pour l'image :

TYPE=DATA,COLUMN=PRODIMAGE,IMAGE=(PRODIMAGE),SIZE=(1 1),$

La sortie partielle montre que le format DHTML préserve l'espacement spécifié.

La requête suivante génère la sortie au format HTML.

-* Rel 7705 DHTML and HTML supports including Image stored in 
-* BLOB field in report column, heading, footing, subhead, or
-* subfoot
-* Rel 769 supports PDF format
JOIN PRODUCTID IN RETAILDETAIL TO PRODUCTID IN RETAILIMAGE
TABLE FILE RETAILDETAIL
HEADING CENTER
"Product List"
" "
PRINT NAME/A20 PRICE PRODIMAGE AS 'PICTURE'
BY PRODUCTID NOPRINT
BY NAME NOPRINT
ON NAME UNDER-LINE
ON TABLE SET PAGE NOPAGE
-**************************
-* Lines between asterisk lines required for BLOB image support 
-* for HTML and DHTML formats.
ON TABLE SET HTMLEMBEDIMG AUTO
-* Required to support IE8 with images larger than 32K
ON TABLE SET HTMLARCHIVE ON
-*Required for image positioning in subheads in HTML reports
ON TABLE SET HTMLCSS ON 
-**************************
ON TABLE PCHOLD FORMAT HTML
ON TABLE SET STYLE *
TYPE=REPORT,COLOR=BLUE, GRID=OFF, FONT=ARIAL,$
TYPE=HEADING, SIZE = 18, COLOR=RED,$
TYPE=DATA,COLUMN=PRODIMAGE,IMAGE=(PRODIMAGE),SIZE=(1 1),$
ENDSTYLE
END

La sortie partielle montre que l'espacement est différent parce que le navigateur supprime les espaces vierges pour la sortie du rapport HTML.

La requête suivante génère la sortie au format PDF.

-* Rel 7705 DHTML and HTML supports including Image stored in 
-* BLOB field in report column, heading, footing, subhead, or 
-* subfoot
-* Rel 769 supports PDF format
JOIN PRODUCTID IN RETAILDETAIL TO PRODUCTID IN RETAILIMAGE
TABLE FILE RETAILDETAIL
HEADING CENTER
"Product List"
" "
PRINT NAME/A20 PRICE PRODIMAGE AS 'PICTURE'
BY PRODUCTID NOPRINT
BY NAME NOPRINT
ON NAME UNDER-LINE
ON TABLE SET PAGE NOPAGE
-**************************
-* Lines between asterisk lines required for BLOB image support 
-* for HTML and DHTML formats.
ON TABLE SET HTMLEMBEDIMG AUTO
-* Required to support IE8 with images larger than 32K
ON TABLE SET HTMLARCHIVE ON
-*Required for image positioning in subheads in HTML reports
ON TABLE SET HTMLCSS ON 
-**************************
ON TABLE PCHOLD FORMAT PDF
ON TABLE SET STYLE *
TYPE=REPORT,COLOR=BLUE, GRID=OFF,$
TYPE=HEADING, SIZE = 18, FONT = ARIAL, COLOR=RED,$
TYPE=DATA,COLUMN=PRODIMAGE,IMAGE=(PRODIMAGE),SIZE=(1 1),$
ENDSTYLE
END

La sortie partielle PDF préserve l'espacement spécifiées avec des résulats similaires à la sortie DHTML.



Exemple : Insérer une image à partir d'un champ BLOB dans un en-tête secondaire

La source de données Microsoft SQL Server nommée retaildetail comprend les informations sur le produit pour des vêtements de sport et un détaillant de chaussures. La source de données Microsoft SQL Server nommée retailimage a le même identifiant de champ de produit que retaildetail et contient une image pour chaque produit stocké dans le champ nommé prodimage dont le type de données est BLOB.

La requête suivante relie les deux sources de données et imprime les images de produits dans un en-tête secondaire. La sortie est générée au format DHTML. Elle peut également être générée au format HTML ou PDF.

-* Rel 7705 DHTML and HTML supports including Image stored in
-* BLOB field in HTML report column, heading, footing, subhead,
-* or subfoot
-* Rel 769 supports PDF format
-*SET BASEURL='' - Required for embedded images to work. Overrides default
-* setting from WF Client.
SET BASEURL='' 
JOIN PRODUCTID IN RETAILDETAIL TO PRODUCTID IN RETAILIMAGE
TABLE FILE RETAILDETAIL
HEADING CENTER
"Product Catalog"
" "
PRINT NAME NOPRINT PRODIMAGE NOPRINT
BY PRODUCTID NOPRINT
ON PRODUCTID SUBHEAD
""
" ID: <10<PRODUCTID "
" Name: <10<NAME "
" Price: <7<PRICE "
" Image: "
""
""
""
""
""
ON TABLE SET PAGE NOPAGE
-**************************
-* Lines between asterisk lines required for BLOB image support 
-* for HTML and DHTML formats.
ON TABLE SET HTMLEMBEDIMG AUTO
-* Required to support IE8 with images larger than 32K
ON TABLE SET HTMLARCHIVE ON
-*Required for image positioning in subheads in HTML reports
ON TABLE SET HTMLCSS ON 
-**************************
ON TABLE PCHOLD FORMAT DHTML
ON TABLE SET STYLE *
TYPE=REPORT,COLOR=BLUE,FONT = ARIAL,$
TYPE=HEADING, COLOR = RED, SIZE = 16, JUSTIFY=CENTER,$
TYPE=SUBHEAD,BY=PRODUCTID,IMAGE=(PRODIMAGE),SIZE=(1 1), POSITION=(+2 +1),$
END

Voici la sortie partielle.



Exemple : Dimensionner une image d'un champ BLOB

La source de données Microsoft SQL Server nommée retaildetail comprend les informations sur le produit pour des vêtements de sport et un détaillant de chaussures. La source de données Microsoft SQL Server nommée retailimage a le même identifiant de champ de produit que retaildetail et contient une image pour chaque produit stocké dans le champ nommé prodimage dont le type de données est BLOB.

La requête suivante relie les deux sources de données et affiche la même image sur trois colonnes de sortie à l'aide de différentes tailles et différents paramètres PRESERVERATIO. Notez que PRESERVERATIO=ON n'est pas pris en charge avec des images au format PNG.

La sortie est générée au format DHTML. Elle peut également être générée au format HTML ou PDF.

-* Rel 7705 DHTML and HTML supports including Image stored in
-* BLOB field in report column, heading, footing, subhead, or
-* subfoot
-* Rel 769 supports PDF format
JOIN PRODUCTID IN RETAILDETAIL TO PRODUCTID IN RETAILIMAGE
TABLE FILE RETAILDETAIL
PRINT PRODIMAGE AS '' PRODIMAGE AS '' PRODIMAGE AS ''
BY STYLE NOPRINT
WHERE NAME CONTAINS 'Pant' OR 'Tank'
ON STYLE UNDER-LINE
ON TABLE SET PAGE NOPAGE
-**************************
-* Lines between asterisk lines required for BLOB image support 
-* for HTML and DHTML formats.
ON TABLE SET HTMLEMBEDIMG AUTO
-* Required to support IE8 with images larger than 32K
ON TABLE SET HTMLARCHIVE ON
-*Required for image positioning in subheads in HTML reports
ON TABLE SET HTMLCSS ON 
-**************************
ON TABLE PCHOLD FORMAT DHTML
ON TABLE SET STYLE *
TYPE=REPORT,COLOR=BLUE,FONT = ARIAL,$
TYPE=DATA,COLUMN=P1,IMAGE=(PRODIMAGE),SIZE=(.75 .75),$
TYPE=DATA,COLUMN=P2,IMAGE=(PRODIMAGE),SIZE=(.75 1),PRESERVERATIO=ON,$
TYPE=DATA,COLUMN=P3,IMAGE=(PRODIMAGE),SIZE=(.75 1),PRESERVERATIO=OFF,$
END

Notez que PRESERVERATIO=OFF est spécifié pour la deuxième colonne pour préserver le rapport entre la largeur et la hauteur pour cette colonne, même si la hauteur du style SIZE spécifie une valeur différente du style de la première image de colonne. En outre, PRESERVERATIO=OFF est spécifié pour la troisième colonne, donc pour cette colonne le rapport entre la largeur et la hauteur n'est pas préservé et est rendu tel que spécifié par la hauteur du style SIZE et les valeurs de largeur précisées dans la requête (FEX).

La sortie partielle est :



Exemple : Insérer une image à partir d'un champ BLOB dans un rapport de synthèse

Pour insérer une image à partir d'un champ BLOB dans un rapport qui affiche des synthèses de données, vous devez inclure deux commandes d'affichage dans la requête, une commande SUM pour les informations de synthèses et une commande PRINT ou LISTE pour afficher l'image et toute autre détail de données.

La source de données Microsoft SQL Server nommée retaildetail comprend les informations sur le produit pour des vêtements de sport et un détaillant de chaussures. La source de données Microsoft SQL Server nommée retailimage a le même identifiant de champ de produit que retaildetail et contient une image pour chaque produit stocké dans le champ nommé prodimage dont le type de données est BLOB.

La requête suivante joint les deux sources de données. Elle contient deux commandes d'affichage, une commande SUM et une commande PRINT. La commande SUM agrège le prix total pour chaque catégorie et affiche ce nom de catégorie et le prix total dans un en-tête secondaire. La commande PRINT affiche l'image pour chaque élément de la catégorie avec son numéro d'identification individuel et le prix dans un pied de page secondaire.

La sortie est générée au format DHTML. Elle peut également être générée au format HTML ou PDF.

-* Rel 7705 DHTML and HTML supports including images stored in 
-* BLOB field in report column, heading, footing, subhead, or
-* subfoot
-* Rel 769 supports PDF format
SET PRINTPLUS=ON
JOIN PRODUCTID IN RETAILDETAIL TO PRODUCTID IN RETAILIMAGE
TABLE FILE RETAILDETAIL
HEADING CENTER
"Product Price Summary"
" "
SUM PRICE NOPRINT
BY CATEGORY NOPRINT
ON CATEGORY SUBHEAD 
" Category: <CATEGORY "
" Total Price: <PRICE "
" "
PRINT PRICE NOPRINT PRODIMAGE NOPRINT
BY CATEGORY NOPRINT
BY PRODUCTID NOPRINT
ON PRODUCTID SUBFOOT
" " 
" "
" "
" " 
" "
" "
" Product #: <PRODUCTID "
" Name: <NAME "
" Price: <FST.PRICE "
ON TABLE SET PAGE NOPAGE
-**************************
-* Lines between asterisk lines required for BLOB image support 
-* for HTML and DHTML formats.
ON TABLE SET HTMLEMBEDIMG AUTO
-* Required to support IE8 with images larger than 32K
ON TABLE SET HTMLARCHIVE ON
-*Required for image positioning in subheads in HTML reports]
ON TABLE SET HTMLCSS ON 
-**************************
ON TABLE PCHOLD FORMAT DHTML
ON TABLE SET STYLE *
TYPE=REPORT,COLOR=BLUE,FONT=ARIAL,$
TYPE=HEADING, COLOR=RED, SIZE=14, STYLE=BOLD, JUSTIFY=CENTER,$
TYPE=SUBHEAD, COLOR=RED, SIZE=12, STYLE=BOLD, JUSTIFY=CENTER,$
TYPE=SUBFOOT,BY=PRODUCTID,IMAGE=(PRODIMAGE),SIZE=(1 1), POSITION=(0 0),$
TYPE=SUBFOOT,BY=PRODUCTID,OBJECT=FIELD, ITEM=1, WRAP=5,$
END

La sortie de la première catégorie est :


Haut de page

x
Référence : Taille de fichier et considérations de compression pour les images contenues dans les champs BLOB

La taille actuelle d'une image stockée dans le champ BLOB peut varier d'une image à une autre, et l'échelonnement des images selon une taille spécifiée leur permet d'être mieux incorporées dans les colonnes de rapport.

Les fichiers qui comprennent plusieurs images peuvent être grands. Echelonner l'image vers une taille inférieure à l'aide de l'attribut SIZE ne diminue pas la taille du fichier. Notez également que l'utilisation de SET FILECOMPRESS=ON ne réduira pas la taille des images dans un fichier PDF, puisque les images sont déjà stockées dans un formulaire compressé.


WebFOCUS