傳送至 Gestioo（預覽）

將 PDF 與 Word 文件存入 Gestioo，並設有授權存取群組與紀錄分類，然後確認其存檔於安全保險庫中。

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

服務	Class	Regions
Copilot Studio	進階	除下列區域外的所有 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）

聯絡方式
Name	Gestioo 支援
URL	https://gestioo.co/contact
Email	support@gestioo.co

連接器中繼資料
Publisher	蓋斯提歐
網站	https://gestioo.co
隱私權原則	https://gestioo.co/politique-confidentialite
類別	內容和文件;生產力

送往蓋斯提歐

Gestioo 協助組織管理、分類及存檔其文件，存放於一個安全的保險庫中。此連接器會將 PDF 與 Word 文件存放於使用者授權的分類與存取群組，請求歸檔，並檢查最終結果。

Publisher

蓋斯提歐

Prerequisites

一個活躍的 Gestioo 組織，以及一個由該組織授權建立文件及存取其保險庫的 Microsoft 工作帳號。
Power Automate 授權涵蓋 Premium 連接器，並授權您組織的資料政策下使用該連接器。
無論是本地 Windows 檔案伺服器、已設定的 Microsoft 本地資料閘道與檔案系統連線，或是提供檔案內容的現有桌面流程。閘道器會存取你的本地檔案;Gestioo 連接器透過 HTTPS 呼叫 Gestioo。

文件傳輸不需要 Dataverse 資料庫或 Power BI。 Power BI 可以報告由你自己工作流程維護的匯入暫存器。

支援的作業

運算	Purpose
取得訂金選項	取得登入使用者可用的存取群組、分類、管理單位及上傳限制。
建立存款	上傳包含元資料和穩定冪性鍵的 PDF 或 DOCX。退還押金收據。
取得存款狀態	請檢查該使用者和連接器所製作的收據。
檔案存檔	申請存檔所存文件。當處理仍在進行中時，重複此動作。

開始使用

選擇「傳送到 Gestioo」，建立連線，並以你授權的 Microsoft 工作帳號登入。你的 Gestioo 組織會從那個帳戶解決。管理員可能需要依照租戶同意政策核准存取權限。
執行「 取得存款選項 」並選擇目的地分類與存取群組。當所選分類需要時，提供事件日期。
閱讀檔案內容，並為此檔案版本建立持久的冪性鍵。在第一次上傳前先把那個金鑰存好，然後重用它來重試。
執行建立存款，並以原始檔案名稱、標題、元資料和檔案位元組一次編碼成 base64。當來源連接器回傳一個二進位物件時，使用其 $content 值。存放退回 depositId的。
拿著收據打電話給 Archive deposit 。如果狀態是 receiving 或 processing，請等待 retryAfterSeconds （預設為 15 秒）然後再次呼叫 Archive deposit 。例如將迴圈綁定為 240 次迭代和一小時。
只 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封存於安全保險庫中。檔案是不可逆的。在處理時用相同的存款 ID 重複這個步驟，失敗或中斷時停止。
建立存款	上傳帶有穩定檔案版本鍵的 PDF 或 Word 文件。 Word 檔案會轉成 PDF。接著先存檔存入，直到狀態被歸檔，並保留當地原始檔案。

取得存款狀態

作業識別碼：: GetDepositStatus

檢查連接用戶所開立的存款。只有存檔確認送達安全保險庫。

參數

名稱	機碼	必要	類型	Description
存款識別碼	depositId	True	string	由建立存款回傳的存款 ID。

傳回

身體: DepositStatus

取得訂金選項

作業識別碼：: GetDepositOptions

取得連接使用者可用的存取群組、分類規準及管理單元。

傳回

名稱	路徑	類型	Description
組織	organizationName	string	該組織從登入帳戶中解決了這個問題。
最大上傳大小	maxUploadBytes	integer	Gestioo 接受的最大原始檔案大小，以位元組為單位。
支援的格式	supportedFormats	array of string	支援原始檔案副檔名。
授權存取群組	accessGroups	array of object	這個帳號可用的存取群組。
存取群組識別碼	accessGroups.id	string	授權存取群組識別碼。
法文名稱	accessGroups.nameFr	string	法文中稱為接入群組。
英文名稱	accessGroups.nameEn	string	英文版的Access Group名稱。
分類選擇	classifications	array of object	授權的分級評分標準及其活動日期要求。
分類規準識別碼	classifications.id	string	授權的分類評分標準識別碼。
分類標籤	classifications.label	string	評分標準代碼和標題。
活動日期要求	classifications.requiresEventDate	boolean	分類是否要求保留事件日期。
管理單位	administrativeUnits	array of object	組織內的現役行政單位。
行政單位識別碼	administrativeUnits.id	string	行政單位識別碼。
單位名稱	administrativeUnits.name	string	行政單位名稱。
分類系列	classificationSeries	array of object	授權的分類階層與預設保留的元資料。
系列代碼	classificationSeries.seriesCode	string	分類系列代碼。
系列標題	classificationSeries.seriesTitle	string	分類系列標題。
評分指標	classificationSeries.rubrics	array of object	本分類系列中的授權評分標準。
評分標準識別	classificationSeries.rubrics.id	string	分類規準識別碼。
評分標準代碼	classificationSeries.rubrics.code	string	分類評分規準代碼。
評分標準標題	classificationSeries.rubrics.title	string	分類評分標準標題。
系列代碼	classificationSeries.rubrics.seriesCode	string	母分類系列代碼。
系列標題	classificationSeries.rubrics.seriesTitle	string	母分類系列標題。
子系列代碼	classificationSeries.rubrics.subSeriesCode	string	分類子系列代碼（如有）提供。
子系列標題	classificationSeries.rubrics.subSeriesTitle	string	分類子系列標題（如有）。
選用功能	classificationSeries.rubrics.optionalFunction	string	可選的分類功能（如有）。
預設保留規則 ID	classificationSeries.rubrics.defaultRetentionLineId	string	預設保留規則識別碼（若有）。
主動保留類型	classificationSeries.rubrics.defaultRetentionActiveKind	string	有效保留期的類型（如有）。
保留事件類型	classificationSeries.rubrics.defaultRetentionTriggerType	string	建議的保留事件類型（如有）。

存檔存檔

作業識別碼：: ArchiveDeposit

請依照現行的分類與保存規則，將存放的PDF封存於安全保險庫中。檔案是不可逆的。在處理時用相同的存款 ID 重複這個步驟，失敗或中斷時停止。

參數

名稱	機碼	必要	類型	Description
存款識別碼	depositId	True	string	由建立存款回傳的存款 ID。

傳回

身體: DepositStatus

建立存款

作業識別碼：: CreateDeposit

上傳帶有穩定檔案版本鍵的 PDF 或 Word 文件。 Word 檔案會轉成 PDF。接著先存檔存入，直到狀態被歸檔，並保留當地原始檔案。

參數

名稱	機碼	必要	類型	Description
檔案版本說明	idempotencyKey	True	string	此檔案版本的穩定識別碼。重試時重複使用相同的鍵、位元組和元資料。
檔案名稱	fileName	True	string	原始的 PDF 或 DOCX 檔名，但沒有資料夾路徑。
檔案內容	contentBase64	True	byte	原始檔案位元組以 base64 編碼一次。請勿傳送擷取的文字。
文件標題	title	True	string	頭銜展示於 Gestioo 金庫中。
存取群組	accessGroupIds	True	array of string	由「取得存款選項」回傳的一個或多個存取群組識別碼。
分類規準	classificationRubricId	True	string	文件的授權分類評分標準。
複製類型	classificationCopyType		string	文件副本類型。主記錄用 principal，次要副本用 secondaire。
行政單位	administrativeUnitId		string	如適用，該為授權行政單位。
保留事件日期	triggerEventAt		date-time	保留事件日期依 ISO 8601 格式並附時區，視分類要求而定。

傳回

身體: DepositStatus

定義

存款狀態

名稱	路徑	類型	Description
存款識別碼	depositId	string	穩定存款收據識別碼。
文件識別碼	documentId	string	存入文件所保留的識別碼。
Status	status	string	目前的存款狀態。只有存檔確認存檔成功。
存檔於	archivedAt	string	檔案時間戳記為 ISO 8601 格式，檔案保存後可取得。
錯誤碼	error	string	當存款失敗時，會顯示一個安全的錯誤代碼。
下一步行動	nextAction	string	文件處理時，下一步需要做的。
幾秒後重試	retryAfterSeconds	integer	在再次檢查或申請歸檔之前，延遲了。