更聰明的繪圖者（預覽版）

Smarter Drafter 連接器可實現 Smarter Drafter 與您的工作流程之間的無縫集成，使您能夠自動生成文檔並簡化流程。更多資訊請瀏覽 https://developers.smarterdrafter.com/reference/power-automate

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

服務	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://smarterdrafter.com.au/contact-us
Email	support@smarterdrafter.com

連接器中繼資料
Publisher	Tensis 集團
網站	https://smarterdrafter.com.au
隱私策略	https://smarterdrafter.com.au/legal
類別	生產力;內容和文件

更聰明的繪圖者 Power Automate 連接器

Smarter Drafter 連接器可實現 Smarter Drafter 和 Power Automate 工作流程之間的無縫集成，使您能夠自動生成文檔並簡化流程。如需詳細資訊，請參閱 Smarter Drafter for Power Automate

設定

需要在 Smarter Drafter Pro 平台中建立帳戶，然後建立 API 金鑰。更多信息，請訪問 Smarter Drafter 開發人員門戶

使用者入門

安裝連接器

將 Smarter Drafter 連接器匯入您的 Power Automate 環境。

驗證

使用您的 Smarter Drafter API 金鑰設定身份驗證。

建立流程

將更智慧的起草者動作或觸發程序新增至您的 Power Automate 流程。

可用動作

建立提交：此功能接受請求本文中的提交詳細資訊、建立新提交並將文件排入佇列以供產生。它會傳回所建立提交的唯一識別碼。
取得提交：傳回由其唯一 ID 識別的特定提交的詳細資訊。如果找不到提交，則會傳回 404 找不到回應。
依表單取得欄位：傳回與指定表單 ID 相關聯的所有欄位。
下載文件：傳回產生的文件。
更新提交答案：更新提交中特定欄位的答案。支援使用表單資料更新檔案類型欄位。
提交提交並排入世代檔案：提交指定的提交，並將相關聯的文件排入佇列以供產生。會擷取其他中繼資料，例如使用者代理程式和遠端位址。

需求

具有 API 存取權限的 Smarter Drafter Pro 帳戶
在 Smarter Drafter Pro 中建立的 API 金鑰
Power Automate 授權

Support

如需協助或意見回饋，請聯絡 support@smarterdrafter.com。

正在建立連線

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


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

預設

適用：所有地區

建立連線的參數。

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

名稱	類型	Description	為必填項目
更聰明的繪圖者 API 金鑰	securestring	您更聰明的繪圖者 API 金鑰	對
主機 URL	字串	根主機網址（範例：api.rulestar.com）。如果未指定，主機網址將預設為 api.rulestar.com	對
API 版本	字串	API 版本（範例：v1）。如果未指定，API 版本將預設為 v1

節流限制

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

動作

下載文件	下載針對指定提交產生的單一文件
依表單取得欄位	取得與指定表單相關聯的所有欄位
取得提交	擷取特定提交的詳細資料，包括其狀態、答案和產生的文件。
建立提交	在 Smarter Drafter Pro 中建立提交
提交提交並排入佇列文件以供產生	提交指定的提交，並將相關聯的文件排入佇列以供產生。會擷取其他中繼資料，例如使用者代理程式和遠端位址。
更新提交答案	更新提交答案，包括接受檔案上傳

下載文件

作業識別碼：: DownloadDocument

下載針對指定提交產生的單一文件

參數

名稱	機碼	必要	類型	Description
提交標識碼	SubmissionId	True	string	提交的識別碼
檔案名稱	FileName	True	string	要下載的檔案名稱

傳回

要下載的檔案內容

檔案內容: binary

依表單取得欄位

作業識別碼：: GetFields

取得與指定表單相關聯的所有欄位

參數

名稱	機碼	必要	類型	Description
表單識別碼	FormId	True	string	要從中擷取欄位的表單識別碼

傳回

名稱	路徑	類型	Description
Fields		array of object	與指定表單相關聯的欄位
欄位識別碼	id	integer	欄位的識別碼
欄位標籤	label	string	欄位的標籤
父項中的欄位標籤	labelInParent	string	父表單中欄位的標籤
隱藏標籤	hideLabel	boolean	指出是否應該隱藏欄位標籤
表單 ID	formId	integer	欄位所屬表單的識別碼
區段 ID	sectionId	integer	欄位所屬區段的識別碼
欄位描述	description	string	欄位的描述
父項中的欄位描述	descriptionInParent	string	父表單中欄位的描述
欄位類型	type	string	欄位的類型。可能的值包括：address、checkbox、currency、datetime、email、file、id、name、number、phone、radio、richtext、section、select、text、textarea 和 matter
必要欄位	required	boolean	指出欄位是否為必要欄位
父項中的必填欄位	requiredInParent	boolean	指出父表單中是否需要欄位
隱藏欄位	hidden	boolean	指出欄位是否隱藏
父項中的隱藏欄位	hiddenInParent	boolean	指出欄位是否隱藏在父表單中
唯讀欄位	readOnly	boolean	指出欄位是否為唯讀
父項中的唯讀欄位	readOnlyInParent	boolean	指出欄位在父表單中是否為唯讀
排序順序	sort	integer	欄位在表單中顯示的順序
運算	calculation	string	要在欄位上執行的計算
預設值	defaultValue	string	欄位的預設值
父項中的預設值	defaultValueInParent	string	父表單中欄位的預設值
停用預設值	disableDefaultValue	boolean	指出是否應該停用預設值
多行	multiline	boolean	指出欄位是否應支援多行
分節符號	sectionBreak	boolean	指出區段是否顯示在新頁面中
章節標題	sectionHeading	string	該部分的標題
父項中的區段標題	sectionHeadingInParent	string	父表單中區段的標題
欄位文字	text	string	欄位的文字（文字區域或 RichText）
父項中的欄位文字	textInParent	string	父表單中欄位的文字，當 textarea 或 rich text 時
欄位格式	format	string	欄位的格式
格式前綴	formatPrefix	string	要用於欄位格式的前置詞
時間格式	timeFormat	string	用於時間欄位的格式
日期單位	dateUnit	integer	日期欄位的時間單位。可能的值為：1 = 分鐘 2 = 小時 3 = 天 4 = 月 5 = 年
最小值	minValue	integer	欄位的最小值
最大值	maxValue	integer	欄位的最大值
小數點	decimals	integer	欄位的小數位數
邏輯定義	logicDefinition	string	欄位的邏輯定義
Reference	ref	string	欄位的參考
忽略錯誤檢查	ignoreErrorChecking	boolean	指出是否要忽略欄位的錯誤檢查
實體對映類型	entityMapType	string	欄位的實體對應類型。可能的值為： 1 = 類型 1 = 最小值 2 = 地址 3 = 電子郵件 4 = 電話 5 = 傳真 10 = 全名 11 = 出生日期 12 = 名字 13 = 姓氏 14 = 性別 15 = 標題 20 = IsAusCompany 21 = 公司名稱 22 = CompanyAcn 23 = 公司編號 30 = IsTrustee 31 = 信任名稱 32 = TrustHasNumber 33 = TrustAbn 101 = 使用者全名 102 = 使用者名字 103 = 使用者姓氏 104 = 使用者姓名縮寫 105 = 使用者通訊名稱 106 = 使用者位置 107 = 使用者實踐證書號碼 108 = 使用者直接電子郵件 109 = =UserDirectPhone 110 = UserServiceEmail 111 = UserOfficeAddress
可重複	repeatable	boolean	指出欄位是否可重複
最小重複次數	minRepeats	integer	欄位的重複次數下限
重複次數上限	maxRepeats	integer	欄位的重複次數上限
最小重複參考	minRepeatsRef	string	最小重複的參考
最大重複次數參考	maxRepeatsRef	string	最大重複次數的參考
重複編號	repeat	integer	欄位應重複的次數
重複計數	repeatCount	integer	欄位的目前重複計數
啟用 RTF	enableRtf	boolean	指出欄位是否已啟用RTF （RTF格式）
下邊界參考	lowerBoundaryRef	string	下邊界的參考
上限參考	upperBoundaryRef	string	上限的參考
檔案用作	fileUseAs	integer	檔案用於欄位。可能的值為：1 = 合併影像 2 = 附件
零售預填充	retailPrefill	boolean	指出是否為欄位啟用零售預先填入
隱藏在零售業	hideInRetail	boolean	指出欄位是否隱藏在零售檢視中
建立時間	createdAt	string	欄位的建立日期
Alias	alias	string	欄位的別名
角色 ID	roleId	integer	欄位的角色識別碼
區段區塊表單識別碼	globalFormId	integer	欄位的區段區塊表單ID
options	options	array of object	欄位選項
選項 ID	options.id	integer	選項的識別碼
欄位識別碼	options.fieldId	integer	欄位的識別碼
選項標籤	options.label	string	選項的標籤
父項中的標籤	options.labelInParent	string	父前後關聯中選項的標籤
價值觀	options.value	string	選項的值
訂單	options.order	integer	選項的順序
選項參考	options.ref	string	選項的參考
邏輯定義	options.logicDefinition	string	選項的邏輯定義
是邏輯	options.isLogic	boolean	指出選項是否以邏輯為基礎
是自由文字	options.isFreeText	boolean	指出選項是否為自由文字
建立時間	options.createdAt	date-time	選項的建立日期
貨幣	currencies	array of object	貨幣
貨幣 ID	currencies.id	integer	貨幣的 ID
欄位識別碼	currencies.fieldId	integer	欄位的識別碼
Code	currencies.code	string	貨幣的代碼
Symbol	currencies.symbol	string	貨幣的符號
小數點	currencies.decimals	integer	貨幣的小數位數
格式	currencies.format	string	貨幣的格式
預設	currencies.default	boolean	指出這是否為預設貨幣
訂單	currencies.order	integer	貨幣的順序

取得提交

作業識別碼：: GetSubmission

擷取特定提交的詳細資料，包括其狀態、答案和產生的文件。

參數

名稱	機碼	必要	類型	Description
提交標識碼	SubmissionId	True	string	提交的識別碼

傳回

名稱	路徑	類型	Description
提交識別碼	id	string	提交的識別碼
提交名稱	name	string	提交的名稱
表單 ID	formId	integer	與提交相關聯的表單識別碼
接收表單 ID	intakeFormId	integer	與提交相關聯的接收表單識別碼
當前頁面	currentPage	integer	上次儲存提交的頁面
使用者識別碼	userId	integer	與提交相關聯的使用者識別碼。
使用者名字	userFirstName	string	提交表單的使用者的名字
使用者姓氏	userSurname	string	提交表單的使用者姓氏
使用者電子郵件地址	userEmailAddress	string	提交表單之使用者的電子郵件地址
使用者電話號碼	userPhoneNumber	string	提交表單之使用者的電話號碼
接收使用者名字	intakeUserFirstName	string	與提交相關聯的接收使用者的名字
接收使用者姓氏	intakeUserSurname	string	與提交相關聯的接收使用者的姓氏
接收使用者電子郵件地址	intakeUserEmailAddress	string	與提交相關聯的接收使用者的電子郵件地址
接收使用者電話號碼	intakeUserPhoneNumber	string	與提交相關聯的接收使用者的電話號碼
是零售提交	isRetail	boolean	指出提交是否用於零售用途
是舊版提交	isLegacy	boolean	舊版提交是否 [已棄用]
舊版提交標識碼	legacySubmissionId	integer	舊版提交標識碼 [已棄用]
公司編號	companyId	integer	與提交相關聯的公司識別碼
僅產生 PDF 檔案	sendPdfOnly	boolean	指出是否只傳送提交的 PDF 的值
履歷網址	resumeUrl	string	要繼續提交的 URL。當提交處於草稿狀態且稍後需要繼續時，會使用此選項。
提交狀態	status	integer	提交的狀態。可能的值為： 0 = 無效 1 = 已啟動 2 = 已儲存 3 = 已提交 4 = 已產生 5 = 擱置中 6 = 失敗 7 = EditedInWord 8 = OutForSigning 9 = PartiallySigned 10 = SignerDeclined 11 = SigningComplete 12 = SigningVoid 13 = WithClient 14 = ClientComplete
錯誤類型	errorType	integer	提交的錯誤類型（如果有的話）。可能的值為：1 = 泛型 2 = TemplateNotFound 3 = 交叉參照
刪除於	deletedAt	date-time	刪除提交的日期和時間。
產生於	generatedAt	date-time	產生提交文件的日期和時間。
案件編號	matterId	integer	與提交相關聯之事項的內部識別碼
父 ID	parentId	integer	父提交的識別碼（如果有的話）。這用於來自接收表單的提交
上次更新日期	lastUpdatedDate	date-time	上次更新提交的日期和時間
上次更新狀態	lastUpdatedStatus	integer	上次更新時的提交狀態。可能的值為： 0 = 無效 1 = 已啟動 2 = 已儲存 3 = 已提交 4 = 已產生 5 = 擱置中 6 = 失敗 7 = EditedInWord 8 = OutForSigning 9 = PartiallySigned 10 = SignerDeclined 11 = SigningComplete 12 = SigningVoid 13 = WithClient 14 = ClientComplete
最後更新者 ID	lastUpdatedById	integer	上次更新提交之使用者的識別碼
公用存取	publicAccess	boolean	指出所有具有表單存取權的使用者是否都可以存取提交
表單版本	formVersion	integer	用於提交的表單版本
Answers	answers	array of object	提交的內容中提供的答案
答案值	answers.answer	string	為欄位提供的答案值
答案參考	answers.answerRef	string	答案的參考標識碼
欄位參考	answers.fieldRef	string	欄位的參考標識碼
使用預留位置	answers.usePlaceholder	boolean	指出是否要使用欄位的預留位置
貨幣代碼	answers.currencyCode	string	欄位的貨幣代碼（如果適用）
檔案儲存體	answers.files	array of string	與答案相關聯的檔案
產生的文件	generatedDocuments	array of object	提交提交時產生的文件
文件 ID	generatedDocuments.id	integer	產生文件的 ID
檔名	generatedDocuments.filename	string	產生的文件名稱
URL	generatedDocuments.url	string	存取所產生文件的URL
可簽署	generatedDocuments.signable	boolean	指出文件是否可以傳送以進行電子簽章

建立提交

作業識別碼：: CreateSubmission

在 Smarter Drafter Pro 中建立提交

參數

名稱	機碼	必要	類型	Description
提交名稱	name	True	string	提交的名稱
表單 ID	formId	True	integer	表單的識別碼
使用者電子郵件地址	userEmailAddress	True	string	提交擁有者的電子郵件地址
群組ID	groupIds		array of integer	群組ID
iManage 資料夾路徑	iManageFolderPath		string	產生的文件將上傳到的 iManage 資料夾路徑。例如，'libraries/DEV/folders/DEV！171/documents'
當地時間	submissionLocalTime		date-time	正確評估日期時間運算式的本機提交時區資訊
欄位參考	ref		string	在可重複區段內包含重複編號的欄位參照
答案值	answer		string	答案，請參閱欄位類型接受的格式： - 地址 = '地址 = [地址行 1]\n城市 = [城市]\n州 = [州]\n郵遞區號 =\n國家 = [國家]' - 日期時間 = 'yyyy-MM-dd HH：mm' - 姓名 = '名字 = [名字]\n姓氏 = [姓氏]' - 電子郵件 = 'name@domain.com' - ID - ABN = '123 456 789' - 美國 EIN = '12-3456789' - 美國 SSN = '123-45-6789' - GB CRN = 'AB123456' - 數字和貨幣 = '123456789' - 電話 = '（123） 456-7890'
答案參考	answerRef		string	選項參考。使用選項欄位時，這是必需的：- 複選框 = 多選必須用分號 ';' 連接，例如 '123;1234;12345' - 無線電或選擇 = '12345'
使用預留位置	usePlaceholder		boolean	指出是否使用預留位置。
貨幣代碼	currencyCode		string	欄位類型為 Currency 時的貨幣代碼
是測試提交	isTest		boolean	指出提交是否為測試
是草稿提交	isDraft		boolean	指出提交是否處於草稿狀態，也稱為已儲存狀態
事項編號	matterNumber		string	要與提交相關聯的案件編號
整合來源	integrationSource		string	與 MatterNumber 搭配使用的整合來源。可能的值為 “clio”、“leap”、“actionstep”、“smokeball” 或 “unity”
應上傳至指定的事項編號	uploadDocumentsToMatter		boolean	指出是否要將產生的文件上傳至指定的案件編號和來源。
NetDocuments 目的地	netDocumentsDestination		string	產生的文件將上傳到的 NetDocuments 目的地。例如「3462-8536-1690」

傳回

所建立提交的識別碼

提交標識碼: string

提交提交並排入佇列文件以供產生

作業識別碼：: SubmitSubmission

提交指定的提交，並將相關聯的文件排入佇列以供產生。會擷取其他中繼資料，例如使用者代理程式和遠端位址。

參數

名稱	機碼	必要	類型	Description
提交標識碼	SubmissionId	True	string	提交的識別碼
NetDocuments 目的地	netDocumentsDestination		string	產生的文件將上傳到的 NetDocuments 目的地。
iManage 資料夾路徑	iManageFolderPath		string	產生的文件將上傳到的 iManage 資料夾路徑。

更新提交答案

作業識別碼：: UpdateSubmission

更新提交答案，包括接受檔案上傳

參數

名稱	機碼	必要	類型	Description
提交標識碼	SubmissionId	True	string	提交的識別碼
欄位參考	FieldRef	True	string	應更新答案的欄位參考
答案值	answer		string	要針對指定欄位更新的答案
選項參考	answerRef		string	選項答案的參考
檔案	file		file	要上傳答案的檔案

共用方式為

更聰明的繪圖者 （預覽版）