DDX ドキュメントの動的な作成

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

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

NOTE

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

• コンストラクターを使用して System.Xml.XmlElement オブジェクトを作成します。

• XmlElement オブジェクトの CreateElement メソッドを呼び出して、DDX ドキュメントのルート要素を作成します。このメソッドは、 ルート要素を表す Element オブジェクトを作成します。要素の名前を表す文字列値を CreateElement メソッドに渡します。SetAttribute メソッドを呼び出して、DDX 要素の値を設定します。最後に、XmlElement オブジェクトの AppendChild メソッドを呼び出して、DDX ドキュメントに要素を追加します。DDX オブジェクトを引数として渡します。次のコード行は、このアプリケーションロジックを示しています。

   System.Xml.XmlElement root = ddx.CreateElement("DDX");  root.SetAttribute("xmlns", "https://ns.adobe.com/DDX/1.0/");  ddx.AppendChild(root);

• XmlElement オブジェクトの CreateElement メソッドを呼び出して、DDX ドキュメントの PDFsFromBookmarks 要素を作成します。要素の名前を表す文字列値を CreateElement メソッドに渡します。次に、 SetAttribute メソッドを呼び出して、要素の値を設定します。DDX 要素の AppendChild メソッドを呼び出して、PDFsFromBookmarks 要素をルート要素に追加します。PDFsFromBookmarks 要素オブジェクトを引数として渡します。次のコード行は、このアプリケーションロジックを示しています。

   XmlElement PDFsFromBookmarks = ddx.CreateElement("PDFsFromBookmarks");  PDFsFromBookmarks.SetAttribute("prefix", "stmt");  root.AppendChild(PDFsFromBookmarks);

• XmlElement オブジェクトの CreateElement メソッドを呼び出して、DDX ドキュメントの PDF 要素を作成します。要素の名前を表す文字列値を CreateElement メソッドに渡します。次に、 SetAttribute メソッドを呼び出して、子要素の値を設定します。PDFsFromBookmarks 要素の AppendChild メソッドを呼び出して、PDF 要素を PDFsFromBookmarks 要素に追加します。PDF 要素オブジェクトを引数として渡します。次のコード行に、このアプリケーションロジックを示します。

   XmlElement PDF = ddx.CreateElement("PDF");  PDF.SetAttribute("source", "AssemblerResultPDF.pdf");  PDFsFromBookmarks.AppendChild(PDF);

DDX ドキュメントを変換します。

• コンストラクターを使用して System.IO.MemoryStream オブジェクトを作成します。

• DDX ドキュメントを表す XmlElement オブジェクトを使った DDX ドキュメントで、MemoryStream オブジェクトを入力します。XmlElement オブジェクトの Save メソッドを呼び出し、MemoryStream オブジェクトを渡します。

• バイト配列を作成し、MemoryStream オブジェクトにあるデータを入力します。次のコードは、このアプリケーションロジックを示しています。

   int bufLen = Convert.ToInt32(stream.Length);  byte[] byteArray = new byte[bufLen];  stream.Position = 0;  int count = stream.Read(byteArray, 0, bufLen);

• BLOB オブジェクトを作成します。バイト配列を BLOB オブジェクトの MTOM フィールドに割り当てます。

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

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

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

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

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

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

• 動的に作成された DDX ドキュメントを表す BLOB オブジェクト
• 入力 PDF ドキュメントを含む mapItem 配列
• 実行時オプションを指定する AssemblerOptionSpec オブジェクト

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

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

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

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