WenDocs 連結器 (預覽版)
連線到 WenDocs Publish API 服務。 使註冊用戶能夠調用服務來組裝 WenDocs 模板(由我們的 Word 插件:Wendocs 模板設計器製作)和 json 數據,然後發布為 Word、PDF、HTML 格式。 透過與其他連接器集成,可以輕鬆自動產生由資料驅動的文檔,例如歡迎信、履歷、業務報告...
此連接器適用於以下產品和區域:
| 服務 | 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) |
| 連絡人 | |
|---|---|
| 名稱 | WenDocs 支援 |
| URL | https://www.wendocs.com/#/support |
| support@wendocs.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 溫多克斯有限公司 |
| 網站 | https://www.wendocs.com |
| 隱私策略 | https://www.wendocs.com/public/PrivacyPolicy_en.html |
| 類別 | 商業管理;生產力 |
WenDocs Linker 會連線到 WenDocs Publish REST API 服務。 註冊用戶調用服務來組裝他們的 WenDocs 模板和 json 數據,然後發布為 Word、PDF、HTML 格式。
WenDocs Linker幫助企業建立多渠道文檔發布系統,具有一致的外觀和個性化的內容。 透過與 Microsoft 365 平台上的其他連接器集成,您可以輕鬆地自動發布由業務資料驅動的文檔,例如歡迎信、履歷、訂單通知...甚至財務報告。
先決條件
- 請準備好API_Key和API_Secret, support@wendocs.com 以便與 REST 服務建立基本驗證連線。
- 準備一個 WenDocs 模板文件和 json 格式數據,請在 Word Office 插件商店中搜索“WenDocs Template Designer”,並按照 幫助 中的說明創建模板文件或從入 門開始。
如何取得認證
輸入API_Key和建立連接器連線時的API_Secret。
開始使用連接器
以雲端流程為例:
將範本和 json 檔案上傳至您的 OneDrive 或 SharePoint 網站。
透過其他連接器取得範本和 json 檔案內容。
從「WenDocs Linker」建立發佈動作,輸入參數如下:
- “docName”,提供字串值來命名此範本檔案。
- “documentTemplateData”,使用 base64() 表達式對模板文件內容進行編碼。
- “jsonData”,則使用 json 檔案內容。
- “logLevel”,輸入其中一個發佈日誌層級:「DEBUG、ERROR、WARNING、INFO」。
- “language”,輸入發布日誌語言代碼之一:“en, zh”。
- “country”,輸入發布國家代碼之一:“US, CN”。
- “clientType”,輸入“API Service”。
在下一個動作中取得已發佈的文件,使用 base64ToBinary() 運算式來解碼發佈動作輸出中的「文件」項目。 它是輸出文件的二進制數據。
已知限制
發佈 API 呼叫受限於訂用帳戶中的總數和到期日。
常見錯誤和補救措施
使用 OneDrive 的「取得檔案內容」和「使用路徑取得檔案內容」動作
請使用「outputs()」運算式,從「取得檔案內容」和「使用路徑取得檔案內容」動作傳回的輸出內文中取得「內容」項目。 OneDrive會使用base64對檔案內容進行編碼,所以如果你從OneDrive讀取json文件,就需要使用「decodeBase64()」表達式來進一步處理「內容」項,下面是一個範例:
decodeBase64(outputs('Action_Name')?['body/$content'])
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API_Key | securestring | 提供從 WenDocs Corporation 獲得的API_Key[www.wendocs.com] | 對 |
| API_Secret | securestring | Access Publish API 服務的API_Secret | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 發佈 Html 檔案 |
發佈包含範本和 json 資料的 Html 檔案 |
| 發佈 PDF 檔案 |
發佈包含範本和 json 資料的 PDF 檔案 |
| 發布 Docx 文件 |
發佈包含範本和 json 資料的 docx 檔案 |
發佈 Html 檔案
發佈包含範本和 json 資料的 Html 檔案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件名稱
|
docName | string |
文件名稱 |
|
|
文件範本資料
|
documentTemplateData | string |
base64 字串代表範本檔案的二進位資料 |
|
|
jsonData
|
jsonData | string |
JSON 格式的客戶資料 |
|
|
logLevel
|
logLevel | string |
發佈日誌的層級:DEBUG、ERROR、WARNING、INFO |
|
|
語言
|
language | string |
錯誤訊息支援的語言代碼:en、zh |
|
|
country
|
country | string |
支援的錯誤訊息國家代碼:美國、中國 |
|
|
clientType
|
clientType | string |
對於 API 服務用戶,請使用“API 服務” |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
documentName 文件名稱
|
documentName | string |
已發佈文件的名稱 |
|
文件
|
document | string |
已發佈文件二進位資料的 base64 字串 |
|
errorMessage
|
errorMessage | string |
錯誤訊息 |
|
錯誤代碼
|
errorCode | string |
錯誤碼 |
|
messages
|
messages | array of object |
異常堆疊的訊息 |
|
水平儀
|
messages.level | string |
日誌層級 |
|
來源
|
messages.source | string |
日誌資訊來源 |
|
訊息
|
messages.message | string |
記錄訊息 |
|
parameters
|
messages.parameters | array of string |
來自日誌來源的參數 |
|
例外狀況
|
messages.exception | string |
異常堆疊資訊 |
發佈 PDF 檔案
發佈包含範本和 json 資料的 PDF 檔案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件名稱
|
docName | string |
文件名稱 |
|
|
文件範本資料
|
documentTemplateData | string |
base64 字串代表範本檔案的二進位資料 |
|
|
jsonData
|
jsonData | string |
JSON 格式的客戶資料 |
|
|
logLevel
|
logLevel | string |
發佈日誌的層級:DEBUG、ERROR、WARNING、INFO |
|
|
語言
|
language | string |
錯誤訊息支援的語言代碼:en、zh |
|
|
country
|
country | string |
支援的錯誤訊息國家代碼:美國、中國 |
|
|
clientType
|
clientType | string |
對於 API 服務用戶,請使用“API 服務” |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
documentName 文件名稱
|
documentName | string |
已發佈文件的名稱 |
|
文件
|
document | string |
已發佈文件二進位資料的 base64 字串 |
|
errorMessage
|
errorMessage | string |
錯誤訊息 |
|
錯誤代碼
|
errorCode | string |
錯誤碼 |
|
messages
|
messages | array of object |
異常堆疊的訊息 |
|
水平儀
|
messages.level | string |
日誌層級 |
|
來源
|
messages.source | string |
日誌資訊來源 |
|
訊息
|
messages.message | string |
記錄訊息 |
|
parameters
|
messages.parameters | array of string |
來自日誌來源的參數 |
|
例外狀況
|
messages.exception | string |
異常堆疊資訊 |
發布 Docx 文件
發佈包含範本和 json 資料的 docx 檔案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件名稱
|
docName | string |
文件名稱 |
|
|
文件範本資料
|
documentTemplateData | string |
base64 字串代表範本檔案的二進位資料 |
|
|
jsonData
|
jsonData | string |
JSON 格式的客戶資料 |
|
|
logLevel
|
logLevel | string |
發佈日誌的層級:DEBUG、ERROR、WARNING、INFO |
|
|
語言
|
language | string |
錯誤訊息支援的語言代碼:en、zh |
|
|
country
|
country | string |
支援的錯誤訊息國家代碼:美國、中國 |
|
|
clientType
|
clientType | string |
對於 API 服務用戶,請使用“API 服務” |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
documentName 文件名稱
|
documentName | string |
已發佈文件的名稱 |
|
文件
|
document | string |
已發佈文件二進位資料的 base64 字串 |
|
errorMessage
|
errorMessage | string |
錯誤訊息 |
|
錯誤代碼
|
errorCode | string |
錯誤碼 |
|
messages
|
messages | array of object |
異常堆疊的訊息 |
|
水平儀
|
messages.level | string |
日誌層級 |
|
來源
|
messages.source | string |
日誌資訊來源 |
|
訊息
|
messages.message | string |
記錄訊息 |
|
parameters
|
messages.parameters | array of string |
來自日誌來源的參數 |
|
例外狀況
|
messages.exception | string |
異常堆疊資訊 |