在AEM Forms中使用輸出和Forms服務進行開發 developing-with-output-and-forms-services-in-aem-forms
瞭解如何使用AEM Forms中的輸出和Forms服務API進行開發。
在本文中，我們將瞭解以下內容
- 輸出服務 — 通常此服務是用來合併xml資料與xdp範本或pdf以產生平面化pdf。
- FormsService — 這是功能非常廣泛的服務，可讓您將xdp轉譯為pdf，以及將資料從和PDF檔案匯出/匯入。
下列程式碼片段會從PDF檔案匯出資料
javax.servlet.http.Part pdfPart = request.getPart("pdffile");
String filePath = request.getParameter("saveLocation");
java.io.InputStream pdfIS = pdfPart.getInputStream();
com.adobe.aemfd.docmanager.Document pdfDocument = new com.adobe.aemfd.docmanager.Document(pdfIS);
com.adobe.fd.forms.api.FormsService formsservice = sling.getService(com.adobe.fd.forms.api.FormsService.class);
com.adobe.aemfd.docmanager.Document xmlDocument = formsservice.exportData(pdfDocument,com.adobe.fd.forms.api.DataFormat.Auto);
第1行會從請求中擷取PDF檔案
Line2會從請求中擷取saveLocation
第5行取得FormsService
第6行會從PDF檔案匯出xmlData
若要在您的系統上測試範例封裝
安裝套件後，您必須在AdobeGranite CSRF篩選中允許列出下列URL。
- 請依照下列步驟操作，將上述路徑加入允許清單。
- 登入configMgr
- 搜尋AdobeGranite CSRF篩選器
- 在排除的區段中新增下列3個路徑並儲存
- /content/AemFormsSamples/mergedata
- /content/AemFormsSamples/exportdata
- /content/AemFormsSamples/outputservice
- /content/AemFormsSamples/renderxdp
- 搜尋「Sling查閱者篩選器」
- 勾選「允許空白」核取方塊。 （此設定僅供測試之用）
測試樣本
測試範常式式碼的方法有很多種。 最快捷、最輕鬆的方式就是使用Postman應用程式。 Postman可讓您向伺服器發出POST要求。
- 在您的系統上安裝Postman app 。
- 啟動應用程式並輸入適當的URL
- 確定您已從下拉式清單中選取「POST」
- 請務必將「授權」指定為「基本驗證」。 指定AEM伺服器使用者名稱和密碼
- 在body標籤中指定請求引數
- 按一下傳送按鈕
此套件包含4個範例。 以下段落說明何時使用輸出服務或Forms服務、服務的URL、每個服務預期的輸入引數
使用OutputService將資料與xdp範本合併
-
使用輸出服務將資料與xdp或pdf檔案合併，以產生平面化pdf
-
POSTURL： http://localhost:4502/content/AemFormsSamples/outputservice.html
-
要求引數 —
- xdp_or_pdf_file ：您要合併資料的xdp或pdf檔案
- xmlfile：與xdp_or_pdf_file合併的xml資料檔
- saveLocation：將演算後的檔案儲存在檔案系統上的位置。 例如c：\documents\sample.pdf
使用FormsService API
匯入資料
-
使用FormsService importData將資料匯入PDF檔案
-
POSTURL - http://localhost:4502/content/AemFormsSamples/mergedata.html
-
要求引數：
- pdf檔案 ：您要與它合併資料的pdf檔案
- xmlfile：與pdf檔案合併的xml資料檔
- saveLocation：將演算後的檔案儲存在檔案系統上的位置。 例如
c:\\outputsample.pdf。
匯出資料
-
使用FormsService exportData API從PDF檔案匯出資料
-
POSTURL - http://localhost:4502/content/AemFormsSamples/exportdata.html
-
要求引數：
- pdf檔案 ：您要匯出資料的pdf檔案
- saveLocation：將匯出的資料儲存在檔案系統上的位置。 例如c：\documents\exported_data.xml
轉譯XDP
- 將XDP範本轉譯為靜態/動態pdf
- 使用FormsService renderPDFForm API將xdp範本轉譯為PDF
- POSTURL - http://localhost:4502/content/AemFormsSamples/renderxdp?xdpName=f1040.xdp
- 要求引數：
- xdpName：要呈現為pdf的xdp檔案的名稱
recommendation-more-help
8de24117-1378-413c-a581-01e660b7163e