文件起草者

文件生成器連接器讓使用者能自動化文件建立與管理。透過這個連接器，你可以從範本產生動態文件，將系統資料填充，路由以供審查或核准，並安全地交付最終輸出。它旨在幫助組織減少手動工作量，確保一致性，並加速文件驅動的工作流程。

此連接器適用於以下產品和區域：

服務	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）

連絡人
名稱	文件起草者
URL	https://documentdrafter.com
Email	support@documentdrafter.com

連接器中繼資料
Publisher	文件起草者
網站	https://documentdrafter.com
隱私策略	https://documentdrafter.com/privacy/
類別	通敵;資訊科技營運

文件繪圖連接器

文件起草者連接器可讓您建立和管理自動化文件流程的工作流程。

先決條件

必要：訂閱 Document Drafter 並存取其入口網站。

如何獲得訪問權限？

如需演示，請通過 documentdrafter.com 與我們聯繫

正在建立連線

使用從文件起草者入口網站取得的權杖進行連線。

支援的作業

連接器支援數個作業：

觸發器

Button press：按下問卷中的按鈕時啟動工作流程。
Link submission：透過 URL 提交問卷時啟動工作流程。

行動

Create and Fill Questionnaire：使用 JSON 資料填入問卷。
Create Questionnaire：設定新的問卷。
Get Link to a Questionnaire：擷取存取問卷的連結。
Get Documents：取得問卷產生的文件。
Get Questionnaire Information：存取輸入問卷的資訊。
Get Tags for a Questionnaire：檢視指派給問卷的所有標籤。
Get information on flow states and triggers：流程可能具有多個觸發器的多個狀態。此動作會根據流程索引鍵擷取此資訊。
Get link to a questionnaire：建立問卷的新深層連結。
Set current state for a questionnaire：流程可能有多個狀態。此動作可讓您變更問卷的狀態。
Grant users or groups access to a questionnaire：授與使用者或群組對問卷的存取權。
Revoke access to a questionnaire for all users and groups：撤銷所有使用者和群組對問卷的存取權。
Get or Create a Workspace：依名稱檢查現有的工作區。如果找不到工作區，且「如果找不到，請建立」參數設定為 true，則會建立新的工作區。它會傳回工作區存在狀態，以及工作區的名稱、識別碼和路徑（如果適用）。選擇性參數可讓您從另一個主要工作區複製樣式和資料夾。
Get or Create a Folder：依名稱檢查指定工作區內的資料夾。如果找不到資料夾，且「如果找不到就建立」參數設定為 true，則會建立新資料夾。它會傳回「資料夾存在」狀態，以及資料夾的名稱、ID 和路徑（如果適用）。
Save Static Files to a Workspace：將靜態檔案以 base64 格式儲存到指定的工作區和資料夾。它會傳回已儲存檔案的名稱、ID 和路徑。
Get or Create a User：透過電子郵件地址檢查使用者。如果找不到使用者，且如果找不到就建立參數設定為 true，則會建立新使用者。它會傳回「使用者存在」狀態，以及使用者的 ID 和名稱（如果適用）。選擇性參數可讓您隱藏系統產生的邀請電子郵件，並擷取自訂電子郵件流程的臨時密碼。您也可以指定要將新使用者新增至的群組。
Get or Create a Group：依名稱檢查現有群組。如果找不到群組，且「如果找不到就建立」參數設定為 true，則會建立新群組。它會傳回「群組存在」狀態，以及群組的 ID 和名稱（如果適用）。
Add Access for a Group：將群組的存取權新增至指定的工作區或資料夾。它會傳回「存取存在」狀態，並確認已授與存取權（如果適用）。它可用來檢查現有的存取權，而不新增它。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	此連接器的 API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

使用 JSON 資料建立和填寫問卷	上傳 JSON 檔案來建立並填寫問卷。在此動作之後，您可以使用取得文件或取得問卷資訊動作。
取得問卷連結	建立一個新的深度連結到問卷
取得或建立使用者	取得一個使用者的資訊，如果不存在就建立它
取得或建立工作區	取得工作區資訊，如果不存在就建立它
取得或建立資料夾	取得資料夾資訊，如果不存在就建立它
取得或建立資料夾存取權	取得資料夾存取權的資訊，如果資料夾不存在就建立存取權限
取得文件	根據文件 ID 取得文件檔案
取得流量資訊	根據流程金鑰取得流程資訊
填入問卷的所有標籤	取得問卷標籤
將靜態檔案儲存到資料夾	將靜態檔案儲存到指定的資料夾
建立或建立群組	取得一個群組的資訊，如果沒有就創建它
建立新問卷	在選取的範本上建立新問卷
授權使用者或團體使用問卷	授權使用者或團體使用問卷
撤銷所有使用者及團體的問卷存取權	撤銷所有使用者及團體的問卷存取權
獲取匿名問卷鏈接	取得外部共用問卷的深層連結
獲取問卷信息	擷取單一範本的變數
設定問卷當前狀態	流動可能有多種狀態。此動作可讓您變更問卷的狀態。

使用 JSON 資料建立和填寫問卷

作業識別碼：: ProcessJson

上傳 JSON 檔案來建立並填寫問卷。在此動作之後，您可以使用取得文件或取得問卷資訊動作。

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
工作空間	WorkSpace	True	string	從下拉式選單中選取工作區
Questionnaire	TemplateId	True	string	從下拉式清單中選取範本
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件
JSON 資料	JsonData	True	string	JSON 資料來填寫問卷

傳回

名稱	路徑	類型	Description
文件 ID	documentId	string	文件 ID

取得問卷連結

作業識別碼：: GetExternalShareLinkV2

建立一個新的深度連結到問卷

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
使用者電子郵件以提供連結	Email	True	string	使用者會寄電子郵件索取連結
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

傳回共用連結

Link: string

取得或建立使用者

作業識別碼：: GetCreateUser

取得一個使用者的資訊，如果不存在就建立它

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
如果找不到，請自行創建	CreateIfNotFound	True	boolean	如果物件不存在，就建立它
文件編製組名稱	GroupName	True	string	群組名稱
文件繪製者用戶電子郵件	Email	True	string	使用者的電子郵件
文件撰寫者發送邀請給使用者	sendInvite	True	boolean	發送邀請給使用者

傳回

名稱	路徑	類型	Description
地位	Status	string	使用者的當前狀態
身份識別碼	Id	string	使用者的唯一識別碼
名稱	Name	string	使用者的名稱
密碼	Password	string	使用者密碼（僅在建立時回傳，且未發送邀請）

取得或建立工作區

作業識別碼：: GetCreateWorkspace

取得工作區資訊，如果不存在就建立它

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
工作區名稱	WorkspaceNameRoute	True	string	工作區的名稱
如果找不到，請自行創建	CreateIfNotFound	True	boolean	如果物件不存在，就建立它
主工作區	MasterWorkSpace		string	從下拉選單選擇主工作區
從主工作區複製樣式	CopyStyling		boolean	從主工作區複製樣式
從主工作區複製資料夾	CopyFolders		boolean	從主工作區複製資料夾結構

傳回

名稱	路徑	類型	Description
身份識別碼	Id	string	工作區的唯一標識碼
名稱	Name	string	工作區的名稱
路徑	Path	string	工作空間的路徑
地位	Status	string	工作區目前狀態

取得或建立資料夾

作業識別碼：: GetCreateFolder

取得資料夾資訊，如果不存在就建立它

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
如果找不到，請自行創建	CreateIfNotFound	True	boolean	如果物件不存在，就建立它
文件編製者資料夾名稱	FolderName	True	string	資料夾名稱
文件繪製者父資料夾/工作區 ID	ParentId	True	string	父資料夾/工作區的識別碼

傳回

名稱	路徑	類型	Description
身份識別碼	Id	string	資料夾的唯一識別碼
名稱	Name	string	資料夾的名稱
路徑	Path	string	資料夾的路徑
地位	Status	string	資料夾的現況

取得或建立資料夾存取權

作業識別碼：: GetCreateAccessFolder

取得資料夾存取權的資訊，如果資料夾不存在就建立存取權限

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
如果找不到，請自行創建	CreateIfNotFound	True	boolean	如果物件不存在，就建立它
文件編製組名稱	GroupNamePath	True	string	群組名稱
文件編製者資料夾 ID	FolderId	True	string	資料夾的ID

傳回

名稱	路徑	類型	Description
地位	Status	string	該入口的現況

取得文件

作業識別碼：: GetDocuments

根據文件 ID 取得文件檔案

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件
Docx 或 PDF	OutputFormat	True	string	產生文件的格式。

傳回

名稱	路徑	類型	Description
問卷名稱	QuestionnaireName	string	問卷名稱
文件名稱（單一文件）	FirstFileName	string	文件名稱（僅用於單一文件）
文件內容（單一文件）	FirstFileContentBytes	string	文件內容的 Base64 編碼物件
檔案儲存體	Files	array of object	為文件建立的檔案集合
所有文件的名稱（多個文件）	Files.Name	string	所有文件的名稱清單
所有文件的內容（多個文件）	Files.ContentBytes	string	所有文件內容的 Base64 編碼物件清單

取得流量資訊

作業識別碼：: GetFlowInformation

根據流程金鑰取得流程資訊

參數

名稱	機碼	必要	類型	Description
流程鍵	FlowKey	True	string	文件起草器流程索引鍵
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com

傳回

此作業會輸出隨機的結果。

填入問卷的所有標籤

作業識別碼：: GetTagsForQuestionnaire

取得問卷標籤

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
問卷的文件 ID	DocumentId		string	問卷的文件 ID
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

名稱	路徑	類型	Description
items	items	array of object	問卷標籤清單
加標籤	items.tag	string	資料元素的標籤
答	items.answer	string	標記元素的答案

將靜態檔案儲存到資料夾

作業識別碼：: SaveStaticFileToFolder

將靜態檔案儲存到指定的資料夾

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件編製者資料夾 ID	FolderId	True	string	資料夾的ID
文件撰寫者檔案名稱及副檔名	FileName	True	string	要上傳的檔案名稱（包括副檔名）
base64 中的文件繪製檔案	FileBase64	True	string	上傳至 base64 格式的檔案

傳回

名稱	路徑	類型	Description
身份識別碼	Id	string	資料夾的唯一識別碼
名稱	Name	string	資料夾的名稱
路徑	Path	string	資料夾的路徑
地位	Status	string	資料夾的現況

建立或建立群組

作業識別碼：: GetCreateGroup

取得一個群組的資訊，如果沒有就創建它

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
如果找不到，請自行創建	CreateIfNotFound	True	boolean	如果物件不存在，就建立它
文件編製組名稱	GroupNamePath	True	string	群組名稱
文件製作者角色	Role		string	使用者的角色

傳回

名稱	路徑	類型	Description
身份識別碼	Id	string	群組的唯一識別碼
名稱	Name	string	群組的名稱。
地位	Status	string	集團現況

建立新問卷

作業識別碼：: CreateQuestionnaire

在選取的範本上建立新問卷

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
工作空間	WorkSpace	True	string	從下拉式選單中選取工作區
Questionnaire	TemplateId	True	string	從下拉式清單中選取範本
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

此作業會輸出隨機的結果。

授權使用者或團體使用問卷

作業識別碼：: FlowAddShare

授權使用者或團體使用問卷

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件
群組或郵件	GroupOrMail	True	string	群組或郵件
取得部分問題	SelectedQuestions		boolean	啟用對特定問題的存取權限，預設是完全存取

傳回

輸出說明

response: object

撤銷所有使用者及團體的問卷存取權

作業識別碼：: DeleteAllShareLinksOnDocument

撤銷所有使用者及團體的問卷存取權

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

輸出說明

response: object

獲取匿名問卷鏈接

作業識別碼：: GetExternalShareLink

取得外部共用問卷的深層連結

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
輸入參考以識別連結	Scope	True	string	指定觸發動作時連結的參考
連結有效期為天	ExpireDays	True	integer	連結的有效天數
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

傳回共用連結

Link: string

獲取問卷信息

作業識別碼：: GetVariablesForTemplate

擷取單一範本的變數

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
工作空間	WorkSpace	True	string	從下拉式選單中選取工作區
Questionnaire	TemplateId	True	string	從下拉式清單中選取範本
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

此作業會輸出隨機的結果。

設定問卷當前狀態

作業識別碼：: FlowSetState

流動可能有多種狀態。此動作可讓您變更問卷的狀態。

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
文件 ID	DocumentId	True	string	所有產生的檔的單一唯一 ID
流程鍵	FlowKey	True	string	文件起草器流程索引鍵
State	State	True	string	流量態
使用者的電子郵件	CreateUser	True	string	觸發流程之使用者的電子郵件

傳回

輸出說明

response: object

觸發程序

按下問卷按鈕時觸發流程	此觸發程式會根據流程索引鍵檢查文件起草器平台是否有新的自訂流程觸發程式
等待從外部共用連結提交	此觸發器等待問卷已從外部共享鏈接提交

按下問卷按鈕時觸發流程

作業識別碼：: FlowTriggerPolling

此觸發程式會根據流程索引鍵檢查文件起草器平台是否有新的自訂流程觸發程式

參數

名稱	機碼	必要	類型	Description
流程鍵	FlowKey	True	string	文件起草器流程索引鍵
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com

傳回

名稱	路徑	類型	Description
items	items	array of object	items
使用者的電子郵件	items.createUser	string	觸發流程之使用者的電子郵件
文件 ID	items.documentId	string	所有產生的檔的單一唯一 ID
流程時間戳記	items.triggerTime	string	觸發流程的時間戳記。
問卷名稱	items.documentName	string	觸發流程的問卷名稱
目前狀態索引鍵	items.stateKey	string	記錄目前狀態索引鍵
觸發鍵	items.triggerKey	string	事件的觸發鍵
事件資料	items.additionalData	string	事件的觸發器資料
Origin 電子郵件	items.OriginCreateUser	string	建立問卷使用者的 Origin 電子郵件

等待從外部共用連結提交

作業識別碼：: TriggerSubmitPolling

此觸發器等待問卷已從外部共享鏈接提交

參數

名稱	機碼	必要	類型	Description
文件起草者入口網站 URL	SiteUrl	True	string	例如 contenso.documentdrafter.com
輸入參考以識別連結	Scope	True	string	指定觸發動作時連結的參考

傳回

名稱	路徑	類型	Description
items	items	array of object
狀態	items.status	string	作業的狀態（已完成、逾時）
documentId	items.documentId	string	唯一文件 ID

共用方式為

文件起草者

文件繪圖連接器

先決條件

如何獲得訪問權限？

正在建立連線

支援的作業

觸發器

行動

正在建立連線

預設

節流限制

動作

使用 JSON 資料建立和填寫問卷

參數

傳回

取得問卷連結

參數

傳回

取得或建立使用者

參數

傳回

取得或建立工作區

參數

傳回

取得或建立資料夾

參數

傳回

取得或建立資料夾存取權

參數

傳回

取得文件

參數

傳回

取得流量資訊

參數

傳回

填入問卷的所有標籤

參數

傳回

將靜態檔案儲存到資料夾

參數

傳回

建立或建立群組

參數

傳回

建立新問卷

參數

傳回

授權使用者或團體使用問卷

參數

傳回

撤銷所有使用者及團體的問卷存取權

參數

傳回

獲取匿名問卷鏈接

參數

傳回

獲取問卷信息

參數

傳回

設定問卷當前狀態

參數

傳回

觸發程序

按下問卷按鈕時觸發流程

參數

傳回

等待從外部共用連結提交

參數

傳回

定義

字串

物件