WebサービスAPIを使用したPDFドキュメントのディスアセンブリ

このドキュメントのサンプルと例は、JEE環境上のAEM Formsに対してのみ提供されています。

Assembler Service API（Webサービス）を使用してPDFドキュメントをディスアセンブリします。

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

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

   メモ

   localhostを、AEM FormsをホストするサーバーのIPアドレスに置き換えます。

2. PDFアセンブラクライアントを作成します。

   • AssemblerServiceClientオブジェクトを作成するには、そのデフォルトのコンストラクタを使用します。

   • System.ServiceModel.EndpointAddressコンストラクターを使用してAssemblerServiceClient.Endpoint.Addressオブジェクトを作成します。 WSDLをAEM Formsサービスに指定するstring値を渡します（例：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認証を有効にします。

     • AEM formsユーザー名をフィールドAssemblerServiceClient.ClientCredentials.UserName.UserNameに割り当てます。
     • 対応するパスワード値をフィールドAssemblerServiceClient.ClientCredentials.UserName.Passwordに割り当てます。
     • 定数値HttpClientCredentialType.BasicをフィールドBasicHttpBindingSecurity.Transport.ClientCredentialTypeに割り当てます。
     • 定数値BasicHttpSecurityMode.TransportCredentialOnlyをフィールドBasicHttpBindingSecurity.Security.Modeに割り当てます。

3. 既存のDDXドキュメントの参照。

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

4. ディスアセンブリするPDFドキュメントの参照

   • コンストラクタを使用して BLOB オブジェクトを作成します。BLOBオブジェクトは、入力PDFドキュメントの保存に使用されます。 このBLOBオブジェクトは、invokeOneDocumentに引数として渡されます。
   • コンストラクターを呼び出し、入力PDFドキュメントーのファイルの場所とファイルを開くモードを表すstring値を渡して、System.IO.FileStreamオブジェクトを作成します。
   • System.IO.FileStreamオブジェクトの内容を格納するバイト配列を作成します。 System.IO.FileStreamオブジェクトのLengthプロパティを取得して、バイト配列のサイズを決定できます。
   • System.IO.FileStreamオブジェクトのReadメソッドを呼び出し、読み取るバイト配列、開始位置、ストリーム長を渡すことで、バイト配列にストリームデータを入力します。
   • BLOBオブジェクトに、MTOMフィールドにバイト配列の内容を割り当てて入力します。
   • MyMapOf_xsd_string_To_xsd_anyTypeオブジェクトを作成します。 このコレクションオブジェクトは、ディスアセンブリ対象のPDFを保存するために使用します。
   • MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトを作成します。
   • キー名を表すstring値を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オブジェクトのMyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクト。 MyMapOf_xsd_string_To_xsd_anyTypeオブジェクト’ Addメソッドを呼び出し、MyMapOf_xsd_string_To_xsd_anyTypeオブジェクトを渡します。

5. 実行時オプションを設定します。

   • コンストラクターを使用して、実行時オプションを格納するAssemblerOptionSpecオブジェクトを作成します。
   • AssemblerOptionSpecオブジェクトに属するデータメンバに値を割り当てて、ビジネス要件に合うように実行時オプションを設定します。 例えば、エラーが発生した場合にジョブの処理を続行するようAssemblerサービスに指示するには、falseをAssemblerOptionSpecオブジェクトのfailOnErrorフィールドに割り当てます。

6. PDFドキュメントのディスアセンブリ

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

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

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

7. アセンブル解除されたPDFドキュメントを保存します。

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

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

関連トピック

プログラムによるPDFドキュメントのディスアセンブリ

MTOMを使用したAEM Formsの呼び出し