从 Azure Function 查询 Dataverse 审核日志

如何解决从 Azure Function 查询 Dataverse 审核日志

我对此很陌生，所以请原谅我

我们有一个要求 Every X days,query changes made in tables/records in dataverse and send email with these changes

根据我的研究，这可以通过 Power Automate 完成，因此每 7 天运行一次 HTTP 触发器，该触发器触发 C# 函数，该函数查询审计日志并发送一封包含已更改内容表的电子邮件。

我在我的测试环境中使用了审计日志记录，它显示了对表所做的更改，其余部分我不确定。

我遇到的主要问题是如何从 C# Azure Function 应用程序查询 dataverse 审计日志？

解决方法

使用 Azure 函数

您可以使用 audits 实体集名称对 Dataverse Web API 执行 HTTP 请求。该请求类似于：

GET /api/data/v9.2/audits HTTP/1.1
Host: {organizationUniqueName}.{region}.dynamics.com
Authorization: Bearer eyJ0eXAi...

请注意，您需要在请求中提供不记名身份验证令牌（有关如何执行此操作的详细信息，请参阅 Use OAuth authentication with Microsoft Dataverse。有关查询 Dataverse Web API 的综合指南，请参阅 Query data using the Web API。>

或者，您可以使用以下任一 NuGet 包来使用 C# 查询 Dataverse。

1. Microsoft.CrmSdk.CoreAssemblies（仅适用于 Azure Function 运行时 1.x）
2. Microsoft.PowerPlatform.Dataverse.Client（公开预览。适用于运行时 2.x+）

关于您选择使用的包，C# 代码看起来或多或少相同，除了 ServiceClient 适用于第二个 NuGet 包，而 CrmServiceClient 适用于第一个包.

var client = new CrmServiceClient(connectionString);

var auditLogsQuery =
    @"<fetch top='50' >
        <entity name='audit' >
            <filter>
            <condition attribute='operation' operator='eq' value='1' />
            <condition attribute='createdon' operator='last-x-hours' value='1' />
            </filter>
        </entity>
    </fetch>";

EntityCollection auditLogs = client.RetrieveMultiple(new FetchExpression(auditLogsQuery));

使用 Power Automate

看到您提到使用 Power Automate，我建议您考虑使用它来满足您的要求。通过内置的 Dataverse 连接器在 Dataverse 中查询数据是 Power Automate 的原生功能。

假设您有以下 Fetch XML 查询，用于提取操作为 Create (1) 且操作在过去一小时内执行的所有审核日志。

提示：您可以使用 FetchXML Builder 中的 XrmToolBox 插件来创作这些查询。不支持在高级查找中查询审核日志。

<fetch top="50" >
  <entity name="audit" >
    <filter>
      <condition attribute="operation" operator="eq" value="1" />
      <condition attribute="createdon" operator="last-x-hours" value="1" />
    </filter>
  </entity>
</fetch>

使用 Dataverse List rows 操作，您可以指定要查询 Audits 表并在该操作的 Fetch Xml Query 属性中提供上述 Fetch XML 查询。请参阅下面的示例：

此查询的结果现在可在整个 Power Automate 云流中使用。例如，这里我使用 Compose 操作为返回的审核日志写出 Operation、Record Type、Record ID 和 Changed Field。>