Web サービス API を使用した PDF ドキュメントの分割 disassemble-a-pdf-document-usingthe-web-service-api

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。サービスリファレンスを設定する際は、WSDL の定義 http://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1 を必ず使用してください。

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 ドキュメントを参照します。

• コンストラクターを使用して BLOB オブジェクトを作成します。BLOB オブジェクトは、入力 PDF ドキュメントを格納するために使用します。この BLOB オブジェクトは引数として invokeOneDocument に渡されます。
• コンストラクタを呼び出し、入力 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 ソース要素の値と一致している必要があります。
• 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 サービスに指示するには、AssemblerOptionSpec オブジェクトの failOnError フィールドに false を割り当てます。

PDF ドキュメントを分割します。

AssemblerServiceClient オブジェクトの invokeDDX メソッドを呼び出して、次の値を渡します。

• PDF ドキュメントをディスアセンブルする DDX ドキュメントを表す BLOB オブジェクト
• ディスアセンブルする PDF ドキュメントを含む MyMapOf_xsd_string_To_xsd_anyType オブジェクト
• 実行時オプションを指定する AssemblerOptionSpec オブジェクト

invokeDDX メソッドは、ジョブの結果および発生した例外を含む AssemblerResult オブジェクトを返します。

分割した PDF ドキュメントを保存します。

新しく作成した PDF ドキュメントを取得するには、次の操作を実行します。

• AssemblerResult オブジェクトの documents フィールド（ディスアセンブリされた PDF ドキュメントを含む Map オブジェクト）にアクセスします。
• Mapオブジェクトを反復処理して、各結果ドキュメントを取得します。次に、その配列メンバーのvalueをBLOBにキャストします。
• BLOBオブジェクトのMTOMプロパティにアクセスして、PDF ドキュメントを表すバイナリデータを抽出します。これにより、PDF ファイルに書き出すことができるバイト配列が返されます。