部落 - 平台 （預覽版）
透過強大的客製化來擴展和增強部落招生以及部落簽證和移民，在整個關鍵行政流程中為員工、申請人和學生提供支援。 讓您的組織能夠建立量身打造的工作流程和體驗，以解決教育管理中的這些關鍵領域。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 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） |
| 連絡人 | |
|---|---|
| 名稱 | 部落團體 |
| URL | https://www.tribalgroup.com |
| servicedesk@tribalgroup.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 部落團體 |
| 網站 | https://www.tribalgroup.com |
| 隱私策略 | https://www.tribalgroup.com/privacy-policy |
| 類別 | 商務管理 |
部落邊緣模組，例如部落招生，為教職員工和學生提供了在教育領域取得成功所需的工具。 使用部落連接器來接收事件通知，以及查詢和操作部落邊緣模組內的實體。
先決條件
要使用部落連接器，您需要成為您選擇的模組的部落邊緣使用者。
如何取得認證
若要存取部落連接器，您的租用戶必須有具有以下權限的使用者：
- 訂閱活動
- 在 Tribal Edge 中執行任何操作/查詢，例如，如果您想獲取參考數據，您將需要“參考數據 - 讀取”權限
在 Power Automate 中，當您建立連線時，您將因以下項目而升級：
- 您想要存取的環境類型，即即時、測試或開發。
- 您所在的 EMEA 或 APAC 地區
- 您在加入 Tribal Edge 時收到的租戶
輸入憑證後，系統會要求您同意，需要提供以下內容
- 事件連接器端點
- 連線到網頁掛鉤
開始使用連接器
部落連接器的目的是讓您與任何 Power Automate 連接器整合，並將部落邊緣邏輯擴展到其內部可以提供的範圍之外。 部落連接器提供觸發器來通知，例如申請人已更新詳細資訊以及可在部落邊緣中執行的操作，例如建立新的許可檢查類型。
以下重點介紹了 2 種常見情況。
- 使用 Excel 連接器從雲端中託管的 Excel 試算表擷取資料列，並使用部落建立和更新動作來填入參考資料。
- 使用部落連接器來接聽人員是否已更新、擷取該人員的詳細數據，並透過 Teams 連接器通知員工。
已知問題與限制
- 透過 Tribal Edge 產生的觸發程式只會繼續需要進一步查詢的唯一識別層。 可以執行單獨的操作來擷取受權限保護的詳細資訊，以了解更多資訊。
- 觸發器和動作目前正在開發中，這些觸發器和動作將在準備就緒時在聯結器中可用。
常見錯誤和補救措施
- 執行動作時，您可能會收到權限錯誤。 這可以透過向管理員請求權限來解決。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 環境 | 字串 | 環境 | 對 |
| 區域 | 字串 | 區域 | 對 |
| Edge 租用戶識別碼 | 字串 | Tribal Edge 的租用戶識別碼 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| HTTP 要求 |
將 HTTP 要求傳送至 Edge |
| 刪除子實體 |
刪除子實體 |
| 刪除實體 |
刪除實體 |
| 取代子實體 |
這會取代子實體的內容。 這會從實體中移除任何尚未包含的屬性。 |
| 取代實體 |
這會取代實體的內容。 這會從實體中移除任何尚未包含的屬性。 |
| 將文件上傳至子實體 |
將文件上傳至子實體 |
| 將文件上傳至實體 |
將文件上傳至實體 |
| 建立子實體 |
建立子實體 |
| 建立實體 |
建立實體 |
| 讀取子實體 |
讀取子實體 |
| 讀取子實體集合 |
讀取子實體集合 |
| 讀取實體 |
讀取實體 |
| 讀取實體集合 |
讀取實體集合 |
HTTP 要求
將 HTTP 要求傳送至 Edge
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | string |
包含資訊的服務 |
|
|
Key
|
key | string |
Key |
|
|
value
|
value | string |
value |
|
|
動詞
|
verb | True | string |
HTTP 動詞 |
|
身體
|
body | string |
要求內文 |
|
|
相對URL，例如/api/referenceData
|
relativeUrl | True | string |
相對 URL |
刪除子實體
刪除子實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父實體
|
parentEntity | True | string |
要刪除子項的父實體 |
|
父實體識別碼
|
parentId | True | string |
父實體的識別碼 |
|
子實體
|
childEntity | True | string |
正在查詢的子實體 |
|
子實體識別碼
|
childId | True | string |
子實體的識別碼 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的相互關聯 ID |
刪除實體
刪除實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
實體
|
entityType | True | string |
要刪除的實體 |
|
Id
|
id | True | string |
實體的識別碼 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的關聯識別碼 |
取代子實體
這會取代子實體的內容。 這會從實體中移除任何尚未包含的屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父實體
|
parentEntity | True | string |
正在更新子系的父實體 |
|
父實體識別碼
|
parentId | True | string |
子系正在更新之父實體的唯一識別碼 |
|
子實體
|
childEntity | True | string |
正在更新的父實體 |
|
子實體識別碼
|
childId | True | string |
子實體的識別碼 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的相互關聯 ID |
|
|
If-Match
|
If-Match | True | string |
ETag 新增在 If-Match 標頭中 |
|
body
|
body | True | dynamic |
傳回
取代實體
這會取代實體的內容。 這會從實體中移除任何尚未包含的屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
實體
|
entityType | True | string |
正在更新的實體 |
|
Id
|
id | True | string |
實體的識別碼 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的相互關聯 ID |
|
|
If-Match
|
If-Match | True | string |
ETag 新增在 If-Match 標頭中 |
|
body
|
body | True | dynamic |
傳回
將文件上傳至子實體
將文件上傳至子實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父實體
|
parentEntity | True | string |
子項的父實體 |
|
父實體識別碼
|
parentId | True | string |
子項父實體的唯一識別碼 |
|
子實體
|
childEntity | True | string |
上傳文件的子實體 |
|
子實體識別碼
|
childId | True | string |
子實體的識別碼 |
|
要執行操作的輸入檔案。
|
file | True | file |
要執行操作的輸入檔案。 |
|
要上傳的文件類型
|
documentTypeName | string |
要上傳的文件類型 |
|
|
誰建立了文件
|
createdBy | string |
誰建立了文件 |
將文件上傳至實體
將文件上傳至實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
實體
|
entityType | True | string |
正在建立的實體 |
|
Id
|
id | True | string |
實體的識別碼 |
|
要執行操作的輸入檔案。
|
file | True | file |
要執行操作的輸入檔案。 |
|
要上傳的文件類型
|
documentTypeName | string |
要上傳的文件類型 |
|
|
誰建立了文件
|
createdBy | string |
誰建立了文件 |
建立子實體
建立子實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父實體
|
parentEntity | True | string |
建立子系的父實體 |
|
父實體識別碼
|
parentId | True | string |
正在建立子項之父實體的唯一識別碼 |
|
子實體
|
childEntity | True | string |
正在建立的子實體 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的關聯識別碼 |
|
|
body
|
body | True | dynamic |
傳回
建立實體
建立實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
實體
|
entityType | True | string |
正在建立的實體 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的關聯識別碼 |
|
|
body
|
body | True | dynamic |
傳回
讀取子實體
讀取子實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父實體
|
parentEntity | True | string |
正在讀取子項的父實體 |
|
父實體識別碼
|
parentId | True | string |
正在建立子項之父實體的唯一識別碼 |
|
子實體
|
childEntity | True | string |
正在讀取的子實體 |
|
子實體識別碼
|
childId | True | string |
子實體的識別碼 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的關聯識別碼 |
傳回
讀取子實體集合
讀取子實體集合
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父實體
|
parentEntity | True | string |
正在讀取子項的父實體 |
|
父實體識別碼
|
parentId | True | string |
正在建立子項之父實體的唯一識別碼 |
|
子實體
|
childEntity | True | string |
正在讀取的子實體 |
|
要略過的記錄
|
skip | True | integer |
要略過的記錄數 |
|
要拍攝的記錄
|
take | True | integer |
要擷取的記錄數目 |
|
Filter
|
filter | string |
使用 Open Data Protocol 語法篩選記錄 |
|
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的關聯識別碼 |
傳回
讀取實體
讀取實體
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
實體
|
entityType | True | string |
正在讀取的實體 |
|
Id
|
id | True | string |
實體的識別碼 |
|
相互關聯標識碼
|
x-correlation-id | string |
在 x-correlation-id 標頭中新增的關聯識別碼 |
傳回
讀取實體集合
讀取實體集合
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
實體
|
entityType | True | string |
正在讀取的實體 |
|
要略過的記錄
|
skip | True | integer |
要略過的記錄數 |
|
要拍攝的記錄
|
take | True | integer |
要擷取的記錄數目 |
|
Filter
|
filter | string |
使用 Open Data Protocol 語法篩選記錄 |
傳回
觸發程序
| 刪除實體時 |
刪除實體時 |
| 在實體上執行長時間執行的作業時 |
在實體上執行長時間執行的作業時 |
| 在實體上觸發事件時 |
在實體上觸發事件時 |
| 建立實體時 |
建立實體時 |
| 更新實體時 |
更新實體時 |
刪除實體時
刪除實體時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
實體
|
entityType | True | string |
要刪除的實體 |
|
實體
|
key | string |
進一步篩選實體 |
|
|
value
|
value | string |
value |
傳回
在實體上執行長時間執行的作業時
在實體上執行長時間執行的作業時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
實體
|
entityType | True | string |
實體 |
|
事件類型
|
eventType | True | string |
事件類型 |
|
房產
|
key | string |
進一步篩選實體 |
|
|
價值觀
|
value | string |
價值觀 |
傳回
在實體上觸發事件時
在實體上觸發事件時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
實體類型
|
entityType | True | string |
觸發的實體 |
|
事件類型
|
eventType | True | string |
作業的事件類型 |
|
實體
|
key | string |
進一步篩選實體 |
|
|
value
|
value | string |
value |
傳回
建立實體時
建立實體時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
實體
|
entityType | True | string |
正在建立的實體 |
|
實體
|
key | string |
進一步篩選實體 |
|
|
value
|
value | string |
value |
傳回
更新實體時
更新實體時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
服務
|
service | True | string |
包含資訊的服務 |
|
實體
|
entityType | True | string |
正在更新的實體 |
|
實體
|
key | string |
進一步篩選實體 |
|
|
value
|
value | string |
value |