除了 Microsoft Power Automate 和 Power Apps 门户之外,还可以直接通过 Microsoft Dataverse API 管理解决方案自定义连接器。
撰写 HTTP 请求
解决方案连接器存储在 Dataverse 中。 若要了解如何为 Dataverse API 编写 HTTP 请求,包括如何编写 URL 和授权令牌,请参阅 Power Automate Web API。
获取自定义连接器列表
您可以通过在连接器上调用 GET 来获取自定义连接器的列表。 每个连接器具有很多属性。 要了解 Dataverse 属性、字段及其用法,请转到连接器表/实体参考。
您还可以请求特定属性、筛选连接器列表等。 若要了解如何使用 Dataverse 查询数据,请参阅使用 Web API 查询数据。
例如,此查询仅返回显示名称与筛选器中给定的名称匹配的连接器:
GET https://org00000000.crm0.dynamics.com/api/data/v9.1/connectors?$filter= displayname eq 'MyConnector1'
Accept: application/json
Authorization: Bearer ey…
获取特定连接器
要检索特定连接器,请在 URL 中添加其 Dataverse ID。 Dataverse ID 为 GUID。 它与您转到连接器页面时在 URL 中看到的主 ID 不同。 如果您使用之前的 API 来获取多个连接器的列表,其 Dataverse ID 在 connectorid 字段中。
下面是一个示例请求:
GET https://org00000000.crm0.dynamics.com/api/data/v9.1/connectors(00000000-0000-0000-0000-000000000002)
Accept: application/json
Authorization: Bearer ey…
创建连接器
对连接器集合调用 POST 以创建连接器。 连接器所需的属性包括:connectorid、name、displayname、openapidefinition 和 connectortype。 将连接器类型设置为 1。 您还可以提供说明。
下面是一个示例请求:
POST https://org00000000.crm0.dynamics.com/api/data/v9.1/connectors
Accept: application/json
Authorization: Bearer ey…
Content-type: application/json
{
"connectorid": "00000000-0000-0000-0000-000000000003",
"name": "cr736_5Fdemosolnconnector",
"displayname": "DemoSolnConnector",
"openapidefinition": "{\"swagger\":\"2.0\",\"info\":{\"title\":\"demosolutionconnector\",\"description\":\"Sample description.\",\"version\":\"1.0\"},\"host\":\"api.demobackend.com\",\"basePath\":\"/\",\"schemes\":[\"https\"],\"consumes\":[],\"produces\":[],\"paths\":{\"/get\":{\"get\":{\"responses\":{\"default\":{\"description\":\"default\",\"schema\":{}}},\"summary\":\"Get\",\"description\":\"Get\",\"operationId\":\"Get\",\"parameters\":[{\"name\":\"foo1\",\"in\":\"query\",\"required\":false,\"type\":\"string\"},{\"name\":\"foo2\",\"in\":\"query\",\"required\":false,\"type\":\"string\"}]}}},\"definitions\":{},\"parameters\":{},\"responses\":{},\"securityDefinitions\":{},\"security\":[],\"tags\":[]}",
"connectortype": 1
}
备注
不支持通过 Web API 设置自定义连接器图标。 创建连接器后,您可以通过用户界面对其进行更新来设置图标。
Microsoft 不会将自定义连接器的机密存储在 Dataverse 中。 如果任何属性包含机密,它们将被替换为空字符串。 您需要通过用户界面设置机密。 这样做会将机密保存在单独的位置,在管理操作期间将它们填充到连接器中。
更新连接器
您可以对连接器调用 PATCH 来更新它。 此调用需要您在 URL 中指定 connectorid。
例如,可以使用以下调用更新连接器的说明和负责人:
PATCH https://org00000000.crm0.dynamics.com/api/data/v9.1/connectors(00000000-0000-0000-0000-000000000002)?tag=PowerAppsRP
Accept: application/json
Authorization: Bearer ey...
Content-type: application/json
{
"description" : "This is updated description of the custom connector.",
"ownerid@odata.bind": "systemusers(00000000-0000-0000-0000-000000000005)",
}
备注
用于更新所有者的语法使用 odata.bind 格式。 这意味着,没有直接修补 _ownerid_value 字段,而是将 @odata.bind 追加到属性名并使用 systemusers() 整合 ID。
删除连接器
通过 DELETE 调用删除连接器:
DELETE https://org00000000.crm0.dynamics.com/api/data/v9.1/connectors(00000000-0000-0000-0000-000000000002)
Accept: application/json
Authorization: Bearer ey...