Adobe Experience Manager （預覽版）
Adobe Experience Manager整合可讓您存取Adobe Experience Manager Forms相關服務（例如通訊等）。 此整合也將允許在透過Adobe Experience Manager Forms提交表單時觸發流程。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Adobe Experience Manager Forms |
| URL | https://www.adobe.com/go/adobe-experience-manager-forms-community |
| aem-pa@adobe.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Adobe |
| 網站 | https://business.adobe.com/products/experience-manager/forms/aem-forms.html |
| 隱私策略 | https://www.adobe.com/in/privacy/policy.html |
| 類別 | 生產力;企業管理 |
您可以使用Adobe Experience Manager聯結器存取 Adobe Experience Manager Forms - Communication功能 ，以建立以表單設計和XML表單資料為基礎的PDF檔案，或建立PostScript（PS）、印表機命令語言（PCL）、Zebra列印語言（ZPL）和其他印表機定義語言檔案。
先決條件
您需要授權和 Adobe Experience Manager Forms as a Cloud Service — 通訊API 的存取權，才能使用聯結器。
如何取得認證
您只需幾個步驟即可輕鬆開始使用 Adobe Experience Manager：
產生服務認證
使用Adobe Experience Manager Developer Console來 產生 服務認證。
設定連線
將您的服務認證新增至Adobe Experience Manager Connector。 您可以從服務認證 JSON 取得認證，並將這些認證詳細資料複製到您的一次性連線設定：
- 組織識別碼
- 用戶端識別碼
- 用戶端密碼
- 技術帳戶 ID
- 元範圍
- 私密金鑰
- Adobe IMS主機URL
針對AEM伺服器，請指定Adobe Experience Manager Cloud Service作者或發佈執行個體的URL。 例如， https://publish-pXXXX-eXXXXX.adobeaemcloud.com
開始使用連接器
連接器支援下列作業：
從範本產生 PDF 文件並合併資料
您可以建立以表單設計和XML表單資料為基礎的PDF檔案。 它可協助您建立品牌認可、個人化和標準化的文件，例如商務信函、報表、索賠處理信函、福利通知、每月帳單或歡迎套件。
基本工作流程是將XML表單資料與表單設計合併，以建立PDF檔案。 您可以在 Adobe Experience Manager Forms Designer中建立範本。
作業的輸出是非互動式 PDF 文件。 也就是說，使用者無法輸入或修改表單資料。 您可以指定下列參數來設定作業的各種選項：
| 參數 | 必填 （必要） | Description |
|---|---|---|
| Template | Yes | 範本會定義 PDF 文件的外觀和行為。 API支援以下格式的範本：XDP和PDF檔案。 您可以指定完整路徑、Adobe Experience Manager存放庫的參考路徑或二進位檔案。 |
| 資料 | Yes | 包含要與範本合併的資料的 XML 檔案。 您可以指定完整 HTTP 位置或二進位檔。 |
| XCI 組態 | 否 | 此服務會使用 XCI 組態檔來設定 PDF 文件的各種內容。 只有在範本型別為XDP或XDP型PDF檔案時，XCI引數才會生效。 您可以指定完整路徑、Adobe Experience Manager存放庫的參考路徑或二進位檔案。 |
| Locale | 否 | 應轉譯 pdf 的地區設定。 |
| 內容根目錄 | 否 | 範本資源（影像、片段等）的位置。 此路徑相對於範本位置。 |
| 將標籤新增至 PDF | 否 | 指定以建立具有標籤的 PDF，以最佳化它以與螢幕助讀程式和其他輔助技術搭配使用。 |
| 將字體內嵌至 PDF | 否 | 當您內嵌字體時，內嵌字體在所有裝置上看起來也相同，但會產生較大的輸出檔案。 |
| 線性化 PDF（快速 Web 視圖） | 否 | 選擇優化 PDF 以實現快速 Web 檢視 |
| 保留狀態 | 否 | 互動式 PDF 文件包含構成表單的各種元素。 這些元素可能包括欄位（用於接受或顯示資料）、按鈕（用於觸發事件）和腳本（用於執行特定操作的命令）。 按一下按鈕可能會觸發變更欄位狀態的事件。 例如，選擇性別選項可能會變更欄位的顏色或表單的外觀。 這是導致表單狀態變更的手動事件範例。 使用Adobe Experience Manager Forms通訊功能平面化這類互動式PDF檔案時，不會保留表單的狀態。 若要確保即使在表單平面化之後仍會保留表單的狀態，請將布林值 Retain state 設定為 True 以儲存和保留表單的狀態。 |
| 保留未簽署的簽名欄位 | 否 | 指定平面化 PDF 檔案時是否保留已簽署和未簽署的簽名欄位 |
| Adobe Acrobat Reader 版本 | 否 | 指定開啟 PDF 文件所需的最低 Acrobat Reader 版本。 預設版本為 Adobe Acrobat 11。 |
從範本和資料產生 PostScript （PS）、印表機命令語言 （PCL）、Zebra 列印語言 （ZPL）、DPL（Datamax 程式設計語言）、IPL（Intermec 印表機語言）、TPCL（TEC 印表機命令語言）檔案
您可以使用文件產生 API 來建立以 XDP 表單設計或 PDF 文件為基礎的 PostScript （PS）、印表機命令語言 （PCL）、Zebra 列印語言 （ZPL）、DPL （Datamax 程式設計語言）、IPL （Intermec 印表機語言）、TPCL （TEC 印表機命令語言） 文件。 這些API有助於將表單設計與表單資料合併以產生檔案。 您可以將文件儲存至檔案，並使用 Power Automate 將其傳送至印表機。 您可以指定下列參數來設定作業的各種選項：
| 參數 | 必填 （必要） | Description |
|---|---|---|
| Template | Yes | 範本會定義 PDF 文件的外觀和行為。 API支援以下格式的範本：XDP和PDF檔案。 您可以指定完整路徑、Adobe Experience Manager存放庫的參考路徑或二進位檔案。 |
| 資料 | Yes | 包含要與範本合併的資料的 XML 檔案。 您可以指定完整 HTTP 位置或二進位檔。 |
| 印表機設定檔 | Yes | 指定要使用的XDC檔案。 XDC檔案是XML格式的印表機描述檔案。 Adobe Experience Manager Forms Communications功能會使用XDC檔案將檔案輸出為PostScript、PCL、DPL、TPCL和ZPL等格式。 XDC 檔案也可用來指定列印選項，例如份數、是否使用雙面印表機或裝訂器選項。 |
| 輸出類型 | Yes | 指定作業的輸出檔案類型。 支援的選項包括 PostScript （PS）、印表機命令語言 （PCL）、Zebra 列印語言 （ZPL）、DPL（Datamax 程式設計語言）、IPL（Intermec 印表機語言）、TPCL（TEC 印表機命令語言）。 |
| XCI 組態 | 否 | 指定要使用的 XCI 檔案。 XCI 檔案可用來描述用於表單設計元素的字型。 您可以指定完整路徑、Adobe Experience Manager存放庫的參考路徑或二進位檔案。 |
| Locale | 否 | 應轉譯輸出的地區設定。 |
| 內容根目錄 | 否 | 範本資源（影像、片段等）的位置。此路徑相對於範本位置。 |
| 份數 | 否 | 指定要產生的輸出檔案副本數。 |
| 分頁 | 否 | 指定是使用雙面列印還是單面列印。 支援 PostScript 和 PCL 的印表機會使用此值。 |
常見錯誤和補救措施
| 錯誤碼 | Description | 解決辦法 |
|---|---|---|
| 403 | 禁止。 您應該是forms-users群組的成員，才能使用API。 | 將技術帳戶設為forms-users群組的成員，同時發佈使用者（技術帳戶）和群組（forms-users）。 |
| 400 | 指定的範本無效。 指定有效的範本，然後重試。 | 當參數的 template 值是純文字而非 URL 時，請將資料 xml 字串轉換為二進位檔。 您可以使用 Microsoft Power Automate 的 binary（） 運算式 來進行轉換。 當您使用JCR路徑時，請將 crx:// 字首新增至路徑。 |
| 400 | 指定的資料無效。 使用有效的資料檔案重試。 | 當參數的 data 值是純文字而非 URL 時，請將資料 xml 字串轉換為二進位檔。 您可以使用 Microsoft Power Automate 的 binary（） 運算式 來進行轉換。 |
| 400 | 指定的 XCI 配置包含一些無效的值。 修復配置文件並重試。 | 當參數的 XCI configuration 值是純文字而非 URL 時，請將資料 xml 字串轉換為二進位檔。 您可以使用 Microsoft Power Automate 的 binary（） 運算式 來進行轉換 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| AEM伺服器 | 字串 | 指定AEM作者或發佈執行個體的URL。 | 對 |
| 組織 ID （組織） | 字串 | 指定您的組織 ID。 | 對 |
| 用戶端識別碼 （clientId） | 字串 | 從您的服務認證中指定用戶端識別碼。 | 對 |
| 用戶端密碼 （clientSecret） | securestring | 從您的服務認證中指定用戶端密碼。 | 對 |
| 技術帳戶 ID （id） | 字串 | 指定您的AEM技術帳戶的ID。 | 對 |
| 元範圍（metascopes） | 字串 | 從您的服務認證中指定中繼範圍。 | 對 |
| 私鑰（privateKey） | securestring | 提供私鑰。 它包含在服務認證中。 | 對 |
| Adobe IMS主機URL （imsEndpoint） | 字串 | 提供Adobe Identity Management服務的主機URL。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 從範本和資料產生 PDF （預覽） |
從PDF或XDP範本產生PDF檔案，並將XML資料合併至該檔案。 |
| 從範本和資料產生 PS、PCL、ZPL、DPL、IPL 或 TPCL 檔案 （預覽） |
從 XDP 檔案或 PDF 文件產生 PostScript （PS）、印表機命令語言 （PCL）、Zebra 列印語言 （ZPL）、DPL （Datamax 程式設計語言）、IPL （Intermec 印表機語言） 或 TPCL （TEC 印表機命令語言） 文件，並將 XML 資料合併到其中。 |
從範本和資料產生 PDF （預覽）
從PDF或XDP範本產生PDF檔案，並將XML資料合併至該檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
提供XDP或PDF範本的二進位檔案或位置。 |
|
資料
|
data | True | binary |
提供要與範本合併的 XML 資料的二進位檔或位置。 |
|
XCI 組態
|
xci | binary |
提供 XCI 組態檔的二進位檔或位置。 |
|
|
Locale
|
locale | string |
選取 PDF 文件的地區設定。 |
|
|
內容根目錄
|
contentRoot | string |
指定URI、絕對參照或位置，以擷取範本中使用的資產。 |
|
|
將標籤新增至 PDF
|
isTagged | boolean |
建立帶有標籤的 PDF，以針對使用螢幕助讀程式和其他輔助技術的使用者最佳化 PDF。 |
|
|
將字體內嵌至 PDF
|
embedFonts | boolean |
在 PDF 中嵌入字體，以便在裝置和螢幕上保持一致的外觀 |
|
|
線性化 PDF（快速 Web 視圖）
|
linearizedPDF | boolean |
選擇優化 PDF 以實現快速 Web 檢視 |
|
|
保留狀態
|
retainFormState | boolean |
選擇在文件平面化後保留文件的狀態。 |
|
|
保留未簽署的簽名欄位
|
retainUnsignedSignatureFields | boolean |
選取以保留或移除未簽署的簽名欄位 |
|
|
Adobe Acrobat Reader 版本
|
acrobatVersion | string |
選取開啟 PDF 文件所需的最低 Acrobat Reader 版本。 |
傳回
- response
- PDFResult
從範本和資料產生 PS、PCL、ZPL、DPL、IPL 或 TPCL 檔案 （預覽）
從 XDP 檔案或 PDF 文件產生 PostScript （PS）、印表機命令語言 （PCL）、Zebra 列印語言 （ZPL）、DPL （Datamax 程式設計語言）、IPL （Intermec 印表機語言） 或 TPCL （TEC 印表機命令語言） 文件，並將 XML 資料合併到其中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
提供XDP或PDF範本的二進位檔案或位置。 |
|
資料
|
data | True | binary |
提供要與範本合併的 XML 資料的二進位檔或位置。 |
|
XCI 組態
|
xci | binary |
提供 XCI 組態檔的二進位檔或位置。 |
|
|
Locale
|
locale | string |
選取輸出檔案的地區設定。 |
|
|
內容根目錄
|
contentRoot | string |
指定URI、絕對參照或位置，以擷取範本中使用的資產。 |
|
|
份數
|
copies | integer |
指定要產生的複本數目。 |
|
|
分頁
|
paginationOverride | string |
設定在頁面的一側或兩面列印的選項。 |
|
|
印表機設定檔
|
xdcUri | True | string |
選擇描述印表機功能的 XDC 檔案，例如印表機功能和紙張類型。 |
|
輸出類型
|
renderType | True | string |
從可用的輸出類型中選擇。 |
傳回
- response
- PrintedResult
定義
PDF評論
- PDF輸出
- binary
列印結果
- 列印輸出
- binary