Java API を使用して、PDF/A ドキュメントにドキュメントを変換する
Java API を使用して、PDF ドキュメントを PDF/A ドキュメントに変換します。
-
プロジェクトファイルを含める
adobe-docconverter-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
DocConvert クライアントの作成
- 接続プロパティを含む
ServiceClientFactory
オブジェクトを作成します。 - コンストラクターを使用し、
DocConverterServiceClient
オブジェクトを渡すことによって、ServiceClientFactory
オブジェクトを作成します。
- 接続プロパティを含む
-
PDF ドキュメントを参照して PDF/A ドキュメントに変換
- コンストラクターを使用して、変換ファイルの場所を指定する文字列値を渡すことによって、変換する PDF ドキュメントを表す
java.io.FileInputStream
オブジェクトを作成します。 - コンストラクターを使用し、
java.io.FileInputStream
オブジェクトを渡すことによって、com.adobe.idp.Document
オブジェクトを作成します。
- コンストラクターを使用して、変換ファイルの場所を指定する文字列値を渡すことによって、変換する PDF ドキュメントを表す
-
トラッキング情報を設定
- コンストラクターを使用して
PDFAConversionOptionSpec
オブジェクトを作成します。 PDFAConversionOptionSpec
オブジェクトのsetLogLevel
メソッドを呼び出し、トラッキングレベルを指定する文字列値を渡すことにより、情報のトラッキングレベルを設定します。例えば、値FINE
を渡します。様々な値について詳しくは、AEM Forms API リファレンスのsetLogLevel
メソッドを参照してください。
- コンストラクターを使用して
-
ドキュメントを変換
DocConverterServiceClient
オブジェクトのtoPDFA
メソッドを呼び出して次の値を渡すことによって、PDF ドキュメントを PDF/A ドキュメントに変換します。- 変換する PDF ドキュメントを含む
com.adobe.idp.Document
オブジェクト - トラッキング情報を指定する
PDFAConversionOptionSpec
オブジェクト
toPDFA
メソッドは、PDF/A ドキュメントを含むPDFAConversionResult
オブジェクトを返します。 - 変換する PDF ドキュメントを含む
-
PDF/A ドキュメントを保存
PDFAConversionResult
オブジェクトのgetPDFA
メソッドを呼び出して PDF/A ドキュメントを取得します。このメソッドは、PDF/A ドキュメントを表すcom.adobe.idp.Document
オブジェクトを返します。- PDF/A ファイルを表す
java.io.File
オブジェクトを作成します。ファイル名の拡張子が .pdf であることを確認します。 com.adobe.idp.Document
オブジェクトのcopyToFile
メソッドを呼び出してjava.io.File
オブジェクトを渡すことによって、PDF/A データをファイルに入力します。
Web サービス API を使用してドキュメントを PDF/A ドキュメントに変換
DocConverter API(web サービス)を使用して、PDF ドキュメントを PDF/A ドキュメントに変換します。
-
プロジェクトファイルを含める
- DocConverter WSDL を使用する Microsoft .NET クライアントアセンブリを作成します。
- Microsoft .NET クライアントアセンブリを参照します。
-
DocConvert クライアントの作成
- Microsoft .NET クライアントアセンブリを使用して、デフォルトのコンストラクターを呼び出すことによって
DocConverterServiceService
オブジェクトを作成します。 DocConverterServiceService
オブジェクトのCredentials
データメンバーを、ユーザー名とパスワードの値を指定するSystem.Net.NetworkCredential
値で設定します。
- Microsoft .NET クライアントアセンブリを使用して、デフォルトのコンストラクターを呼び出すことによって
-
PDF ドキュメントを参照して PDF/A ドキュメントに変換
- コンストラクターを使用して
BLOB
オブジェクトを作成します。BLOB
オブジェクトは、PDF/A ドキュメントに変換される PDF ドキュメントを格納するために使用されます。 - コンストラクターを呼び出し、暗号化する PDF ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡して、
System.IO.FileStream
オブジェクトを作成します。 System.IO.FileStream
オブジェクトの内容を格納するバイト配列を作成します。System.IO.FileStream
オブジェクトのLength
プロパティを取得することで、バイト配列のサイズを決定できます。- バイト配列にストリームデータを入力するには、
System.IO.FileStream
オブジェクトのRead
メソッドを呼び出し、バイト配列、開始位置、読み取るストリーム長を渡します。 binaryData
プロパティにバイト配列のコンテンツを割り当てることによってBLOB
オブジェクトを設定します。
- コンストラクターを使用して
-
トラッキング情報を設定
- コンストラクターを使用して
PDFAConversionOptionSpec
オブジェクトを作成します。 - トラッキングレベルを指定する値を
PDFAConversionOptionSpec
オブジェクトのlogLevel
データメンバーに割り当てることによって、情報トラッキングレベルを設定します。例えば、FINE
の値をこのデータメンバーに割り当てます。
- コンストラクターを使用して
-
ドキュメントを変換
DocConverterServiceService
オブジェクトのtoPDFA
メソッドを呼び出して次の値を渡すことによって、PDF ドキュメントを PDF/A ドキュメントに変換します。- 変換する PDF ドキュメントを含む
BLOB
オブジェクト - トラッキング情報を指定する
PDFAConversionOptionSpec
オブジェクト
toPDFA
メソッドは、PDF/A ドキュメントを含むPDFAConversionResult
オブジェクトを返します。 - 変換する PDF ドキュメントを含む
-
PDF/A ドキュメントを保存
- PDF/A ドキュメントを格納する
BLOB
オブジェクトを作成するには、PDFAConversionResult
オブジェクトのPDFADocument
データメンバーの値を取得します。 PDFAConversionResult
オブジェクトを使用して、返されたBLOB
オブジェクトの内容を格納するバイト配列を作成します。BLOB
オブジェクトのbinaryData
データメンバーの値を取得して、バイト配列に入力します。System.IO.FileStream
オブジェクトを作成するには、そのコンストラクターを呼び出し、PDF/A ドキュメントのファイルの場所を表す文字列の値を渡します。- コンストラクターを使用して
System.IO.FileStream
オブジェクトを渡すことにより、System.IO.BinaryWriter
オブジェクトを作成します。 System.IO.BinaryWriter
オブジェクトのWrite
メソッドを呼び出して、バイト配列を渡すことによって、バイト配列の内容を PDF ファイルに書き込みます。
- PDF/A ドキュメントを格納する
プログラムによる PDF/A 準拠の判別
DocConverter サービスを使用すると、PDF ドキュメントが PDF/A に準拠しているかどうかを検証できます。PDF/A ドキュメントの詳細と、PDF ドキュメントを PDF/A ドキュメントに変換する方法について詳しくは、ドキュメントを PDF/A ドキュメントに変換を参照してください。
手順の概要
PDF/A 準拠を判断するには、次の手順に従います。
- プロジェクトファイルを含めます。
- DocConvert クライアントの作成
- PDF/A の準拠を判断するために使用される PDF ドキュメントを参照してください。
- 実行時オプションを設定します。
- PDF ドキュメントに関する情報を取得します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、必ずプロキシファイルを含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-docconverter-client.jar
- adobe-utilities.jar(AEM Forms が JBoss Application Server にデプロイされている場合に必要)
- jbossall-client.jar(AEM Forms が JBoss Application Server にデプロイされている場合に必要)
これらの JAR ファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。
DocConvert クライアントの作成
DocConverter の操作をプログラム的に実行する前に、DocConverter クライアントを作成する必要があります。Java API を使用する場合は、DocConverterServiceClient
オブジェクトを作成します。DocConverter web サービス API を使用する場合は、DocConverterServiceService
オブジェクトを作成してください。
PDF/A 準拠の判断に使用する PDFドキュメントを参照
PDF ドキュメントが PDF/ A に準拠しているかどうかを判断するには、PDF ドキュメントを参照し、DocConverter サービスに渡す必要があります。
実行時オプションの設定
変換処理中に追跡する情報の量を指定する実行時オプションを設定できます。つまり、PDF ドキュメントを PDF/A ドキュメントに変換する際に DocConverter サービスが追跡する情報の量を 9 つの異なるレベルで設定できます。
PDF ドキュメントに関する情報を取得
DocConverter サービスクライアントを作成し、PDFドキュメントを参照し、実行時オプションを設定した後、PDFドキュメントが PDF/A 準拠のドキュメントであるかどうかを判断できます。
関連トピック
Java API を使用して PDF/A の準拠を判断
Java API を使用して PDF/A の準拠を判断します。
-
プロジェクトファイルを含める
adobe-docconverter-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
DocConvert クライアントの作成
- 接続プロパティが格納された
ServiceClientFactory
オブジェクトを作成します。 - コンストラクターを使用して
ServiceClientFactory
オブジェクトを渡し、DocConverterServiceClient
オブジェクトを作成します。
- 接続プロパティが格納された
-
PDF/A 準拠の判断に使用する PDF ドキュメントを参照
- コンストラクターを使用して、PDF ファイルの場所を指定する文字列値を渡すことにより、変換するインタラクティブ PDF ドキュメントを表す
java.io.FileInputStream
オブジェクトを作成します。 - コンストラクターを使用して
java.io.FileInputStream
オブジェクトを渡すことにより、com.adobe.idp.Document
オブジェクトを作成します。
- コンストラクターを使用して、PDF ファイルの場所を指定する文字列値を渡すことにより、変換するインタラクティブ PDF ドキュメントを表す
-
実行時オプションを設定
- コンストラクターを使用して
PDFAValidationOptionSpec
オブジェクトを作成します。 PDFAValidationOptionSpec
オブジェクトのsetCompliance
メソッドを呼び出し、PDFAValidationOptionSpec.Compliance.PDFA_1B
を渡して、準拠レベルを設定します。PDFAValidationOptionSpec
オブジェクトのsetLogLevel
メソッドを呼び出し、トラッキングレベルを指定する文字列値を渡して、情報トラッキングレベルを指定します。例えば、値FINE
を渡します。様々な値について詳しくは、 AEM Forms API リファレンスのsetLogLevel
メソッドを参照してください。
- コンストラクターを使用して
-
PDF ドキュメントに関する情報を取得
DocConverterServiceClient
オブジェクトのisPDFA
メソッドを呼び出し、次の値を渡して、PDF/A 準拠を判断します。- PDF ドキュメントが含まれる
com.adobe.idp.Document
オブジェクト。 - 実行時オプションを指定する
PDFAValidationOptionSpec
オブジェクト。
この
isPDFA
メソッドは、この操作の結果を格納するPDFAValidationResult
オブジェクトを返します。 - PDF ドキュメントが含まれる