Postscript から PDF ドキュメントへの変換 converting-postscript-to-pdf-documents
このドキュメントのサンプルと例は、JEE 環境の AEM Forms のみを対象としています。
Distiller サービスについて about-the-distiller-service
Distiller® サービスは、PostScript®、Encapsulated PostScript(EPS)および PRN ファイルを、ネットワーク上でコンパクトで信頼の高い、より安全な PDF ファイルに変換します。Distiller サービスは、請求書や明細書など、容量の大きい印刷ドキュメントを電子ドキュメントに変換する際によく使用されます。ドキュメントを PDF に変換して、顧客にドキュメントの印刷バージョンと電子バージョンを送付できます。
PostScript を PDF ドキュメントに変換する converting-postscript-to-pdf-documents-inner
このトピックでは、Distiller Service API(Java および web サービス)を使用して、PostScript(PS)、Encapsulated PostScript(EPS)および PRN ファイルをプログラムで PDF ドキュメントに変換する方法について説明します。
手順の概要 summary-of-steps
サポートされているタイプのいずれかを PDF ドキュメントに変換するには、次の手順を実行します。
- プロジェクトファイルを含めます。
- Distiller サービスクライアントを作成します。
- 変換するファイルを取得します。
- PDF 作成の操作を呼び出します。
- 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 に変換する
Java API を使用して PostScript ファイルを PDF に変換する convert-a-postscript-file-to-pdf-using-the-java-api
Distiller Service API(Java)を使用して、PostScript ファイルを PDF ドキュメントに変換します。
-
プロジェクトファイルを含めます。
adobe-distiller-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
Distiller サービスクライアントを作成します。
- 接続プロパティを含む
ServiceClientFactoryオブジェクトを作成します。 - コンストラクターを使用し
ServiceClientFactoryオブジェクトを渡すことによって、DistillerServiceClientオブジェクトを作成します。
- 接続プロパティを含む
-
変換するファイルを取得します。
- コンストラクターを使用してファイルの場所を指定する文字列値を渡すことで、変換するファイルを表す
java.io.FileInputStreamオブジェクトを作成します - コンストラクタを使用して
com.adobe.idp.Documentオブジェクトを渡すことによって、java.io.FileInputStreamオブジェクトを作成します。
- コンストラクターを使用してファイルの場所を指定する文字列値を渡すことで、変換するファイルを表す
-
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オブジェクトを返します。通常、ログファイルには、変換リクエストによって生成されるエラーメッセージや警告メッセージが含まれます。 - 変換する PS、EPS、または PRN ファイルを表す
-
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 ドキュメントに変換
Web サービス API を使用して PostScript ファイルを PDF に変換する converting-a-postscript-file-to-pdf-using-the-web-service-api
Distiller Service API(Web サービス)を使用して、PostScript ファイルを PDF ドキュメントに変換します。
-
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義
http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1を使用するようにします。note note NOTE localhostを AEM Forms をホストするサーバーの IP アドレスに置き換えます。 -
Distiller サービスクライアントを作成します。
-
デフォルトのコンストラクターを使用して
DistillerServiceClientオブジェクトを作成します。 -
System.ServiceModel.EndpointAddressコンストラクターを使用してDistillerServiceClient.Endpoint.Addressオブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します(例えば、http://localhost:8080/soap/services/DistillerService?blob=mtom) 。lc_version属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。ただし、?blob=mtomを指定して MTOM を使用します。 -
DistillerServiceClient.Endpoint.Bindingフィールドの値を取得して、System.ServiceModel.BasicHttpBindingオブジェクトを作成します。戻り値をBasicHttpBindingにキャストします。 -
System.ServiceModel.BasicHttpBindingオブジェクトのMessageEncodingフィールドをWSMessageEncoding.Mtomに設定します。この値により、MTOM が確実に使用されます。 -
次のタスクを実行して、HTTP 基本認証を有効にします。
DistillerServiceClient.ClientCredentials.UserName.UserNameフィールドに AEM Forms ユーザー名を割り当てます。- 対応するパスワード値を
DistillerServiceClient.ClientCredentials.UserName.Passwordフィールドに割り当てます。 - 定数値
HttpClientCredentialType.BasicをBasicHttpBindingSecurity.Transport.ClientCredentialTypeフィールドに割り当てます。 - 定数値
BasicHttpSecurityMode.TransportCredentialOnlyをフィールドBasicHttpBindingSecurity.Security.Modeに割り当てます。
-
-
変換するファイルを取得します。
- コンストラクタを使用して
BLOBオブジェクトを作成します。BLOBオブジェクトを使用して、PDF ドキュメントに変換するファイルを保存します。 - コンストラクターを呼び出し、ファイルの場所とファイルを開くモードを表す文字列値を渡して、
System.IO.FileStreamオブジェクトを作成します。 System.IO.FileStreamオブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStreamオブジェクトのLengthプロパティを取得することで、バイト配列のサイズを決定できます。- バイト配列にストリームデータを入力するには、
System.IO.FileStreamオブジェクトのReadメソッドを呼び出し、バイト配列、開始位置、読み取るストリーム長を渡します。 MTOMプロパティにバイト配列の内容を割り当てて、BLOBオブジェクトに入力します。
- コンストラクタを使用して
-
PDF 作成の操作を呼び出します。
DistillerServiceServiceオブジェクトのCreatePDF2メソッドを呼び出して、次の必須値を渡します。- 変換する PS ファイルを表す
BLOBオブジェクト - 変換するファイルのパス名を含む文字列
- 使用する Adobe PDF 設定を含む文字列オブジェクト(例えば
Standard) - 使用するセキュリティ設定を含む文字列オブジェクト(例えば
No Security) - PDF ドキュメントの生成時に適用される設定を含む オプションの
BLOBオブジェクト - PDF ドキュメントに適用するメタデータ情報を含むオプションの
BLOBオブジェクト - PDF ドキュメントの保存に使用する
BLOB出力パラメータ - ログの保存に使用する
BLOB出力パラメーター
- 変換する PS ファイルを表す
-
PDF ドキュメントを保存します。
- コンストラクターを呼び出して
System.IO.FileStreamオブジェクトを作成します。署名済み PDF ドキュメントのファイルの場所と、ファイルを開くモードを表す文字列値を渡します。 CreatePDF2メソッド(出力パラメーター)によって返されたBLOBオブジェクトのコンテンツを格納するバイト配列を作成します。BLOBオブジェクトのMTOMデータメンバーの値を取得して、バイト配列に入力します。- コンストラクターを使用して
System.IO.BinaryWriterオブジェクトを渡すことによって、System.IO.FileStreamオブジェクトを作成します。 System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出して、バイト配列を渡すことによって、バイト配列の内容を PDF ファイルに書き込みます。
- コンストラクターを呼び出して
関連トピック: