HUE Datagate （預覽版）

Datagate 是 Works Applications 的軟件即服務數據管理平台，為用戶提供了一種簡化的方法來存儲、管理和生成業務數據的見解。 此連接器可讓您從 Power Platform 利用 Datagate 上的業務資料。

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

Datagate 是 Works Applications 的軟件即服務數據管理平台，為用戶提供了一種簡化的方法來存儲、管理和生成業務數據的見解。 它可以作為儲存資料和管理的集中平台

此連接器提供 API，可讓您從 Power Platform 存取 Datagate 上的業務資料。

先決條件

若要使用此連接器，您需要下列項目：

• 可存取 OData API 的 Datagate API 金鑰。
• 具有所需表格存取權的 Datagate 角色認證 （角色 ID、角色密碼）。
• Datagate 使用者帳戶，以存取 Datagate 上的查詢建置器。

如何取得認證

有兩層鑑別及授權可存取 Datagate 上的表格，即 Datagate API 金鑰及 Datagate 角色。 以下是取得 Datagate API 金鑰和 Datagate 角色認證的簡化步驟。 如需更多資訊，請參閱 上的 Datagate 手冊 @SUPPORT，或聯絡我們的顧問。

若要取得 Datagate API 金鑰：

1. 登入 Datagate 畫面。
2. 前往 API 金鑰管理頁面。 API 金鑰按鈕將位於頁面左側導覽列上。 按一下金鑰圖示並選擇「API 金鑰管理」以導航至 API 金鑰管理頁面。
3. 按一下頁面右上角的建立 API 金鑰按鈕。
4. 「編輯 API」頁面將顯示空白欄位。
5. 在 API 金鑰資訊區段中，填寫所需的描述。
6. 選取所需的許可權以授與 API 金鑰。
7. 點擊頁面右上角的「儲存 API 金鑰」按鈕以建立所需的 API 金鑰。

若要取得 Datagate 角色認證：

1. 登入 Datagate 畫面。
2. 前往角色管理頁面。 角色管理連結將位於頁面的左側導覽列上。 按一下表格圖示並選擇「角色管理」以導航到角色管理頁面。
3. 按一下頁面右上角的建立角色按鈕。
4. 將顯示建立角色頁面。
5. 在角色資訊區段中，填寫所需的角色名稱並選取權限類型。
6. 從結構描述或表格清單中選取所需的許可權以授與角色。
7. 點擊頁面右上角的「儲存角色」按鈕以建立新角色並取得所需的角色憑證。

開始使用連接器

目前有一個 API 可供使用，即 OData API，它允許讀取 Datagate 上的表格資料。 透過Datagate OData查詢，可以設定要選取的列、排序順序、所需的參數是查詢字串，以及有權存取表的角色憑證。 請參閱上一節「如何取得認證」，以取得所需 API 金鑰和角色認證的步驟。 若要取得查詢字串，請參閱下列步驟。

1. 在 Datagate 畫面上，在表格清單頁面上搜尋所需的表格。
2. 開啟所需表格的資料檢視器頁面。
3. 設定所需的參數，然後複製產生的查詢字串。

通過電子郵件發送每日報告

使用 Datagate 的連接器，建立每天自動發送銷售報告的 Power flow

1. 準備要使用的 API 金鑰。 （請參閱上一節「如何取得認證」）
2. 準備角色（角色ID和角色密碼）。 （請參閱上一節「如何取得認證」）
3. 取得輸出資料表的查詢。
4. 建立排程的雲端流程。
5. 設定所需的時間表。
6. 確認排程集正確無誤。
7. 新增步驟以取得目前日期時間，並從 UTC 時區轉換為所需的時區。
8. 新增 OData API 步驟。 可以透過在查詢字串中插入變數來產生動態查詢字串。
9. 新增 JSON 轉換步驟。 使用範例 JSON 承載來產生結構描述。
10. 新增建立HTML表格的步驟。
11. 新增傳送電子郵件的步驟，並輸入所需的電子郵件內文，然後儲存聯結器。 您可以選擇手動執行流程來測試流程。
12. 電子郵件將按照定義的時間表以以下格式發送。

已知問題與限制

每個 API 呼叫的可傳回資料大小上限為 6MB。

如果要求的資料集大小大於 6MB，API 呼叫將傳回錯誤「413 承載太大」。

常見錯誤和補救措施

連接器上目前只有一個 API，即 OData API。 以下是使用 API 時可能面臨的一些錯誤。

200 確定

“關係”public_view.table_name“不存在”

該表可能不再存在。 請檢查表格是否可透過 Datagate 的資料檢視器存取。

“”無法剖析過濾器 （XXX）“ （第 X 行，X 欄）”

提供的查詢有一些問題。 請確認查詢是否已正確從 Datagate 畫面複製。

413 有效負載太大

OData API 的承載大小限制為 6MB。 請在 OData 查詢中設定 「limit」 參數，以設定資料列計數的下限。

500 內部伺服器錯誤

無法建立與伺服器的連線。 如果問題仍然存在，請諮詢我們的顧問。

FAQ

以下是 Datagate 使用者的常見問題。 對於此處未涵蓋的問題或更多詳細信息，請參閱 Works Applications 平台上 @SUPPORT 提供的 Datagate 手冊，否則請聯繫我們的顧問。

如何從連接器取得外部資料表資料？

存取所需外部資料表的資料檢視器頁面，並從查詢產生器取得相關的查詢字串。

正在建立連線

連接器支援下列驗證類型：

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

動作

OData API