发送到 Gestioo （预览版）

使用授权的访问组和记录分类将 PDF 和Word文档存入 Gestioo，然后在安全保管库中确认其存档。

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

Service	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	Gestioo 支持
URL	https://gestioo.co/contact
Email	support@gestioo.co

连接器元数据
Publisher	Gestioo
网站	https://gestioo.co
隐私策略	https://gestioo.co/politique-confidentialite
Categories	内容和文件;生产力

发送到 Gestioo

Gestioo 可帮助组织在安全保管库中管理、分类和存档其文档。此连接器将 PDF 和Word文档与用户的授权分类和访问组一起存储，请求存档，并检查最终结果。

Publisher

Gestioo

Prerequisites

有效的 Gestioo 组织和由该组织授权创建文档并访问其保管库的Microsoft工作帐户。
涵盖高级连接器的Power Automate许可证，以及根据组织的数据策略使用连接器的权限。
对于本地Windows文件服务器、配置的Microsoft本地数据网关和文件系统连接，或提供文件内容的现有桌面流。网关访问本地文件;Gestioo 连接器通过 HTTPS 调用 Gestioo。

文档传输不需要 Dataverse 数据库或Power BI。 Power BI可以报告由你自己的工作流维护的导入寄存器。

支持的操作

运算	用途
获取存款选项	获取登录用户可用的访问组、分类、管理单元和上传限制。
创建存款	上传 PDF 或 DOCX 及其元数据和稳定的幂等密钥。返回存款收据。
获取存款状态	检查此用户和连接器创建的回执。
存档存款	请求存档已保存的文档。处理仍在进行中时重复此操作。

入门

选择“发送到 Gestioo”，创建连接并使用授权Microsoft工作帐户登录。 Gestioo 组织已从该帐户解析。管理员可能需要在租户的许可策略下批准访问权限。
运行 “获取存款”选项 并选择目标分类和访问组。提供所选分类要求的事件日期。
读取文件内容并为此文件版本创建持久幂等密钥。在首次上传之前存储该密钥，并重复使用它进行重试。
使用原始文件名、标题、元数据和文件字节作为 base64 编码一次运行 创建存存 。当源连接器返回二进制对象时，请使用其 $content 值。存储返回 depositId的。
使用该收据调用 存档存款 。如果状态为 receiving 或 processing，请等待（默认为 retryAfterSeconds 15 秒），然后再次调用 存档存款 。将循环绑定到 240 次迭代和 1 小时。
仅 archived 确认完成。在导入寄存器中记录收据和存档时间戳。打开 failed、 interrupted或超时时，保留原始收据并调查现有收据。

存档会密封文档，并且不可逆。仅为组织批准的文件配置自动存档。将初始导入限制为一个文件，并保护流运行历史记录中的文件输入和输出。

已知的限制

支持 PDF 和 DOCX。 Gestioo 接受高达 50 MiB 的原始文件;上游连接器和网关可以施加较低的限制。在上传之前检查整个流中最严格的限制。
Word文档转换为 PDF。原始 DOCX 不保留为存档源;将原始文件保留在源系统中。
连接器传输现有文件和元数据。它不会扫描文件服务器、诊断其基础结构或自行决定记录分类。
状态 processing 并不意味着文档位于保管库中。 获取存款状态 仅观察进度; 存档存款 在处理后请求密封。
重用具有不同字节或元数据的键返回 409 idempotency_conflict。不要在超时或响应丢失后自动生成新密钥。
每次调用时都会检查访问。删除用户的权限或组成员身份可以停止以前连接的流。
Power Platform 环境和源系统确定Microsoft端数据位置。连接器认证不保证整个工作流完全托管在魁北克。

Troubleshooting

响应	Action
401	使用授权Microsoft工作帐户重新连接。
403	要求 Gestioo 管理员验证帐户、文档和保管库权限以及所选访问组。
404	检查回执，并使用创建回执的同一用户和连接器。
409	保留现有的收据和幂等密钥。调查报告的冲突或文档状态。
413 或 415	检查文件大小、扩展名和实际内容。
429 或 503	使用相同的回执或相同的幂等密钥和有效负载等待并重试。

Support

请联系 Gestioo 支持或电子邮件 support@gestioo.co。提供操作、时间戳和安全错误代码。请勿在支持请求中发送凭据或文档内容。

使用条款 · 隐私策略

操作

创建存款	上传具有稳定文件版本密钥的 PDF 或Word文档。 Word文件转换为 PDF。使用存档存款执行此操作，直到状态存档，并保留本地原始文件。
存档存款	使用安全保管库中的当前分类和保留规则密封已存放的 PDF。存档不可逆。处理时使用相同的存款 ID 重复，并在失败或中断时停止。
获取存款状态	检查已连接用户创建的存款。仅存档确认传送到安全保管库。
获取存款选项	获取可供已连接用户访问的访问组、分类准则和管理单元。

创建存款

操作 ID:: CreateDeposit

上传具有稳定文件版本密钥的 PDF 或Word文档。 Word文件转换为 PDF。使用存档存款执行此操作，直到状态存档，并保留本地原始文件。

参数

名称	密钥	必需	类型	说明
文件版本密钥	idempotencyKey	True	string	此文件版本的稳定标识符。在重试时重复使用相同的键、字节和元数据。
文件名	fileName	True	string	没有文件夹路径的原始 PDF 或 DOCX 文件名。
文件内容	contentBase64	True	byte	以 base64 完全编码的原始文件字节数一次。不要发送提取的文本。
文档标题	title	True	string	在 Gestioo 保管库中显示的标题。
访问组	accessGroupIds	True	array of string	Get 存款选项返回的一个或多个访问组的标识符。
分类准则	classificationRubricId	True	string	文档的授权分类标准。
复制类型	classificationCopyType		string	文档复制类型。对辅助副本使用主记录或辅助副本的主体。
管理单元	administrativeUnitId		string	授权的管理单元（如果适用）。
保留事件日期	triggerEventAt		date-time	分类需要时，采用 ISO 8601 格式的保留事件日期（时区）。

Body: DepositStatus

存档存款

操作 ID:: ArchiveDeposit

使用安全保管库中的当前分类和保留规则密封已存放的 PDF。存档不可逆。处理时使用相同的存款 ID 重复，并在失败或中断时停止。

参数

名称	密钥	必需	类型	说明
存款 ID	depositId	True	string	创建存款返回的存款 ID。

Body: DepositStatus

获取存款状态

操作 ID:: GetDepositStatus

检查已连接用户创建的存款。仅存档确认传送到安全保管库。

参数

名称	密钥	必需	类型	说明
存款 ID	depositId	True	string	创建存款返回的存款 ID。

Body: DepositStatus

获取存款选项

操作 ID:: GetDepositOptions

获取可供已连接用户访问的访问组、分类准则和管理单元。

名称	路径	类型	说明
组织	organizationName	string	组织已从已登录帐户解析。
最大上传大小	maxUploadBytes	integer	Gestioo 接受的最大原始文件大小（以字节为单位）。
支持的格式	supportedFormats	array of string	支持的原始文件扩展名。
授权访问组	accessGroups	array of object	此帐户可用的访问组。
访问组 ID	accessGroups.id	string	授权访问组标识符。
法语名称	accessGroups.nameFr	string	法语的访问组名称。
英语名称	accessGroups.nameEn	string	英语访问组名称。
分类选项	classifications	array of object	授权的分类准则及其事件日期要求。
分类标准 ID	classifications.id	string	授权的分类标准标识符。
分类标签	classifications.label	string	标准代码和标题。
所需的事件日期	classifications.requiresEventDate	boolean	分类是否需要保留事件日期。
管理单元	administrativeUnits	array of object	组织中的活动管理单元。
管理单元 ID	administrativeUnits.id	string	管理单元标识符。
单位名称	administrativeUnits.name	string	管理单元名称。
分类系列	classificationSeries	array of object	授权的分类层次结构和默认保留元数据。
系列代码	classificationSeries.seriesCode	string	分类系列代码。
系列标题	classificationSeries.seriesTitle	string	分类系列标题。
评分标准	classificationSeries.rubrics	array of object	此分类系列中授权的准则。
Rubric ID	classificationSeries.rubrics.id	string	分类标准标识符。
Rubric 代码	classificationSeries.rubrics.code	string	分类标准代码。
鲁里克标题	classificationSeries.rubrics.title	string	分类标准标题。
系列代码	classificationSeries.rubrics.seriesCode	string	父分类系列代码。
系列标题	classificationSeries.rubrics.seriesTitle	string	父分类系列标题。
子项代码	classificationSeries.rubrics.subSeriesCode	string	分类子Erseries 代码（如果可用）。
子级标题	classificationSeries.rubrics.subSeriesTitle	string	分类子Erseries 标题（如果可用）。
可选函数	classificationSeries.rubrics.optionalFunction	string	可选分类函数（如果可用）。
默认保留规则 ID	classificationSeries.rubrics.defaultRetentionLineId	string	默认保留规则标识符（如果可用）。
活动保留类型	classificationSeries.rubrics.defaultRetentionActiveKind	string	可用时的活动保留期的类型。
保留事件类型	classificationSeries.rubrics.defaultRetentionTriggerType	string	建议的保留事件类型（如果可用）。

定义

DepositStatus

名称	路径	类型	说明
存款 ID	depositId	string	稳定的存款收据标识符。
文档编号	documentId	string	为已保存的文档保留的标识符。
Status	status	string	当前存款状态。仅存档确认成功存档。
存档于	archivedAt	string	存档后提供的 ISO 8601 格式的存档时间戳。
错误代码	error	string	存款失败时的安全错误代码。
后续操作	nextAction	string	文档正在处理时所需的下一个操作。
秒后重试	retryAfterSeconds	integer	再次检查或请求存档前的延迟。