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ドキュメントを参照してPDF/Aドキュメントに変換します。
  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 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ドキュメントに変換する

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ドキュメントを参照してPDF/Aドキュメントに変換

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

    • コンストラクタを使用して PDFAConversionOptionSpec オブジェクトを作成します。
    • PDFAConversionOptionSpecオブジェクトのsetLogLevelメソッドを呼び出し、追跡レベルを指定する文字列値を渡して、情報追跡レベルを設定します。 例えば、値FINEを渡します。 異なる値について詳しくは、『AEM FormsAPIリファレンス』の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ドキュメントを参照してPDF/Aドキュメントに変換

    • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、PDF/Aドキュメントに変換されたPDFドキュメントを保存するために使用します。
    • コンストラクターを呼び出し、PDFドキュメントーのファイルの場所と、ファイルを開くモードを表す文字列値を渡して、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ドキュメントーのファイルの場所を表す文字列値を渡して、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ドキュメントを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 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への準拠の確認

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ファイルの場所を指定するstring値を渡して、変換するPDFドキュメントを表すjava.io.FileInputStreamオブジェクトを作成します。
    • コンストラクタを使用して com.adobe.idp.Document オブジェクトを渡すことによって、java.io.FileInputStream オブジェクトを作成します。
  4. 実行時オプションの設定

    • コンストラクタを使用して PDFAValidationOptionSpec オブジェクトを作成します。
    • PDFAValidationOptionSpecオブジェクトのsetComplianceメソッドを呼び出し、PDFAValidationOptionSpec.Compliance.PDFA_1Bを渡して、準拠レベルを設定します。
    • PDFAValidationOptionSpecオブジェクトのsetLogLevelメソッドを呼び出し、追跡レベルを指定する文字列値を渡して、情報追跡レベルを設定します。 例えば、値FINEを渡します。 異なる値について詳しくは、『AEM FormsAPIリファレンス』の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ドキュメントーのファイルの場所と、ファイルを開くモードを表す文字列値を渡して、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クライアントアセンブリの作成

このページ

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now