<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 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。 |
関連項目
cfdocument、cfdocumentsection、cfpdf、cfpdfform、cfpdfformparam、cfpdfsubform、cfprint、IsPDFFile、IsPDFObject
属性
属性 |
必須／オプション |
デフォルト |
説明 |
|---|---|---|---|
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 によってフォームフィールドが自動的にフラット化されます。 |
