複数の XDP フラグメントのアセンブル
複数の XDP フラグメントを単一の XDP ドキュメントにアセンブルできます。例えば、各 XDP ファイルに、ヘルスフォームの作成に使用される 1 つ以上のサブフォームが含まれている XDP フラグメントについて考えてみましょう。次の図に、アウトラインビューを示します（複数の XDP フラグメントのアセンブル クイックスタートで使用される tuc018_template_flowed.xdp ファイルを表わしています）。
次の図に、「patient」セクションを示します（複数の XDP フラグメントのアセンブル クイックスタートで使用される tuc018_contact.xdp ファイルを表わしています）。
次の図に、「patient health」セクションを示します（複数の XDP フラグメントのアセンブル クイックスタートで使用される tuc018_patient.xdp ファイルを表わしています）。
このフラグメントには、subPatientPhysical および subPatientHealth という 2 つのサブフォームが含まれています。これらの両方のサブフォームは、Assembler サービスに渡される DDX ドキュメント内で参照されます。次の図に示すように、Assembler サービスを使用して、これらすべての XDP フラグメントを単一の XDP ドキュメントに組み合わせることができます。
次の DDX ドキュメントは、複数の XDP フラグメントを単一の XDP ドキュメントにアセンブルします。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="https://ns.adobe.com/DDX/1.0/">
<XDP result="tuc018result.xdp">
<XDP source="tuc018_template_flowed.xdp">
<XDPContent insertionPoint="ddx_fragment" source="tuc018_contact.xdp" fragment="subPatientContact" required="false"/>
<XDPContent insertionPoint="ddx_fragment" source="tuc018_patient.xdp" fragment="subPatientPhysical" required="false"/>
<XDPContent insertionPoint="ddx_fragment" source="tuc018_patient.xdp" fragment="subPatientHealth" required="false"/>
</XDP>
</XDP>
</DDX>
DDX ドキュメントには、結果の名前を指定する XDP result タグが含まれています。この場合、値は tuc018result.xdp です。この値は、Assembler サービスが結果を返した後に XDP ドキュメントを取得するために使用されるアプリケーションロジックで参照されます。例えば、アセンブルされた XDP ドキュメントを取得するために使用される次の Java アプリケーションロジックについて考えてみます（値が太字で示されています）。
//Iterate through the map object to retrieve the result XDP document
for (Iterator i = allDocs.entrySet().iterator(); i.hasNext();) {
// Retrieve the Map object’s value
Map.Entry e = (Map.Entry)i.next();
//Get the key name as specified in the
//DDX document
String keyName = (String)e.getKey();
if (keyName.equalsIgnoreCase("tuc018result.xdp"))
{
Object o = e.getValue();
outDoc = (Document)o;
//Save the result PDF file
File myOutFile = new File("C:\\AssemblerResultXDP.xdp");
outDoc.copyToFile(myOutFile);
}
}
XDP source タグは、完全な XDP ドキュメント（XDP フラグメントを追加するためのコンテナとして使用したり、順番に追加されるいくつかのドキュメントの 1 つとして使用したりできる）を表す XDP ファイルを指定します。この場合、XDP ドキュメントはコンテナ（複数の XDP フラグメントのアセンブル に示した最初の図）としてのみ使用されます。つまり、他の XDP ファイルは XDP コンテナ内に配置されます。
サブフォームごとに、 XDPContent 要素（この要素はオプションです）を追加できます。上記の例では、subPatientContact、subPatientPhysical、subPatientHealth の 3 つのサブフォームがあることに注意してください。両方の subPatientPhysical サブフォームおよび subPatientHealth サブフォームは、同じ XDP ファイル（tuc018_patient.xdp）に存在します。fragment 要素は、Designer で定義されたサブフォームの名前を指定します。
NOTENOTE手順の概要
複数の XDP フラグメントをアセンブルするには、次のタスクを実行します。
- プロジェクトファイルを含めます。
- PDF Assembler クライアントを作成します。
- 既存の DDX ドキュメントを参照します。
- XDP ドキュメントを参照します。
- 実行時オプションを設定します。
- 複数の XDP ドキュメントをアセンブリします。
- アセンブルされた XDP ドキュメントを取得します。
プロジェクトファイルを含める
必要なファイルを開発プロジェクトに含めます。Java を使用してクライアントアプリケーションを作成する場合は、必要な JAR ファイルを含めます。Web サービスを使用している場合は、プロキシファイルを必ず含めてください。
次の JAR ファイルをプロジェクトのクラスパスに追加する必要があります。
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-assembler-client.jar
- adobe-utilities.jar（AEM Forms が JBoss にデプロイされている場合に必要）
- jbossall-client.jar（AEM Formsが JBoss にデプロイされている場合に必要）
PDF Assembler クライアントの作成
Assembler 操作をプログラムで実行する前に、Assembler サービスクライアントを作成します。
既存の DDX ドキュメントの参照
複数の XDP ドキュメントをアセンブルするには、DDX ドキュメントを参照する必要があります。この DDX ドキュメントには、XDP result、XDP source、XDPContent 要素を含める必要があります。
XDP ドキュメントの参照
複数の XDP ドキュメントをアセンブルするには、結果の XDP ドキュメントをアセンブルするために使用されるすべての XDP ファイルを参照します。source 属性によって参照される XDP ドキュメントに含まれるサブフォームの名前が、fragment 属性で指定されていることを確認してください。サブフォームは Designer で定義されます。例えば、次のような XML を考えてみましょう。
<XDPContent insertionPoint="ddx_fragment" source="tuc018_contact.xdp" fragment="subPatientContact" required="false"/>
subPatientContact という名前のサブフォームは、tuc018_contact.xdp という名前の XDP ファイル内にある必要があります。
実行時オプションの設定
ジョブを実行する際の Assembler サービスの動作を制御する実行時オプションを設定できます。例えば、エラーが発生した場合にジョブの処理を続行するよう Assembler サービスに指示するオプションを設定できます。
複数の XDP ドキュメントのアセンブリ
複数の XDP ファイルをアセンブリするには、 invokeDDX 操作を呼び出します。Assembler サービスは、コレクションオブジェクト内でアセンブルされた XDP ドキュメントを返します。
アセンブルされた XDP ドキュメントの取得
アセンブルされた XDP ドキュメントがコレクションオブジェクト内で返されます。コレクションオブジェクトを繰り返し処理し、XDP ドキュメントを XDP ファイルとして保存します。また、XDP ドキュメントを別の AEM Forms サービス（Output など）に渡すこともできます。
関連トピック
Java API を使用した複数の XDP フラグメントのアセンブル
Java API を使用した複数の XDP フラグメントのアセンブル
Assembler Service API（Java）を使用して、複数の XDP フラグメントをアセンブルします。
-
プロジェクトファイルを含めます。
adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。
-
PDF Assembler クライアントを作成します。
- 接続プロパティを含む
ServiceClientFactoryオブジェクトを作成します。 - コンストラクターを使用して
ServiceClientFactoryオブジェクトを渡すことにより、AssemblerServiceClientオブジェクトを作成します。
- 接続プロパティを含む
-
既存の DDX ドキュメントを参照します。
- コンストラクタを使用し、DDX ファイルの場所を指定する文字列値を渡すことによって、その DDX ドキュメントを表す
java.io.FileInputStreamオブジェクトを作成します。 - コンストラクターを使用して
java.io.FileInputStreamオブジェクトを渡すことによって、com.adobe.idp.Documentオブジェクトを作成します。
- コンストラクタを使用し、DDX ファイルの場所を指定する文字列値を渡すことによって、その DDX ドキュメントを表す
-
XDP ドキュメントを参照します。
-
HashMapコンストラクターを使用することで、入力 XDP ドキュメントを格納するために使用されるjava.util.Mapオブジェクトを作成します。 -
com.adobe.idp.Documentオブジェクトを作成して、入力 XDP ファイルを含むjava.io.FileInputStreamオブジェクトを渡します（XDP ファイルごとにこのタスクを繰り返します）。 -
putメソッドを呼び出して次の引数を渡すことで、エントリをjava.util.Mapオブジェクトに追加します。- キー名を表す文字列値。この値は、DDX ドキュメントで指定された
source要素値に一致する必要があります（XDP ファイルごとにこのタスクを繰り返します）。 source要素に対応する XDP ドキュメントを含むcom.adobe.idp.Documentオブジェクト（XDP ファイルごとにこのタスクを繰り返します）。
- キー名を表す文字列値。この値は、DDX ドキュメントで指定された
-
-
実行時オプションを設定します。
- コンストラクターを使用して、実行時オプションを格納する
AssemblerOptionSpecオブジェクトを作成します。 AssemblerOptionSpecオブジェクトに属するメソッドを呼び出して、ビジネス要件を満たすよう実行時オプションを設定します。例えば、エラーが発生したときにジョブの処理を続行するように Assembler サービスに指示するには、AssemblerOptionSpecオブジェクトのsetFailOnErrorメソッドを呼び出してfalseを渡します。
- コンストラクターを使用して、実行時オプションを格納する
-
複数の XDP ドキュメントをアセンブリします。
AssemblerServiceClientオブジェクトのinvokeDDXメソッドを呼び出して、以下の必須値を渡します。- 使用する DDX ドキュメントを表す
com.adobe.idp.Documentオブジェクト - 入力 XDP ファイルを格納する
java.util.Mapオブジェクト - デフォルトのフォントやジョブのログレベルを含む、実行時のオプションを指定する
com.adobe.livecycle.assembler.client.AssemblerOptionSpecオブジェクト
invokeDDXメソッドは、作成された XDP ドキュメントを格納するcom.adobe.livecycle.assembler.client.AssemblerResultオブジェクトを返します。 - 使用する DDX ドキュメントを表す
-
アセンブルされた XDP ドキュメントを取得します。
作成された XDP ドキュメントを取得するには、以下の操作を実行します。
AssemblerResultオブジェクトのgetDocumentsメソッドを呼び出します。このメソッドは、java.util.Mapオブジェクトを返します。- 結果の
com.adobe.idp.Documentオブジェクトが見つかるまで、java.util.Mapオブジェクトを反復処理します。 com.adobe.idp.DocumentオブジェクトのcopyToFileメソッドを呼び出して、作成された XDP ドキュメントを抽出します。
Web サービス API を使用した複数の XDP フラグメントのアセンブル
Assembler Service API（web サービス）を使用して、複数の XDP フラグメントを作成します。
-
プロジェクトファイルを含めます。
MTOM を使用する Microsoft .NET プロジェクトを作成します。サービス参照を設定する際は、以下の WSDL 定義を必ず使用してください。
https://localhost:8080/soap/services/AssemblerService?WSDL&lc_version=9.0.1.NOTElocalhostを、AEM Forms をホストするサーバーの IP アドレスに置換します。 -
PDF Assembler クライアントを作成します。
-
デフォルトのコンストラクターを使用して、
AssemblerServiceClientオブジェクトを作成します。 -
System.ServiceModel.EndpointAddressコンストラクターを使用してAssemblerServiceClient.Endpoint.Addressオブジェクトを作成します。WSDL を指定する文字列値（例：https://localhost:8080/soap/services/AssemblerService?blob=mtom）を AEM Forms サービスに渡します。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フィールドに対応するパスワード値を割り当てます。BasicHttpBindingSecurity.Transport.ClientCredentialTypeフィールドにHttpClientCredentialType.Basic定数値を割り当てます。BasicHttpBindingSecurity.Security.ModeフィールドにBasicHttpSecurityMode.TransportCredentialOnly定数値を割り当てます。
-
-
既存の DDX ドキュメントを参照します。
- コンストラクターを使用して
BLOBオブジェクトを作成します。BLOBオブジェクトは、DDX ドキュメントを格納するために使用されます。 - コンストラクターを呼び出し、DDX ドキュメントのファイルの場所とファイルを開くモードを表す文字列値を渡すことによって、
System.IO.FileStreamオブジェクトを作成します。 System.IO.FileStreamオブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStreamオブジェクトのLengthプロパティを取得することでバイト配列のサイズを決定することができます。System.IO.FileStreamオブジェクトのReadメソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。MTOMプロパティにバイト配列の内容を割り当てて、BLOBオブジェクトに入力します。
- コンストラクターを使用して
-
XDP ドキュメントを参照します。
- 入力 XDP ファイルごとに、コンストラクタ―を使用して
BLOBオブジェクトを作成します。このBLOBオブジェクトは、入力ファイルを格納するために使用されます。 - コンストラクターを呼び出し、入力ファイルのファイルの場所とファイルを開くモードを表す文字列値を渡すことによって、
System.IO.FileStreamオブジェクトを作成します。 System.IO.FileStreamオブジェクトのコンテンツを格納するバイト配列を作成します。System.IO.FileStreamオブジェクトのLengthプロパティを取得することでバイト配列のサイズを決定することができます。System.IO.FileStreamオブジェクトのReadメソッドを呼び出して、バイト配列にストリームデータを入力します。読み取り対象のバイト配列、開始位置、ストリーム長を渡します。MTOMフィールドにバイト配列の内容を割り当てて、BLOBオブジェクトにデータを入力します。MyMapOf_xsd_string_To_xsd_anyTypeオブジェクトを作成します。このコレクションオブジェクトは、XDP ドキュメントの作成に必要な入力ファイルを格納するために使用されます。- 入力ファイルごとに、
MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトを作成します。 MyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトのkeyフィールドにキー名を表す文字列値を入力します。この値は、DDX ドキュメントで指定された要素の値と一致する必要があります（このタスクは入力 XDP ファイルごとに実行します）。- 入力ファイルを格納する
BLOBオブジェクトをMyMapOf_xsd_string_To_xsd_anyType_Itemオブジェクトのvalueフィールドに割り当てます（このタスクは入力 XDP ファイルごとに実行します）。 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オブジェクトを渡します（このタスクは入力 XDP ドキュメントごとに実行します）。
- 入力 XDP ファイルごとに、コンストラクタ―を使用して
-
実行時オプションを設定します。
- ランタイムオプションを格納する
AssemblerOptionSpecオブジェクトをコンストラクタで作成します。 AssemblerOptionSpecオブジェクトに属するデータメンバーに値を割り当てることで、ビジネス要件に応じたランタイムオプションを設定します。例えば、エラーが発生した場合にジョブの処理を続行するように Assembler サービスに指示するには、falseをAssemblerOptionSpecオブジェクトのfailOnErrorデータメンバーに割り当てます。
- ランタイムオプションを格納する
-
複数の XDP ドキュメントをアセンブリします。
AssemblerServiceClientオブジェクトのinvokeDDXメソッドを呼び出して、以下の値を渡します。- DDX ドキュメントを表す
BLOBオブジェクト - 必要なファイルを含む
MyMapOf_xsd_string_To_xsd_anyTypeオブジェクト - 実行時オプションを指定する
AssemblerOptionSpecオブジェクト
invokeDDXメソッドは、ジョブの結果と例外（発生した場合）を含むAssemblerResultオブジェクトを返します。 - DDX ドキュメントを表す
-
アセンブルされた XDP ドキュメントを取得します。
新しく作成した XDP ドキュメントを取得するには、次の操作を実行します。
AssemblerResultオブジェクトのdocumentsフィールドにアクセスします。これは、結果の PDF ドキュメントを格納するMapオブジェクトです。Mapオブジェクトを反復処理して各結果ドキュメントを取得します。次に、その配列メンバーのvalueをBLOBにキャストします。BLOBオブジェクトのMTOMプロパティにアクセスして、PDF ドキュメントを表すバイナリデータを抽出します。XDP ファイルに書き出すことができるバイトの配列を返します。
