Assembler サービスを使用して、PDF ドキュメントが PDF/A に準拠しているかどうかを判断できます。PDF/A ドキュメントは、ドキュメントのコンテンツを長期間保存するためのアーカイブ形式として存在します。フォントはドキュメントに埋め込まれ、ファイルは非圧縮になります。 その結果、通常、PDF/A ドキュメントは標準の PDF ドキュメントよりも大きくなります。なお、PDF/A ドキュメントには、オーディオおよびビデオのコンテンツは含まれません。
PDF/A-1 仕様は、A と B という 2 つの適合レベルで構成されます。2 つのレベルの主な違いは、適合レベル B には必要ない論理構造(アクセシビリティ)のサポートです。適合レベルに関係なく、PDF/A-1 では、生成されたPDF/A ドキュメント内にすべてのフォントが埋め込まれていることを示します。現時点では、検証(および変換)では PDF/A-1b のみがサポートされています。
この説明では、次の DDX ドキュメントが使用されていると仮定します。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<DocumentInformation source="Loan.pdf" result="Loan_result.xml">
<PDFAValidation compliance="PDF/A-1b" resultLevel="Detailed" ignoreUnusedResources="true" allowCertificationSignatures="true" />
</DocumentInformation>
</DDX>
この DDX ドキュメント内で、DocumentInformation
要素は、入力 PDF ドキュメントに関する情報を返すように Assembler サービスに指示します。DocumentInformation
要素内で、PDFAValidation
要素は、入力 PDF ドキュメントが PDF/A に準拠しているかどうかを示すように Assembler サービスに指示します。
Assembler サービスは、入力 PDF ドキュメントが PDFAConformance
要素を含む XML ドキュメント内で PDF/A 準拠であるかどうかを指定する情報を返します。入力 PDF ドキュメントが PDF/A に準拠している場合、PDFAConformance
要素の isCompliant
属性の値は true
です。PDF ドキュメントが PDF/A に準拠していない場合、PDFAConformance
要素の isCompliant
属性の値は false
です。
この節で指定した DDX ドキュメントには DocumentInformation
要素が含まれているため、Assembler サービスは PDF ドキュメントではなく、XML データを返します。つまり、Assembler サービスは、PDF ドキュメントをアセンブルやディスアセンブルしません。XML ドキュメント内の入力 PDF ドキュメントに関する情報を返します。
Assembler サービスについて詳しくは、AEM Forms のサービスリファレンスを参照してください。
DDX ドキュメントについて詳しくは、Assembler サービスと DDX リファレンスを参照してください。
PDF ドキュメントが PDF/A に準拠しているかどうかを判断するには、以下のタスクを実行します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
AEM Forms が JBoss 以外のサポート対象の J2EE アプリケーションサーバーにデプロイされている場合は、adobe-utilities.jar ファイルと jbossall-client.jar ファイルを、AEM Forms がデプロイされている J2EE アプリケーションサーバーに固有の JAR ファイルに置き換える必要があります。すべての AEM Forms JAR ファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。
PDF Assembler クライアントの作成
Assembler 操作をプログラムで実行する前に、Assembler サービスクライアントを作成する必要があります。
既存の DDX ドキュメントの参照
Assembler サービス操作を実行するには、DDX ドキュメントを参照する必要があります。入力 PDF ドキュメントが PDF/A に準拠しているかどうかを判断するには、DDX ドキュメントに DocumentInformation
要素内の PDFAValidation
要素が含まれていることを確認してください。この PDFAValidation
要素は、入力 PDF ドキュメントが PDF/A に準拠しているかどうかを指定する XML ドキュメントを返すように Assembler サービスに指示します。
PDF/A 準拠の判断に使用される PDF ドキュメントの参照
PDFドキュメントが PDF/A に準拠しているかどうかを判断するには、PDF ドキュメントを参照して Assembler サービスに渡す必要があります。
実行時オプションを設定
ジョブの実行中に Assembler サービスの動作を制御する実行時オプションを設定できます。例えば、エラーが発生した場合にジョブの処理を続行するよう Assembler サービスに指示するオプションを設定できます。設定できる実行時オプションについて詳しくは、AEM Forms API リファレンスの AssemblerOptionSpec
クラスリファレンスを参照してください。
PDF ドキュメントに関する情報の取得
Assembler サービスクライアントの作成、DDX ドキュメントの参照、インタラクティブ PDF ドキュメントの参照、実行時オプションの設定を行うと、invokeDDX
操作を呼び出すことができます。DDX ドキュメントには DocumentInformation
要素が含まれているため、Assembler サービスは PDF ドキュメントではなく、XML データを返します。
返された XML ドキュメントの保存
Assembler サービスが返す XML ドキュメントは、入力 PDF ドキュメントが PDF/A に準拠しているかどうかを指定します。例えば、入力 PDF ドキュメントが PDF/A に準拠していない場合、Assembler サービスは以下の要素を含む XML ドキュメントを返します。
<PDFAConformance isCompliant="false" compliance="PDF/A-1b" resultLevel="Detailed" ignoreUnusedResources="true" allowCertificationSignatures="true">
XML ドキュメントを XML ファイルとして保存し、ファイルを開いて結果を表示できるようにします。
関連トピック
Java API を使用したドキュメントが PDF/A に準拠しているかどうかの確認
web サービス API を使用したドキュメントが PDF/A に準拠しているかどうかの確認
Assembler サービス API(Java)を使用して、PDF ドキュメントが PDF/A に準拠しているかどうかを判断します。
プロジェクトファイルを含めます。
adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
PDF Assembler クライアントを作成します。
ServiceClientFactory
オブジェクトを作成します。ServiceClientFactory
オブジェクトを渡すことにより、AssemblerServiceClient
オブジェクトを作成します。既存の DDX ドキュメントを参照します。
java.io.FileInputStream
オブジェクトを作成するには、コンストラクターを使用して、DDX ファイルの場所を指定する文字列値を渡します。PDF ドキュメントが PDF/A に準拠しているかどうかを判断するには、DDX ドキュメントの DocumentInformation
要素内に含まれる PDFAValidation
要素が含まれていることを確認してください。java.io.FileInputStream
オブジェクトを渡し、com.adobe.idp.Document
オブジェクトを作成します。PDF/A の準拠を判断するために使用される PDF ドキュメントを参照してください。
java.io.FileInputStream
オブジェクトを作成するには、コンストラクターを使用して、PDF/A の準拠を判断するために使用される PDF ドキュメントの場所を渡します。
com.adobe.idp.Document
オブジェクトを作成するには、コンストラクターを使用して、PDF ドキュメントを含む java.io.FileInputStream
オブジェクトを渡します。
HashMap
コンストラクターを使用して、入力 PDF ドキュメントを格納するために使用されるjava.util.Map
オブジェクトを作成します。
java.util.Map
オブジェクトにエントリを追加するには、put
メソッドを呼び出して、以下の引数を渡します。
com.adobe.idp.Document
オブジェクト。実行時オプションを設定します。
AssemblerOptionSpec
オブジェクトを作成します。AssemblerOptionSpec
オブジェクトに属するメソッドを呼び出して、ビジネス要件を満たすよう実行時オプションを設定します。例えば、エラーが発生したときにジョブの処理を続行するように Assembler サービスに指示するには、AssemblerOptionSpec
オブジェクトの setFailOnError
メソッドを呼び出して、false
を渡します。PDF ドキュメントに関する情報を取得します。
AssemblerServiceClient
オブジェクトの invokeDDX
メソッドを呼び出して、以下の必要な値を渡します。
com.adobe.idp.Document
オブジェクトjava.util.Map
オブジェクトcom.adobe.livecycle.assembler.client.AssemblerOptionSpec
オブジェクトこの invokeDDX
メソッドは、入力 PDF ドキュメントが PDF/A に準拠しているかどうかを指定する XML データを含む com.adobe.livecycle.assembler.client.AssemblerResult
オブジェクトを返します。
返された XML ドキュメントを保存します。
入力 PDF ドキュメントが PDF/A ドキュメントであるかどうかを指定する XML データを取得するには、次のアクションを実行します。
AssemblerResult
オブジェクトの getDocuments
メソッドを呼び出します。これにより、java.util.Map
オブジェクトが返されます。com.adobe.idp.Document
オブジェクトが見つかるまで、java.util.Map
オブジェクトを繰り返し処理します。com.adobe.idp.Document
オブジェクトの copyToFile
メソッドを呼び出して、XML ドキュメントを抽出します。XML データは XML ファイルとして保存してください。関連トピック
クイックスタート(SOAP モード):Java API を使用したドキュメントの PDF/A 準拠の確認(SOAP モード)
Assembler Service API(web サービス)を使用して、PDF ドキュメントが PDF/A に準拠しているかどうかを判断します。
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1
を使用するようにします。
localhost
を、AEM Forms をホストするサーバーの IP アドレスに置換します。
PDF Assembler クライアントを作成します。
デフォルトのコンストラクターを使用して、AssemblerServiceClient
オブジェクトを作成します。
System.ServiceModel.EndpointAddress
コンストラクターを使用して、AssemblerServiceClient.Endpoint.Address
オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します(例:http://localhost:8080/soap/services/AssemblerService?blob=mtom
)。lc_version
属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。
AssemblerServiceClient.Endpoint.Binding
フィールドの値を取得して、System.ServiceModel.BasicHttpBinding
オブジェクトを作成します。戻り値を BasicHttpBinding
にキャストします。
System.ServiceModel.BasicHttpBinding
オブジェクトの MessageEncoding
フィールドを WSMessageEncoding.Mtom
に設定します。この値により、MTOM が確実に使用されます。
次のタスクを実行して、HTTP 基本認証を有効にします。
AssemblerServiceClient.ClientCredentials.UserName.UserName
フィールドに AEM Forms ユーザー名を割り当てます。AssemblerServiceClient.ClientCredentials.UserName.Password
フィールドに割り当てます。HttpClientCredentialType.Basic
をBasicHttpBindingSecurity.Transport.ClientCredentialType
フィールドに割り当てます。BasicHttpSecurityMode.TransportCredentialOnly
をフィールド BasicHttpBindingSecurity.Security.Mode
に割り当てます。既存の DDX ドキュメントを参照します。
BLOB
オブジェクトを作成します。この BLOB
オブジェクトは、DDX ドキュメントの保存に使用されます。System.IO.FileStream
オブジェクトを作成するには、そのコンストラクターを呼び出し、DDX ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡します。System.IO.FileStream
オブジェクトのコンテンツを保存するバイト配列を作成します。System.IO.FileStream
オブジェクトの Length
プロパティを取得することで、バイト配列のサイズを決定できます。System.IO.FileStream
オブジェクトの Read
メソッドを呼び出し、バイト配列、開始位置、読み取るストリーム長を渡すことにより、バイト配列にストリームデータを入力します。MTOM
フィールドにバイト配列の内容をを割り当てて、BLOB
オブジェクトにデータを入力します。PDF/A の準拠を判断するために使用される PDF ドキュメントを参照してください。
BLOB
オブジェクトを作成します。この BLOB
オブジェクトは、入力 PDF ドキュメントの格納に使用します。System.IO.FileStream
オブジェクトを作成します。System.IO.FileStream
オブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStream
オブジェクトの Length
プロパティを取得することで、バイト配列のサイズを決定できます。System.IO.FileStream
オブジェクトの Read
メソッドを呼び出し、バイト配列、開始位置、読み取るストリーム長を渡します。MTOM
プロパティにバイト配列の内容を割り当てて、BLOB
オブジェクトにデータを入力します。MyMapOf_xsd_string_To_xsd_anyType
オブジェクトを作成します。このコレクションオブジェクトは、PDF ドキュメントの保存に使用されます。MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトを作成します。MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトの key
フィールドに割り当てます。この値は、DDX ドキュメントで指定された PDF ソース要素の値と一致している必要があります。BLOB
オブジェクトを MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトの value
フィールドに入力します。MyMapOf_xsd_string_To_xsd_anyType_Item
オブジェクトを MyMapOf_xsd_string_To_xsd_anyType
オブジェクトに追加します。MyMapOf_xsd_string_To_xsd_anyType
オブジェクトの Add
メソッドを呼び出して MyMapOf_xsd_string_To_xsd_anyType
オブジェクトを渡します。実行時オプションを設定します。
AssemblerOptionSpec
オブジェクトをコンストラクタで作成します。AssemblerOptionSpec
オブジェクトに属するデータメンバーに値を割り当てることで、ビジネス要件に応じたランタイムオプションを設定します。例えば、エラーが発生した場合にジョブの処理を続行するように Assembler サービスに指示するには、false
を AssemblerOptionSpec
オブジェクトの failOnError
データメンバーに割り当てます。PDF ドキュメントに関する情報を取得します。
AssemblerServiceService
オブジェクトの invoke
メソッドを呼び出して、以下の値を渡します。
BLOB
オブジェクト。MyMapOf_xsd_string_To_xsd_anyType
オブジェクト。キーは PDF ソースファイルの名前と一致する必要があり、値は入力 PDF ファイルに対応する BLOB
オブジェクトである必要があります。AssemblerOptionSpec
オブジェクト。invoke
メソッドは、入力 PDF ドキュメントが PDF/A ドキュメントであるかどうかを指定する XML データを含む AssemblerResult
オブジェクトを返します。
返された XML ドキュメントを保存します。
入力 PDF ドキュメントが PDF/A ドキュメントであるかどうかを指定する XML データを取得するには、次のアクションを実行します。
AssemblerResult
オブジェクトの documents
フィールドにアクセスします。これは、入力 PDF ドキュメントが PDF/A ドキュメントであるかどうかを指定する XML データを含む Map
オブジェクトです。Map
オブジェクトを反復処理して各結果ドキュメントを取得します。次に、その配列メンバーの値を BLOB
にキャストします。BLOB
オブジェクトの MTOM
フィールドにアクセスして、XML データを表すバイナリデータを抽出します。このフィールドには、XML ファイルとして書き出すことができるバイトの配列が格納されます。関連トピック