使用代码还原已删除的记录

使用 SDK 时，可以使用 FetchXml 或 QueryExpression 检索数据。

使用 FetchXml 检索数据时，检索记录时，将 fetch 元素datasource 属性设置为“bin”。

static EntityCollection GetDeletedAccountRecordsFetchXml(IOrganizationService service) {

   string queryString = @"<fetch top='3' datasource='bin'>
                     <entity name='account'>
                        <attribute name='name' />
                     </entity>
                     </fetch>";
   
   FetchExpression query = new(queryString);

   return service.RetrieveMultiple(query);
}

使用 QueryExpression 检索数据时，检索记录时，请将 QueryExpression.DataSource 属性设置为“bin”。

static EntityCollection GetDeletedAccountRecordsQueryExpression(IOrganizationService service) {

   QueryExpression query = new("account") { 
         ColumnSet = new ColumnSet("name"),
         DataSource = "bin",
         TopCount = 3
   };

   return service.RetrieveMultiple(query);
}

• 使用 FetchXml 检索数据
• 使用 QueryExpression 生成查询

通过使用 Web API，可以使用 FetchXml 或 OData 语法检索记录。

使用 FetchXml 检索数据时，检索记录时，将 fetch 元素datasource 属性设置为“bin”。

此 Get-DeletedAccountRecords PowerShell 函数最多返回三个已删除的帐户记录。

本文中的此 Web API 示例和其他示例依赖于 $environmentUrl 和 $baseHeaders 变量，如 Quick Start Web API 与 PowerShell 和 Visual Studio Code 中所述。

function Get-DeletedAccountRecords{

   $query = @()
   $query += "<fetch top='3' datasource='bin'>"
   $query += "<entity name='account'>"
   $query += "<attribute name='name' />"
   $query += "</entity>"
   $query += "</fetch>"

   $uri = $environmentUrl
   $uri += 'accounts'
   $uri += '?fetchXml=' + [uri]::EscapeUriString($query -join '')

   $RetrieveMultipleRequest = @{
      Uri     = $uri
      Method  = 'Get'
      Headers = $baseHeaders
   }
   Invoke-RestMethod @RetrieveMultipleRequest

}

• 使用 FetchXml 检索数据
• 将 PowerShell 和 Visual Studio Code 与 Dataverse Web API 配合使用

如何使用 SDK for .NET 还原记录取决于是使用 pac modelbuilder 生成早期绑定类型还是使用后期绑定样式。

了解如何使用 .NET SDK 进行晚绑定和早绑定编程

早期绑定示例

静态RestoreAccountRecordEarlyBound方法使用RestoreRequest<T>生成的Account和类。

/// <summary>
/// Restores an account record
/// </summary>
/// <param name="service">The authenticated IOrganizationService instance</param>
/// <param name="accountId">The ID of the deleted account record.</param>
/// <param name="originalName">The original name value for the account record.</param>
/// <returns>The ID of the restored account</returns>
static Guid RestoreAccountRecordEarlyBound(
    IOrganizationService service, 
    Guid accountId,
    string originalName)
{
    Account accountToRestore = new()
    {
        Id = accountId,
        // Appending '(Restored)' to the original name
        // to demonstrate overwriting a value.
        Name = originalName + " (Restored)"
    };

    RestoreRequest<Account> request = new()
    {
        Target = accountToRestore
    };

    var response = (RestoreResponse)service.Execute(request);
    return response.id;
}

后期绑定示例

静态 RestoreAccountRecordLateBound 方法使用 OrganizationRequest 类调用 Restore 消息，并设置 Target 参数。

/// <summary>
/// Restores an account record
/// </summary>
/// <param name="service">The authenticated IOrganizationService instance</param>
/// <param name="accountId">The ID of the deleted account record.</param>
/// <param name="originalName">The original name value for the account record.</param>
/// <returns>The ID of the restored account</returns>
static Guid RestoreAccountRecordLateBound(
   IOrganizationService service,
   Guid accountId,
   string originalName)
{
   Entity accountToRestore = new("account", accountId)
   {
         Attributes = {
            // Appending '(Restored)' to the original name
            // to demonstrate overwriting a value.
            {"name", originalName + " (Restored)"}
         }
   };

   OrganizationRequest request = new("Restore")
   {
         Parameters = {
            { "Target", accountToRestore }
         }
   };

   OrganizationResponse response = service.Execute(request);

   return (Guid)response.Results["id"];
}

将消息与用于 .NET 的 SDK 配合使用

使用 “还原”操作 还原已删除的记录。 此操作返回一个 RestoreResponse 复杂类型，该复杂类型 的属性 id 设置为已还原记录的 ID。

恢复任何类型的记录，且不覆盖列值

Restore-AnyRecord PowerShell 函数演示如何通过使用记录的完整 URL 和@odata.id注释来还原任何类型的记录。 将像contacts(0ad63f65-990d-ef11-9f89-6045bdece8bb)这样的相对 URL 传递给此函数的relativeUri参数。 然而，采用这种方法无法更改记录中的任何值。

function Restore-AnyRecord{
   param(
      [Parameter(Mandatory)]
      [uri]$relativeUri
   )

   $uri = $environmentUrl + 'api/data/v9.2/'
   $uri += 'Restore'
   
   $body = @{
      'Target' = @{
         '@odata.id' = $environmentUrl + 'api/data/v9.2/' + $relativeUri
      }
   }

   $postHeaders = $baseHeaders.Clone()
   $postHeaders.Add('Content-Type', 'application/json')

   $RestoreRequest = @{
      Uri     = $uri
      Method  = 'Post'
      Headers = $postHeaders
      Body    = (ConvertTo-Json $body) 
   }
  
  $id = Invoke-RestMethod @RestoreRequest | Select-Object -ExpandProperty id

  return $id
}

还原记录并覆盖列值

Restore-AccountRecord PowerShell 函数演示如何还原帐户记录并重写值。 有三个要求：

• 使用 @odata.type 并指定实体类型的完全限定名称来指定表类型参数 。 此批注告知 OData 它是哪种类型的记录。
• 若要指定记录，请包含主键值，在本例 accountid 中。
• 指定您要覆盖的任何属性，在此情况下为属性 name。

function Restore-AccountRecord {
   param(
      [Parameter(Mandatory)]
      [guid]$recordId,
      [Parameter(Mandatory)]
      [string]$originalName
   )
   
   $uri = $environmentUrl
   $uri += 'Restore'
   
   $body = @{
      'Target' = @{
         '@odata.type' = 'Microsoft.Dynamics.CRM.account'
         # Appending '(Restored)' to the original name
         # to demonstrate overwriting a value.
         'name'       = ($originalName + ' (Restored)')
         'accountid'  = $recordId.Guid
      }
   }

   $postHeaders = $baseHeaders.Clone()
   $postHeaders.Add('Content-Type', 'application/json')

   $RestoreRequest = @{
      Uri     = $uri
      Method  = 'Post'
      Headers = $postHeaders
      Body    = (ConvertTo-Json $body) 
   }
  
  $id = Invoke-RestMethod @RestoreRequest | Select-Object -ExpandProperty id

  return $id
}

使用此静态 SetCleanupIntervalInDays 方法可设置特定表的 CleanupIntervalInDays 列值。

/// <summary>
/// Updates the CleanupIntervalInDays value for a specified table
/// </summary>
/// <param name="service">The authenticated IOrganizationService instance</param>
/// <param name="entityId">The entityId of the table</param>
/// <param name="cleanupIntervalInDays">The new CleanupIntervalInDays value</param>
static void SetCleanupIntervalInDays(
    IOrganizationService service,
    Guid entityId,
    int cleanupIntervalInDays)
{

    QueryExpression query = new("recyclebinconfig")
    {
        ColumnSet = new ColumnSet("recyclebinconfigid"),
        Criteria = new FilterExpression(LogicalOperator.And)
        {
            Conditions = {
              {
                  new ConditionExpression(
                      attributeName: "extensionofrecordid",
                      conditionOperator: ConditionOperator.Equal,
                      value: entityId)
              }
          }
        }
    };

    EntityCollection records = service.RetrieveMultiple(query);

    if (records.Entities.Count.Equals(1))
    {
        Guid id = records.Entities[0].Id;

        Entity record = new(entityName: "recyclebinconfig", id: id)
        {
            Attributes = {
                { "cleanupintervalindays", cleanupIntervalInDays }
            }
        };

        service.Update(record);

    }
    else
    {
        throw new Exception($"Deleted record keeping configuration for table '{tableLogicalName}' not found.");
    }
}

使用 .NET 的软件开发工具包 (SDK)

此 Set-CleanupIntervalInDays PowerShell 函数检索 recyclebinconfig 中与参数 $tableEntityId 相匹配的 entityId 的数据行。 然后将记录的 cleanupintervalindays 列属性更新为 $cleanupIntervalInDays 参数的值。

此函数依赖于Get-Records和Update-Record函数，这些函数在创建表操作函数中有所描述。

function Set-CleanupIntervalInDays{
      param(
         [Parameter(Mandatory)]
         [guid]$tableEntityId,
         [Parameter(Mandatory)]
         [int]$cleanupIntervalInDays
      )
      $records = (Get-Records `
         -setName 'recyclebinconfigs' `
         -query "?`$filter=_extensionofrecordid_value eq $($tableEntityId)").value
   
      if ($records.Count -eq 1) {
         $recyclebinconfigId = $records[0].recyclebinconfigid
   
         Update-Record `
               -setName 'recyclebinconfigs' `
               -id $recyclebinconfigId `
               -body @{
               'cleanupintervalindays' = $cleanupIntervalInDays
         }
      }
      else {
         Write-Host "Deleted record keeping configuration for table $tableEntityId not found."
      }
}

• 使用 Microsoft Dataverse Web API
• 《使用 PowerShell 和 Visual Studio Code 快速启动 Web API》
• 将 PowerShell 和 Visual Studio Code 与 Dataverse Web API 配合使用