部落 - 平台 （预览版）
通过强大的自定义功能扩展和增强部落招生和部落签证和移民，支持员工、申请人和学生在整个关键行政流程中。 使组织能够构建定制工作流和体验，以解决教育管理中的这些关键领域。
此连接器在以下产品和区域中可用：
| 服务 | 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 | 部落团体 |
| URL | https://www.tribalgroup.com |
| servicedesk@tribalgroup.com |
| 连接器元数据 | |
|---|---|
| 发布者 | 部落团体 |
| 网站 | https://www.tribalgroup.com |
| 隐私策略 | https://www.tribalgroup.com/privacy-policy |
| 类别 | 商业管理 |
部落边缘模块（如部落招生）为员工和学生提供在教育界取得成功所需的工具。 使用部落连接器通知事件，并查询和作部落 Edge 模块中的实体。
先决条件
若要使用部落连接器，需要成为所选模块的部落 Edge 用户。
如何获取凭据
若要访问部落连接器，必须在租户上拥有有权：
- 订阅事件
- 在部落边缘中执行任何作/查询，例如，如果要获取引用数据，则需要“引用数据 - 读取”权限
在 Power Automate 中创建连接时，会提升为：
- 要访问的环境类型，即实时、测试或开发。
- 在 EMEA 或 APAC 中的区域
- 加入部落边缘时收到的租户
输入凭据后，系统会要求你同意，需要以下项
- 事件连接器终结点
- 连接到 Web 挂钩
连接器入门
部落连接器的目的是允许与任何 Power Automate 连接器集成，并将部落边缘逻辑扩展到其内部提供的内容之外。 部落连接器提供触发器来通知，例如，申请人已更新详细信息，并且可以在部落边缘内执行的作，例如创建新的清关检查类型。
下面重点介绍了 2 种常见方案。
- 使用 Excel 连接器从云中托管的 Excel 电子表格中检索行，并使用部落创建和更新作填充引用数据。
- 使用部落连接器侦听人员是否已更新，检索有关该人员的详细信息，并通过 Teams 连接器通知员工成员。
已知问题和限制
- 通过部落边缘生成的触发器仅继续需要进一步查询的唯一标识器。 可以执行单独的作来检索受权限保护的详细信息，以便了解详细信息。
- 触发器和作目前正在开发中，这些触发器和作将在连接器中可用，并且它们已准备就绪。
常见错误和补救措施
- 执行作时，可能会收到权限错误。 可以通过从管理员请求权限来解决此问题。
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| 环境 | 字符串 | 环境 | True |
| 区域 | 字符串 | 区域 | True |
| Edge 租户 ID | 字符串 | 部落边缘的租户 ID | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| HTTP 请求 |
将 HTTP 请求发送到 Edge |
| 创建子实体 |
创建子实体 |
| 创建实体 |
创建实体 |
| 删除子实体 |
删除子实体 |
| 删除实体 |
删除实体 |
| 将文档上传到子实体 |
将文档上传到子实体 |
| 将文档上传到实体 |
将文档上传到实体 |
| 替换子实体 |
这将替换子实体的内容。 这将从尚未包含的实体中删除任何属性。 |
| 替换实体 |
这会替换实体的内容。 这将从尚未包含的实体中删除任何属性。 |
| 读取子实体 |
读取子实体 |
| 读取子实体集合 |
读取子实体集合 |
| 读取实体 |
读取实体 |
| 读取实体集合 |
读取实体集合 |
HTTP 请求
将 HTTP 请求发送到 Edge
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | string |
包含信息的服务 |
|
|
关键值
|
key | string |
关键值 |
|
|
value
|
value | string |
value |
|
|
动词
|
verb | True | string |
HTTP 谓词 |
|
Body
|
body | string |
请求正文 |
|
|
相对 URL，例如 /api/referenceData
|
relativeUrl | True | string |
相对 URL |
创建子实体
创建子实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父实体
|
parentEntity | True | string |
正在创建子级的父实体 |
|
父实体 ID
|
parentId | True | string |
要为其创建子实体的父实体的唯一标识符 |
|
子实体
|
childEntity | True | string |
正在创建的子实体 |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的关联 ID |
|
|
身体
|
body | True | dynamic |
返回
创建实体
创建实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
实体
|
entityType | True | string |
正在创建的实体 |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的关联 ID |
|
|
身体
|
body | True | dynamic |
返回
删除子实体
删除子实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父实体
|
parentEntity | True | string |
正在删除子级的父实体 |
|
父实体 ID
|
parentId | True | string |
父实体的 ID |
|
子实体
|
childEntity | True | string |
正在查询的子实体 |
|
子实体 ID
|
childId | True | string |
子实体的 ID |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的相关 ID |
删除实体
删除实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
实体
|
entityType | True | string |
正在删除的实体 |
|
Id
|
id | True | string |
实体的 ID |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的关联 ID |
将文档上传到子实体
将文档上传到子实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父实体
|
parentEntity | True | string |
子实体的父实体 |
|
父实体 ID
|
parentId | True | string |
子实体的父实体的唯一标识符 |
|
子实体
|
childEntity | True | string |
正在上载文档的子实体 |
|
子实体 ID
|
childId | True | string |
子实体的 ID |
|
要针对其执行作的输入文件。
|
file | True | file |
要针对其执行作的输入文件。 |
|
正在上传的文档的类型
|
documentTypeName | string |
正在上传的文档的类型 |
|
|
创建文档的人员
|
createdBy | string |
创建文档的人员 |
将文档上传到实体
将文档上传到实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
实体
|
entityType | True | string |
正在创建的实体 |
|
Id
|
id | True | string |
实体的 ID |
|
要针对其执行作的输入文件。
|
file | True | file |
要针对其执行作的输入文件。 |
|
正在上传的文档的类型
|
documentTypeName | string |
正在上传的文档的类型 |
|
|
创建文档的人员
|
createdBy | string |
创建文档的人员 |
替换子实体
这将替换子实体的内容。 这将从尚未包含的实体中删除任何属性。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父实体
|
parentEntity | True | string |
正在更新子级的父实体 |
|
父实体 ID
|
parentId | True | string |
要更新子实体的父实体的唯一标识符 |
|
子实体
|
childEntity | True | string |
要更新的父实体 |
|
子实体 ID
|
childId | True | string |
子实体的 ID |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的相关 ID |
|
|
If-Match
|
If-Match | True | string |
在 If-Match 标头中添加的 ETag |
|
身体
|
body | True | dynamic |
返回
替换实体
这会替换实体的内容。 这将从尚未包含的实体中删除任何属性。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
实体
|
entityType | True | string |
正在更新的实体 |
|
Id
|
id | True | string |
实体的 ID |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的相关 ID |
|
|
If-Match
|
If-Match | True | string |
在 If-Match 标头中添加的 ETag |
|
身体
|
body | True | dynamic |
返回
读取子实体
读取子实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父实体
|
parentEntity | True | string |
正在读取子级的父实体 |
|
父实体 ID
|
parentId | True | string |
要为其创建子实体的父实体的唯一标识符 |
|
子实体
|
childEntity | True | string |
正在读取的子实体 |
|
子实体 ID
|
childId | True | string |
子实体的 ID |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的关联 ID |
返回
读取子实体集合
读取子实体集合
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
父实体
|
parentEntity | True | string |
正在读取子级的父实体 |
|
父实体 ID
|
parentId | True | string |
要为其创建子实体的父实体的唯一标识符 |
|
子实体
|
childEntity | True | string |
正在读取的子实体 |
|
要跳过的记录
|
skip | True | integer |
要跳过的记录数 |
|
要获取的记录
|
take | True | integer |
要获取的记录数 |
|
过滤器
|
filter | string |
使用开放数据协议语法筛选记录 |
|
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的关联 ID |
返回
读取实体
读取实体
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
实体
|
entityType | True | string |
正在读取的实体 |
|
Id
|
id | True | string |
实体的 ID |
|
相关 ID
|
x-correlation-id | string |
在 x-correlation-id 标头中添加的关联 ID |
返回
读取实体集合
读取实体集合
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
API 版本
|
api-version | True | string |
要使用的 API 版本 |
|
实体
|
entityType | True | string |
正在读取的实体 |
|
要跳过的记录
|
skip | True | integer |
要跳过的记录数 |
|
要获取的记录
|
take | True | integer |
要获取的记录数 |
|
过滤器
|
filter | string |
使用开放数据协议语法筛选记录 |
返回
触发器
| 创建实体时 |
创建实体时 |
| 删除实体时 |
删除实体时 |
| 在实体上触发事件时 |
在实体上触发事件时 |
| 对实体执行长时间运行的作时 |
对实体执行长时间运行的作时 |
| 更新实体时 |
更新实体时 |
创建实体时
创建实体时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
实体
|
entityType | True | string |
正在创建的实体 |
|
实体
|
key | string |
进一步筛选实体 |
|
|
value
|
value | string |
value |
返回
删除实体时
删除实体时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
实体
|
entityType | True | string |
正在删除的实体 |
|
实体
|
key | string |
进一步筛选实体 |
|
|
value
|
value | string |
value |
返回
在实体上触发事件时
在实体上触发事件时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
实体类型
|
entityType | True | string |
正在触发的实体 |
|
事件类型
|
eventType | True | string |
作的事件类型 |
|
实体
|
key | string |
进一步筛选实体 |
|
|
value
|
value | string |
value |
返回
对实体执行长时间运行的作时
对实体执行长时间运行的作时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
实体
|
entityType | True | string |
实体 |
|
事件类型
|
eventType | True | string |
事件类型 |
|
资产
|
key | string |
进一步筛选实体 |
|
|
价值
|
value | string |
价值 |
返回
更新实体时
更新实体时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
服务
|
service | True | string |
包含信息的服务 |
|
实体
|
entityType | True | string |
正在更新的实体 |
|
实体
|
key | string |
进一步筛选实体 |
|
|
value
|
value | string |
value |