Recuperar o histórico de alterações auditadas nos dados

Ao habilitar a auditoria e alterar dados em tabelas e colunas auditadas, você pode recuperar o histórico de alterações dessas tabelas e colunas.

Você não pode acessar dados de auditoria usando o ponto de extremidade do Dataverse TDS (SQL).

O histórico de auditoria não está disponível para tabelas no aplicativo móvel.

Tabela de auditoria

A tabela Auditoria (Audit) armazena eventos de auditoria. Na API Web, o EntityType de auditoria é o recurso para esses dados. A tabela de auditoria é somente leitura.

A tabela de auditoria fornece os dados para Exibir resumo da auditoria exibido no centro de administração do Power Platform.

Certifique-se de que o usuário de chamada tem o prvReadAuditSummary privilégio de recuperar dados da tabela.

A tabela a seguir resume colunas importantes na tabela de auditoria.

SchemaName Nome lógico DisplayName	Tipo	Description
`Action` `action` Acontecimento	Opção	Representa o evento que causou a alteração. Saiba mais sobre ações disponíveis.
`AttributeMask` `attributemask` Campo Alterado	Memorando	Quando a alteração representa uma alteração nos dados de registro, contém uma lista separada por vírgulas de números que correspondem ao AttributeMetadata.ColumnNumber para as colunas que foram alteradas. Observação: Não use esses dados. Em vez disso, use as mensagens para recuperar o histórico de alterações.
`AuditId` `auditid` ID do registro	Identificador exclusivo	Identifica a chave primária da tabela de auditoria.
`CallingUserId` `callinguserid` Chamando o usuário	Lookup	Identifica o usuário chamador quando a personificação é usada para a operação; caso contrário, nulo.
`CreatedOn` `createdon` Data da Alteração	DateTime	Identifica quando o registro de auditoria foi criado, que é quando a operação do usuário ocorreu. Em julho de 2025, a precisão desse valor foi aprimorada para incluir milissegundos. Essa alteração captura a sequência correta de eventos de auditoria em transações que têm várias operações.
`ObjectId` `objectid` Registro	Lookup	Identifica exclusivamente o registro que foi auditado.
`ObjectTypeCode` `objecttypecode` Entidade	Nome da entidade	Exibe o nome lógico da tabela referenciada pela `objectid` coluna.
`Operation` `operation` Operation	Opção	Identifica a operação que criou o registro de auditoria; um dos quatro valores: 1 = Criar 2 = Atualizar 3 = Excluir 4 = Acesso
`UserId` `userid` Alterado por	Lookup	Exibe a ID do usuário que alterou os dados.

Ações de auditoria

Use Escolhas/Opções de ação para filtrar eventos específicos. As tabelas a seguir categorizam os eventos.

Eventos de linha da tabela

Esses eventos capturam alterações em um registro.

Valor	Label	Message	Description
1	Create	`Create`	Um registro é criado.
2	Update	`Update`	Um registro é atualizado.
3	Delete	`Delete`	Um registro é excluído.
12	Merge	`Merge`	Um registro é mesclado com outro.
13	Assign	`Assign`	O `ownerid` valor da coluna de um registro de tabela de propriedade do usuário é alterado.
41	Definir status	`SetState`	O valor da coluna `statecode` de um registro é alterado.

Esses eventos capturam alterações no acesso ao registro quando um registro é compartilhado.

Valor	Label	Message	Description
14	Share	`GrantAccess`	Um usuário recebe privilégios sobre um registro.
48	Alterar compartilhamento	`ModifyAccess`	Os privilégios concedidos a um usuário são alterados.
49	Cancelar compartilhamento	`RevokeAccess`	O acesso de um usuário a um registro é removido.

Eventos de relacionamento muitos-para-muitos

Esses eventos capturam alterações para relacionamentos muitos-para-muitos.

Valor	Label	Message	Description
33	Entidades associadas	`Associate`	Um ou mais registros estão associados a outro.
34	Desassociar entidades	`Disassociate`	Um ou mais registros são desassociados de outro.
53	Atribuir função à equipe	`Associate`	Um perfil de segurança é atribuído a uma equipe.
54	Remover papel da equipe	`Disassociate`	Uma função de segurança é removida de uma equipe.
55	Atribuir função ao usuário	`Associate`	Uma função de segurança é atribuída a um usuário.
56	Remover função do usuário	`Disassociate`	Uma função de segurança é removida de um usuário.

Eventos de acesso do usuário

Essas opções capturam o histórico de acesso do usuário quando a auditoria de acesso do usuário está habilitada. O registro de auditoria desses eventos tem um operation valor de coluna de 4.

Valor	Label	Description
64	Acesso do usuário via Web	O usuário está acessando o Dataverse usando um aplicativo baseado em modelo.
65	Acesso do usuário via serviços da Web	O usuário está acessando o Dataverse com serviços Web usando um cliente diferente de um aplicativo baseado em modelo.
112	Auditoria de acesso do usuário iniciada	A auditoria de acesso do usuário começou.
113	Auditoria de acesso do usuário interrompida	A auditoria de acesso do usuário terminou.

O Exemplo: auditar o acesso do usuário mostra como usar essas opções de ação para auditar o acesso do usuário.

Eventos de alteração de metadados

Esses eventos capturam alterações nas definições de tabela e coluna e alterações na tabela Organization.

Valor	Label	Description
100	Excluir Entidade	O usuário excluiu uma tabela.
101	Excluir Atributo	O usuário excluiu uma coluna.
102	Alteração de auditoria no nível da entidade	O usuário alterou uma definição de tabela para habilitar ou desabilitar a auditoria.
103	Alteração de auditoria no nível do atributo	O usuário alterou uma definição de coluna para habilitar ou desabilitar a auditoria.
104	Auditoria de alterações no nível da organização	O usuário alterou as configurações da organização.

Eventos de mudança de auditoria

Esses eventos capturam alterações nas configurações de auditoria.

Valor	Label	Description
105	Auditoria da entidade iniciada	A auditoria foi habilitada para uma tabela.
106	Auditoria de atributos iniciada	A auditoria foi habilitada para uma coluna.
107	Auditoria Habilitada	A auditoria foi habilitada para a organização.
108	Auditoria da entidade interrompida	A auditoria foi desabilitada para uma tabela.
109	Auditoria de atributo interrompida	A auditoria foi desabilitada para um atributo.
110	Audit desabilitado	A auditoria foi desabilitada para uma coluna.
111	Exclusão de log de auditoria	Um log de auditoria foi excluído.

Eventos de alteração de função de segurança

Esses eventos capturam alterações nos papéis de segurança.

Valor	Label	Message	Description
57	Adicionar privilégios ao perfil	`AddPrivilegesRole`	Privilégios foram adicionados a um papel.
58	Remover privilégios do perfil	`RemovePrivilegeRole`	Privilégios foram removidos de um perfil.
59	Substituir privilégios na função	`ReplacePrivilegesRole`	Privilégios para um perfil foram substituídos.

Outras ações

As opções de ação restantes geralmente se referem a operações auditáveis que se aplicam a soluções específicas, como Dynamics 365 Sales, Atendimento ao Cliente e Marketing.

Os rótulos dessas ações devem se alinhar a um valor SdkMessage.Name que representa a ação. A operação específica pode ser uma combinação do nome da ação e de uma tabela. Por exemplo, uma opção com um valor de 10 e o rótulo Fechar deve corresponder às mensagens CloseQuote ou CloseIncident.

Relações da tabela de auditoria

A tabela de auditoria tem apenas duas relações muitos para um com a systemuser tabela:

Relationship	Consulta da tabela de auditoria	Description
`lk_audit_userid`	`userid`	Relaciona o usuário a todos os registros de auditoria criados devido às alterações feitas por ele.
`lk_audit_callinguserid`	`callinguserid`	Relaciona o usuário a qualquer um dos registros de auditoria que ele criou ao se passar por outro usuário.

Você pode usar essas relações para filtrar os registros de dados de auditoria criados para um usuário específico.

A entidade de auditoria dá suporte a apenas uma entidade vinculada em uma consulta. Como existem apenas duas relações com a tabela systemuser, você pode incluir dados da coluna userid ou da coluna callinguserid, mas não ambas ao mesmo tempo.

Você não pode criar consultas usando QueryExpression ou FetchXml que unem dados de auditoria com tabelas diferentes das duas relações formais que existem com a systemuser tabela.

Definição de EntityType de auditoria

Usando a API Web, você pode usar o recurso EntityType de auditoria para ler dados da tabela de auditoria. Os dados a seguir são a definição de EntityType de auditoria do documento de serviço CSDL $metadata da API Web sem anotações.

<EntityType Name="audit" BaseType="mscrm.crmbaseentity">
  <Key>
      <PropertyRef Name="auditid" />
  </Key>
  <Property Name="operation" Type="Edm.Int32" />
  <Property Name="attributemask" Type="Edm.String" Unicode="false" />
  <Property Name="action" Type="Edm.Int32" />
  <Property Name="useradditionalinfo" Type="Edm.String" Unicode="false" />
  <Property Name="createdon" Type="Edm.DateTimeOffset" />
  <Property Name="objecttypecode" Type="Edm.String" Unicode="false" />
  <Property Name="_callinguserid_value" Type="Edm.Guid" />
  <Property Name="_regardingobjectid_value" Type="Edm.Guid" />
  <Property Name="_objectid_value" Type="Edm.Guid" />
  <Property Name="_userid_value" Type="Edm.Guid" />
  <Property Name="transactionid" Type="Edm.Guid" />
  <Property Name="auditid" Type="Edm.Guid" />
  <NavigationProperty Name="callinguserid" Type="mscrm.systemuser" 
    Nullable="false" Partner="lk_audit_callinguserid">
      <ReferentialConstraint Property="_callinguserid_value" 
        ReferencedProperty="systemuserid" />
  </NavigationProperty>
  <NavigationProperty Name="userid" Type="mscrm.systemuser" 
    Nullable="false" Partner="lk_audit_userid">
      <ReferentialConstraint Property="_userid_value" 
        ReferencedProperty="systemuserid" />
  </NavigationProperty>
</EntityType>

Note

A Coluna ChangeData não está incluída no EntityType de auditoria da API Web. Não use esses dados. Em vez disso, use as mensagens para recuperar o histórico de alterações de auditoria.

Exemplo: localizar registros de contato excluídos por um usuário

Os exemplos a seguir são consultas que mostram o histórico de auditoria dos registros de contato excluídos por um usuário específico.

Web API
SDK para .NET

Ambas as consultas a seguir retornam a mesma resposta.

A consulta a seguir filtra pela propriedade _userid_value do registro de auditoria em que o valor corresponde a <user id>.

Solicitação:

GET [Organization URI]/api/data/v9.2/audits?$select=_objectid_value,objecttypecode,createdon,_userid_value&$orderby=createdon desc&$filter=operation eq 3 and objecttypecode eq 'contact' and _userid_value eq '<user id>'

Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null
Prefer: odata.include-annotations="*"

A consulta a seguir acessa a coleção de registros de auditoria para um usuário específico com a lk_audit_userid propriedade de navegação com valor de coleção da systemuser tabela, em que o systemuserid valor corresponde a <user id>.

Solicitação:

GET [Organization URI]/api/data/v9.2/systemusers(<user id>)/lk_audit_userid?$select=_objectid_value,objecttypecode,createdon,_userid_value&$orderby=createdon desc&$filter=operation eq 3 and objecttypecode eq 'contact'

Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null
Prefer: odata.include-annotations="*"

Resposta:

HTTP/1.1 200 OK
Preference-Applied: odata.include-annotations="*"

{
  "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#audits(_objectid_value,objecttypecode,createdon,_userid_value)",
  "@Microsoft.Dynamics.CRM.totalrecordcount": -1,
  "@Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded": false,
  "value": [
    {
      "_objectid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "contact",
      "_objectid_value": "0e76dc8a-41b5-ec11-983f-0022482bf046",
      "objecttypecode@OData.Community.Display.V1.FormattedValue": "Contact",
      "objecttypecode": "contact",
      "createdon@OData.Community.Display.V1.FormattedValue": "5/12/2022 3:19 PM",
      "createdon": "2022-05-12T22:19:12Z",
      "_userid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "systemuser",
      "_userid_value@OData.Community.Display.V1.FormattedValue": "FirstName LastName",
      "_userid_value": "4026be43-6b69-e111-8f65-78e7d1620f5e"
    },
    < Other results truncated for brevity>
  ]
}

Os dois métodos estáticos a seguir mostram o número de registros de contato que o usuário especificado excluiu. Essas consultas usam agregação, portanto, não se limitam a 5.000 resultados. No entanto, eles estão limitados ao limite mais alto de 50.000 registros para agregação.

ShowNumberContactsDeletedByUserQE usa QueryExpression.

/// <summary>
/// Shows the number of contacts deleted by a user.
/// </summary>
/// <param name="svc">IOrganizationService to use</param>
/// <param name="systemuserid">The user's id.</param>
static void ShowNumberContactsDeletedByUserQE(
    IOrganizationService svc,
    Guid systemuserid)
{
    var columnSet = new ColumnSet("auditid");

    //Adding Attribute expression to use aggregation
    columnSet
        .AttributeExpressions
        .Add(new XrmAttributeExpression(
            attributeName: "auditid",
            aggregateType: XrmAggregateType.Count,
            alias: "count"));

    var query =
    new QueryExpression(entityName: "audit")
    {
        ColumnSet = columnSet
    };

    query.Criteria.AddCondition(
        attributeName: "userid",
        conditionOperator: ConditionOperator.Equal,
        values: systemuserid);

    query.Criteria.AddCondition(
        attributeName: "operation",
        conditionOperator: ConditionOperator.Equal,
        values: 3);

    query.Criteria.AddCondition(
        attributeName: "objecttypecode",
        conditionOperator: ConditionOperator.Equal,
        values: "contact");

    EntityCollection records =
        svc.RetrieveMultiple(query);

    int number = (int)
        ((AliasedValue)records
        .Entities[0]["count"])
        .Value;

    Console.WriteLine(
        $"User has deleted {number} contact records");
}

Saiba mais sobre:

Criar consultas com QueryExpression

ShowNumberContactsDeletedByUserFetchXml usa FetchExpression com uma consulta composta usando FetchXml.

/// <summary>
/// Shows the number of contacts deleted by a user.
/// </summary>
/// <param name="svc">IOrganizationService instance to use</param>
/// <param name="systemuserid">The user's id.</param>
static void ShowNumberContactsDeletedByUserFetchXml(
IOrganizationService svc,
Guid systemuserid)
{
    string fetchXml = $@"<fetch 
    aggregate='true'>
<entity name='audit'>
    <attribute name='auditid' 
        aggregate='count' 
        alias='count' />
    <filter>
        <condition attribute='userid' 
            operator='eq' 
            value='{systemuserid}' />
        <condition attribute='operation' 
            operator='eq' 
            value='3' />
        <condition attribute='objecttypecode' 
            operator='eq' 
            value='2' />
    </filter>
</entity>
</fetch>";

    int number;

    try
    {
        EntityCollection records =
        svc.RetrieveMultiple(new FetchExpression(fetchXml));

        number = (int)
            ((AliasedValue)records
            .Entities[0]["count"])
            .Value;
    }
    catch (Exception)
    {
        throw;
    }
    Console.WriteLine(
        $"User has deleted {number} contact records");
}

Saiba mais sobre:

Recuperar o histórico de alterações de auditoria

Para recuperar as alterações em dados auditados, use qualquer uma das mensagens a seguir.

Web API	SDK para .NET	Description
Função RetrieveAuditDetails	Classe RetrieveAuditDetailsRequest	Recupere os detalhes completos da auditoria de um registro de auditoria.
Função RetrieveAttributeChangeHistory	Classe RetrieveAttributeChangeHistoryRequest	Recupere o histórico de alterações de uma única coluna de um registro auditado.
Função RetrieveRecordChangeHistory	Classe RetrieveRecordChangeHistoryRequest	Recupere todas as alterações de dados auditadas para um registro específico.

Para usar essas mensagens, verifique se você tem os privilégios prvReadAuditSummary e prvReadRecordAuditHistory.

Tipos de auditDetail

Essas mensagens fornecem mais detalhes que dependem do tipo de ação. Os detalhes usam tipos derivados de um tipo base AuditDetail , conforme mostrado na tabela a seguir.

Web API	SDK para .NET	Description
AuditDetail ComplexType	Classe AuditDetail	Exibe o tipo base das classes derivadas. Fornece acesso ao registro de auditoria.
AttributeAuditDetail ComplexType	Classe AttributeAuditDetail	Fornece detalhes quando ocorrem alterações de dados para um registro. Fornece acesso a valores antigos e novos valores. Retornado pelos seguintes tipos de ações: - Eventos de linha de tabela - Eventos de alteração de metadados - Eventos de alteração de auditoria
RelationshipAuditDetail ComplexType	Classe RelationshipAuditDetail	Fornece detalhes quando os registros são associados ou desassociados usando uma relação muitos para muitos. Fornece o nome da relação e uma lista dos registros alterados pela operação. Retornado por eventos de relacionamento muitos-para-muitos.
RolePrivilegeAuditDetail ComplexType	Classe RolePrivilegeAuditDetail	Fornece detalhes quando as definições dos registros de Cargo de Segurança (Função) são alteradas. Fornece informações sobre os privilégios de função antigos e novos associados à função. Retornado por eventos de alteração de função de segurança.
ShareAuditDetail ComplexType	Classe ShareAuditDetail	Fornece detalhes quando um registro é compartilhado ou deixa de ser compartilhado ou quando o nível de acesso a um registro compartilhado é alterado. Retornado por eventos de compartilhamento de registro.
UserAccessAuditDetail ComplexType	Classe UserAccessAuditDetail	Fornece detalhes para monitorar a auditoria de acesso do usuário. Fornece detalhes sobre o intervalo e o tempo de acesso. Retornado por eventos de acesso do usuário.

Importante

Os tipos de API Web listados anteriormente que herdam de AuditDetail ComplexType não retornam o valor da propriedade de navegação AuditRecord de AuditDetail, da qual devem herdar. O SDK para classes .NET retorna esses dados.
Valores de colunas grandes incluídos em propriedades NewValueAttributeAuditDetail ou OldValue, como Email.Description ou Anotação, são limitados a 5 KB ou cerca de 5.000 caracteres. Reconheça um valor de coluna truncado pelas reticências (...) no final do texto; por exemplo, "lorem ipsum, lorem ip...". Como os dados estão truncados, você não pode usá-los para restaurar as alterações nesses valores de coluna.

mensagem RetrieveAuditDetails

Use esta mensagem para recuperar os detalhes da auditoria de um único registro de auditoria.

Web API
SDK para .NET

RetrieveAuditDetails é uma função associada à tabela de auditoria. Inclua o cabeçalho da solicitação Prefer: odata.include-annotations="*" para obter valores formatados.

O exemplo a seguir mostra o ComplexType AttributeAuditDetail retornado quando o parentaccountid é definido em um registro account.

Solicitação:

GET [Organization URI]/api/data/v9.2/audits(12869c65-d7d3-ec11-b656-281878f0eba9)/Microsoft.Dynamics.CRM.RetrieveAuditDetails

Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null
Prefer: odata.include-annotations="*"

Resposta:

HTTP/1.1 200 OK
OData-Version: 4.0
Preference-Applied: odata.include-annotations="*"

{
 "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.RetrieveAuditDetailsResponse",
 "AuditDetail": {
  "@odata.type": "#Microsoft.Dynamics.CRM.AttributeAuditDetail",
  "InvalidNewValueAttributes": [],
  "LocLabelLanguageCode": 0,
  "DeletedAttributes": {
   "Count": 0,
   "Keys": [],
   "Values": []
  },
  "OldValue": {
   "@odata.type": "#Microsoft.Dynamics.CRM.account"
  },
  "NewValue": {
   "@odata.type": "#Microsoft.Dynamics.CRM.account",
   "_parentaccountid_value@OData.Community.Display.V1.FormattedValue": "A. Datum Corporation",
   "_parentaccountid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "parentaccountid",
   "_parentaccountid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "account",
   "_parentaccountid_value": "d249d106-38b5-ec11-983f-002248296cd0"
  }
 }
}

Saiba mais sobre:

O método estático a seguir ShowAuditDetail retorna detalhes de auditoria para qualquer tipo de detalhes de auditoria que um registro de auditoria possa acompanhar.

/// <summary>
/// Returns audit details for the specified audit record
/// </summary>
/// <param name="svc">The IOrganizationService instance to use.</param>
/// <param name="auditid">The auditid for the audit record.</param>
static void ShowAuditDetail(
    IOrganizationService svc,
    Guid auditid)
{

    RetrieveAuditDetailsRequest req =
                new RetrieveAuditDetailsRequest
                {
                    AuditId = auditid
                };

    RetrieveAuditDetailsResponse resp =
        (RetrieveAuditDetailsResponse)svc.Execute(req);

    DisplayAuditDetail(resp.AuditDetail);
}

Método DisplayAuditDetail

O método estático DisplayAuditDetail exibe diferentes detalhes no console, dependendo do tipo de detalhe de auditoria. Outros exemplos de SDK para .NET nesta página usam esse método.

/// <summary>
/// Displays properties of the different classes derived from AuditDetail
/// </summary>
/// <param name="auditDetail">The instance of a type derived from AuditDetail</param>
static void DisplayAuditDetail(AuditDetail auditDetail)
{
    switch (auditDetail)
    {
        case AttributeAuditDetail aad:

            Entity oldRecord = aad.OldValue;
            Entity newRecord = aad.NewValue;
            List<string> oldKeys = new List<string>();

            //Look for changed or deleted values that are included in the OldValue collection
            oldRecord.Attributes.Keys.ToList().ForEach(k =>
            {
                if (oldRecord.FormattedValues.Keys.Contains(k))
                {
                    if (newRecord.FormattedValues.Contains(k))
                    {
                        Console.WriteLine(
                            $"\tChange:{k}:{oldRecord.FormattedValues[k]} => " +
                            $"{newRecord.FormattedValues[k]}");
                    }
                    else
                    {

                        Console.WriteLine($"\tDeleted:{k}:" +
                            $"{oldRecord.FormattedValues[k]}");
                    }
                }
                else
                {
                    if (newRecord.Attributes.Keys.Contains(k))
                    {

                        Console.WriteLine($"\tChange:{k}:{oldRecord[k]} => " +
                            $"{newRecord[k]}");
                    }
                    else
                    {
                        Console.WriteLine($"\tDeleted:{k}:{oldRecord[k]}");
                    }
                }

                oldKeys.Add(k); //Add to list so we don't check again
            });

            //Look for New values that are only in the NewValues collection
            newRecord.Attributes.Keys.ToList().ForEach(k =>
            {
                if (!oldKeys.Contains(k))//Exclude any keys for changed or deleted values
                {
                    if (newRecord.FormattedValues.Keys.Contains(k))
                    {
                        Console.WriteLine($"\tNew Value:{k} => " +
                            $"{newRecord.FormattedValues[k]}");
                    }
                    else
                    {
                        Console.WriteLine($"\tNew Value:{k}:{newRecord[k]}");
                    }
                }
            });
            break;

        case ShareAuditDetail sad:
            Console.WriteLine($"\tUser: {sad.Principal.Name}");
            Console.WriteLine($"\tOld Privileges: {sad.OldPrivileges}");
            Console.WriteLine($"\tNew Privileges: {sad.NewPrivileges}");
            break;

        //Applies to operations on N:N relationships
        case RelationshipAuditDetail rad:
            Console.WriteLine($"\tRelationship Name :{rad.RelationshipName }");
            Console.WriteLine($"\tRecords:");
            rad.TargetRecords.ToList().ForEach(y =>
            {
                Console.WriteLine($"\tTarget Record :{y.Name}");
            });
            break;

        //Only applies to role record
        case RolePrivilegeAuditDetail rpad:

            List<string> newRolePrivileges = new List<string>();
            rpad.NewRolePrivileges.ToList().ForEach(y =>
            {
                if (y != null)
                {
                    newRolePrivileges.Add(
                    $"\t\tPrivilege Id:{y.PrivilegeId} Depth:{y.Depth}\n");
                }
            });

            List<string> oldRolePrivileges = new List<string>();
            rpad.OldRolePrivileges.ToList().ForEach(y =>
            {
                if (y != null)
                {
                    oldRolePrivileges.Add(
                    $"\t\tPrivilege Id:{(y.PrivilegeId)} Depth:{y.Depth}\n");
                }
            });

            List<string> invalidNewPrivileges = new List<string>();
            rpad.InvalidNewPrivileges.ToList().ForEach(y =>
            {
                if (y != null)
                {
                    invalidNewPrivileges.Add(
                    $"\t\tGuid:{y}\n");
                }
            });

            Console.WriteLine($"\tNew Role Privileges:\n{string.Join(string.Empty, newRolePrivileges.ToArray())}");
            Console.WriteLine($"\tOld Role Privileges:\n{string.Join(string.Empty, oldRolePrivileges.ToArray())}");
            Console.WriteLine($"\tInvalid New Privileges:\n{string.Join(string.Empty, invalidNewPrivileges.ToArray())}"); ;
            break;

        //Only applies for systemuser record
        case UserAccessAuditDetail uaad:
            Console.WriteLine($"\tAccess Time:{uaad.AccessTime}");
            Console.WriteLine($"\tInterval:{uaad.Interval}");
            break;
    }
}

Saiba mais sobre:

mensagem RetrieveAttributeChangeHistory

Use esta mensagem para recuperar uma lista de alterações para uma coluna de tabela específica.

Use o parâmetro PagingInfo para controlar o número de registros a serem retornados e avançar ou voltar pelas páginas. Para solicitações subsequentes, defina a propriedade PagingInfo.PagingCookie como o valor retornado pelo AuditDetailCollection.PagingCookie.

As alterações dessa mensagem são sempre do tipo AttributeAuditDetail.

Web API
SDK para .NET

Este exemplo retorna um único histórico de alterações auditado para a coluna description de um registro de tabela account.

Solicitação:

GET [Organization URI]/api/data/v9.2/RetrieveAttributeChangeHistory(Target=@target,AttributeLogicalName=@attributeLogicalName,PagingInfo=@paginginfo)?
@target={ '@odata.id':'accounts(611e7713-68d7-4622-b552-85060af450bc)'}
&@attributeLogicalName='description'
&@paginginfo={
   "PageNumber": 1,
   "Count": 1,
   "ReturnTotalRecordCount": true
}

Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

Resposta:

HTTP/1.1 200 OK

{
 "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.RetrieveAttributeChangeHistoryResponse",
 "AuditDetailCollection": {
  "MoreRecords": true,
  "PagingCookie": "<cookie page=\"1\"><cookieExtensions ContinuationToken=\"{&quot;pageNumber&quot;:2,&quot;continuationToken&quot;:&quot;[{\\&quot;compositeToken\\&quot;:{\\&quot;token\\&quot;:null,\\&quot;range\\&quot;:{\\&quot;min\\&quot;:\\&quot;3A800000000000000000000000000000\\&quot;,\\&quot;max\\&quot;:\\&quot;3B000000000000000000000000000000\\&quot;}},\\&quot;orderByItems\\&quot;:[{\\&quot;item\\&quot;:\\&quot;2022-05-13T22:06:46.6175613Z\\&quot;}],\\&quot;rid\\&quot;:\\&quot;CVoNAJIidnNsmz0AAADwAw==\\&quot;,\\&quot;skipCount\\&quot;:0,\\&quot;filter\\&quot;:null}]&quot;}\" /></cookie>",
  ,
  "TotalRecordCount": 3,
  "AuditDetails": [
   {
    "@odata.type": "#Microsoft.Dynamics.CRM.AttributeAuditDetail",
    "InvalidNewValueAttributes": [],
    "LocLabelLanguageCode": 0,
    "DeletedAttributes": {
     "Count": 0,
     "Keys": [],
     "Values": []
    },
    "OldValue": {
     "@odata.type": "#Microsoft.Dynamics.CRM.account",
     "description": "Old description value"
    },
    "NewValue": {
     "@odata.type": "#Microsoft.Dynamics.CRM.account",
     "description": "New description value"
    }
   }
  ]
 }
}

Saiba mais sobre:

O ShowAttributeChangeHistory método estático retorna as primeiras 20 alterações auditadas para a coluna especificada no registro especificado.

Esse método depende do método DisplayAuditDetail de exemplo incluído no exemplo de mensagem RetrieveAuditDetails nesta página.

/// <summary>
/// Returns up to 20 audited changes for the specified column of a specified record.
/// </summary>
/// <param name="svc">The IOrganizationService instance to use.</param>
/// <param name="target">The specified record.</param>
/// <param name="columnLogicalName">The specified column.</param>
static void ShowAttributeChangeHistory(IOrganizationService svc,
            EntityReference target,
            string columnLogicalName)
{
    RetrieveAttributeChangeHistoryRequest req =
        new RetrieveAttributeChangeHistoryRequest
        {
            Target = target,
            AttributeLogicalName = columnLogicalName,
            PagingInfo = new PagingInfo
            {
                PageNumber = 1,
                Count = 20,
                ReturnTotalRecordCount = true
            }
        };

    RetrieveAttributeChangeHistoryResponse resp =
        (RetrieveAttributeChangeHistoryResponse)svc.Execute(req);
    var auditDetailCollection = resp.AuditDetailCollection;

    int recordsReturned = auditDetailCollection.AuditDetails.Count;
    int totalRecords = auditDetailCollection.TotalRecordCount;
    Console.WriteLine($"Retrieved {recordsReturned} of " +
        $"{totalRecords} auditdetail records.");

    auditDetailCollection.AuditDetails.ToList().ForEach(x =>
    {

        Entity auditRecord = x.AuditRecord;

        Console.WriteLine($"Change Date: " +
            $"{auditRecord.FormattedValues["createdon"]}");
        Console.WriteLine($"Change By: " +
            $"{((EntityReference)auditRecord["userid"]).Name}");
        Console.WriteLine($"Action: " +
            $"{auditRecord.FormattedValues["action"]}");
        Console.WriteLine($"Operation: " +
            $"{auditRecord.FormattedValues["operation"]}");

        DisplayAuditDetail(auditDetail: x);

        Console.WriteLine();
    });
}

Saiba mais sobre:

Mensagem de RetrieveRecordChangeHistory

A mensagem RetrieveRecordChangeHistory mostra o histórico de alterações de dados para o registro indicado pelo parâmetro Target.

Normalmente, você vê os resultados dessa mensagem como os AttributeAuditDetail dados exibidos em aplicativos controlados por modelos quando você seleciona Relacionados>. Ele mostra os valores antigos e os novos valores dos registros, mas também retorna os tipos RelationshipAuditDetail e ShareAuditDetail.

Você também pode usar essa mensagem com as tabelas role e systemuser para retornar os tipos RolePrivilegeAuditDetail e UserAccessAuditDetail.

Web API
SDK para .NET

O exemplo a seguir retorna apenas as duas primeiras de quatro alterações em um registro de conta.

Solicitação:

GET [Organization URI]/api/data/v9.2/RetrieveRecordChangeHistory(Target=@target,PagingInfo=@paginginfo)?
@target={ '@odata.id':'accounts(611e7713-68d7-4622-b552-85060af450bc)'}
&@paginginfo={
   "PageNumber": 1,
   "Count": 2,
   "ReturnTotalRecordCount": true
}
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0
If-None-Match: null

Resposta:

HTTP/1.1 200 OK

{
 "@odata.context": "[Organization URI]/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.RetrieveRecordChangeHistoryResponse",
 "AuditDetailCollection": {
  "MoreRecords": true,
  "PagingCookie": "<cookie page=\"1\"><cookieExtensions ContinuationToken=\"{&quot;pageNumber&quot;:2,&quot;continuationToken&quot;:&quot;[{\\&quot;compositeToken\\&quot;:{\\&quot;token\\&quot;:null,\\&quot;range\\&quot;:{\\&quot;min\\&quot;:\\&quot;38000000000000000000000000000000\\&quot;,\\&quot;max\\&quot;:\\&quot;38800000000000000000000000000000\\&quot;}},\\&quot;orderByItems\\&quot;:[{\\&quot;item\\&quot;:\\&quot;2022-05-13T22:06:27.8029732Z\\&quot;}],\\&quot;rid\\&quot;:\\&quot;CVoNAJIidnPOnT0AAAAICA==\\&quot;,\\&quot;skipCount\\&quot;:0,\\&quot;filter\\&quot;:null}]&quot;}\" /></cookie>",
  "TotalRecordCount": 4,
  "AuditDetails": [
   {
    "@odata.type": "#Microsoft.Dynamics.CRM.AttributeAuditDetail",
    "InvalidNewValueAttributes": [],
    "LocLabelLanguageCode": 0,
    "DeletedAttributes": {
     "Count": 0,
     "Keys": [],
     "Values": []
    },
    "OldValue": {
     "@odata.type": "#Microsoft.Dynamics.CRM.account",
     "description": "Old description value"
    },
    "NewValue": {
     "@odata.type": "#Microsoft.Dynamics.CRM.account",
     "description": "New description value"
    }
   },
   {
    "@odata.type": "#Microsoft.Dynamics.CRM.AttributeAuditDetail",
    "InvalidNewValueAttributes": [],
    "LocLabelLanguageCode": 0,
    "DeletedAttributes": {
     "Count": 0,
     "Keys": [],
     "Values": []
    },
    "OldValue": {
     "@odata.type": "#Microsoft.Dynamics.CRM.account",
     "_ownerid_value@OData.Community.Display.V1.FormattedValue": "FirstName LastName",
     "_ownerid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "ownerid",
     "_ownerid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "systemuser",
     "_ownerid_value": "4026be43-6b69-e111-8f65-78e7d1620f5e"
    },
    "NewValue": {
     "@odata.type": "#Microsoft.Dynamics.CRM.account",
     "_ownerid_value@OData.Community.Display.V1.FormattedValue": "TeamName",
     "_ownerid_value@Microsoft.Dynamics.CRM.associatednavigationproperty": "ownerid",
     "_ownerid_value@Microsoft.Dynamics.CRM.lookuplogicalname": "team",
     "_ownerid_value": "39e0dbe4-131b-e111-ba7e-78e7d1620f5e"
    }
   }
  ]
 }
}

Note

Os valores de ComplexType AuditDetail retornados não incluem a AuditRecord propriedade, portanto, nenhum dado sobre quem fez a alteração e quando ela foi feita está disponível.

Saiba mais sobre:

Esse ShowRetrieveRecordChangeHistory método estático executa a mensagem RetrieveRecordChangeHistory para um registro especificado e processa a resposta.

Para cada registro de auditoria, ele exibe as propriedades e usa o método DisplayAuditDetail de exemplo definido na Mensagem RetrieveAuditDetails nesta página para exibir os detalhes.

/// <summary>
/// Shows the results of the RetrieveRecordChangeHistory message
/// </summary>
/// <param name="svc">The IOrganizationService instance to use</param>
/// <param name="record">A reference to a record of a table enabled for auditing</param>
static void ShowRetrieveRecordChangeHistory(
    IOrganizationService svc, 
    EntityReference record)
{
    var req = new RetrieveRecordChangeHistoryRequest
    {
        Target = record,
        PagingInfo = new PagingInfo
        {
            PageNumber = 1,
            Count = 20,
            ReturnTotalRecordCount = true
        }
    };

    var resp = (RetrieveRecordChangeHistoryResponse)svc.Execute(req);
    var auditDetailCollection = resp.AuditDetailCollection;

    int recordsReturned = auditDetailCollection.AuditDetails.Count;
    int totalRecords = auditDetailCollection.TotalRecordCount;
    Console.WriteLine($"Retrieved {recordsReturned} of {totalRecords} auditdetail records.");

    auditDetailCollection.AuditDetails.ToList().ForEach(x =>
    {

        Entity auditRecord = x.AuditRecord;

        Console.WriteLine($"Change Date: {auditRecord.FormattedValues["createdon"]}");
        Console.WriteLine($"Change By: {((EntityReference)auditRecord["userid"]).Name}");
        Console.WriteLine($"Action: {auditRecord.FormattedValues["action"]}");
        Console.WriteLine($"Operation: {auditRecord.FormattedValues["operation"]}");

        DisplayAuditDetail(auditDetail: x);
        
        Console.WriteLine();
    });
}

Saiba mais sobre:

Consulte também

Visão geral de auditoria
Configurar a auditoria
Excluir dados de auditoria
Gerir a auditoria do Dataverse
Exemplo: Alterações nos dados da tabela de auditoria
Exemplo: auditar o acesso do usuário

Comentários

Esta página foi útil?

Última atualização em 2026-10-27

Recuperar o histórico de alterações auditadas nos dados

Tabela de auditoria

Ações de auditoria

Eventos de linha da tabela

Registrar eventos de compartilhamento

Eventos de relacionamento muitos-para-muitos

Eventos de acesso do usuário

Eventos de alteração de metadados

Eventos de mudança de auditoria

Eventos de alteração de função de segurança

Outras ações

Relações da tabela de auditoria

Definição de EntityType de auditoria

Exemplo: localizar registros de contato excluídos por um usuário

Recuperar o histórico de alterações de auditoria

Tipos de auditDetail

mensagem RetrieveAuditDetails

mensagem RetrieveAttributeChangeHistory

Mensagem de RetrieveRecordChangeHistory

Consulte também

Comentários

Recursos adicionais