PDF/Aドキュメントの操作

DocConverterサービスについて

DocConverterサービスは、PDFドキュメントをPDA/Aドキュメントに変換できます。 このサービスを使用して、次のタスクを実行できます。

メモ

DocConverterサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

ドキュメントをPDF/Aドキュメントに変換する

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ドキュメントに変換するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. DocConvertクライアントの作成
  3. PDF/Aドキュメントに変換するPDFドキュメントを参照します。
  4. トラッキング情報を設定します。
  5. ドキュメントを変換します。
  6. PDF/Aドキュメントを保存します。

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

必要なファイルを開発プロジェクトに含めます。 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/Aドキュメントに変換するPDFドキュメントを取得します。 AcrobatフォームなどのPDFドキュメントをPDF/Aドキュメントに変換しようとすると、例外が発生します。

トラッキング情報の設定

変換処理中に追跡する情報の量を決定する実行時オプションを設定できます。 つまり、PDFドキュメントをPDF/Aドキュメントに変換する際にDocConverterサービスが追跡する情報の量を指定する9つの異なるレベルを設定できます。

ドキュメントの変換

DocConverterサービスクライアントを作成した後、変換するPDFドキュメントを参照し、追跡する情報の量を指定する実行時オプションを設定します。PDFドキュメントをPDF/Aドキュメントに変換できます。

PDF/Aドキュメントの保存

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

関連トピック

Java APIを使用したドキュメントのPDF/Aドキュメントへの変換

WebサービスAPIを使用したドキュメントのPDF/Aドキュメントへの変換

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

接続プロパティの設定

プログラムによるPDF/Aの準拠の判断

Java APIを使用してドキュメントをPDF/Aドキュメントに変換します。

Java APIを使用してPDFドキュメントをPDF/Aドキュメントに変換します。

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

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

  2. DocConvertクライアントの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocConverterServiceClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. PDF/Aドキュメントに変換するPDFドキュメントの参照

    • 変換するPDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。その際、コンストラクターを使用し、PDFファイルの場所を指定するstring値を渡します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

  4. トラッキング情報の設定

    • コンストラクタを使用して PDFAConversionOptionSpec オブジェクトを作成します。
    • PDFAConversionOptionSpecオブジェクトのsetLogLevelメソッドを呼び出し、追跡レベルを指定する文字列値を渡すことで、情報追跡レベルを設定します。 例えば、値FINEを渡します。 様々な値について詳しくは、『AEM Forms APIリファレンス』のsetLogLevelメソッドを参照してください。

  5. ドキュメントの変換

    DocConverterServiceClientオブジェクトのtoPDFAメソッドを呼び出し、次の値を渡してPDFドキュメントをPDF/Aドキュメントに変換します。

    • 変換するPDFドキュメントを含むcom.adobe.idp.Documentオブジェクト
    • 追跡情報を指定するPDFAConversionOptionSpecオブジェクト

    toPDFAメソッドは、PDF/Aドキュメントを含むPDFAConversionResultオブジェクトを返します。

  6. 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データをファイルに入力します。

関連トピック

PDF/Aドキュメントの操作

クイックスタート（SOAPモード）:Java APIを使用したドキュメントのPDF/Aドキュメントへの変換

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

接続プロパティの設定

WebサービスAPIを使用してドキュメントをPDF/Aドキュメントに変換する

DocConverter API（Webサービス）を使用してPDFドキュメントをPDF/Aドキュメントに変換します。

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

    • DocConverter WSDLを使用するMicrosoft .NETクライアントアセンブリを作成します。
    • Microsoft .NETクライアントアセンブリを参照します。

  2. DocConvertクライアントの作成

    • Microsoft .NETクライアントアセンブリを使用して、デフォルトのコンストラクタを呼び出してDocConverterServiceServiceオブジェクトを作成します。
    • DocConverterServiceServiceオブジェクトのCredentialsデータメンバーに、ユーザー名とパスワードの値を指定するSystem.Net.NetworkCredential値を設定します。

  3. PDF/Aドキュメントに変換するPDFドキュメントの参照

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

  4. トラッキング情報の設定

    • コンストラクタを使用して PDFAConversionOptionSpec オブジェクトを作成します。
    • PDFAConversionOptionSpecオブジェクトのlogLevelデータメンバーに追跡レベルを指定する値を割り当てて、情報追跡レベルを設定します。 例えば、値FINEをこのデータメンバーに割り当てます。

  5. ドキュメントの変換

    DocConverterServiceServiceオブジェクトのtoPDFAメソッドを呼び出し、次の値を渡してPDFドキュメントをPDF/Aドキュメントに変換します。

    • 変換するPDFドキュメントを含むBLOBオブジェクト
    • 追跡情報を指定するPDFAConversionOptionSpecオブジェクト

    toPDFAメソッドは、PDF/Aドキュメントを含むPDFAConversionResultオブジェクトを返します。

  6. PDF/Aドキュメントの保存

    • PDFAConversionResultオブジェクトのPDFADocumentデータメンバーの値を取得して、PDF/Aドキュメントを格納するBLOBオブジェクトを作成します。
    • PDFAConversionResultオブジェクトを使用して返されたBLOBオブジェクトの内容を格納するバイト配列を作成します。 BLOBオブジェクトのbinaryDataデータメンバーの値を取得して、バイト配列を設定します。
    • コンストラクターを呼び出し、PDF/Aドキュメントのファイルの場所を表すstring値を渡して、System.IO.FileStreamオブジェクトを作成します。
    • コンストラクターを呼び出し、System.IO.FileStreamオブジェクトを渡して、System.IO.BinaryWriterオブジェクトを作成します。
    • System.IO.BinaryWriterオブジェクトのWriteメソッドを呼び出し、バイト配列を渡すことにより、バイト配列の内容をPDFファイルに書き込みます。

関連トピック

PDF/Aドキュメントの操作

Base64エンコーディングを使用したAEM Formsの呼び出し

Base64エンコーディングを使用する.NETクライアントアセンブリの作成

プログラムによるPDF/Aの準拠の判断

DocConverterサービスを使用して、PDFドキュメントがPDF/Aに準拠しているかどうかを判断できます。 PDF/AドキュメントとPDF/Aドキュメントの変換方法について詳しくは、ドキュメントからPDF/Aドキュメントへの変換を参照してください。

メモ

DocConverterサービスの詳細については、『AEM Formsのサービスリファレンス』を参照してください。

手順の概要

PDF/Aの準拠を判断するには、次の手順を実行します。

  1. プロジェクトファイルを含めます。
  2. DocConvertクライアントの作成
  3. PDF/Aの準拠性を判断するために使用するPDFドキュメントを参照します。
  4. 実行時オプションを設定します。
  5. 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の準拠の判断

WebサービスAPIを使用したPDF/Aの準拠の判断

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

接続プロパティの設定

Java APIを使用したPDF/Aの準拠性の判断

Java APIを使用してPDF/Aの準拠を決定します。

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

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

  2. DocConvertクライアントの作成

    • 接続プロパティを含む ServiceClientFactory オブジェクトを作成します。
    • コンストラクタを使用して DocConverterServiceClient オブジェクトを渡すことによって、ServiceClientFactory オブジェクトを作成します。

  3. PDF/Aの準拠性の判断に使用するPDFドキュメントの参照

    • 変換するPDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。その際、コンストラクターを使用し、PDFファイルの場所を指定するstring値を渡します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。

  4. 実行時オプションの設定

    • コンストラクタを使用して PDFAValidationOptionSpec オブジェクトを作成します。
    • PDFAValidationOptionSpecオブジェクトのsetComplianceメソッドを呼び出し、PDFAValidationOptionSpec.Compliance.PDFA_1Bを渡すことで、準拠レベルを設定します。
    • PDFAValidationOptionSpecオブジェクトのsetLogLevelメソッドを呼び出し、追跡レベルを指定する文字列値を渡すことで、情報追跡レベルを設定します。 例えば、値FINEを渡します。 様々な値について詳しくは、『AEM Forms APIリファレンス』のsetLogLevelメソッドを参照してください。

  5. PDFドキュメントに関する情報の取得

    DocConverterServiceClientオブジェクトのisPDFAメソッドを呼び出し、次の値を渡してPDF/Aの準拠性を判断します。

    • PDFドキュメントを含むcom.adobe.idp.Documentオブジェクト。
    • 実行時オプションを指定するPDFAValidationOptionSpecオブジェクト。

    isPDFAメソッドは、この操作の結果を含むPDFAValidationResultオブジェクトを返します。

関連トピック

PDF/Aドキュメントの操作

クイックスタート（SOAPモード）:Java APIを使用したPDF/Aの準拠の決定

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

接続プロパティの設定

WebサービスAPIを使用したPDF/Aの準拠性の判断

WebサービスAPIを使用してPDF/Aの準拠性を判断します。

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

    • DocConverter WSDLを使用するMicrosoft .NETクライアントアセンブリを作成します。
    • Microsoft .NETクライアントアセンブリを参照します。

  2. DocConvertクライアントの作成

    • Microsoft .NETクライアントアセンブリを使用して、デフォルトのコンストラクタを呼び出してDocConverterServiceServiceオブジェクトを作成します。
    • DocConverterServiceServiceオブジェクトのCredentialsデータメンバーに、ユーザー名とパスワードの値を指定するSystem.Net.NetworkCredential値を設定します。

  3. PDF/Aの準拠性の判断に使用するPDFドキュメントの参照

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

  4. 実行時オプションの設定

    • コンストラクタを使用して PDFAValidationOptionSpec オブジェクトを作成します。
    • PDFAValidationOptionSpecオブジェクトのcomplianceデータメンバに値PDFAConversionOptionSpec_Compliance.PDFA_1Bを割り当てて、準拠レベルを設定します。
    • PDFAValidationOptionSpecオブジェクトのresultLevelデータメンバーに値PDFAValidationOptionSpec_ResultLevel.DETAILEDを割り当てて、情報追跡レベルを設定します。

  5. PDFドキュメントに関する情報の取得

    DocConverterServiceServiceオブジェクトのisPDFAメソッドを呼び出し、次の値を渡してPDF/Aの準拠性を判断します。

    • PDFドキュメントを含むBLOBオブジェクト。
    • 実行時オプションを含むPDFAValidationOptionSpecオブジェクト。

    isPDFAメソッドは、この操作の結果を含むPDFAValidationResultオブジェクトを返します。

関連トピック

PDF/Aドキュメントの操作

Base64エンコーディングを使用したAEM Formsの呼び出し

Base64エンコーディングを使用する.NETクライアントアセンブリの作成

このページ