説明

cfpdf タグの追加情報を提供します。cfpdfparam タグは、cfpdf タグの merge アクションにのみ適用され、常に cfpdf タグの子タグになります。

履歴

ColdFusion 8:このタグが追加されました。

カテゴリ

フォームタグ

シンタックス

<cfpdf action = "merge" ..> 
<cfpdfparam 
pages = "page number|page range|comma-separated page numbers" 
password = "user or owner password" 
source = "absolute or relative pathname to a PDF file|PDF document variable| 
cfdocument variable"> 
</cfpdf>

PDF や他のタイプのファイルを PDF に添付できます。PDF を新しい場所に移動すると、添付ファイルも一緒に移動します。cfpdfparam を使用して、添付ファイルの場所、添付ファイルのファイル名、添付ファイルの説明、エンコーディング、添付ファイルの MIME タイプを指定できます。ファイルはドキュメントレベルで添付できます。

<cfpdfparam
   // required
   source= "path of attachment"
   filename = "filename for the attachment"
   encoding = "encoding for filename" >
   // optional  
   description = "descriptive text"
   mimetype = "application/pdf, text/html">
/>

属性名

必須/オプション

説明

 

action

必須

実行するアクション:

addAttachments

 

source

 

 

必須

PDF ファイルへの

絶対または相対パス名 | PDF ドキュメント変数または

cfdocument 変数

 

filename

必須

添付ファイルのファイル名

 

mimetype

オプション

mimetype 属性値の例としては、text/html、application/pdf などがあります。

 

encoding

必須

filename のエンコーディングのタイプ。デフォルト値は UTF-8 です。

description

オプション

添付ファイルの説明

destination/name

必須

destination = "PDF 出力ファイルのパス名"。

name = "PDF ドキュメント変数名"。

保存先のファイルが既に存在する場合は、overwrite 属性を yes に設定します。保存先のファイルが存在せず、指定した親ディレクトリが存在する場合は、ColdFusion によってそのファイルが作成されます。

注意:このタグの属性は attributeCollection 属性で指定でき、その値は構造体になります。attributeCollection 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。

関連項目

cfdocumentcfdocumentsectioncfpdfcfpdfformcfpdfformparamcfpdfsubformcfprintIsPDFFileIsPDFObject

属性

属性

必須/オプション

デフォルト

説明

pages

オプション

 

マージする PDF ソースファイルのページです。ページの範囲(例 : "1-5")またはページのカンマ区切りリスト(例 : "1-5,9-10,18")を指定できます。

password

オプション

 

ユーザーパスワードまたはオーナーパスワードを指定します(ソース PDF ファイルがパスワードで保護されている場合)。

source

必須

 

マージするソース PDF ファイルです。PDF 変数、cfdocument 変数またはファイルのパス名を指定できます。

使用方法

cfpdfparam タグを使用すると、複数の PDF ドキュメントを 1 つのファイルにマージできます。cfpdfparam タグを使用すると、ソースファイルの順序を明示的に指定できます。このタグを使用すると、異なる場所にある複数の PDF ドキュメントソースファイルのページをマージできます。
次のコードは、combined.pdf という PDF ドキュメントを作成します。この PDF ドキュメントには、abc.pdf ファイルの 1 ~ 3 ページおよび 5 ページ、xyz.pdf の全ページ、メモリ内の myPDFvariable 変数に格納されたファイル、abc.pdf ファイルの 10 ~ 90 ページ、という順序でページがマージされます。password 属性は、ソースファイルがパスワードで保護されている場合にのみ適用されます。

<cfpdf action="merge" destination="combined.pdf" overwrite="yes"> 
<cfpdfparam source="c:\abc.pdf" pages="1-3,5" password="adobe"> 
\\x 
<cfpdfparam source="myPDFvariable"> 
<cfpdfparam source="abc.pdf" pages="10-90" password="adobe"> 
</cfpdf>

注:cfpdfparam タグを cfpdf の merge アクションと共に使用する場合は、cfpdf タグの destination 属性または name 属性を指定する必要があります。

次の ColdFusion ページでは、税務関連のフォームと税務情報の冊子をダウンロードするためのフォームを作成します。

<h3>Downloading Federal Tax Documents</h3> 
<p>Please choose the your type of business.</p> 
<!--- Create the ColdFusion form to determine which PDF documents to merge. ---> 
<table> 
<cfform action="cfpdfMergeAction.cfm" method="post"> 
<tr><td><cfinput type="radio" name="businessType" Value="SoleP"> 
Sole Proprieter</td></tr> 
<tr><td><cfinput type="radio" name="businessType" 
Value="Partner">Partnership</td></tr> 
<tr><td><cfinput type="radio" name="businessType" Value="SCorp">S Corporation</td></tr> 
<cfinput type = "hidden" name = "selection required" value = "must make a selection"> 
<tr><td><cfinput type="Submit" name="OK" label="OK"></td></tr> 
</tr> 
</cfform> 
</table>

ColdFusion アクションページにより、フォームで選択された値に基づいて、異なる場所にある PDF ファイルがマージされます。

<!--- Create a merged PDF document based on the selection in the form. ---> 
<cfpdf action="merge" name="taxDoc"> 
<cfif #form.businessType# is "SoleP"> 
<cfpdfparam source="taxForms\f2106ez.pdf"> 
<cfpdfparam source="taxForms\f1040.pdf"> 
<cfpdfparam source="taxForms\f1040sc.pdf"> 
<cfpdfparam source="taxInfo\i1040sc.pdf"> 
<cfpdfparam source="taxInfo\i2106.pdf"> 
<cfpdfparam source="taxInfo\i1040sc.pdf"> 
<cfpdfparam source="taxInfo\p535.pdf"> 
<cfpdfparam source="taxInfo\p560.pdf"> 
<cfpdfparam source="taxInfo\p334.pdf"> 
<cfelseif #form.businessType# is "Partner"> 
<cfpdfparam source="taxForms\f1065.pdf"> 
<cfpdfparam source="taxForms\f1065b.pdf"> 
<cfpdfparam source="taxForms\f1065bsk.pdf"> 
<cfpdfparam source="taxForms\f8804.pdf"> 
<cfpdfparam source="taxForms\f8825.pdf"> 
<cfpdfparam source="taxInfo\p535.pdf"> 
<cfpdfparam source="taxInfo\p560.pdf"> 
<cfpdfparam source="taxInfo\i1065bsk.pdf"> 
<cfelseif #form.businessType# is "SCorp"> 
<cfpdfparam source="taxForms\f1120s.pdf"> 
<cfpdfparam source="taxForms\f2553.pdf"> 
<cfpdfparam source="taxForms\f8453s.pdf"> 
<cfpdfparam source="taxForms\f8825.pdf"> 
<cfpdfparam source="taxInfo\i1120s.pdf"> 
<cfpdfparam source="taxInfo\p542.pdf"> 
<cfpdfparam source="taxInfo\p535.pdf"> 
<cfpdfparam source="taxInfo\p560.pdf"> 
</cfif> 
</cfpdf> 

<cfpdf action="write" source="taxDoc" destination="c:\taxDoc.PDF" 
overwrite="yes"/>

注:cfpdf タグの merge アクションを使用すると、ColdFusion によってフォームフィールドが自動的にフラット化されます。

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー