Generate PDF

Generate PDF サービスは、ネイティブファイル形式を PDF に変換します。また、PDF を他のファイル形式に変換し、PDF ドキュメントのサイズを最適化します。

Generate PDF サービスは、以下のファイル形式を PDF に変換する際にネイティブアプリケーションを使用します。特に説明がない限り、これらのアプリケーションはドイツ語版、フランス語版、英語版および日本語版のみサポートされています。「 Windows のみ 」は、Windows Server 2008 のみがサポートされることを示しています。

  • Microsoft Office 2007 および 2010：DOC、DOCX、RTF、TXT、XLS、XLSX、PPT、PPTX、VSD、MPP、XPS (Windows のみ) および PUB を変換（Windows のみ）

  • Autodesk AutoCAD DWF、DWG（英語のみ）

  • OpenOffice 3.3：ODT、ODS、ODP、ODG、ODF、SXW、SXI、SXC、SXD、DOC、DOCX、RTF、TXT、XLS、XLSX、PPTおよび PPTX を変換。（Windows、LinuxおよびSolaris のみ）

    注意： Generate PDF サービスは、64 ビットバージョンの OpenOffice をサポートしていません。
    注意： Generate PDF サービスは、AutoCAD 2013 で作成された DWF ファイルと DWG ファイルをサポートしていません。

  • FM の変換：Adobe FrameMaker® 8（Windows のみ）

  • PMD、PM6、P65、PM の変換：Adobe PageMaker® 7.0（Windows のみ）

  • サードパーティのアプリケーションによってサポートされているネイティブ形式（アプリケーションに固有のセットアップファイルの開発が必要）（Windows のみ）

Generate PDF サービスでは、次の標準ベースのファイル形式を PDF に変換します。

  • ビデオファイル形式：SWF、FLV（Windows のみ）

  • 画像ファイル形式：JPEG、JPG、JP2、J2Kí、JPC、J2C、GIF、BMP、TIFF、TIF、PNG、JPF

  • HTML

注意： AEM forms では、上記のソフトウェアについて、32 ビット版のみサポートします。

Generate PDF サービスでは、PDF を次のファイル形式に変換します（Windows のみ）：

  • EPS（Encapsulated PostScript）

  • HTML3.2

  • CSS 1.0 を使用した HTML 4.01

  • DOC（Microsoft Word format）

  • RTF

  • テキスト（アクセス可能およびプレーンの両方）

  • XML

  • PDF/A-1b および PDF/A-1a は DeviceRGB カラースペースのみを使用します

  • PDF/E-1（DeviceRGB カラースペースのみを使用）

  • DOCX

  • XLSX

  • PPTX

注意： FM、PMD、PM6、P65、PM、DWG、MPP、SWF、XPS、FLV、VSD、WordPerfect ドキュメント、Microsoft Office ドキュメント（DOC、XLS、PPT、WPD、MPP、RTF、TXT）の PDF 変換は、Acrobat XI Pro がインストールされている場合のみ可能です。

Generate PDF サービスを使用するには、以下の管理タスクを実行する必要があります。

  • 必要なネイティブアプリケーションを、AEM forms をホストするコンピューター上にインストールする

  • AEM forms をホストするコンピューター上における Adobe Acrobat DC Pro のインストール

  • インストール後のセットアップタスクを実行する

これらのタスクに関する説明は、『 AEM forms の自動インストールおよびデプロイ（JBoss 版） 』に記載されています。

Generate PDF サービスの使用に関する詳細は、『 AEM forms サービスリファレンス 』を参照してください。

Generate PDF サービスの設定

Generate PDF サービスに対して設定できるプロパティは以下のとおりです。

Adobe PDF Settings：
変換に適用する、事前設定済みの Adobe PDF 設定の名前です。Adobe PDF 設定は、管理コンソールから設定します。（『 AEM forms 管理ヘルプ 』の「Adobe PDF 設定の指定」を参照）。

Security Settings：
変換ジョブに適用される、事前設定済みのセキュリティ設定の名前です。セキュリティ設定は、管理コンソールで設定されます（『 AEM forms 管理ヘルプ 』の「セキュリティ設定の指定」を参照）。

File type Settings：
変換ジョブに適用される、事前設定済みのファイルタイプ設定の名前です。ファイルタイプ設定は、管理コンソールで設定されます（『 AEM forms 管理ヘルプ 』の「ファイルタイプ設定の指定」を参照）。

Use Acrobat WebCapture（Windows のみ）：
このプロパティが true の場合、Generate PDF サービスは Acrobat Pro Extended 9.0 を使用して、すべての HTML から PDF への変換を実行します。Acrobat Pro Extended を使用すると PDF ファイルの質が向上しますが、パフォーマンスがわずかに低下することがあります。デフォルト値は false です。

Use Acrobat Image Conversion（Windows のみ）：
この設定が true の場合、Generate PDF サービスは Acrobat Pro Extended 9.0 を使用して、すべてのイメージから PDF への変換を実行します。この設定が有用であるのは、Generate PDF サービスの変換メカニズムでは入力画像の大部分が正常に変換できない場合のみです。デフォルト値は false です。

Enable Acrobat-based AutoCAD Conversions（Windows のみ）：
この設定が true の場合、Generate PDF サービスは Acrobat Pro Extended 9.0 を使用して、すべての DWG から PDF への変換を実行します。この設定が有用であるのは、AutoCAD がサーバーにインストールされていない場合や、AutoCAD 変換メカニズムではファイルを正常に変換できない場合のみです。

Regular Expressions For Finding Out Prohibited Special Characters In User Name（Windows のみ）：
ユーザーの名前に含まれていた場合に PDF の書き出し操作および PDF の最適化操作の妨げとなる文字を、正規表現で指定します。次のデフォルト値では、$、¥、/、?、@、*、+、"、|、:、;、=、>、<、[ および ] が削除されます。 
[\\$,\\,\/,\?,\@,\*,\+,\",\|,\:,\;\,\=,\>,\<,\[,\]]

ImageToPDF Pool Size：
Generate PDF サービスによる画像から PDF への変換に使用されるプールサイズです。この数値は、Generate PDF サービスによって同時に実行できる画像から PDF への変換の最大数を表します。シングルプロセッーシステムの場合は、デフォルト値の 3 をお勧めします。マルチプロセッサーシステムの場合にこの値を大きくしてください。

HTML to PDF Pool Size：
Generate PDF サービスによる HTML から PDF への変換に使用されるプールサイズです。この数値は、Generate PDF サービスによって同時に実行できる HTML から PDF への変換の最大数を表します。シングルプロセッーシステムの場合は、デフォルト値の 3 をお勧めします。マルチプロセッサーシステムの場合にこの値を大きくしてください。

Fallback font family for HTML to PDF conversions：
元の HTML で使用されているフォントが AEM forms サーバーからは利用できない場合に PDF ドキュメントで使用されるフォントです。ここでフォントを指定するのは、変換対象の HTML ページに使用されているフォントが利用不可能である場合です。例えば、特定の地域の言語で作成されたページには、利用不可能なフォントが使用されていることがあります。

CreatePDF 操作

様々なファイル形式を PDF ドキュメントに変換します。サポートされるファイル形式は、Microsoft Word、Microsoft PowerPoint、Microsoft Excel、Microsoft Project、Microsoft Visio、Microsoft Publisher および AutoCAD です。さらに、サードパーティのアプリケーションタイプについても、そのタイプ用の PDF 生成アプリケーションがあれば変換できます。

作成される PDF のファイル名は、入力データとして指定される必要があります。このファイル名は、次の場所で指定できます。

  • Input Document プロパティの file 属性

  • Filename With Extension プロパティ

作成される PDF ドキュメントに、セキュリティ権限、PDF 出力設定およびメタデータ情報を適用することもできます。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

変換するファイルおよび変換パラメーターを指定するためのプロパティです。

入力ドキュメント

変換するファイルを表す 文書 値。

Filename with Extension プロパティに値が指定されていない場合は、この document 値の file 属性で入力ファイルの名前が設定されている必要があります。 file 属性を設定するには、XPath の setDocAttribute 関数を使用します。

setDocAttribute 関数を使用する場所は、 Set Value サービスによって提供される execute 操作の中です。この execute 操作は、プロセスダイアグラム上で CreatePDF 操作の前に使用する必要があります。

リテラル値を指定するには、省略記号ボタン をクリックし、アプリケーションからアセットを選択します。

変換オプションプロパティ

ファイルをどのように PDF に変換するかを指定するためのプロパティです。

Filetype Settings

（オプション）生成される PDF ドキュメントに適用される設定を表す string 値。次の値がデフォルトで用意されています。

  • 標準

  • Standard OCR

  • Standard OpenOffice

独自のファイルタイプ設定は、管理コンソールから作成できます。（『 PDF 生成管理ヘルプ 』を参照）。リテラル値を指定するには、設定名をリストから選択します。管理コンソールを使用して作成された、選択可能な設定の名前がリストに表示されます。

Adobe PDF Settings

（オプション）適用する PDF 出力設定を表す string 値。デフォルトで有効である値は次のとおりです。

  • 高品質印刷

  • オーバーサイズページ

  • PDFA 1b 2005 CMYK

  • PDFA1b 2005 RGB

  • PDFX1a 2001

  • PDFX3 2003

  • プレス品質

  • 最小ファイルサイズ

  • 標準

独自の設定を管理コンソールで作成して、その設定をここで指定することができます。（『 Generate PDF 管理ヘルプ 』を参照）。

リテラル値を指定するには、設定名をリストから選択します。管理コンソールを使用して作成された、選択可能な設定の名前がリストに表示されます。

詳細オプションプロパティ

生成される PDF ドキュメントに関する、省略可能なプロパティを指定するためのプロパティです。

ファイル拡張子

（オプション）変換するドキュメントのファイル名と拡張子を表す string 値。この値を指定するのは、Input Document に対して指定された document 値の file 属性が設定されていない場合のみです。

Security Settings

（オプション）セキュリティ設定を表す string 値。デフォルトで用意されている値は No Security のみです。管理コンソールからは、独自の設定を作成できます。

リテラル値を指定するには、設定名をリストから選択します。管理コンソールを使用して作成された、選択可能な設定の名前がリストに表示されます。

Settings Document

（オプション）PDF ドキュメント生成時に適用される設定が格納される 文書 値。例えば、この設定を使用して、PDF を Web での表示用に最適化することができます。設定によっては、PDF ドキュメントの作成後に適用されるものもあります（初期表示やセキュリティなどの設定など）。

この XML ファイルは、Generate PDF 設定ファイルの XML スキーマ定義（XSD）に準拠している必要があります

この XML 設定ファイルの例については、管理コンソールを使用して設定ファイルの 1 つを書き出してください（『 AEM forms 管理ヘルプ 』の「PDF Generator 設定ファイルの読み込みおよび書き出し」を参照）。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

XMP Document

（オプション）生成される PDF ドキュメントに適用されるメタデータ情報が格納されているファイルを表す 文書 値。UTF-8 でエンコードされた XMP のメタデータのみがサポートされます。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

Output プロパティ

出力 PDF ドキュメントの保存に関するプロパティです。

作成されたドキュメント

出力 PDF ドキュメントの保存場所。データタイプは 文書 です。

オプションの Output プロパティ

サービスアクティビティのログ保存に関するプロパティです。

ログドキュメント

オプションのログファイルの保存場所。ログファイルとは、エラーや診断のメッセージが格納されるプレーンテキストファイルです。ログファイルは、どのような場合でも生成されるわけではありません。ログファイルが存在していても、変換時にエラーが発生したとは限りません。ログファイルには、診断メッセージのみが格納されていることもあるからです。データタイプは 文書 です。

Exceptions

この操作によって、 ConversionException 、 FileFormatNotSupportedException 、および InvalidParameterException 例外が発生する場合があります。

ExportPDF 操作

PDF ドキュメントを、サポートされているアプリケーション（ファイル名拡張子に基づきます）に応じて様々なファイルタイプに変換します。この操作がサポートされるのは、Windows プラットフォームのみです。

作成される PDF のファイル名は、入力データとして指定される必要があります。このファイル名は、次の場所で指定できます。

  • Input Document プロパティの file 属性

  • Filename With Extension プロパティ

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

PDF ドキュメントおよび目的の出力形式を指定するためのプロパティです。

入力ドキュメント

変換する PDF ドキュメントを表す 文書 値。この操作の Filename with Extension プロパティに値が指定されていない場合は、この document 値の file 属性が入力ファイルの名前（例えば input.pdf ）に設定されている必要があります。

file 属性を設定するには、XPath の setDocAttribute 関数を使用します。

setDocAttribute 関数を使用する場所は、 Set Value サービスによって提供される execute 操作の中です。この execute 操作は、プロセスダイアグラム上で ExportPDF2 操作よりも前に使用する必要があります。

リテラル値を指定するには、省略記号ボタン をクリックし、アプリケーションからアセットを選択します。

ファイル拡張子

（オプション）入力ドキュメントの名前を表す string 値。 .doc 、 .xls 、 .txt などの値を入力します。この値を指定するのは、Input Document に対して指定された document 値の file 属性が設定されていない場合のみです。

Format Type

（オプション）PDF ドキュメントの変換先ファイル形式を表す string 値。デフォルト値はありません。次の値を指定できます。

  • EPS

  • HTML32

  • HTML40

  • DOC

  • RTF

  • Accessible-Text

  • Plain-Text

  • XML10

  • PDF/A-1a(sRGB)

  • PDF/A-1b(sRGB)

  • PDF/E-1(sRGB)

リテラル値を指定するには、形式をリストから選択します。

Settings Document

（オプション）変換先のドキュメントに適用される設定が格納されている設定ファイルを表す 文書 値。通常、XML ファイルです。

この XML ファイルは、Generate PDF 設定ファイルの XML スキーマ定義（XSD）に準拠している必要があります

この XML 設定ファイルの例については、管理コンソールを使用して設定ファイルの 1 つを書き出してください。（『 AEM forms 管理ヘルプ 』の「PDF Generator ES2 設定ファイルの読み込みおよび書き出し」を参照）。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

Output プロパティ

変換先のドキュメントを指定するためのプロパティです。

Converted Document

書き出されたドキュメントを保存する場所です。データタイプは 文書 です。

Exceptions

この操作によって、 ConversionException 、 FileFormatNotSupportedException 、および InvalidParameterException 例外が発生する場合があります。

HtmlFileToPDF 操作

HTML ファイルまたはアーカイブファイル（ZIP）から PDF ドキュメントを作成します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

HTML ファイルおよび変換設定を指定するためのプロパティです。

入力ドキュメント

PDF ドキュメントに変換する HTML または ZIP ファイルを表す 文書 値。

リテラル値を指定するには、省略記号ボタン をクリックし、アプリケーションからアセットを選択します。

Filetype Settings

（オプション）サポートされるファイルタイプを変換する方法の設定を表す string 値。デフォルトは Standard です。デフォルトで有効である値は次のとおりです。

  • 標準

  • Standard OCR

  • Standard OpenOffice

管理コンソールでは、独自のファイルタイプ設定を作成できます。（『 PDF 生成管理ヘルプ 』を参照）。リテラル値を指定するには、設定名をリストから選択します。管理コンソールを使用して作成された、選択可能な設定の名前がリストに表示されます。

Security Settings

（オプション）生成される PDF ドキュメントのセキュリティ設定を表す string 値。デフォルトは No Security です。管理コンソールからは、独自のセキュリティ設定を作成することもできます。（『 PDF 生成管理ヘルプ 』を参照）。

Settings Document

（オプション）PDF ドキュメント生成時に適用される設定が格納されたファイルを表す 文書 値。例えば、この設定を使用して、PDF を Web での表示用に最適化することができます。設定によっては、PDF ドキュメントの作成後に適用されるものもあります（初期表示やセキュリティなどの設定など）。

この XML ファイルは、Generate PDF 設定ファイルの XML スキーマ定義（XSD）に準拠している必要があります

この XML 設定ファイルの例については、管理コンソールを使用して設定ファイルの 1 つを書き出してください。（『 AEM forms 管理ヘルプ 』の「PDF Generator ES2 設定ファイルの読み込みおよび書き出し」を参照）。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

XMP Document

（オプション）生成される PDF ドキュメントに適用されるメタデータ情報が格納される 文書 値。UTF-8 でエンコードされた XMP のメタデータのみがサポートされます。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

Output プロパティ

変換後のドキュメントおよび操作の結果を指定するためのプロパティです。

作成されたドキュメント

作成された PDF ドキュメントを保存する場所です。データタイプは 文書 です。

Exceptions

この操作によって、 ConversionException 、 FileFormatNotSupportedException 、および InvalidParameterException 例外が発生する場合があります。

Html URL To PDF 操作

指定された URL に存在する HTML ファイルから PDF ドキュメントを作成します。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

HTML ファイルおよび変換設定を指定するためのプロパティです。

Input URL

変換する HTML ファイルの URL を表す string 値。

Filetype Settings

（オプション）サポートされるファイルタイプを変換する方法の設定を表す string 値。デフォルトは Standard です。デフォルトで有効である値は次のとおりです。

  • 標準

  • Standard OCR

  • Standard OpenOffice

管理コンソールでは、独自のファイルタイプ設定を作成できます。（『 PDF 生成管理ヘルプ 』を参照）。リテラル値を指定するには、設定名をリストから選択します。管理コンソールを使用して作成された、選択可能な設定の名前がリストに表示されます。

Security Settings

（オプション）生成される PDF ドキュメントのセキュリティ設定を表す string 値。指定できるオプションは No Security のみです。独自の設定は、管理コンソールから作成することもできます。

Settings Document

（オプション）PDF ドキュメント生成に使用される設定が格納されたファイルを表す 文書 値。例えば、Web での表示用に PDF を最適化するための設定を適用できます。設定によっては、PDF ドキュメントの作成後に適用されるものもあります（初期表示やセキュリティなどの設定など）。

この XML ファイルは、Generate PDF 設定ファイルの XML スキーマ定義（XSD）に準拠している必要があります

この XML 設定ファイルの例については、管理コンソールを使用して設定ファイルの 1 つを書き出してください。（『 AEM forms 管理ヘルプ 』の「PDF Generator ES2 設定ファイルの読み込みおよび書き出し」を参照）。

リテラル値を指定するには、省略記号ボタン をクリックし、アプリケーションからアセットを選択します。

XMP Document

（オプション）生成される PDF ドキュメントに適用されるメタデータ情報が格納される 文書 値。UTF-8 でエンコードされた XMP のメタデータのみがサポートされます。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

Output プロパティ

変換後のドキュメントを指定するためのプロパティです。

作成されたドキュメント

出力 PDF ドキュメントの保存場所。データタイプは 文書 です。

Exceptions

この操作によって、 ConversionException 、 FileFormatNotSupportedException 、および InvalidParameterException 例外が発生する場合があります。

Optimize PDF 操作

PDF ドキュメントを最適化してファイルサイズを縮小します。この操作では、PDF ドキュメントを別の PDF バージョンに変換することもできます。この操作でサポートされる最適化設定は、Adobe Acrobat でサポートされるものと同じです。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Input プロパティ

最適化する PDF ドキュメントおよび最適化設定を指定するためのプロパティです。

Input document

最適化する PDF ドキュメントを表す 文書 値。

リテラル値を指定するには、省略記号ボタン をクリックし、アプリケーションからアセットを選択します。

Filetype settings

使用される Generate PDF ファイルタイプ設定の名前を表す string 値。変換設定は、AEM forms サーバー管理者が管理コンソールから設定します。（『 AEM forms 管理ヘルプ 』の「ファイルタイプ設定の指定」を参照）。次の設定名がデフォルトで提供されています。

  • 標準

  • Standard OCR

  • Standard OpenOffice

AEM forms 管理者は、これらに加えて新しい設定名を作成することもできます。

Settings document プロパティを使用して変換設定を指定する場合は、Conversion Setting Name の値を指定しないでください。これらのプロパティの値を両方とも指定した場合は、Settings document の値で指定された設定が使用されます。どちらのプロパティにも値を指定しない場合は、AEM forms サーバー上のデフォルト設定で選択された File Type 設定が使用されます（『 AEM forms 管理ヘルプ 』の「デフォルト設定の変更」を参照）。

Settings document

（オプション）使用されるファイルタイプ設定が格納された Generate PDF XML 設定ファイルを表す 文書 値。この操作には、XML の filetype-settings 要素内の情報のみが使用されます。

この XML ファイルは、Generate PDF 設定ファイルの XML スキーマ定義（XSD）に準拠している必要があります

この XML 設定ファイルの例については、管理コンソールを使用して設定ファイルの 1 つを書き出してください（『 AEM forms 管理ヘルプ 』の「PDF Generator ES2 設定ファイルの読み込みおよび書き出し」を参照）。

リテラル値を指定するには、省略記号ボタンをクリックし、アプリケーションからアセットを選択します。

Output プロパティ

最適化された PDF ドキュメントを保存する場所を指定するためのプロパティです。

Converted Document

最適化された PDF を保存する、プロセスデータモデル内の場所。データタイプは 文書 です。例えば、最適化された PDF を変数に保存するには、ドキュメント変数をリストから選択します。

Exceptions

この操作によって、 ConversionException 、 FileFormatNotSupportedException 、および InvalidParameterException 例外が発生する場合があります。

Generate PDF の例外

Generate PDF サービスでは、以下の例外のときに例外イベントがスローされます。

ConversionException

基本的例外で変換が失敗した場合に発生します。

FileFormatNotSupportedException

指定されたファイルフォーマットがサポートされていない場合に発生します。

InvalidParameterException

指定されたパラメーターが無効な場合に発生します。