組合多個XDP片段

您可以將多個XDP片段組合為單一XDP檔案。 例如，請考慮每個XDP檔案包含一個或多個用於建立健康表單的子表單的XDP片段。 下圖顯示大綱視圖（代表​組合多個XDP片段​快速啟動中使用的tuc018_template_gred.xdp檔案）:

下圖顯示病人區段（代表​組合多個XDP片段​快速啟動中使用的tuc018_contact.xdp檔案）:

下圖顯示病人健康區段（代表​組合多個XDP片段​快速啟動中使用的tuc018_patient.xdp檔案）:

此片段包含兩個名為​subPatientPhysical​和​subPatientHealth​的子表單。 這兩個子表單都在傳遞給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檔案，該檔案可用作添加XDP片段的容器，或作為按順序附加的多個文檔之一。 在這種情況下，XDP文檔僅用作容器（組合多個XDP片段​中的第一圖）。 也就是說，其他XDP檔案會放在XDP容器中。

對於每個子表單，您可以新增XDPContent元素（此元素為選用元素）。 在上述範例中，請注意有三個子表單：subPatientContact、subPatientPhysical和subPatientHealth。 subPatientPhysical子表單和subPatientHealth子表單都位於相同的XDP檔案tuc018_patient.xdp中。 片段元素指定子表單的名稱，如設計器中所定義。

步驟摘要

要組合多個XDP片段，請執行以下任務：

1. 包含專案檔案。
2. 建立PDF匯寫程式式用戶端。
3. 參考現有的DDX檔案。
4. 參考XDP檔案。
5. 設定執行時期選項。
6. 組合多個XDP檔案。
7. 檢索已裝配的XDP文檔。

包含專案檔案

在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式，請包括必要的JAR檔案。 如果您使用web services，請確定您包含proxy檔案。

必須將下列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匯寫程式式用戶端

在以寫程式方式執行匯編器操作之前，請建立匯編器服務客戶端。

參考現有的DDX檔案

必須引用DDX文檔才能組合多個XDP文檔。 此DDX文檔必須包含XDP result、XDP source和XDPContent元素。

參考XDP檔案

要組合多個XDP文檔，請參考用於組合結果XDP文檔的所有XDP檔案。 確保在fragment屬性中指定了source屬性所引用的XDP文檔中包含的子表單的名稱。 子表單是在設計器中定義的。 例如，請考慮以下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服務，例如「輸出」。

另請參閱

使用Java API組合多個XDP片段

使用web service API組合多個XDP片段

包含AEM Forms Java程式庫檔案

設定連接屬性

以程式設計方式組合PDF檔案

使用片段建立PDF檔案

使用Java API組合多個XDP片段

使用Assembler Service API(Java)組合多個XDP片段：

1. 包含專案檔案。

   在Java專案的類別路徑中包含用戶端JAR檔案，例如adobe-assembler-client.jar。

2. 建立PDF匯寫程式式用戶端。

   • 建立包含連接屬性的ServiceClientFactory對象。
   • 使用其建構子並傳遞ServiceClientFactory對象，建立AssemblerServiceClient對象。

3. 參考現有的DDX檔案。

   • 使用DDX文檔的建構子並傳遞指定DDX檔案位置的字串值，建立代表DDX文檔的java.io.FileInputStream對象。
   • 使用其建構子並傳遞java.io.FileInputStream對象，建立com.adobe.idp.Document對象。

4. 參考XDP檔案。

   • 使用HashMap建構函式建立java.util.Map物件，用來儲存輸入的XDP檔案。

   • 建立com.adobe.idp.Document對象並傳遞包含輸入XDP檔案的java.io.FileInputStream對象（對每個XDP檔案重複此任務）。

   • 通過調用put方法並傳遞以下參數，將條目添加到java.util.Map對象：

     • 代表索引鍵名稱的字串值。 此值必須與DDX文檔中指定的source元素值匹配（對每個XDP檔案重複此任務）。
     • 包含與source元素對應的XDP文檔的com.adobe.idp.Document對象（對每個XDP檔案重複此任務）。

5. 設定執行時期選項。

   • 使用其建構子建立一個AssemblerOptionSpec對象，該對象儲存運行時選項。
   • 通過調用屬於AssemblerOptionSpec對象的方法，設定運行時選項以滿足您的業務要求。 例如，若要指示Assembler服務在發生錯誤時繼續處理作業，請叫用AssemblerOptionSpec物件的setFailOnError方法並傳遞false。

6. 組合多個XDP檔案。

   叫用AssemblerServiceClient物件的invokeDDX方法並傳遞下列必要值：

   • com.adobe.idp.Document物件，代表要使用的DDX檔案
   • 包含輸入XDP檔案的java.util.Map對象
   • com.adobe.livecycle.assembler.client.AssemblerOptionSpec物件，指定執行時間選項，包括預設字型和工作記錄層級

   invokeDDX方法返回包含已裝配的XDP文檔的com.adobe.livecycle.assembler.client.AssemblerResult對象。

7. 檢索已裝配的XDP文檔。

   要獲取已裝配的XDP文檔，請執行以下操作：

   • 叫用AssemblerResult物件的getDocuments方法。 此方法返回java.util.Map對象。
   • 重複java.util.Map物件，直到找到結果com.adobe.idp.Document物件。
   • 叫用com.adobe.idp.Document物件的copyToFile方法，擷取已組合的XDP檔案。

另請參閱

組合多個XDP片
段快速啟動（SOAP模式）:使用Java
API組合多個XDP片段（包括AEM Forms Java程式庫檔案）設
定連線屬性

使用web service API組合多個XDP片段

使用Assembler Service API(web service)組合多個XDP片段：

1. 包含專案檔案。

   建立使用MTOM的Microsoft .NET專案。 在設定服務引用時，請確保使用以下WSDL定義：

    https://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服務，例如https://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表單使用者名稱指派至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對象的建構子並傳遞一個字串值來建立<a0/>對象，該字串值表示DDX文檔的檔案位置和開啟檔案的模式。
   • 建立儲存System.IO.FileStream對象內容的位元組陣列。 您可以取得System.IO.FileStream物件的Length屬性，以判斷位元組陣列的大小。
   • 呼叫System.IO.FileStream物件的Read方法，以串流資料填入位元組陣列。 傳遞要讀取的位元組陣列、起始位置和串流長度。
   • 通過為MTOM對象的<a1/>屬性指定位元組陣列的內容來填充BLOB對象。

4. 參考XDP檔案。

   • 對於每個輸入的XDP檔案，使用其建構子建立BLOB對象。 BLOB對象用於儲存輸入檔案。
   • 通過調用System.IO.FileStream對象的建構子並傳遞一個字串值來建立<a0/>對象，該字串值表示輸入檔案的檔案位置以及開啟檔案的模式。
   • 建立儲存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文檔執行此任務。）

5. 設定執行時期選項。

   • 使用其建構子建立一個AssemblerOptionSpec對象，該對象儲存運行時選項。
   • 通過為屬於AssemblerOptionSpec對象的資料成員分配值，設定運行時選項以滿足您的業務要求。 例如，要指示Assembler服務在出現錯誤時繼續處理作業，請將false分配給AssemblerOptionSpec對象的failOnError資料成員。

6. 組合多個XDP檔案。

   叫用AssemblerServiceClient物件的invokeDDX方法並傳遞下列值：

   • 代表DDX文檔的BLOB對象
   • 包含所需檔案的MyMapOf_xsd_string_To_xsd_anyType對象
   • 指定運行時選項的AssemblerOptionSpec對象

   invokeDDX方法返回一個AssemblerResult對象，該對象包含作業的結果和發生的任何例外。

7. 檢索已裝配的XDP文檔。

   要獲取新建立的XDP文檔，請執行以下操作：

   • 存取AssemblerResult物件的documents欄位，此欄位是Map物件，包含產生的PDF檔案。
   • 重複Map物件，以取得每個結果檔案。 然後，將該陣列成員的value轉換為BLOB。
   • 存取PDF檔案的BLOB物件的MTOM屬性，擷取代表PDF檔案的二進位資料。 這會傳回可寫出至XDP檔案的位元組陣列。

另請參閱

組合多個XDP片
段使用MTOM叫用AEM表單