「generatePDFOutput」操作

指定したフォームデザインとデータから PDF または PDF/A ドキュメントを生成します。オプションで、各レコードのメタデータファイルを生成し、出力を直接プリンターに送信することもできます。この操作は、アプリケーションの一部であるフォームデザインを Application ビューで使用する場合に行います。フォームデザインがネットワーク上、ローカルファイルシステム、または HTTP 上の場所にある場合は、「generatePDFOutput」操作(非推奨)操作を行うことをお勧めします。

「generatePDFOutput」(非推奨)操作の代わりにこの操作を使用することの利点は、次のとおりです。

  • すべてのアセットが単一のアプリケーションに含まれるため、アプリケーションの移植性が最大化されます。

  • フォームデザインやデータファイルが document 変数として評価されるため、プロセスのデザインが簡単になります。

例えば、データファイルの数百件ものレコードに対してアプリケーションで PDF ファイルを作成する必要があるとします。フォームデザインはアプリケーションの一部です。「generatePDFOutput」操作使用すると、データファイルの各レコードに対して PDF ファイルを作成できます。

注意: 「generatePDFOutput」操作(非推奨)操作は、ドキュメント変数を作成してフォームデザインまたはフォームデータを保存することができない場合にのみ使用します。ネットワーク、ローカルファイルシステム、または HTTP 上の場所で動的に参照されているフォームデザインやデータファイルに対してはドキュメント変数を作成できません。

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

Input プロパティ

フォームデザイン、データファイル、印刷形式を指定するプロパティです。

Form

フォームデザインを表す document 値。Designer でフォームデザインを作成します。

リテラル値を指定する場合は、省略記号ボタン をクリックして、Select Asset ダイアログボックスを開きます(Select Asset についてを参照)。

Input Data

(オプション)フォームデザインとマージするデータファイルを指定する document 値。指定するデータファイルは XML ファイルです。

リテラル値を指定する場合は、省略記号ボタンをクリックして、Select Asset ダイアログボックスを開きます(Select Asset についてを参照)。

Transformation Format

ドキュメントをレンダリングする形式を指定する TransformationFormat 値。

リテラル値を指定する場合、次のいずれかの値を選択します。

PDF:
非インタラクティブ PDF ドキュメントが作成されます。

PDFA:
非インタラクティブ PDF/A ドキュメントが作成されます。PDF/A ドキュメントはアーカイブ用に使用するもので、ISO 規格 19005-1 に準拠しています。また、すべてのフォントが埋め込まれ、圧縮が無効になります。この値を選択する場合、PDF/A Revision Number プロパティと PDF/A Conformance プロパティに値を設定してください。

Template Options プロパティ

Content Root

(オプション)フォームデザインで使用する関連アセットを取得するための URI、絶対参照、またはレポジトリ内の場所を指定する string 値。例えば、フォームデザインが ../myImage.gif のようにイメージを相対的に参照する場合、myImage.gif は repository:// に配置する必要があります。デフォルト値は repository:// で、これはリポジトリのルートレベルをポイントします。

アプリケーションからアセットを選択するとき、コンテンツルート URI パスは正確な構造になっている必要があります。例えば、フォームを SampleApp というアプリケーションから選択し、SampleApp/1.0/forms/Test.xdp に配置する場合、コンテンツルート URI は repository://administrator@password/Applications/SampleApp/1.0/forms/ または repository:/Applications/SampleApp/1.0/forms/(認証機関情報が NULL の場合)と指定する必要があります。コンテンツルート URI をこの方式で指定すると、フォーム内で参照されているすべてのアセットのパスがこの URI を基準に解決されます。

URI または絶対参照には次のソースを使用します。

リポジトリ:
リポジトリには、LiveCycle サーバーにアップロードするアセットがあります。値 repository:/// はリポジトリのルートを参照します。最初の 2 つのスラッシュはプロトコル(repository://)の一部であり、3 番目のスラッシュはリポジトリのルートを表します。例えば、フォームデザインが ../myImage.gif のようにイメージを相対的に参照する場合、myImage.gif は repository:// に配置する必要があります。デフォルト値は repository:// で、これはリポジトリのルートレベルをポイントします。

LiveCycle サーバーのファイルシステムのディレクトリ:
LiveCycle サーバー上の場所(C:\[folder name] など)を指定できます。アプリケーションの移植性を最大限に高める必要がある場合、サーバー上の場所を使用することはお勧めしません。

ネットワークディレクトリ:
ネットワーク上の場所(¥¥[folder name] など)を指定できます。

HTTP でアクセス可能な Web 上の場所:
ファイルを Web サーバー上の場所にアップロードした後で、URL を使用して場所を指定できます。例えば、http://[server name]:[port number]/[folder name] のように入力します。[server name] は Web サーバーの名前、[port number] はポート番号、[folder name] はフォルダーの名前です。

PDF Output Options プロパティ

生成した PDF ファイルの出力オプションを指定するプロパティです。

XCI URI

(オプション)使用する XCI ファイルを指定する string 値。XCI ファイルはフォームデザイン要素に使用するフォントの説明に使用します。また、部数、両面印刷の使用、ステープル印刷オプションなどの印刷オプションも指定できます。

Character Set

(オプション)レンダリングしたフォームをエンコードするために使用される文字セットを指定する string 値。

リテラル値を指定する場合、使用する文字セットを選択するか、または次のいずれかの値を選択します。

<Use Server Default>:
(デフォルト)LiveCycle サーバー上で設定されている文字セット設定を使用します。文字セット設定は、管理コンソールを使用して設定されます(Forms 管理ヘルプを参照)。

<Use Custom Value>:
リスト内にない文字セットを使用します。この値を選択した後、リストの横にあるボックスで、リストにないエンコーディングセットの正規の名前(Java.nio API)を入力します。文字セットのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/encoding.doc.html を参照してください。

Locale

(オプション)PDF ドキュメントの生成時に使用する言語を指定する string 値。

リテラル値を指定する場合は、リストから選択するか、次のいずれかの値を選択します。

<Use Server Default>:
(デフォルト)LiveCycle サーバー上で設定されているロケール設定を使用します。ロケール設定は、管理コンソールを使用して設定されます(Forms 管理ヘルプを参照)。

<Use Custom Value>:
リスト内にないロケールを使用します。この値を選択した後、リストの横にあるボックスで、リストにないロケールコードのロケール ID を入力します。サポートされるロケールコードのリストについては、http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html を参照してください。

Record Name

(オプション)レコードのバッチの先頭を表す要素名を指定する string 値。

Record Level

(オプション)レコードデータを含む XML 要素レベルを指定する int 値。

リテラル値を指定する場合、デフォルト値は 1 です。この値は Record Name プロパティで指定したレコードの最初のレベルを表します。

Generate Multiple Streams

(オプション)この操作により作成される出力が 1 件か複数かを指定する boolean 値。

リテラル値を指定する場合、デフォルトでは「Generate Multiple Streams」チェックボックスの選択が解除されています。複数の出力を作成する場合はこのチェックボックスを選択してください。レコード 1 件の処理が完了するたびに送信する場合は、複数の出力を作成すると便利です。出力を 1 件だけ作成する場合はこのチェックボックスの選択を解除します。処理されたすべてのレコードを一括送信する場合は、1 件の出力を作成すると便利です。

Enable Lazy Loading

(オプション)複数レコードのデータセットを処理する場合にインクリメンタル(遅延)読み込みを使用するかどうかを指定する boolean 値。インクリメンタル読み込みを使用すると、LiveCycle サーバーで使用するメモリの量を抑えることができます。インクリメンタル読み込みを使用する場合、変換は 1 回につき 1 レコードにしか適用されないため、XCI ファイルで指定した XLST オプションが制限されます。

リテラル値を指定する場合は、「Enable Lazy Loading」ボックスを選択して 1 件のデータレコードを読み込んでマージします。データファイル全体、またはすべてのデータを一度に読み込んでマージする場合は、このチェックボックスの選択解除します。

Pattern Match Size

(オプション)パターン文字列のスキャンのため使用する入力ファイルの先頭からのバイト数を指定する int 値。

リテラル値を指定する場合、デフォルト値は 500 です。

Pattern Matching Rules

(オプション)データファイルでパターンを検索し、データを特定のフォームデザインと関連付けるために使用する string 値のlist です。次のいずれかのボタンをクリックすると、リストのエントリを追加または削除できます。

緑のプラス記号。Add A List Entry:
新規ルールを追加します。このボタンをクリックすると、新規エントリがリストに作成されます。新規エントリの「Pattern」フィールドに、検索するパターンを入力します。「Form」フィールドで、パターンと照合するフォームデザインの名前を入力します。指定するフォームデザインはいずれも、この操作の Content Root プロパティで指定する場所で使用可能である必要があります。

赤色の X 印。Delete A Selected List Entry:
選択されたルールをリストから削除します。

例えば、car のようなテキストパターンを検索し、この操作で AutoInsurance.xdp という名前のフォームデザインを使用するように指定することができます。データに car というテキストがあると必ず AutoInsurance.xdp フォームが使用されます。検索ルールの操作について詳しくは、Designer ヘルプを参照してください。

Output Location URI

(オプション)出力ファイルの保存先となる URI を指定する string 値。複数のファイルを作成する場合、ファイル名の末尾には数値が付加されます。例えば、C:¥forms¥Loan.pdf を指定した場合、Output サービスにより作成されるファイル名は Loan0001.pdf、Loan0002、Loan0003 などのようになります。各ファイルは LiveCycle サーバーの C:\forms フォルダーに作成されます。

Printer Name

(オプション)印刷のために出力を送信するプリンターの名前を指定する string 値。指定したプリンターに LiveCycle サーバーがアクセスできるよう設定されている必要があります。

リテラル値を指定する場合、プリンター名は ¥¥[print server]¥[printer name] という形式で指定できます。[print server] の値はプリンターサーバー、[printer name] はプリンター名をそれぞれ表します。

LPD URI

(オプション)ネットワーク上で実行されている Line Printer Daemon(LPD)の URI を指定する string 値。

リテラル値を指定する場合、LPD の名前は lpd://[host name] という形式で指定できます。[host name] の値は LPD ホストの名前です。

LPD Printer Name

(オプション)指定した LPD にあるプリンターの名前を指定する string 値。

リテラル値を指定する場合、プリンター名は [printer name] という形式で指定できます。[printer name] の値はプリンターの名前です。

Meta Data Spec File

(オプション)使用するメタデータ仕様ファイルの URI を指定する string 値。メタデータ仕様ファイルは、指定したデータファイルからメタデータを生成するために使用します。

例えば、次のようなメタデータ仕様ファイルを作成できます。

<metadata-spec> 
<system> 
        <map xpath="$fileName" name="fName"/> 
        <map xpath="$format" name="docType"/> 
    </system> 
    <user> 
        <map xpath="header/txtOrderedByCompanyName" name="companyName"/> 
        <map xpath="header/txtOrderedByAddress" name="address"/> 
        <map xpath="header/txtOrderedByCity" name="city"/> 
        <map xpath="header/txtOrderedByStateProv" name="state"/> 
        <map xpath="header/txtOrderedByZipCode" name="zipCode"/> 
        <map xpath="header/txtOrderedByCountry" name="country"/> 
        <map xpath="header/txtOrderedByPhone" name="phone"/> 
        <map xpath="header/txtOrderedByFax" name="fax"/> 
    </user> 
</metadata-spec>

リテラル値を指定する場合は、省略記号ボタンをクリックして、Select Asset ダイアログボックスを開きます(Select Asset についてを参照)。

メタデータファイルは、各レコードから抽出したデータで作成されます。作成されるメタデータファイルの構造はメタデータ仕様ファイルに基づいています。前述のメタデータ仕様ファイルに基づいて作成されたメタデータファイルは次のようになります。

<root><record id='null'> 
    <system> 
        <data name='fName'>c:\cumulativedata0001.pdf</data> 
        <data name='docType'>PDF</data> 
    </system> 
    <user> 
        <data name='companyName'>Any Company Name</data> 
        <data name='address'>555, Any Blvd.</data> 
        <data name='city'>Any City</data> 
        <data name='state'>Alabama</data> 
        <data name='zipCode'>12345</data> 
        <data name='country'>United States</data> 
        <data name='phone'>(123) 456-7890</data> 
        <data name='fax'>(123) 456-7899</data> 
    </user> 
</record>

Record ID XPath

(オプション)XPath 式に使用するルートレベルノードを指定する int 値。ルートレベルノードは XPath 式の開始点を指定します。例えば、次のようなデータスキーマがあるとします。

<batch_100> 
    <purchaseOrder> 
        <header> 
            <txtPONum>1of100</txtPONum>  
            <dtmDate>2004-02-08</dtmDate>  
            <txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>  
            <txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>  
            <txtOrderedByCity>Any City</txtOrderedByCity>  
            <txtOrderedByStateProv>Alabama</txtOrderedByStateProv>  
        </header> 
        </detail 
            <txtPartNum>580463116</txtPartNum>  
            <txtDescription>Electric Fuel Pump</txtDescription>  
            <numQty>1</numQty>  
            <numUnitPrice>149.95</numUnitPrice>  
            <numAmount>149.95</numAmount> 
        </detail> 
    </purchaseOrder> 
</batch_100>

XPath 式の最初のレベルとして <purchaseOrder> タグを参照するには、このプロパティの値を 2 に設定します。<batch_100> を最初のレベルとして設定するには、このプロパティの値を 1 に設定します。

Generate Record Level Meta Data

(オプション)レコード 1 件ごとにメタデータファイルを生成するかどうかを指定する boolean 値。

リテラル値を指定する場合、デフォルトででは「Generate Record Level Meta Data」チェックボックスの選択が解除されています。このチェックボックスを選択すると、処理されたレコード 1 件ごとにメタデータファイルが生成されます。このチェックボックスの選択を解除すると、処理されたすべてのレコード全体に対して 1 つのメタデータファイルが生成されます。

General Render Options プロパティ

基本的な PDF レンダリングオプションを指定するプロパティです。

Linearized PDF

線形化された PDF ドキュメントをレンダリングするかどうかを指定する boolean 値。線形化された PDF ドキュメントは、ネットワーク上の PDF ドキュメントにアクセスした場合にこのドキュメントへのインクリメンタルアクセスが可能になるように構成されます。例えば、線形化された PDF は、PDF ドキュメント全体がダウンロードされる前に、Web ブラウザーで表示できます。

リテラル値を指定する場合、デフォルトでは「Create PDF For Quicker Display In A Browser」チェックボックスの選択が解除されています。このチェックボックスを選択すると、線形化された PDF フォームがレンダリングされます。このオプションは、最適化された Web アプリケーションに適しています。このチェックボックスの選択を解除すると、線形化された PDF フォームはレンダリングされません。このオプションは、Web 用以外のアプリケーションに適しています。

Debug Enabled

(オプション)デバッグレベルのログを有効にするかどうかを指定する boolean 値。デバッグレベルでは使用するサーバーリソースが多くなるため、LiveCycle サーバーのパフォーマンスが低下する場合があります。デフォルト値は「False」です。デバッグレベルのログにより、J2EE アプリケーションサーバーのログファイルにデバッグのための詳細情報が記録されます。

リテラル値を指定する場合、「Debug Enabled」チェックボックスの選択が解除されています。このチェックボックスを選択すると、デバッグレベルのログが有効になります。このチェックボックスの選択を解除すると、デフォルトレベルのログが使用されます。

PDF Specific Render Options プロパティ

PDF ファイルをレンダリングするための高度なオプションを指定するプロパティです。

Acrobat Version

(オプション)PDF ドキュメントを表示するために必要な Acrobat および Adobe Reader の最小限のバージョンを指定する AcrobatVersion-OutputService 値。指定したバージョンより後のバージョンでも PDF ドキュメントを開けます。また、このプロパティは PDF ドキュメントの生成に使用する PDF バージョンを指定します。

リテラル値を指定する場合は、次のいずれかの値を選択します。

<Use Form Template Default>:
(デフォルト)Acrobat や Adobe Reader の最小バージョンはフォームデザインの「Target Version」により決まります。さらに、フォームデザインによって PDF のバージョンが決まります。

Acrobat and Adobe Reader 6 or later:
PDF ドキュメントの生成には PDF バージョン 1.5 が使用されます。

Acrobat and Adobe Reader 7.0 or later:
PDF ドキュメントの生成には PDF バージョン 1.6 が使用されます。

Acrobat and Adobe Reader 7.0.5 or later:
PDF ドキュメントの生成には PDF バージョン 1.65 が使用されます。

Acrobat and Adobe Reader 8 or later:
PDF ドキュメントの生成には PDF バージョン 1.7 が使用されます。

Acrobat and Adobe Reader 8.1 or later:
PDF ドキュメントの生成には PDF バージョン 1.7-ADBE-1 が使用されます。

Acrobat and Adobe Reader 9 or later:
PDF ドキュメントの生成には PDF バージョン 1.7-ADBE-3 が使用されます。

Acrobat および Adobe Reader X:
PDF ドキュメントの生成には PDF バージョン 1.7-ADBE-3 が使用されます。

Accessible (Tagged) PDF

(オプション)タグ付き Adobe PDF フォームを作成するかどうかを指定する boolean 値。タグ付き PDF フォームにより、ページコンテンツを抽出し、他の目的のために再利用することがサポートされる標準構造タイプと属性のセットが定義されます。次のタイプの操作を実行するクライアントアプリケーションによる使用を前提としています。

  • 他のアプリケーションに貼り付けるためのテキストおよびグラフィックの単純な抽出

  • 元のレイアウトを想定するのではなく、ページを別のサイズに合わせるためのテキストおよび関連づけられたグラフィックの自動再フロー

  • 検索、インデックス作成、スペルチェックなどの目的のためのテキスト処理

  • ドキュメント構造と基本スタイル情報を保持したまま、他の一般的なファイル形式(HTML、XML、RTF など)に変換

  • コンテンツをスクリーンリーダーソフトウェアからアクセス可能にする

リテラル値を指定する場合、デフォルトでは「Create a PDF That Meets The Section 508 Accessibility Rules」チェックボックスの選択が解除されています。このチェックボックスを選択すると、タグ付き PDF フォームがレンダリングされます。PDF/A 1A はつねにタグ付けされ、PDF/A 1B はタグ付けされることがないため、PDF/A 出力についてはこの値は無効です。このチェックボックスの選択を解除すると、アクセス不能なフォームが作成されます。

Render At Client:

クライアント側のレンダリング機能を使用して PDF のコンテンツを配信できるようにするかどうかを指定する string 値。クライアント側のレンダリングは、Acrobat 7.0 または Adobe Reader 7.0 以降で可能です。設定できる string 値は auto、yes、no です。クライアント側のレンダリングを使用すると、Output サービスのパフォーマンスが向上します。

リテラル値を指定する場合、デフォルトでは「<Use Form Template Default>」が選択されています。次のいずれかの値を選択します。

<Use Form Template Default>:
Output サービスでは、フォームデザインの設定に基づいてフォームのレンダリング設定が決定されます。

Yes:
動的 PDF フォームが生成され、Acrobat でレンダリングが発生します。動的フォームのレンダリングは Acrobat 7.0 以降でのみ発生します。以前のバージョンの Acrobat では、レンダリングは実行されません。

No:
静的 PDF フォームが生成されます。クライアントではレンダリングが実行されません。

Retain Signature Field:

(オプション)生成された出力で署名フィールドをどのように保持するかを指定する RetainSignatureField 値。非インタラクティブに設定されている署名フィールドは、PDF ドキュメントでは画像になります。

リテラル値を指定する場合、次のいずれかの値を選択します。

None:
PDF ファイルをフラット化すると、署名済みのフィールドと未署名の署名フィールドが非インタラクティブになります。

All:
PDF ファイルをフラット化すると、署名済みのフィールドと未署名の署名フィールドはインタラクティブな状態のままになります。

Signed Signature Fields:
未署名の署名フィールドが非インタラクティブになります。PDF ファイルをフラット化すると、署名済みの署名フィールドのみがインタラクティブな状態のままとなります。

Unsigned Signature Field Only:
署名済みの署名フィールドが非インタラクティブになります。PDF ファイルをフラット化すると、未署名の署名フィールドはインタラクティブな状態のままとなります。

PDFA Specific Render Options プロパティ

PDF/A ドキュメントをレンダリングする際のオプションを指定するプロパティです。

PDF/A Revision Number

PDF/A リビジョン番号を指定する string 値。「Revision_1」のみを設定できます。

PDF/A Conformance

(オプション)使用する PDF/A-1 仕様の準拠レベルを指定する PDFAConformance 値。準拠レベルは、PDF ドキュメントがアーカイブおよび長期保存のための電子文書保存要件をどの程度満たしているかを示します。

リテラル値を指定する場合、次のいずれかの値を選択します。

A:
(デフォルト)準拠レベル A は、ISO-19005-1:2005 に完全に準拠していることを表します。PDF ファイルは PDF 1.4 により生成され、すべての色が CMYK または RGB に変換されます。これらの PDF ファイルは、Acrobat および Adobe Reader 5.0 以降で開くことができます。

B:
準拠レベル B は、ISO-19005-1:2005 への準拠が最小限であることを表します。生成される PDF ファイルにはすべてのフォントが埋め込まれ、所定の PDF バウンディングボックスが指定され、色は CMYK とスポットカラーのいずれか一方または両方に変換されます。準拠ファイルには、使用する印刷条件に関する情報を設定する必要があります。PDF/X-1a に準拠して作成された PDF ファイルは、Acrobat 4.0 および Adobe Reader 4.0 以降で開くことができます。

Output プロパティ

生成される出力を保存する場所を指定するプロパティです。

PDF Output

PDF 出力を保存する場所です。データタイプは document です。例えば、PDF ドキュメントの保存に使用する document 変数を選択します。

その他の Outputプロパティ

操作の結果を保存する場所を指定するプロパティです。

Meta Data Document

メタデータを保存する場所です。データタイプは document です。

Output Result

操作の結果を保存する場所です。データタイプは OutputResult です。

Exceptions

この操作では OutputException 例外がスローされる可能性があります。