PostscriptドキュメントからPDFへの変換

Distiller事務について

Distiller®サービスは、PostScript®、Encapsulated PostScript(EPS)およびPRNファイルを、ネットワーク経由でコンパクトで信頼性の高い、より安全なPDFファイルに変換します。 Distiller サービスは、請求書や明細書など、容量の大きい印刷ドキュメントを電子ドキュメントに変換する際によく使用されます。ドキュメントを PDF に変換して、顧客にドキュメントの印刷バージョンと電子バージョンを送付できます。

メモ

For more information about the Distiller service, see Services Reference for AEM Forms.

PostScriptからPDFドキュメントへの変換

このトピックでは、DistillerサービスAPI(JavaおよびWebサービス)を使用して、PostScript(PS)、Encapsulated PostScript(EPS)およびPRNファイルをプログラムでPDFドキュメントに変換する方法について説明します。

メモ

For more information about the Distiller service, see Services Reference for AEM Forms.

メモ

PostScriptファイルをPDFドキュメントに変換するには、AEM Formsをホストするサーバーに次のいずれかをインストールする必要があります。Acrobat 9またはMicrosoft Visual C++ 2005再配布可能パッケージ。

手順の概要

サポートされている任意の種類をPDFドキュメントに変換するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. Distillerサービスクライアントを作成します。
  3. 変換するファイルを取得します。
  4. PDF作成操作を呼び出します。
  5. PDFドキュメントを保存します。

プロジェクトファイルを含める

必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めてください。

Distillerサービスクライアントの作成

プログラムでDistillerサービスを実行する前に、Distillerサービスクライアントを作成する必要があります。 Java APIを使用している場合は、 DistillerServiceClient オブジェクトを作成します。 WebサービスAPIを使用している場合は、 DistillerServiceService オブジェクトを作成します。

変換するファイルを取得します

変換するファイルを取得する必要があります。 例えば、PSファイルをPDFドキュメントに変換するには、PSファイルを取得する必要があります。

PDF作成操作の呼び出し

サービスクライアントを作成したら、PDF作成操作を呼び出すことができます。 この操作には、ターゲットドキュメントへのパスなど、変換するドキュメントに関する情報が必要です。

PDFドキュメントの保存

PDFドキュメントをPDFファイルとして保存できます。

関連トピック

Java APIを使用したPostScriptファイルのPDFへの変換

WebサービスAPIを使用したPostScriptファイルのPDFへの変換

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

OutputサービスAPIのクイック開始

Java APIを使用したPostScriptファイルのPDFへの変換

DistillerサービスAPI(Java)を使用してPostScriptファイルをPDFドキュメントに変換します。

  1. プロジェクトファイルを含めます。

    Javaプロジェクトのクラスパスに、adobe-distiller-client.jarなどのクライアントJARファイルを含めます。

  2. Distillerサービスクライアントを作成します。

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • Create an DistillerServiceClient object by using its constructor and passing the ServiceClientFactory object.
  3. 変換するファイルを取得します。

    • コンストラクターを使用し、ファイルの場所を指定する文字列値を渡して、変換するファイルを表す java.io.FileInputStream オブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
  4. PDF作成操作を呼び出します。

    オブジェクトの DistillerServiceClient createPDF メソッドを呼び出し、次の値を渡します。

    • 変換するPS、EPS、またはPRNファイルを表す com.adobe.idp.Document オブジェクトです。
    • 変換するファイルの名前を含む java.lang.String オブジェクトです。
    • 使用するAdobe PDF設定の名前を含む java.lang.String オブジェクトです
    • 使用するセキュリティ設定の名前を含む java.lang.String オブジェクトです
    • PDFドキュメントの生成時に適用される設定を含むオプションの com.adobe.idp.Document オブジェクトです
    • PDFドキュメントに適用されるメタデータ情報を含むオプションの com.adobe.idp.Document オブジェクトです

    この createPDF メソッドは、新しいPDFドキュメントと、生成される可能性のあるログファイルを含む CreatePDFResult オブジェクトを返します。 通常、ログファイルには、変換要求によって生成されるエラーメッセージや警告メッセージが含まれます。

  5. PDFドキュメントを保存します。

    新しく作成されたPDFドキュメントを取得するには、次の操作を実行します。

    • オブジェクトの CreatePDFResult メソッドを呼び出し getCreatedDocument ます。 これは、 com.adobe.idp.Document オブジェクトを返します。
    • オブジェクトの com.adobe.idp.Document copyToFile メソッドを呼び出してPDFドキュメントを抽出します。

    同様に、ログドキュメントを取得するには、次の操作を実行します。

    • オブジェクトの CreatePDFResult メソッドを呼び出し getLogDocument ます。 これは、 com.adobe.idp.Document オブジェクトを返します。
    • オブジェクトの com.adobe.idp.Document copyToFile メソッドを呼び出してログドキュメントを抽出します。

関連トピック

手順の概要

クイック開始(SOAPモード):Java APIを使用したPostScriptファイルのPDFドキュメントへの変換

AEM Forms Java ライブラリファイルを含める

接続プロパティの設定

WebサービスAPIを使用したPostScriptファイルのPDFへの変換

DistillerサービスAPI(Webサービス)を使用してPostScriptファイルをPDFドキュメントに変換します。

  1. プロジェクトファイルを含めます。

    MTOMを使用するMicrosoft .NETプロジェクトを作成します。 次のWSDL定義を使用していることを確認します。 http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1.

    メモ

    AEM Forms localhost をホストするサーバーのIPアドレスに置き換えます。

  2. Distillerサービスクライアントを作成します。

    • Create a DistillerServiceClient object by using its default constructor.

    • Create a DistillerServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. WSDLをAEM Formsサービス(例えば、 http://localhost:8080/soap/services/DistillerService?blob=mtom)に指定するstring値を渡します。 属性を使用する必要はありません lc_version 。 この属性は、サービス参照を作成する際に使用されます。 ただし、MTOMを使用す ?blob=mtom るように指定します。

    • フィールドの値を取得して System.ServiceModel.BasicHttpBinding オブジェクトを作成し DistillerServiceClient.Endpoint.Binding ます。 戻り値を BasicHttpBinding にキャストします。

    • オブジェクトの System.ServiceModel.BasicHttpBinding フィールドをに設定し MessageEncodingWSMessageEncoding.Mtomす。 この値により、MTOMが使用されます。

    • 次のタスクを実行して、基本的なHTTP認証を有効にします。

      • フィールドにAEM formsユーザー名を割り当て DistillerServiceClient.ClientCredentials.UserName.UserNameます。
      • 対応するパスワード値をフィールドに割り当て DistillerServiceClient.ClientCredentials.UserName.Passwordます。
      • 定数値をフィールド HttpClientCredentialType.Basic に割り当て BasicHttpBindingSecurity.Transport.ClientCredentialTypeます。
      • 定数値をフィールド BasicHttpSecurityMode.TransportCredentialOnly に割り当て BasicHttpBindingSecurity.Security.Modeます。
  3. 変換するファイルを取得します。

    • コンストラクタを使用して BLOB オブジェクトを作成します。この BLOB オブジェクトは、PDFドキュメントに変換するファイルの保存に使用されます。
    • コンストラクターを呼び出し、ファイルを開く場所とモードを表すstring値を渡して、 System.IO.FileStream オブジェクトを作成します。
    • オブジェクトの内容を格納するバイト配列を作成し System.IO.FileStream ます。 バイト配列のサイズは、 System.IO.FileStream オブジェクトのプロパティを取得して決定でき Length ます。
    • オブジェクトの System.IO.FileStream Read メソッドを呼び出し、読み取るバイト配列、開始位置およびストリーム長を渡すことで、バイト配列にストリームデータを入力します。
    • オブジェクトのプロパティにバイト配列の内容を割り当てて、 BLOB MTOM オブジェクトを入力します。
  4. PDF作成操作を呼び出します。

    オブジェクトの DistillerServiceService CreatePDF2 メソッドを呼び出し、次の必須値を渡します。

    • 変換するPSファイルを表す BLOB オブジェクトです。
    • 変換するファイルのパス名を含む文字列です
    • 使用するAdobe PDF設定を含むstringオブジェクト(例: Standard)
    • 使用するセキュリティ設定が格納されているstringオブジェクト( No Securityなど)
    • PDFドキュメントの生成時に適用される設定を含むオプションの BLOB オブジェクトです
    • PDFドキュメントに適用されるメタデータ情報を含むオプションの BLOB オブジェクトです
    • PDFドキュメントの保存に使用される BLOB 出力パラメーター
    • ログの保存に使用される BLOB 出力パラメーター
  5. PDFドキュメントを保存します。

    • Create a System.IO.FileStream object by invoking its constructor. 署名済みPDFドキュメントーのファイルの場所とファイルを開くモードを表すstring値を渡します。
    • メソッド(出力パラメーター)によって返された BLOB オブジェクトの内容を格納するバイト配列を作成し CreatePDF2 ます。 オブジェクトのデータメンバーの値を取得して、 BLOB バイト配列を入力し MTOM ます。
    • Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
    • オブジェクトのメソッドを呼び出し、バイト配列を渡して、バイト配列の内容をPDFファイルに書き込み System.IO.BinaryWriterWrite す。

関連トピック

手順の概要

MTOMを使用したAEM Formsの呼び出し

SwaRefを使用したAEM Formsの呼び出し

このページ