傳送至 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 |
| 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。 接著先存檔存入，直到狀態被歸檔，並保留當地原始檔案。 |
取得存款狀態
檢查連接用戶所開立的存款。 只有存檔確認送達安全保險庫。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
存款識別碼
|
depositId | True | string |
由建立存款回傳的存款 ID。 |
傳回
取得訂金選項
取得連接使用者可用的存取群組、分類規準及管理單元。
傳回
| 名稱 | 路徑 | 類型 | 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 |
建議的保留事件類型（如有）。 |
存檔存檔
請依照現行的分類與保存規則，將存放的PDF封存於安全保險庫中。 檔案是不可逆的。 在處理時用相同的存款 ID 重複這個步驟，失敗或中斷時停止。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
存款識別碼
|
depositId | True | string |
由建立存款回傳的存款 ID。 |
傳回
建立存款
上傳帶有穩定檔案版本鍵的 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 格式並附時區，視分類要求而定。 |
傳回
定義
存款狀態
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
存款識別碼
|
depositId | string |
穩定存款收據識別碼。 |
|
文件識別碼
|
documentId | string |
存入文件所保留的識別碼。 |
|
Status
|
status | string |
目前的存款狀態。 只有存檔確認存檔成功。 |
|
存檔於
|
archivedAt | string |
檔案時間戳記為 ISO 8601 格式，檔案保存後可取得。 |
|
錯誤碼
|
error | string |
當存款失敗時，會顯示一個安全的錯誤代碼。 |
|
下一步行動
|
nextAction | string |
文件處理時，下一步需要做的。 |
|
幾秒後重試
|
retryAfterSeconds | integer |
在再次檢查或申請歸檔之前，延遲了。 |