DocConverterサービスについて
DocConverterサービスは、PDFドキュメントをPDA/Aドキュメントに変換できます。 このサービスを使用して、次のタスクを実行できます。
DocConverterサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。
DocConverterサービスを使用すると、PDFドキュメントをPDF/Aドキュメントに変換できます。 PDF/Aはドキュメントのコンテンツを長期間保存するためのアーカイブ形式なので、すべてのフォントが埋め込まれ、ファイルは圧縮されません。 その結果、通常、PDF/A ドキュメントは標準の PDF ドキュメントよりも大きくなります。また、PDF/A ドキュメントには、オーディオおよびビデオコンテンツは含まれません。PDFドキュメントをPDF/Aドキュメントに変換する前に、PDFドキュメントがPDF/Aドキュメントでないことを確認してください。
PDF/A-1仕様は、AとBの2つの準拠レベルで構成されています。主な違いは、論理構造(アクセシビリティ)のサポートですが、準拠レベルBには必要ありません。準拠レベルにかかわらず、PDF/A-1では、生成されたPDF/Aドキュメントにすべてのフォントが埋め込まれます。 現時点では、検証(および変換)ではPDF/A-1bのみがサポートされています。
PDF/AはPDFドキュメントのアーカイブの標準ですが、標準のPDFドキュメントが会社の要件を満たしている場合、PDF/Aをアーカイブに使用する必要はありません。 PDF/A標準の目的は、長期にわたるアーカイブやドキュメントの保存のニーズに対応したPDFファイルを作成することです。
DocConverterサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。
PDFドキュメントをPDF/Aドキュメントに変換するには、次の手順を実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。
次のJARファイルをプロジェクトのクラスパスに追加する必要があります。
これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。
DocConvertクライアントの作成
プログラムによってDocConverter操作を実行する前に、DocConverterクライアントを作成する必要があります。 Java APIを使用している場合は、DocConverterServiceClient
オブジェクトを作成します。 DocConverter WebサービスAPIを使用している場合は、DocConverterServiceService
オブジェクトを作成します。
PDFドキュメントを参照してPDF/Aドキュメントに変換
PDF/Aドキュメントに変換するPDFドキュメントを取得します。 AcrobatフォームなどのPDFドキュメントをPDF/Aドキュメントに変換しようとすると、例外が発生します。
トラッキング情報の設定
変換プロセス中に追跡する情報の量を決定する実行時オプションを設定できます。 つまり、9つの異なるレベルを設定して、PDFドキュメントをPDF/Aドキュメントに変換するときに、DocConverterサービスで追跡される情報の量を指定できます。
ドキュメントの変換
DocConverterサービスクライアントを作成した後、変換するPDFドキュメントを参照し、追跡する情報の量を指定する実行時オプションを設定します。PDFドキュメントをPDF/Aドキュメントに変換できます。
PDF/Aドキュメントの保存
PDF/AドキュメントをPDFファイルとして保存できます。
関連トピック
Java APIを使用したPDF/Aドキュメントへのドキュメントの変換
WebサービスAPIを使用してドキュメントをPDF/Aドキュメントに変換する
Java APIを使用してPDFドキュメントをPDF/Aドキュメントに変換します。
プロジェクトファイルを含める
Javaプロジェクトのクラスパスに、adobe-docconverter-client.jarなどのクライアントJARファイルを含めます。
DocConvertクライアントの作成
ServiceClientFactory
オブジェクトを作成します。DocConverterServiceClient
オブジェクトを渡すことによって、ServiceClientFactory
オブジェクトを作成します。PDFドキュメントを参照してPDF/Aドキュメントに変換
java.io.FileInputStream
オブジェクトを作成します。com.adobe.idp.Document
オブジェクトを渡すことによって、java.io.FileInputStream
オブジェクトを作成します。トラッキング情報の設定
PDFAConversionOptionSpec
オブジェクトを作成します。PDFAConversionOptionSpec
オブジェクトのsetLogLevel
メソッドを呼び出し、追跡レベルを指定する文字列値を渡して、情報追跡レベルを設定します。 例えば、値FINE
を渡します。 異なる値について詳しくは、『AEM FormsAPIリファレンス』のsetLogLevel
メソッドを参照してください。ドキュメントの変換
DocConverterServiceClient
オブジェクトのtoPDFA
メソッドを呼び出し、次の値を渡して、PDFドキュメントをPDF/Aドキュメントに変換します。
com.adobe.idp.Document
オブジェクトですPDFAConversionOptionSpec
オブジェクトtoPDFA
メソッドは、PDF/Aドキュメントを含むPDFAConversionResult
オブジェクトを返します。
PDF/Aドキュメントの保存
PDFAConversionResult
オブジェクトのgetPDFA
メソッドを呼び出して、PDF/Aドキュメントを取得します。 このメソッドは、PDF/Aドキュメントを表すcom.adobe.idp.Document
オブジェクトを返します。java.io.File
オブジェクトを作成します。 ファイル名の拡張子が.pdfであることを確認します。com.adobe.idp.Document
オブジェクトのcopyToFile
メソッドを呼び出し、java.io.File
オブジェクトを渡すことで、PDF/Aデータをファイルに入力します。関連トピック
クイック開始(SOAPモード):Java APIを使用したドキュメントのPDF/Aドキュメントへの変換
DocConverter API(Webサービス)を使用してPDFドキュメントをPDF/Aドキュメントに変換します。
プロジェクトファイルを含める
DocConvertクライアントの作成
DocConverterServiceService
オブジェクトを作成します。その場合は、デフォルトのコンストラクタを呼び出します。DocConverterServiceService
オブジェクトのCredentials
データメンバーに、ユーザー名とパスワードの値を指定するSystem.Net.NetworkCredential
値を設定します。PDFドキュメントを参照してPDF/Aドキュメントに変換
BLOB
オブジェクトを作成します。BLOB
オブジェクトは、PDF/Aドキュメントに変換されたPDFドキュメントを保存するために使用します。System.IO.FileStream
オブジェクトを作成します。System.IO.FileStream
オブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStream
オブジェクトのLength
プロパティを取得して、バイト配列のサイズを決定できます。System.IO.FileStream
オブジェクトのRead
メソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。BLOB
オブジェクトにbinaryData
プロパティを割り当て、バイト配列の内容を指定します。トラッキング情報の設定
PDFAConversionOptionSpec
オブジェクトを作成します。PDFAConversionOptionSpec
オブジェクトのlogLevel
データメンバに割り当てて、情報追跡レベルを設定します。 例えば、値FINE
をこのデータメンバーに割り当てます。ドキュメントの変換
DocConverterServiceService
オブジェクトのtoPDFA
メソッドを呼び出し、次の値を渡して、PDFドキュメントをPDF/Aドキュメントに変換します。
BLOB
オブジェクトですPDFAConversionOptionSpec
オブジェクトtoPDFA
メソッドは、PDF/Aドキュメントを含むPDFAConversionResult
オブジェクトを返します。
PDF/Aドキュメントの保存
PDFAConversionResult
オブジェクトのPDFADocument
データメンバーの値を取得して、PDF/Aドキュメントを格納するBLOB
オブジェクトを作成します。PDFAConversionResult
オブジェクトを使用して返されたBLOB
オブジェクトの内容を格納するバイト配列を作成します。 BLOB
オブジェクトのbinaryData
データメンバの値を取得して、バイト配列を入力します。System.IO.FileStream
オブジェクトを作成します。System.IO.FileStream
オブジェクトを渡し、System.IO.BinaryWriter
オブジェクトを作成します。System.IO.BinaryWriter
オブジェクトのWrite
メソッドを呼び出し、バイト配列を渡すことで、バイト配列の内容をPDFファイルに書き込みます。関連トピック
Base64エンコーディングを使用したAEM Formsの呼び出し
Base64エンコーディングを使用する.NETクライアントアセンブリの作成
DocConverterサービスを使用すると、PDFドキュメントがPDF/Aに準拠しているかどうかを確認できます。 PDF/AドキュメントおよびPDFドキュメントをPDF/Aドキュメントに変換する方法について詳しくは、ドキュメントをPDF/Aドキュメントに変換するを参照してください。
DocConverterサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。
PDF/Aの互換性を判断するには、次の手順を実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。 Javaを使用してクライアントアプリケーションを作成する場合は、必要なJARファイルを含めます。 Webサービスを使用している場合は、プロキシファイルを必ず含めます。
次のJARファイルをプロジェクトのクラスパスに追加する必要があります。
これらのJARファイルの場所について詳しくは、「AEM FormsJavaライブラリファイルを含める」を参照してください。
DocConvertクライアントの作成
プログラムによってDocConverter操作を実行する前に、DocConverterクライアントを作成する必要があります。 Java APIを使用している場合は、DocConverterServiceClient
オブジェクトを作成します。 DocConverter WebサービスAPIを使用している場合は、DocConverterServiceService
オブジェクトを作成します。
PDF/Aの準拠性の判定に使用されるPDFドキュメントの参照
PDFドキュメントがPDF/Aに準拠しているかどうかを確認するには、PDFドキュメントを参照して、DocConverterサービスに渡す必要があります。
実行時オプションの設定
変換プロセス中に追跡する情報の量を決定する実行時オプションを設定できます。 つまり、9種類の異なるレベルを設定して、PDFドキュメントをPDF/Aドキュメントに変換する場合に、DocConverterサービスで追跡される情報の量を指定できます。
PDFドキュメントに関する情報の取得
DocConverterサービスクライアントを作成し、PDFドキュメントを参照し、実行時オプションを設定した後、PDFドキュメントがPDF/A準拠のドキュメントであるかどうかを確認できます。
関連トピック
Java APIを使用してPDF/Aへの準拠を確認します。
プロジェクトファイルを含める
Javaプロジェクトのクラスパスに、adobe-docconverter-client.jarなどのクライアントJARファイルを含めます。
DocConvertクライアントの作成
ServiceClientFactory
オブジェクトを作成します。DocConverterServiceClient
オブジェクトを渡すことによって、ServiceClientFactory
オブジェクトを作成します。PDF/Aの準拠性の判定に使用されるPDFドキュメントの参照
java.io.FileInputStream
オブジェクトを作成します。com.adobe.idp.Document
オブジェクトを渡すことによって、java.io.FileInputStream
オブジェクトを作成します。実行時オプションの設定
PDFAValidationOptionSpec
オブジェクトを作成します。PDFAValidationOptionSpec
オブジェクトのsetCompliance
メソッドを呼び出し、PDFAValidationOptionSpec.Compliance.PDFA_1B
を渡して、準拠レベルを設定します。PDFAValidationOptionSpec
オブジェクトのsetLogLevel
メソッドを呼び出し、追跡レベルを指定する文字列値を渡して、情報追跡レベルを設定します。 例えば、値FINE
を渡します。 異なる値について詳しくは、『AEM FormsAPIリファレンス』のsetLogLevel
メソッドを参照してください。PDFドキュメントに関する情報の取得
DocConverterServiceClient
オブジェクトのisPDFA
メソッドを呼び出し、次の値を渡して、PDF/Aの準拠性を判断します。
com.adobe.idp.Document
オブジェクトです。PDFAValidationOptionSpec
オブジェクト。isPDFA
メソッドは、この操作の結果を含むPDFAValidationResult
オブジェクトを返します。
関連トピック
クイック開始(SOAPモード):Java APIを使用したPDF/Aへの準拠の判断
WebサービスAPIを使用して、PDF/Aへの準拠を確認します。
プロジェクトファイルを含める
DocConvertクライアントの作成
DocConverterServiceService
オブジェクトを作成します。その場合は、デフォルトのコンストラクタを呼び出します。DocConverterServiceService
オブジェクトのCredentials
データメンバーに、ユーザー名とパスワードの値を指定するSystem.Net.NetworkCredential
値を設定します。PDF/Aの準拠性の判定に使用されるPDFドキュメントの参照
BLOB
オブジェクトを作成します。BLOB
オブジェクトは、PDF/Aドキュメントに変換されたPDFドキュメントを保存するために使用します。System.IO.FileStream
オブジェクトを作成します。System.IO.FileStream
オブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStream
オブジェクトのLength
プロパティを取得して、バイト配列のサイズを決定できます。System.IO.FileStream
オブジェクトのRead
メソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。BLOB
オブジェクトにbinaryData
プロパティを割り当て、バイト配列の内容を指定します。実行時オプションの設定
PDFAValidationOptionSpec
オブジェクトを作成します。PDFAValidationOptionSpec
オブジェクトのcompliance
データメンバに値PDFAConversionOptionSpec_Compliance.PDFA_1B
を割り当てて、準拠レベルを設定します。PDFAValidationOptionSpec
オブジェクトのresultLevel
データメンバに値PDFAValidationOptionSpec_ResultLevel.DETAILED
を割り当てて、情報追跡レベルを設定します。PDFドキュメントに関する情報の取得
DocConverterServiceService
オブジェクトのisPDFA
メソッドを呼び出し、次の値を渡して、PDF/Aの準拠性を判断します。
BLOB
オブジェクトです。PDFAValidationOptionSpec
オブジェクトです。isPDFA
メソッドは、この操作の結果を含むPDFAValidationResult
オブジェクトを返します。
関連トピック