Since Adobe will no longer be supporting Flash Player after December 31, 2020 and Adobe will block Flash content from running in Flash Player beginning January 12, 2021, Adobe strongly recommends all users immediately uninstall Flash Player to help protect their systems.
For more information, see Flash Player End of Life announcement.
The cfdocument tag converts everything between its start and end tags into PDF or FlashPaper output format and returns it to the browser or saves it to a file. As a result you can easily convert HTML to printable output, as the following example shows:
<p>This is a document rendered by the cfdocument tag.</p> |
The cfdocument tag supports all HTML and CFML tags, with the following exceptions:
Note: ColdFusion does not return HTML and CFML outside the <cfdocument> </cfdocument> pair. |
You can convert HTML-based reports into PDF or FlashPaper output by wrapping the HTML in the cfdocument start and end tags, and specifying cfdocument attributes, as appropriate, to customize the following items:
Note: Embedding fonts in the report can help ensure consistent display across multiple browsers and platforms. For more information on the considerations related to embedding fonts, see Creating a simple report. |
The following example displays a list of employees, using a cfoutput tag to loop through the query:
<h1>Employee List</h1> |
You can use the cfdocument and cfdocumentsection tags to fine-tune your printable output, as follows:
You use one or more cfdocumentitem tags to specify headers and footers or to create a page break. You can use cfdocumentitem tags with or without the cfdocumentsection tag, as follows:
<!--- Running header ---> |
When using cfdocumentsection, all text in the document must be enclosed within cfdocumentsection tags. ColdFusion ignores HTML and CFML outside cfdocumentsection tags. The margin attributes override margins specified in previous sections or in the parent cfdocument tag. If you specify margin attributes, the unit attribute of the parent cfdocument tag control the units; the default for the unit attribute is inches.
Within a section, use the cfdocumentitem tag to specify unique headers and footers for each section and a page break before each section, as the following example shows:
SELECT Emp_ID, firstname, lastname, e.dept_id, salary, d.dept_name |
When you use the cfdocument tag, ColdFusion creates a scope named cfdocument. This scope contains the following variables:
totalsectionpagecountDisplays the total number of sections.
Note: You can use the cfdocument scope variables in expressions within the cfdocumentitem tag only. |
You typically use these variables in a header or footer to display the current page number and total number or pages, as the following example shows:
#cfdocument.totalpagecount#</cfdocumentitem> |
You can use the cfdocument bookmark attribute to create bookmarks for each section within a PDF document, as the following example shows:
<cfdocumentitem type="header"> |
The bookmarks appear in the bookmarks panel of the PDF document.
You can use the cfhttp tag in combination with the cfdocument tag to display entire web pages in PDF or FlashPaper output format, as the following example shows:
<cfparam name="url.target_url" default="http://www.boston.com"> |
The cfdocument tag supports the Acrobat security options, as the following table shows:
Security option |
Description |
---|---|
Encryption |
Use the encryption attribute to specify whether PDF output is encrypted. Specify one of the following:
|
User password |
Use the userpassword attribute to specify a password that users must enter to view the document. |
Owner password |
Use the ownerpassword attribute to specify a password that users must enter to view and optionally modify the document. |
Additionally, the cfdocument tag supports the following Acrobat security permissions through the permissions attribute. Specify one or more of the following values; separate multiple permissions with a comma:
Permission |
Description |
---|---|
Printing |
Specify the AllowPrinting attribute to enable viewers to print the document. |
Modification |
Specify the AllowModifyContents attribute to let viewers modify the document, assuming they have the required software. |
Copy |
Specify the AllowCopy attribute to let viewers select and copy text from the document. |
Annotation |
Specify AllowModifyAnnotations to let viewers add comments to the document. If users add annotations, they must save the PDF after making changes. |
Screen readers |
Specify AllowScreenReaders to enable access to the document through a screen reader. |
Fill in |
Specify AllowFillIn to enable users to use form fields. |
Assembly |
Specify AllowAssembly to enable users to create bookmarks and thumbnails, as well as insert, delete, and rotate pages. |
Degraded printing |
Specify AllowDegradedPrinting to enable lower-resolution printing. This format prints each page as a bitmap, so printing can be slower. |
Note: The defaults for these options vary, based on encryption level. These options apply to PDF only. For more information, see the cfdocument discussion in the CFML Reference. |
The following example creates a PDF document that allows copying only:
ownerpassword="us3rpa$$w0rd" userpassword="us3rpa$$w0rd" |
You can use the cfdocument filename attribute to save the generated PDF or SWF content to a file, as the following example shows:
tutorial application, found under the cfdocs directory. --->
|
Log ind på din konto