OUTPUTIMAGEFORMAT
command line keywordOUTPUTIMAGEFORMAT
specifies the format for
images in report output.
The executables that can use this keyword are:
rwbuilder |
yes |
rwrun |
yes |
rwclient |
yes |
rwcgi |
yes |
rwserver |
no |
rwservlet |
yes |
rwconverter |
no |
OUTPUTIMAGEFORMAT={PNG|JPEG|JPG|GIF|BMP}
Values |
Description |
|
|
Supported image formats when
|
|
GIF |
Supported image format when DESFORMAT
value is PDF , HTML , HTMLCSS , or SPREADSHEET |
|
BMP |
Supported image format when DESFORMAT
value is RTF |
This command line keyword overrides the setting of the REPORTS_OUTPUTIMAGEFORMAT
environment variable.
This command line keyword is not supported if the REPORTS_DEFAULT_DISPLAY
environment variable is explicitly set to NO
(default is YES
).
In this case, image rendering defaults to GIF for HTML, HTMLCSS, and PDF
output, and to BMP for RTF output.
You must ensure that the format that you specify matches the output type. For example, BMP only works for RTF output. It will not work for HTML, HTMLCSS, or PDF output.
DESFORMAT=SPREADSHEET
using a secured Reports Server is not supported. This is due to Excel's limitation
on cookie support. Alternatively, you can write the Excel output from a secure
Reports Server to a URL using WebDAV. For more information about this pluggable
destination, refer to the Oracle Reports Plugin Exchange on the Oracle
Technology Network (OTN): on the Oracle Reports 10g page (http://www.oracle.com/technology/products/reports/index.html
),
click Plugin Exchange.The following command lines generate PNG images with HTML output:
rwclient server=my_rep_server
report=images.rdf destype=file desformat=html desname=images.html userid=user_id
outputimageformat=PNG
rwrun report=images.rdf destype=file
desformat=html desname=images.html userid=user_id outputimageformat=PNG
Similarly when DESFORMAT=PDF
, images are embedded
in PNG format in the generated PDF document.
An error is displayed if an invalid value is specified for the OUTPUTIMAGEFORMAT
.
The following command lines generate an error message:
rwclient server=my_rep_server
report=images.rdf destype=file desformat=html desname=images.html userid=user_id
outputimageformat=ABCD
rwrun report=images.rdf destype=file
desformat=html desname=images.html userid=user_id outputimageformat=ABCD
The invalid image format ABCD generates the following error message:
REP-35000: The image output format
specified is not supported.
Running a report from the command line
Copyright © 1984, 2005, Oracle. All rights reserved.