將Word文檔轉換為PDF文檔
本節說明如何使用「產生PDFAPI」,以程式設計方式將Microsoft Word檔案轉換為PDF檔案。
步驟摘要
要將Microsoft Word文檔轉換為PDF文檔,請執行以下任務:
- 包含專案檔案。
- 建立「生成PDF」客戶端。
- 檢索要轉換為PDF文檔的檔案。
- 將檔案轉換為PDF文檔。
- 檢索結果。
包含項目檔案
在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
建立生成PDF客戶端
在以寫程式方式執行「生成PDF」操作之前,請建立「生成PDF」服務客戶端。 如果您使用Java API,請建立 GeneratePdfServiceClient 物件。 如果您使用網站服務API,請建立 GeneratePDFServiceService 物件。
檢索要轉換為PDF文檔的檔案
檢索Microsoft Word文檔以轉換為PDF文檔。
將檔案轉換為PDF文檔
建立「生成PDF」服務客戶端後,可以調用 createPDF2 方法。 此方法需要有關要轉換的文檔的資訊,包括副檔名。
擷取結果
將檔案轉換為PDF文檔後,可以檢索結果。 例如,將Word檔案轉換為PDF文檔後,可以檢索並保存PDF文檔。
另請參閱
使用Java API將Word文檔轉換為PDF文檔
使用「產生MicrosoftAPI(Java)」將PDF Word檔案轉換為PDF檔案:
-
包含專案檔案。
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-generatepdf-client.jar。
-
建立「生成PDF」客戶端。
- 建立
ServiceClientFactory包含連接屬性的對象。 - 建立
GeneratePdfServiceClient對象,使用其建構子並傳遞ServiceClientFactory物件。
- 建立
-
檢索要轉換為PDF文檔的檔案。
- 建立
java.io.FileInputStream使用其建構子表示要轉換的Word檔案的對象。 傳遞指定檔案位置的字串值。 - 建立
com.adobe.idp.Document對象,使用其建構子並傳遞java.io.FileInputStream物件。
- 建立
-
將檔案轉換為PDF文檔。
調用
GeneratePdfServiceClient物件createPDF2方法並傳遞下列值:- A
com.adobe.idp.Document表示要轉換的檔案的對象。 - A
java.lang.String包含副檔名的物件。 - A
java.lang.String包含要用於轉換的檔案類型設定的物件。 檔案類型設定提供不同檔案類型(如.doc或.xls)的轉換設定。 - A
java.lang.String包含要使用的PDF設定名稱的物件。 例如,您可以指定Standard. - A
java.lang.String包含要使用的安全設定名稱的對象。 - 可選
com.adobe.idp.Document包含在生成PDF文檔時要應用的設定的對象。 - 可選
com.adobe.idp.Document包含要應用到PDF文檔的元資料資訊的對象。
此
createPDF2方法傳回CreatePDFResult包含新PDF文檔和日誌資訊的對象。 記錄檔通常包含轉換請求產生的錯誤或警告訊息。 - A
-
檢索結果。
要獲取PDF文檔,請執行以下操作:
- 叫用
CreatePDFResult物件getCreatedDocument方法,返回com.adobe.idp.Document物件。 - 叫用
com.adobe.idp.Document物件copyToFile方法,從上一步中建立的物件中擷取PDF檔案。
如果您使用
createPDF2要獲取日誌文檔的方法(不適用於HTML轉換),請執行以下操作:- 叫用
CreatePDFResult物件getLogDocument方法。 這會傳回com.adobe.idp.Document物件。 - 叫用
com.adobe.idp.Document物件copyToFile方法來擷取記錄檔。
- 叫用
使用Web服務API將Word文檔轉換為PDF文檔
使用「產生MicrosoftAPI」(Web服務)將PDF Word檔案轉換為PDF檔案:
-
包含專案檔案。
建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義:
http://localhost:8080/soap/services/GeneratePDFService?WSDL&lc_version=9.0.1.注意
取代localhost和托管AEM Forms之伺服器的IP位址。 -
建立「生成PDF」客戶端。
-
建立
GeneratePDFServiceClient物件,使用其預設建構函式。 -
建立
GeneratePDFServiceClient.Endpoint.Address物件,使用System.ServiceModel.EndpointAddress建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如http://localhost:8080/soap/services/GeneratePDFService?blob=mtom.) 您不需要使用lc_version屬性。 不過,請指定?blob=mtom. -
建立
System.ServiceModel.BasicHttpBinding物件,方法是取得GeneratePDFServiceClient.Endpoint.Binding欄位。 將傳回值轉換為BasicHttpBinding. -
設定
System.ServiceModel.BasicHttpBinding物件MessageEncoding欄位至WSMessageEncoding.Mtom. 此值可確保使用MTOM。 -
通過執行以下任務來啟用基本HTTP身份驗證:
- 將AEM表單使用者名稱指派給欄位
GeneratePDFServiceClient.ClientCredentials.UserName.UserName. - 為欄位分配相應的密碼值
GeneratePDFServiceClient.ClientCredentials.UserName.Password. - 指派常數值
HttpClientCredentialType.Basic欄位BasicHttpBindingSecurity.Transport.ClientCredentialType. - 指派常數值
BasicHttpSecurityMode.TransportCredentialOnly欄位BasicHttpBindingSecurity.Security.Mode.
- 將AEM表單使用者名稱指派給欄位
-
-
檢索要轉換為PDF文檔的檔案。
- 建立
BLOB物件,使用其建構子。 此BLOB對象用於儲存要轉換為PDF文檔的檔案。 - 建立
System.IO.FileStream對象,方法是調用其建構子。 傳遞一個字串值,該字串值表示要轉換的檔案的檔案位置以及開啟檔案的模式。 - 建立位元組陣列,用於儲存
System.IO.FileStream物件。 您可以取得System.IO.FileStream物件Length屬性。 - 叫用
System.IO.FileStream物件Read方法,並傳遞位元組陣列、起始位置及流長度以讀取。 - 填入
BLOB對象,通過為其分配MTOM屬性位元組陣列的內容。
- 建立
-
將檔案轉換為PDF文檔。
調用
GeneratePDFServiceService物件CreatePDF2方法並傳遞下列值:- A
BLOB表示要轉換的檔案的物件。 - 包含副檔名的字串。
- A
java.lang.String包含要用於轉換的檔案類型設定的物件。 檔案類型設定提供不同檔案類型(如.doc或.xls)的轉換設定。 - 包含要使用的PDF設定的字串物件。 您可以指定
Standard. - 包含要使用的安全設定的字串對象。 您可以指定
No Security. - 可選
BLOB包含在生成PDF文檔時要應用的設定的對象。 - 可選
BLOB包含要應用到PDF文檔的元資料資訊的對象。 - 類型的輸出參數
BLOB由CreatePDF2方法。 此CreatePDF2方法會以轉換的檔案填入此物件。 (此參數值僅對於Web服務調用是必需的)。 - 類型的輸出參數
BLOB由CreatePDF2方法。 此CreatePDF2方法會以記錄檔填入此物件。 (此參數值僅對於Web服務調用是必需的)。
- A
-
檢索結果。
- 通過分配
BLOB物件MTOM欄位至位元組陣列。 位元組陣清單示轉換的PDF文檔。 請確定您使用BLOB用作createPDF2方法。 - 建立
System.IO.FileStream對象,方法是調用其建構子並傳遞一個字串值,該字串值表示已轉換PDF文檔的檔案位置。 - 建立
System.IO.BinaryWriter對象,調用其建構子並傳遞System.IO.FileStream物件。 - 調用
System.IO.BinaryWriter物件Write方法,並傳遞位元組陣列。
- 通過分配
將HTML文檔轉換為PDF文檔
本節說明如何使用「產生PDFAPI」,以程式設計方式將HTML檔案轉換為PDF檔案。
步驟摘要
要將HTML文檔轉換為PDF文檔,請執行以下任務:
- 包含專案檔案。
- 建立「生成PDF」客戶端。
- 檢索要轉換為HTML文檔的PDF內容。
- 將HTML內容轉換為PDF文檔。
- 檢索結果。
包含項目檔案
在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
建立生成PDF客戶端
在以寫程式方式執行「生成PDF」操作之前,必須建立「生成PDF」服務客戶端。 如果您使用Java API,請建立 GeneratePdfServiceClient 物件。 如果您使用網站服務API,請建立 GeneratePDFServiceService.
檢索要轉換為HTML文檔的PDF內容
參考要轉換為HTML文檔的PDF內容。 您可以參考HTML內容,例如HTML檔案或HTML內容,可透過URL存取。
將HTML內容轉換為PDF文檔
建立服務客戶端後,可以調用相應的PDF建立操作。 此操作需要有關要轉換的文檔的資訊,包括目標文檔的路徑。
擷取結果
將HTML內容轉換為PDF文檔後,可以檢索結果並保存PDF文檔。
另請參閱
使用Java API將HTML內容轉換為PDF檔案
使用「生成HTMLAPI(Java)」將PDF文檔轉換為PDF文檔:
-
包含專案檔案。
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-generatepdf-client.jar。
-
建立「生成PDF」客戶端。
建立
GeneratePdfServiceClient對象,使用其建構子並傳遞ServiceClientFactory包含連接屬性的對象。 -
檢索要轉換為HTML文檔的PDF內容。
建立字串變數並指派指向HTML內容的URL,以擷取HTML內容。
-
將HTML內容轉換為PDF文檔。
叫用
GeneratePdfServiceClient物件htmlToPDF2方法,並傳遞下列值:- A
java.lang.String包含要轉換的HTML檔案URL的物件。 - A
java.lang.String包含要用於轉換的檔案類型設定的物件。 檔案類型設定可以包含尖峰層級。 - A
java.lang.String包含要使用的安全設定名稱的對象。 - 可選
com.adobe.idp.Document包含在生成PDF文檔時要應用的設定的對象。 如果未提供此資訊,則會根據前三個參數自動選擇設定。 - 可選
com.adobe.idp.Document包含要應用到PDF文檔的元資料資訊的對象。
- A
-
檢索結果。
此
htmlToPDF2方法傳回HtmlToPdfResult包含已生成的新PDF文檔的對象。 要獲取新建立的PDF文檔,請執行以下操作:- 叫用
HtmlToPdfResult物件getCreatedDocument方法。 這會傳回com.adobe.idp.Document物件。 - 叫用
com.adobe.idp.Document物件copyToFile方法,從上一步中建立的物件中擷取PDF檔案。
- 叫用
使用Web服務API將HTML內容轉換為PDF文檔
使用「產生HTMLAPI」(網站服務)將PDF內容轉換為PDF檔案:
-
包含專案檔案。
建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義:
http://localhost:8080/soap/services/GeneratePDFService?WSDL&lc_version=9.0.1.注意
取代localhost和托管AEM Forms之伺服器的IP位址。 -
建立「生成PDF」客戶端。
-
建立
GeneratePDFServiceClient物件,使用其預設建構函式。 -
建立
GeneratePDFServiceClient.Endpoint.Address物件,使用System.ServiceModel.EndpointAddress建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如http://localhost:8080/soap/services/GeneratePDFService?blob=mtom.) 您不需要使用lc_version屬性。 不過,請指定?blob=mtom. -
建立
System.ServiceModel.BasicHttpBinding物件,方法是取得GeneratePDFServiceClient.Endpoint.Binding欄位。 將傳回值轉換為BasicHttpBinding. -
設定
System.ServiceModel.BasicHttpBinding物件MessageEncoding欄位至WSMessageEncoding.Mtom. 此值可確保使用MTOM。 -
通過執行以下任務來啟用基本HTTP身份驗證:
- 將AEM表單使用者名稱指派給欄位
GeneratePDFServiceClient.ClientCredentials.UserName.UserName. - 為欄位分配相應的密碼值
GeneratePDFServiceClient.ClientCredentials.UserName.Password. - 指派常數值
HttpClientCredentialType.Basic欄位BasicHttpBindingSecurity.Transport.ClientCredentialType. - 指派常數值
BasicHttpSecurityMode.TransportCredentialOnly欄位BasicHttpBindingSecurity.Security.Mode.
- 將AEM表單使用者名稱指派給欄位
-
-
檢索要轉換為HTML文檔的PDF內容。
建立字串變數並指派指向HTML內容的URL,以擷取HTML內容。
-
將HTML內容轉換為PDF文檔。
調用以下命令,將HTML內容轉換為PDF文檔
GeneratePDFServiceService物件HtmlToPDF2方法,並傳遞下列值:- 包含要轉換的HTML內容的字串。
- A
java.lang.String包含要用於轉換的檔案類型設定的物件。 - 包含要使用的安全設定的字串對象。
- 可選
BLOB包含在生成PDF文檔時要應用的設定的對象。 - 可選
BLOB包含要應用到PDF文檔的元資料資訊的對象。 - 類型的輸出參數
BLOB由CreatePDF2方法。 此CreatePDF2方法會以轉換的檔案填入此物件。 (此參數值僅對於Web服務調用是必需的)。
-
檢索結果。
- 通過分配
BLOB物件MTOM欄位至位元組陣列。 位元組陣清單示轉換的PDF文檔。 請確定您使用BLOB用作HtmlToPDF2方法。 - 建立
System.IO.FileStream對象,方法是調用其建構子並傳遞一個字串值,該字串值表示已轉換PDF文檔的檔案位置。 - 建立
System.IO.BinaryWriter對象,調用其建構子並傳遞System.IO.FileStream物件。 - 調用
System.IO.BinaryWriter物件Write方法,並傳遞位元組陣列。
- 通過分配
將PDF文檔轉換為非影像格式
本節介紹如何使用生成PDFJava API和Web服務API,以寫程式方式將PDF文檔轉換為RTF檔案,這是非影像格式的示例。 其他非影像格式包括HTML、文字、DOC和EPS。 將PDF文檔轉換為RTF時,請確保PDF文檔不包含表單元素,如提交按鈕。 表單元素不會轉換。
步驟摘要
要將PDF文檔轉換為任何支援的類型,請執行以下步驟:
- 包含專案檔案。
- 建立「生成PDF」客戶端。
- 檢索要轉換的PDF文檔。
- 轉換PDF文檔。
- 儲存轉換的檔案。
包含項目檔案
在您的開發專案中加入必要的檔案。 如果要使用Java建立客戶端應用程式,請包括必要的JAR檔案。 如果您使用Web服務,請確定您包含Proxy檔案。
建立生成PDF客戶端
在以寫程式方式執行「生成PDF」操作之前,必須建立「生成PDF」服務客戶端。 如果您使用Java API,請建立 GeneratePdfServiceClient 物件。 如果您使用網站服務API,請建立 GeneratePDFServiceService 物件。
檢索要轉換的PDF文檔
檢索PDF文檔以轉換為非影像格式。
轉換PDF文檔
建立服務客戶端後,可以調用PDF導出操作。 此操作需要有關要轉換的文檔的資訊,包括目標文檔的路徑。
儲存轉換的檔案
儲存轉換的檔案。 例如,如果將PDF文檔轉換為RTF檔案,請將轉換的文檔保存為RTF檔案。
另請參閱
使用Java API將PDF文檔轉換為RTF檔案
使用生成PDFAPI(Java)將PDF文檔轉換為RTF檔案:
-
包含專案檔案。
在Java專案的類別路徑中包含用戶端JAR檔案,例如adobe-generatepdf-client.jar。
-
建立「生成PDF」客戶端。
建立
GeneratePdfServiceClient對象,使用其建構子並傳遞ServiceClientFactory包含連接屬性的對象。 -
檢索要轉換的PDF文檔。
- 建立
java.io.FileInputStream表示要使用其建構子轉換的PDF文檔的對象。 傳遞指定PDF文檔位置的字串值。 - 建立
com.adobe.idp.Document對象,使用其建構子並傳遞java.io.FileInputStream物件。
- 建立
-
轉換PDF文檔。
叫用
GeneratePdfServiceClient物件exportPDF2方法,並傳遞下列值:- A
com.adobe.idp.Document表示要轉換的PDF檔案的對象。 - A
java.lang.String包含要轉換的檔案名稱的對象。 - A
java.lang.String包含Adobe PDF設定名稱的物件。 - A
ConvertPDFFormatType指定轉換目標檔案類型的對象。 - 可選
com.adobe.idp.Document包含在生成PDF文檔時要應用的設定的對象。
此
exportPDF2方法傳回ExportPDFResult包含轉換檔案的物件。 - A
-
轉換PDF文檔。
要獲取新建立的檔案,請執行以下步驟:
- 叫用
ExportPDFResult物件getConvertedDocument方法。 這會傳回com.adobe.idp.Document物件。 - 叫用
com.adobe.idp.Document物件copyToFile方法來擷取新檔案。
- 叫用
使用Web服務API將PDF文檔轉換為RTF檔案
使用生成PDFAPI(Web服務)將PDF文檔轉換為RTF檔案:
-
包含專案檔案。
建立使用MTOM的Microsoft .NET專案。 確保使用以下WSDL定義:
http://localhost:8080/soap/services/GeneratePDFService?WSDL&lc_version=9.0.1.注意
取代localhost和托管AEM Forms之伺服器的IP位址。 -
建立生成PDf客戶端。
-
建立
GeneratePDFServiceClient物件,使用其預設建構函式。 -
建立
GeneratePDFServiceClient.Endpoint.Address物件,使用System.ServiceModel.EndpointAddress建構子。 將指定WSDL的字串值傳遞至AEM Forms服務(例如http://localhost:8080/soap/services/GeneratePDFService?blob=mtom.) 您不需要使用lc_version屬性。 不過,請指定?blob=mtom. -
建立
System.ServiceModel.BasicHttpBinding物件,方法是取得GeneratePDFServiceClient.Endpoint.Binding欄位。 將傳回值轉換為BasicHttpBinding. -
設定
System.ServiceModel.BasicHttpBinding物件MessageEncoding欄位至WSMessageEncoding.Mtom. 此值可確保使用MTOM。 -
通過執行以下任務來啟用基本HTTP身份驗證:
- 將AEM表單使用者名稱指派給欄位
GeneratePDFServiceClient.ClientCredentials.UserName.UserName. - 為欄位分配相應的密碼值
GeneratePDFServiceClient.ClientCredentials.UserName.Password. - 指派常數值
HttpClientCredentialType.Basic欄位BasicHttpBindingSecurity.Transport.ClientCredentialType. - 指派常數值
BasicHttpSecurityMode.TransportCredentialOnly欄位BasicHttpBindingSecurity.Security.Mode.
- 將AEM表單使用者名稱指派給欄位
-
-
檢索要轉換的PDF文檔。
- 建立
BLOB物件,使用其建構子。 此BLOB對象用於儲存轉換的PDF文檔。 - 建立
System.IO.FileStream對象,方法是調用其建構子並傳遞一個字串值,該字串值表示PDF文檔的檔案位置以及開啟檔案的模式。 - 建立位元組陣列,用於儲存
System.IO.FileStream物件。 您可以取得System.IO.FileStream物件Length屬性。 - 叫用
System.IO.FileStream物件Read方法,並傳遞位元組陣列、起始位置及流長度以讀取。 - 填入
BLOB對象,通過為其分配MTOM屬性位元組陣列的內容。
- 建立
-
轉換PDF文檔。
叫用
GeneratePDFServiceServiceWse物件ExportPDF2方法,並傳遞下列值:- A
BLOB表示要轉換的PDF檔案的對象。 - 包含要轉換的檔案路徑名的字串。
- A
java.lang.String指定檔案位置的對象。 - 指定轉換目標檔案類型的字串對象。 指定
RTF. - 可選
BLOB包含在生成PDF文檔時要應用的設定的對象。 - 類型的輸出參數
BLOB由ExportPDF2方法。 此ExportPDF2方法會以轉換的檔案填入此物件。 (此參數值僅對於Web服務調用是必需的)。
- A
-
儲存轉換的檔案。
- 通過分配
BLOB物件MTOM欄位至位元組陣列。 位元組陣清單示轉換的RTF文檔。 請確定您使用BLOB用作ExportPDF2方法。 - 建立
System.IO.FileStream對象,方法是調用其建構子。 傳遞表示RTF檔案位置的字串值。 - 建立
System.IO.BinaryWriter對象,調用其建構子並傳遞System.IO.FileStream物件。 - 調用
System.IO.BinaryWriter物件Write方法,並傳遞位元組陣列。
- 通過分配