Initiate Document Export模板允許您以 HTTP 格式導出 Workiva 文檔,然後將其轉換為 PDF 或 DOCX 檔案。此功能常用於備份文件、啟用離線編輯或與工作區以外的使用者分享 Workiva 文件。
要求
- 您必須能透過您的 OAuth2 授權存取 Client ID 和 Client Secret。
- 您的工作區中必須設定下列連線器:
建立您的範本
Initiate Document Export 模板位於 Templates 螢幕的 Workiva Chains 區段。
如何找到它
- 在Chain Builder 中,转到Templates 选项卡。
- 從上方功能表選擇Workiva Chains 。
- 在右上方搜尋Initiate Document Export並開啟範本。
找到模板後,使用下列變數和運行時輸入為您的工作區設定模板。
備註: 有關從範本建立鏈的詳細說明,請參閱建立和管理鏈 文章。
變數
| 變數類型 | 變數名稱 | 描述 | 必要 |
| 動態鏈 | dcv-exportStatus | 用於擷取文件的匯出狀態。 | 是 |
| 動態鏈 | dcv-resourceURL | 文件名或 ID 值。 | 是 |
| 工作區 | wsv-ClientID | 從您 Workiva 連接器的 OAuth2 授權產生的 ID。 | 是 |
| 工作區 | wsv-Secret | 從您 Workiva 連接器的 OAuth2 授權產生的秘密令牌。 | 是 |
| 工作區 | wsv-IAMURL | IAM 主機覆寫 URL。 | 是 |
| 工作區 | wsv-PlatformURL | Platform API 主機覆寫 URL。 | 是 |
注意事項
| 運行時間輸入 | 描述 | 選項 | 必要 |
| ExportFormat | 表示匯出的格式。 | .pdf 或 .docx | 是 |
| 匯出 ID | 文件的 ID 。 | 是 | |
| ExportFileName | 可在上傳或發送電子郵件時使用,以取代檔案的預設名稱。 | 否 | |
| 區段 | 要匯出的文件中各區段的 ID。如果匯出整個文件,可以留空。 | 否 | |
| Docx - 匯出選項 | 匯出至 .docx 時,提供匯出物件的規格。 |
|
否 |
| PDF 匯出選項 | 匯出至 .pdf 時,提供匯出物件的規格。 |
|
否 |
注意: 如果可選欄位留空,整個物件將不會套用任何規格。
電子郵件傳送通知設定
若要接收匯出的檔案,您必須另外設定Get (Final Resource) 指令,並附上電子郵件通知:
- 編輯「啟動文件匯出」鏈時,選擇Get (Final Resource) 指令,然後按一下Edit
- 按一下信封圖示,開啟Notifications 畫面。
- 按一下+ New notification 按鈕。
- 打開 「條件 」下拉菜單,選擇成功 。
- 開啟 「收件者 」下拉式功能表,並選擇應接收匯出物件的所有使用者的電子郵件。
- 開啟「附件」功能表,並選擇 Get (Final Resource) 指令的檔案輸出。
此程序將傳送 HTTP 檔案給電子郵件的收件者。收件人必須手動將檔案的副檔名重新命名為所需格式:
- File_name.txt. => file_name.pdf
- File_name.txt => file_name.docx
疑難排解
如果您的鏈觸發了錯誤或未能更新正確的資料,請檢查下列內容是否為真:
-
所有工作區變數都正確。如果您使用的是沙箱工作區,請使用沙箱版本的 IAM/Platform URL。
-
您已包含所有必要的執行時輸入,例如簡報和匯出 ID。
-
您為Get (Final Result) 指令設定了電子郵件通知設定。