c# - 从 Azure Function 查询 Dataverse 审核日志

Question

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

我们有一个要求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 审计日志？

Answer 1

使用 Azure 函数

audits您可以使用实体集名称对 Dataverse Web API 执行 HTTP 请求。该请求看起来像：

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

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

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

1. Microsoft.CrmSdk.CoreAssemblies（仅适用于 Azure Function runtime 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，我建议您考虑使用它来满足您的要求。通过内置的 Dataverse 连接器查询 Dataverse 中的数据是 Power Automate 的本机。

假设您有以下Fetch XML查询来拉回操作为Create(1) 且操作在过去一小时内执行的所有审计日志。

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

<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>

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

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