通过

文档起草者

文档草稿器连接器使用户能够自动创建和管理文档。 使用此连接器，可以从模板生成动态文档，使用系统中的数据填充这些文档，对其进行路由以供审阅或审批，并安全地交付最终输出。 它旨在帮助组织减少手动工作量，确保一致性并加速文档驱动的工作流。

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

服务 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://documentdrafter.com
Email support@documentdrafter.com
连接器元数据
发布者 文档起草者
网站 https://documentdrafter.com
隐私策略 https://documentdrafter.com/privacy/
类别 协作;IT作

文档草稿器连接器

文档草稿器连接器为自动化文档流程启用工作流的创建和管理。

先决条件

必需：文档草稿器订阅并访问其门户。

如何获取访问权限？

有关演示，请在 documentdrafter.com 与我们联系

正在创建连接

使用从文档草稿器门户获取的令牌进行连接。

支持的作

连接器支持多个作：

Triggers

  • 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，则会创建一个新工作区。 它返回“工作区存在”状态，如果适用，则返回工作区的名称、ID 和路径。 可选参数允许从另一个主工作区复制样式和文件夹。
  • Get or Create a Folder：按指定工作区中的名称检查文件夹。 如果未找到该文件夹，并且“如果找不到”参数设置为 true，则会创建一个新文件夹。 它返回“文件夹存在”状态，如果适用，则返回文件夹的名称、ID 和路径。
  • Save Static Files to a Workspace：以 base64 格式将静态文件保存到指定的工作区和文件夹。 它返回已保存文件的名称、ID 和路径。
  • Get or Create a User：通过电子邮件检查用户。 如果未找到用户，并且“如果未找到”参数，则创建一个新用户。 它返回“用户存在”状态，如果适用，则返回用户的 ID 和名称。 可选参数允许取消系统生成的邀请电子邮件，并检索自定义电子邮件流的临时密码。 还可以指定要向其添加新用户的组。
  • Get or Create a Group：按名称检查现有组。 如果未找到组，并且“如果未找到则创建”参数设置为 true，则会创建一个新组。 它返回“组存在”状态，如果适用，则返回组的 ID 和名称。
  • Add Access for a Group：将组的访问权限添加到指定的工作区或文件夹。 它返回 Access Exists 状态，如果适用，则确认已授予访问权限。 它可用于检查现有访问权限，而无需添加它。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

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

Name 类型 Description 必选
API 密钥 securestring 此连接器的 API 密钥 True

限制

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

操作

使用 JSON 数据创建和填写问卷

通过上传 JSON 文件创建和填写问卷。 此作后，可以使用“获取文档”或“获取问卷信息”作。
创建新问卷

在所选模板上创建新的问题
填充问卷的所有标记

获取问卷标记
将静态文件保存到文件夹

将静态文件保存到指定文件夹
授予用户或组对问卷的访问权限

授予用户或组对问卷的访问权限
撤消对所有用户和组问卷的访问权限

撤消对所有用户和组问卷的访问权限
获取匿名问卷链接

获取外部共享问卷的深层链接
获取或创建对文件夹的访问权限

获取有关文件夹访问权限的信息，并在不存在时创建访问权限
获取或创建工作区

获取有关工作区的信息，并在工作区不存在时创建它
获取或创建文件夹

获取有关文件夹的信息，并创建它（如果不存在）
获取或创建用户

获取有关用户的信息，并创建用户（如果不存在）
获取或创建组

获取有关组的信息，并创建它（如果不存在）
获取文档

基于文档 ID 获取文档文件
获取流信息

基于流密钥获取流信息
获取调查问卷的链接

创建指向问卷的新深层链接
获取问卷信息

提取单个模板的变量
设置问卷的当前状态

流可能具有多个状态。 此作允许更改问卷的状态。

使用 JSON 数据创建和填写问卷

操作 ID:
ProcessJson

通过上传 JSON 文件创建和填写问卷。 此作后，可以使用“获取文档”或“获取问卷信息”作。

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
工作空间
 WorkSpace True string

从下拉列表中选择工作区
调查问卷
 TemplateId True string

从下拉列表中选择模板
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件
JSON 数据
 JsonData True string

用于填充问卷的 JSON 数据

返回

名称 路径 类型 说明
文档 ID
 documentId string

文档 ID

创建新问卷

操作 ID:
CreateQuestionnaire

在所选模板上创建新的问题

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
工作空间
 WorkSpace True string

从下拉列表中选择工作区
调查问卷
 TemplateId True string

从下拉列表中选择模板
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

此操作输出是动态内容。

填充问卷的所有标记

操作 ID:
GetTagsForQuestionnaire

获取问卷标记

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
问卷的文档 ID
 DocumentId string

问卷的文档 ID
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

名称 路径 类型 说明
items
 items array of object

问卷标记列表
标签
 items.tag string

数据元素的标记
答
 items.answer string

标记元素的答案

将静态文件保存到文件夹

操作 ID:
SaveStaticFileToFolder

将静态文件保存到指定文件夹

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档草稿器文件夹 ID
 FolderId True string

文件夹的 ID
带扩展名的文档草稿器文件名
 FileName True string

要上传的文件的名称，包括扩展名
base64 中的文档草稿器文件
 FileBase64 True string

要以 base64 格式上传的文件

返回

名称 路径 类型 说明
Id
 Id string

文件夹的唯一标识符
Name
 Name string

文件夹的名称
路径
 Path string

文件夹的路径
状态
 Status string

文件夹的当前状态

授予用户或组对问卷的访问权限

操作 ID:
FlowAddShare

授予用户或组对问卷的访问权限

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件
组或邮件
 GroupOrMail True string

组或邮件
访问所选问题
 SelectedQuestions boolean

启用对所选问题的访问权限，默认为完全访问权限

返回

out description

response
object

撤消对所有用户和组问卷的访问权限

操作 ID:
DeleteAllShareLinksOnDocument

撤消对所有用户和组问卷的访问权限

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

out description

response
object

获取匿名问卷链接

操作 ID:
GetExternalShareLink

获取外部共享问卷的深层链接

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
键入用于标识链接的引用
 Scope True string

指定触发器作上链接的引用
链接有效期（以天为单位）
 ExpireDays True integer

链接有效天数
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

返回共享链接

Link
string

获取或创建对文件夹的访问权限

操作 ID:
GetCreateAccessFolder

获取有关文件夹访问权限的信息，并在不存在时创建访问权限

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
如果未找到，请创建
 CreateIfNotFound True boolean

创建对象（如果不存在）
文档草稿器组名称
 GroupNamePath True string

组的名称
文档草稿器文件夹 ID
 FolderId True string

文件夹的 ID

返回

名称 路径 类型 说明
状态
 Status string

访问的当前状态

获取或创建工作区

操作 ID:
GetCreateWorkspace

获取有关工作区的信息，并在工作区不存在时创建它

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
工作区名称
 WorkspaceNameRoute True string

工作区的名称
如果未找到，请创建
 CreateIfNotFound True boolean

创建对象（如果不存在）
主工作区
 MasterWorkSpace string

从下拉列表中选择主工作区
从主工作区复制样式
 CopyStyling boolean

从主工作区复制样式
从主工作区复制文件夹
 CopyFolders boolean

从主工作区复制文件夹结构

返回

名称 路径 类型 说明
Id
 Id string

工作区的唯一标识符
Name
 Name string

工作区的名称
路径
 Path string

工作区的路径
状态
 Status string

工作区的当前状态

获取或创建文件夹

操作 ID:
GetCreateFolder

获取有关文件夹的信息，并创建它（如果不存在）

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
如果未找到，请创建
 CreateIfNotFound True boolean

创建对象（如果不存在）
文档草稿器文件夹名称
 FolderName True string

文件夹的名称
文档草稿器父文件夹/工作区 ID
 ParentId True string

父文件夹/工作区的 ID

返回

名称 路径 类型 说明
Id
 Id string

文件夹的唯一标识符
Name
 Name string

文件夹的名称
路径
 Path string

文件夹的路径
状态
 Status string

文件夹的当前状态

获取或创建用户

操作 ID:
GetCreateUser

获取有关用户的信息，并创建用户（如果不存在）

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
如果未找到，请创建
 CreateIfNotFound True boolean

创建对象（如果不存在）
文档草稿器组名称
 GroupName True string

组的名称
文档草稿器用户电子邮件
 Email True string

用户的电子邮件
文档草稿器向用户发送邀请
 sendInvite True boolean

向用户发送邀请

返回

名称 路径 类型 说明
状态
 Status string

用户的当前状态
Id
 Id string

用户的唯一标识符
Name
 Name string

用户的名称
密码
 Password string

用户的密码（仅在创建时返回且未发送邀请）

获取或创建组

操作 ID:
GetCreateGroup

获取有关组的信息，并创建它（如果不存在）

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
如果未找到，请创建
 CreateIfNotFound True boolean

创建对象（如果不存在）
文档草稿器组名称
 GroupNamePath True string

组的名称
文档草稿器角色
 Role string

用户的角色

返回

名称 路径 类型 说明
Id
 Id string

组的唯一标识符
Name
 Name string

组的名称
状态
 Status string

组的当前状态

获取文档

操作 ID:
GetDocuments

基于文档 ID 获取文档文件

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件
Docx 或 PDF
 OutputFormat True string

生成的文档的格式。

返回

名称 路径 类型 说明
QuestionnaireName
 QuestionnaireName string

问卷名称
文档名称（单个文档）
 FirstFileName string

文档名称（仅用于单个文档）
文档内容（单个文档）
 FirstFileContentBytes string

文档内容的 Base64 编码对象
文件存储
 Files array of object

为文档创建的文件集合
所有文档的名称（多个文档）
 Files.Name string

所有文档的名称列表
所有文档的内容（多个文档）
 Files.ContentBytes string

所有文档内容的 Base64 编码对象列表

获取流信息

操作 ID:
GetFlowInformation

基于流密钥获取流信息

参数

名称 密钥 必需 类型 说明
流键
 FlowKey True string

文档草稿器流键
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com

返回

此操作输出是动态内容。

获取调查问卷的链接

操作 ID:
GetExternalShareLinkV2

创建指向问卷的新深层链接

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
用于链接的用户的电子邮件
 Email True string

链接的用户电子邮件
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

返回共享链接

Link
string

获取问卷信息

操作 ID:
GetVariablesForTemplate

提取单个模板的变量

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
工作空间
 WorkSpace True string

从下拉列表中选择工作区
调查问卷
 TemplateId True string

从下拉列表中选择模板
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

此操作输出是动态内容。

设置问卷的当前状态

操作 ID:
FlowSetState

流可能具有多个状态。 此作允许更改问卷的状态。

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
文档 ID
 DocumentId True string

所有生成的文档的唯一 ID
流键
 FlowKey True string

文档草稿器流键
State
 State True string

流状态
用户的电子邮件
 CreateUser True string

触发流的用户的电子邮件

返回

out description

response
object

触发器

“调查问卷”按钮上的流触发器按下

此触发器根据流键检查文档草稿器平台是否有新的自定义流触发器
等待从外部共享链接提交

此触发器等待从外部共享链接提交问卷

“调查问卷”按钮上的流触发器按下

操作 ID:
FlowTriggerPolling

此触发器根据流键检查文档草稿器平台是否有新的自定义流触发器

参数

名称 密钥 必需 类型 说明
流键
 FlowKey True string

文档草稿器流键
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com

返回

名称 路径 类型 说明
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

触发事件数据
源电子邮件
 items.OriginCreateUser string

创建问卷的用户的来源电子邮件

等待从外部共享链接提交

操作 ID:
TriggerSubmitPolling

此触发器等待从外部共享链接提交问卷

参数

名称 密钥 必需 类型 说明
文档草稿器门户 URL
 SiteUrl True string

例如 contenso.documentdrafter.com
键入用于标识链接的引用
 Scope True string

指定触发器作上链接的引用

返回

名称 路径 类型 说明
items
 items array of object
状态
 items.status string

作业的状态（已完成、超时）
documentId
 items.documentId string

唯一文档 ID

定义

字符串

这是基本数据类型“string”。

对象

这是 'object' 类型。