更智能的草稿器（预览版）

智能草稿器连接器支持智能草稿器与工作流之间的无缝集成，使你能够自动生成文档并简化流程。有关详细信息，请参阅 https://developers.smarterdrafter.com/reference/power-automate

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	更智能的草稿器支持
URL	https://smarterdrafter.com.au/contact-us
Email	support@smarterdrafter.com

连接器元数据
发布者	Tensis 组
网站	https://smarterdrafter.com.au
隐私策略	https://smarterdrafter.com.au/legal
类别	生产力;内容和文件

更智能的草稿器 Power Automate 连接器

智能草稿器连接器支持智能草稿器与 Power Automate 工作流之间的无缝集成，使你能够自动生成文档并简化流程。有关 Power Automate 的智能草稿器的详细信息

设置

需要智能草稿器 Pro 平台中的帐户，然后创建 API 密钥。智能草稿器开发人员门户的详细信息

入门

安装连接器

将智能草稿器连接器导入 Power Automate 环境。

身份验证

使用智能草稿器 API 密钥配置身份验证。

创建流

将更智能的草稿器作或触发器添加到 Power Automate 流。

可用操作

创建提交：此函数接受请求正文中的提交详细信息、创建新的提交和排队文档以供生成。它返回所创建提交的唯一标识符。
获取提交：返回由其唯一 ID 标识的特定提交的详细信息。如果未找到提交，则返回 404 未找到响应。
按窗体获取字段：返回与指定表单 ID 关联的所有字段。
下载文档：返回生成的文档。
更新提交答案：更新提交中特定字段的答案。支持使用表单数据更新文件类型字段。
为几代提交提交和排队文档：提交指定的提交，并将关联的文档排队进行生成。捕获其他元数据，例如用户代理和远程地址。

要求

具有 API 访问权限的更智能的草稿程序 Pro 帐户
在 Smarter Drafter Pro 中创建的 API 密钥
Power Automate 许可证

Support

如需帮助或反馈，请联系 support@smarterdrafter.com。

创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
更智能的草稿器 API 密钥	securestring	更智能的草稿器 API 密钥	True
托管 URL	字符串	根主机 URL（示例：api.rulestar.com）。如果未指定，则主机 URL 将默认为 api.rulestar.com	True
API 版本	字符串	API 版本（示例：v1）。如果未指定，API 版本将默认为 v1

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

下载文档	下载为指定提交生成的单个文档
创建提交	在 Smarter Drafter Pro 中创建提交
按窗体获取字段	获取与指定窗体关联的所有字段
提交提交和队列文档以进行生成	提交指定的提交，并将关联的文档排队进行生成。捕获其他元数据，例如用户代理和远程地址。
更新提交答案	更新提交答案，包括接受文件上传
获取提交	检索特定提交的详细信息，包括其状态、答案和生成的文档。

下载文档

操作 ID:: DownloadDocument

下载为指定提交生成的单个文档

参数

名称	密钥	必需	类型	说明
提交 ID	SubmissionId	True	string	提交的 ID
文件名	FileName	True	string	要下载的文件的名称

要下载的文件的内容

文件内容: binary

创建提交

操作 ID:: CreateSubmission

在 Smarter Drafter Pro 中创建提交

参数

名称	密钥	必需	类型	说明
提交名称	name	True	string	提交的名称
表单 ID	formId	True	integer	窗体的 ID
用户电子邮件地址	userEmailAddress	True	string	提交所有者的电子邮件地址
groupIds	groupIds		array of integer	groupIds
iManage 文件夹路径	iManageFolderPath		string	将生成的文档上传到的 iManage 文件夹路径。例如“libraries/DEV/folders/DEV！171/documents”
当地时间	submissionLocalTime		date-time	用于正确计算日期/时间表达式的本地提交时区信息
字段引用	ref		string	在可重复节内时包含重复编号的字段引用
答案值	answer		string	Answer, see formats accepted by field type: - Address = 'address = [ADDRESS LINE 1]\ncity = [CITY]\nstate = [STATE]\nzip = [POSTCODE]\ncountry = [COUNTRY]' - DateTime = 'yyyy-MM-dd HH:mm' - Name = 'first = [GIVEN NAME(S)]\nlast = [SURNAME]' - Email = 'name@domain.com' - Id - ABN = '12 234 678 901' - ACN = '123 456 789' - US EIN = '12-3456789' - US SSN = '123-45-6789' - GB CRN = 'AB123456' - Number and Currency = '123456789' - Phone = '(123) 456-7890'
答案参考	answerRef		string	选项引用。使用选项字段时需要此项： - 复选框 = 必须通过分号“;”（例如“123”）联接多个选择。1234;12345“ - 单选或选择 = ”12345”
使用占位符	usePlaceholder		boolean	指示是否使用占位符。
货币代码	currencyCode		string	字段类型为 Currency 时货币代码
测试提交	isTest		boolean	指示提交是否为测试
提交草稿	isDraft		boolean	指示提交是否处于草稿状态 a.k.a 保存状态
问题编号	matterNumber		string	要与提交关联的事项编号
集成源	integrationSource		string	与 MatterNumber 一起使用的集成源。可能的值为“clio”、“leap”、“actionstep”、“smokeball”或“unity”
应上载到指示的编号	uploadDocumentsToMatter		boolean	指示是否将生成的文档上传到指示的编号和源。
NetDocuments 目标	netDocumentsDestination		string	将生成的文档上传到的 NetDocuments 目标。例如“3462-8536-1690”

创建的提交的 ID

提交 ID: string

按窗体获取字段

操作 ID:: GetFields

获取与指定窗体关联的所有字段

参数

名称	密钥	必需	类型	说明
窗体 ID	FormId	True	string	要从中检索字段的窗体的 ID

名称	路径	类型	说明
Fields		array of object	与指定窗体关联的字段
字段 ID	id	integer	字段的 ID
字段标签	label	string	字段的标签
父级的字段标签	labelInParent	string	父窗体中字段的标签
隐藏标签	hideLabel	boolean	指示是否应隐藏字段标签
表单 ID	formId	integer	字段所属的窗体的 ID
节 ID	sectionId	integer	字段所属部分的 ID
字段说明	description	string	字段的说明
父级的字段说明	descriptionInParent	string	父窗体中字段的说明
Field 类型	type	string	字段的类型。可能的值包括：地址、复选框、货币、日期时间、电子邮件、文件、ID、名称、数字、电话、无线电、富文本、节、选择、文本、文本区域和物质
必填字段	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 或 richtext 时父窗体中字段的文本
字段格式	format	string	字段的格式
设置前缀格式	formatPrefix	string	要用于字段格式的前缀
时间格式	timeFormat	string	要用于时间字段的格式
dateUnit	dateUnit	integer	日期字段的时间单位。可能的值为：1 = 分钟 2 = 小时 3 = 天 4 = 月 5 = 年份
最小值	minValue	integer	字段的最小值
最大值	maxValue	integer	字段的最大值
小数	decimals	integer	字段的小数位数
逻辑定义	logicDefinition	string	字段的逻辑定义
Reference	ref	string	字段的引用
忽略错误检查	ignoreErrorChecking	boolean	指示是否忽略字段的错误检查
实体映射类型	entityMapType	string	字段的实体映射类型。可能的值为：1 = 类型 1 = MinValue 2 = Address 3 = Email 4 = Phone 5 = Fax 10 = FullName 11 = BirthDate 12 = FirstName 13 = Surname 14 = Gender 15 = Title 20 = IsAusCompany 21 = CompanyName 22 = CompanyAcn 23 = CompanyNumber 30 = IsTrustee 31 = TrustName 32 = TrustHasNumber 33 = TrustAbn 101 = UserFullName 102 = UserFirstName 103 = UserSurname 104 = UserInitials 105 = UserCorrespondenceName 106 = UserPosition 107 = UserPractisingCertificateNumber 108 = UserDirectEmail 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 = MergedImage 2 = Attachment
零售预填充	retailPrefill	boolean	指示是否为字段启用零售预填充
在零售中隐藏	hideInRetail	boolean	指示字段是否隐藏在零售视图中
创建时间	createdAt	string	字段的创建日期
别名	alias	string	字段的别名
角色 ID	roleId	integer	字段的角色 ID
节块窗体 ID	globalFormId	integer	字段的节块窗体 ID
options	options	array of object	字段的选项
选项 ID	options.id	integer	选项的 ID
字段 ID	options.fieldId	integer	字段的 ID
选项标签	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
字段 ID	currencies.fieldId	integer	字段的 ID
Code	currencies.code	string	货币的代码
符号	currencies.symbol	string	货币的符号
小数	currencies.decimals	integer	货币的小数位数
Format	currencies.format	string	货币的格式
违约	currencies.default	boolean	指示这是默认货币
下单	currencies.order	integer	货币顺序

提交提交和队列文档以进行生成

操作 ID:: SubmitSubmission

提交指定的提交，并将关联的文档排队进行生成。捕获其他元数据，例如用户代理和远程地址。

参数

名称	密钥	必需	类型	说明
提交 ID	SubmissionId	True	string	提交的 ID
NetDocuments 目标	netDocumentsDestination		string	将生成的文档上传到的 NetDocuments 目标。
iManage 文件夹路径	iManageFolderPath		string	将生成的文档上传到的 iManage 文件夹路径。

更新提交答案

操作 ID:: UpdateSubmission

更新提交答案，包括接受文件上传

参数

名称	密钥	必需	类型	说明
提交 ID	SubmissionId	True	string	提交的 ID
字段参考	FieldRef	True	string	应更新答案的字段 ref
答案值	answer		string	要为指定字段更新的答案
选项引用	answerRef		string	选项答案的参考
文件	file		file	要为答案上传的文件

获取提交

操作 ID:: GetSubmission

检索特定提交的详细信息，包括其状态、答案和生成的文档。

参数

名称	密钥	必需	类型	说明
提交 ID	SubmissionId	True	string	提交的 ID

名称	路径	类型	说明
提交 ID	id	string	提交的 ID
提交名称	name	string	提交的名称
表单 ID	formId	integer	与提交关联的表单的 ID
入口窗体 ID	intakeFormId	integer	与提交关联的接收表单的 ID
当前页	currentPage	integer	上次保存提交的页面
用户 ID	userId	integer	与提交关联的用户的 ID。
用户名	userFirstName	string	提交表单的用户的名字
用户姓氏	userSurname	string	提交表单的用户的姓氏
用户电子邮件地址	userEmailAddress	string	提交表单的用户的电子邮件地址
用户电话号码	userPhoneNumber	string	提交表单的用户的电话号码
引入用户名字	intakeUserFirstName	string	与提交关联的接收用户的名字
引入用户姓氏	intakeUserSurname	string	与提交关联的接收用户的姓氏
接收用户电子邮件地址	intakeUserEmailAddress	string	与提交关联的接收用户的电子邮件地址
引入用户电话号码	intakeUserPhoneNumber	string	与提交关联的接收用户的电话号码
零售提交	isRetail	boolean	指示提交是否用于零售目的
旧版提交	isLegacy	boolean	旧提交 [已弃用]
旧版提交 ID	legacySubmissionId	integer	旧版提交 ID [已弃用]
公司 ID	companyId	integer	与提交关联的公司的 ID
仅生成 PDF 文件	sendPdfOnly	boolean	一个值，该值指示是否仅发送提交的 PDF
恢复 URL	resumeUrl	string	要恢复提交的 URL。当提交处于草稿状态并且稍后需要恢复时，将使用此选项。
提交状态	status	integer	提交的状态。可能的值包括：0 = 无效 1 = Started 2 = Saved 3 = Submitted 4 = Generated 5 = Pending 6 = Failed 7 = EditedInWord 8 = OutForSigning 9 = PartiallySigned 10 = SignerDeclined 11 =SignedComplete 12 =SignedComplete 12 =SignedVoided 13 = WithClient 14 = ClientComplete
错误类型	errorType	integer	提交的错误类型（如果有）。可能的值为：1 = Generic 2 = TemplateNotFound 3 = CrossReference
删除位置	deletedAt	date-time	删除提交的日期和时间。
生成于	generatedAt	date-time	生成提交文档的日期和时间。
物质 ID	matterId	integer	与提交关联的事项的内部 ID
父 ID	parentId	integer	父提交的 ID（如果有）。这用于来自引入表单的提交
上次更新日期	lastUpdatedDate	date-time	上次更新提交的日期和时间
上次更新状态	lastUpdatedStatus	integer	上次更新提交时的状态。可能的值包括：0 = 无效 1 = Started 2 = Saved 3 = Submitted 4 = Generated 5 = Pending 6 = Failed 7 = EditedInWord 8 = OutForSigning 9 = PartiallySigned 10 = SignerDeclined 11 =SignedComplete 12 =SignedComplete 12 =SignedVoided 13 = WithClient 14 = ClientComplete
上次按 ID 更新	lastUpdatedById	integer	上次更新提交的用户的 ID
公共访问权限	publicAccess	boolean	指示是否可供有权访问表单的所有用户访问提交
窗体版本	formVersion	integer	用于提交的表单的版本
答案	answers	array of object	提交中提供的答案
答案值	answers.answer	string	为字段提供的答案值
答案参考	answers.answerRef	string	答案的参考 ID
字段参考	answers.fieldRef	string	字段的引用 ID
使用占位符	answers.usePlaceholder	boolean	指示是否对字段使用占位符
货币代码	answers.currencyCode	string	字段的货币代码（如果适用）
文件存储	answers.files	array of string	与答案关联的文件
生成的文档	generatedDocuments	array of object	提交时生成的文档
文档 ID	generatedDocuments.id	integer	生成的文档的 ID
Filename	generatedDocuments.filename	string	生成的文档的名称
URL	generatedDocuments.url	string	用于访问生成的文档的 URL
可签名	generatedDocuments.signable	boolean	指示是否可以为 eSignatures 发送文档

通过