「generatePDFOutput」操作(非推奨)

注意: この操作は LiveCycle ES2 では推奨されません。代わりに、「generatePDFOutput」操作を使用します。プロセスをアップグレードする場合、「generatePDFOutput」操作を使用するように変更することをお勧めします。generatePDFOutput(非推奨)操作は、ドキュメントオブジェクトを使用してフォームデザインやフォームデータを参照できない場合のみ使用するようにしてください(非推奨操作についてを参照)。

フォームデザインとデータをマージして PDF または PDF/A ドキュメントを生成します。オプションで、レコードごとのメタデータファイルを生成したり、出力を PDF ファイルに保存したりできます。この操作を使用すると、ネットワーク、ローカルファイルシステム、または HTTP 上の場所に保存されているフォームデザインやデータをリテラル値として使用できます。フォームデザインと XML データがアプリケーションに保存されている場合は、「generatePDFOutput」操作を使用します。

例えば、データファイルに保存されているレコードに対してアプリケーションで PDF ドキュメントを作成する必要があるとします。フォームデザインは HTTP 上の場所にあり、データはローカルファイルシステムに保存されています。「generatePDFOutput」(非推奨)操作を使用して、マージしたデータとフォームデザインから PDF ドキュメントを作成します。

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

Input プロパティ

フォームデザイン、データ、PDF オプションを指定するプロパティです。

Transformation Format

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

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

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

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

Form

フォームデザイン名を指定する string 値。この値は、この操作の Content Root プロパティとともにフォームデザインの絶対パスを構成します。

リテラル値を指定する場合、 Form プロパティの下のボックスにフォーム名を入力する必要があります。

例えば、リポジトリ内の form designs という名前のフォルダーには form.xdp という名前のフォームデザインが含まれます。このフォームデザインにアクセスするには、Form プロパティに "/form.xdp" と入力し、Content Root プロパティに "repository:///formdesigns" と入力します。作成される絶対パスは repository:///formdesigns/form.xdp で、フォームデザインにアクセスするために必要です。

Content Root

フォームデザインと XDC ファイルを取得するための URI、絶対参照、またはリポジトリ内の場所を指定する string 値。この値は、この操作の Form プロパティとともにフォームデザインの絶対パスを構成します。デフォルト値はありません。

アプリケーションからアセットを選択するとき、コンテンツルート 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 番目のスラッシュはリポジトリのルートを表します。

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] はフォルダーの名前です。

例えば、formdesigns という名前のリポジトリのフォルダーに、form.xdp という名前のフォームデザインがあるとします。このフォームデザインにアクセスするには、Form プロパティに "/form.xdp" と入力し、Content Root プロパティに "repository:///formdesigns" と入力します。作成される絶対パスは "repository:///formdesigns/form.xdp" で、フォームデザインにアクセスするために必要です。

PDF Output Options

(オプション)PDF ドキュメントの生成に使用するプロパティ値を表す PDFOutputOptionsSpec

リテラル値を指定する場合、次のプロパティを設定します。

General
  • XCI URI:使用する XCI ファイルを設定します。XCI ファイルはフォームデザインの要素に使用するフォントの説明に使用します。XCI ファイルは、部数、両面印刷の使用、用紙とじオプションなどのプリントオプションの指定にも便利です。

  • Character Set:レンダリングされたフォームのエンコードに使用する文字セットを設定します。使用する文字セットを選択するか、または次のいずれかの値を選択します。

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

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

  • Locale:PDF ドキュメントの生成に使用する言語を設定します。リストから言語をするか、または次のいずれかの値を選択します。

    <Use Server Default>:(デフォルト)フォームデザインで設定された「Locale」設定を使用します。フォームデザインでロケール設定が指定されていない場合、LiveCycle サーバーがインストールされているオペレーティングシステムのロケール設定が使用されます。

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

Batch
  • Record Name:レコードのバッチの先頭を示すエレメントの名前を設定します。

  • Record Level:レコードデータを含む XML 要素のレベルを設定します。デフォルトは 1 です。これはデータを含むレコードの最初のレベルを表します。最初のレベルは、Record Name プロパティで指定された要素の下です。

  • Generate Multiple Streams:この操作により 1 件の出力を作成するか複数の出力を作成するかを設定します。次のいずれかの値を選択します。

  • True:複数の出力を作成します。1 件のレコードの処理が終わるたびに出力を送信する場合は、複数の出力を作成すると便利です。

  • False:(デフォルト)1 件の出力を作成します。処理されたすべてのレコードを一括送信する場合は、1 件の出力を作成すると便利です。

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

    True:複数レコードデータセットが 1 データレコードずつ読み込まれ、マージされます。

    False:データファイル全体が読み込まれるため、すべてのデータの読み込みとマージが一括で実行されます。

Rules
  • Pattern Match Size:パターン文字列のスキャンのため使用する入力ファイルの先頭からのバイト数を設定します。デフォルトは 500 です。検索ルールの使用について詳しくは、Designer ヘルプを参照してください。

  • Pattern Matching Rules:入力データファイルでパターンを検索するためのルールを設定し、データを特定のフォームデザインと関連付けます。次のいずれかのボタンをクリックすると、リストのエントリを追加または削除できます。

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

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

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

Destination
出力をプリンターに送信する場合は、sendToPrinter 操作 操作を使用します。sendToPrinter 操作 操作を使用すると、出力の印刷をより柔軟に行うことができます。
  • Output Location URI:出力ファイルの保存先のパスとファイルの URI を設定します。複数のファイルを作成する場合、ファイル名の末尾には数値が付加されます。例えば、C:\forms\Loan.pdf を指定すると、Output サービスにより Loan0001.pdf、Loan0002、Loan0003 などのファイル名が LiveCycle サーバーの C:\forms フォルダーに作成されます。

  • Printer Name:印刷のための出力の送信先となるプリンターの名前を設定します。指定したプリンターに LiveCycle サーバーが接続されている必要があります。この値は ¥¥[print server]¥[printer name] という形式にする必要があります。値 [print server] はプリンターサーバー名、[printer name] はプリンター名です。

  • 「LPD URI」:Line Printer Daemon(LPD)がネットワーク上で実行されている場合に使用する LPD の URI を設定します。LPD の値は lpd://[host name] のように指定できます([host name] は LPD ホストの名前)。

  • 「LPD Printer Name」:LPD がネットワーク上で実行されている場合に、指定した LPD の URI にあるプリンターの名前を設定します。この値は [printer name][print name] はプリンター名)という形式にする必要があります。

MetaData
Meta Data Spec File:
使用するメタデータ仕様ファイルの URI を設定します。メタデータ仕様ファイルは、指定したデータファイルからメタデータを生成するために使用します。デフォルト値はありません。

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

<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>

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

<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 式で使用するルートレベルノードを設定します。ルートレベルノードは 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:
レコードごとにメタデータファイルを生成するかどうかを設定します。次のいずれかの値を選択します。
  • True:各レコードごとにメタデータファイルを生成します。

  • False:(デフォルト)処理されたすべてのレコードを対象に 1 つのメタデータファイルが生成されます。

Render Options

(オプション)出力のレンダリング方式を指定する RenderOptionsSpec-OutputService 値。リテラル値を指定した場合に表示されるレンダリングオプションは、Transformation Format プロパティで選択した値によって異なります。

Transformation Format プロパティの値として「PDF」が選択されている場合、次のレンダリングオプションを使用できます。

Acrobat Version:
PDF ドキュメントの表示に必要な Acrobat と Adobe Reader の最小バージョンを設定します。指定したバージョンより後のバージョンでも PDF ドキュメントを開けます。また、このプロパティは PDF ドキュメントの生成に使用する 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 が使用されます。

  • Auto:(デフォルト)フォームデザインの「Target Version」設定によって、Acrobat または Adobe Reader の最小限のバージョンが決まります。さらに、フォームデザインによって PDF のバージョンが決まります。

Tagged PDF:
タグ付き Adobe PDF フォームを作成するかどうかを設定します。タグ付き PDF フォームにより、ページコンテンツを抽出し、他の目的のために再利用することがサポートされる標準構造タイプと属性のセットが定義されます。次のタイプの操作を実行するクライアントアプリケーションによる使用を前提としています。
  • 他のアプリケーションに貼り付けるためのテキストおよびグラフィックの単純な抽出

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

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

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

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

次のいずれかの値を選択します。

  • False:(デフォルト)タグ付き PDF フォームをレンダリングしません。

  • True:タグ付き PDF フォームをレンダリングします。PDF/A 1A はつねにタグ付けされ、PDF/A 1B はタグ付けされることがないため、PDF/A 出力についてはこの値は無効です。

Linearized PDF:
線形化された PDF ドキュメントをレンダリングするかどうかを設定します。線形化された PDF ドキュメントは、ネットワーク環境にある PDF ドキュメントへのインクリメンタルアクセスが可能になるように構成されます。例えば、線形化された PDF は、PDF ドキュメント全体がダウンロードされる前に Web ブラウザーに表示されます。次のいずれかの値を選択します。
  • False:(デフォルト)線形化された PDF フォームをレンダリングしません。このオプションは、ネットワーク用以外のアプリケーションに適しています。

  • True:線形化された PDF フォームをレンダリングします。このオプションは Web ブラウザーなどのネットワークアプリケーションに適しています。

Render At Client:
Acrobat 7.0 以降または Adobe Reader 7.0 以降のクライアント側レンダリング機能を使用した PDF コンテンツの配信を有効にするかどうかを設定します。クライアント側のレンダリングにより、Output サービスのパフォーマンスが向上します。次のいずれかの値を選択します。
  • Auto:(デフォルト)Output サービスでは、フォームデザインの設定に基づいてフォームのレンダリング設定が決定されます。

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

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

Retain Signature Field:
生成された出力で署名フィールドをどのように保持するかを設定します。署名フィールドは、PDF ドキュメントでは非インタラクティブ画像になります。次のいずれかの値を選択します。
  • None:PDF ファイルをフラット化すると、署名済みのフィールドと未署名の署名フィールドが非インタラクティブになります。

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

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

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

Debug Enabled:
デバッグレベルのログを有効にするかどうかを設定します。デバッグレベルのログにより、J2EE アプリケーションサーバーのログファイルにデバッグのための詳細情報が記録されます。デバッグレベルでは使用するサーバーリソースが多くなるため、LiveCycle サーバーのパフォーマンスが低下する場合があります。次のいずれかの値を選択します。
  • True:デバッグレベルのログが実行されます。

  • False:(デフォルト)デフォルトレベルのログが実行されます。

PDF/A Revision Number:
PDF/A リビジョン番号のバージョンを設定します。デフォルト値は Revision_1 です。

PDF/A Conformance:
電子ドキュメントのアーカイブおよび長期保存のために使用する PDF/A 仕様の準拠レベルを設定します。次のいずれかの値を選択します。
  • 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 以降で開くことができます。

Input Data

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

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

Output プロパティ

プロセスデータモデル内で操作の結果を保存する場所を指定するプロパティです。

PDF Output

生成された PDF ドキュメントを保存するプロセスデータモデル内の場所です。データタイプは document です。例えば、PDF ドキュメントの保存に使用する document 変数を選択します。

Meta Data Document

生成されたメタデータ仕様ファイルを保存するプロセスデータモデル内の場所です。データタイプは document です。

Status Document

プロセスデータモデル内で操作の結果を保存する場所です。データタイプは document です。

Output Result

操作の結果を保存する、プロセスデータモデル内の位置。データタイプは OutputResult です。

Exceptions

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