Wiederherstellen gelöschter Datensätze mit Code (Vorschau)

Wenn Sie das SDK verwenden, können Sie Daten mithilfe von FetchXml oder QueryExpression abrufen.

Wenn Sie Daten mithilfe von FetchXml abrufen, legen Sie das Fetch-Element-Attributdatasource auf "bin" fest, wenn Sie Datensätze abrufen.

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);
}

Wenn Sie Daten mithilfe von QueryExpression abrufen, legen Sie die QueryExpression.DataSource-Eigenschaft auf "bin" fest, wenn Sie Datensätze abrufen.

static EntityCollection GetDeletedAccountRecordsQueryExpression(IOrganizationService service) {

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

   return service.RetrieveMultiple(query);
}

• Daten mithilfe von FetchXml abrufen
• Abfragen mit QueryExpression erstellen

Mit der Web-API können Sie Datensätze mithilfe der FetchXml- oder OData-Syntax abrufen.

Wenn Sie Daten mithilfe von FetchXml abrufen, legen Sie das Fetch-Element-Attributdatasource auf "bin" fest, wenn Sie Datensätze abrufen.

Diese Get-DeletedAccountRecords PowerShell-Funktion gibt bis zu drei gelöschte Kontodatensätze zurück.

Dieses Web-API-Beispiel und andere in diesem Artikel hängen von den $environmentUrl in $baseHeadersder Schnellstart-Web-API mit PowerShell und Visual Studio Code beschriebenen Variablen ab.

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

}

• Daten mithilfe von FetchXml abrufen
• PowerShell und Visual Studio Code mit der Dataverse-Web-API verwenden

Wie Sie einen Datensatz mithilfe des SDK für .NET wiederherstellen, hängt davon ab, ob Sie frühe gebundene Typen mithilfe des Pac-Modellbuilders generieren oder ob Sie die spät gebundene Formatvorlage verwenden.

Informationen zur spät gebundenen und früh gebundenen Programmierung mithilfe des SDK für .NET

Beispiel für frühe Bindung

Die statische RestoreAccountRecordEarlyBound Methode verwendet die RestoreRequest<T>- und die Account-Klassen, die mit dem pac modelbuilder generiert wurden.

/// <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;
}

Beispiel mit später Bindung

Die statische RestoreAccountRecordLateBound Methode verwendet die OrganizationRequest-Klasse , um die Restore Nachricht aufzurufen und den Target Parameter festzulegen.

/// <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"];
}

Nachrichten mit dem SDK für .NET verwenden

Verwenden Sie die Wiederherstellen-Aktion , um gelöschte Datensätze wiederherzustellen. Dieser Vorgang gibt einen RestoreResponse-Komplextyp zurück, in dem die Eigenschaft id auf die ID des wiederhergestellten Datensatzes festgelegt ist.

Wiederherstellen jeder Art von Datensätzen ohne die Spaltenwerte zu überschreiben

Diese Restore-AnyRecord PowerShell-Funktion zeigt, wie ein beliebiger Typdatensatz wiederhergestellt werden kann, indem er mithilfe der vollständigen URL zum Datensatz und der @odata.id Anmerkung darauf verweist. Übergeben Sie eine relative URL wie contacts(0ad63f65-990d-ef11-9f89-6045bdece8bb) an den relativeUri Parameter dieser Funktion. Mit diesem Ansatz können Sie jedoch keine Werte für den Datensatz überschreiben.

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
}

Wiederherstellen eines Datensatzes und Überschreiben von Spaltenwerten

Diese Restore-AccountRecord PowerShell-Funktion zeigt, wie Sie einen Kontodatensatz wiederherstellen und einen Wert überschreiben. Es gibt drei Anforderungen:

• Legen Sie den Tabellentypparameter mithilfe von @odata.type mit dem vollqualifizierten Namen des Entitätstyps fest. Diese Anmerkung teilt OData mit, um welchen Datensatztyp es sich handelt.
• Um den Datensatz anzugeben, geben Sie den Primärschlüsselwert an, der in diesem Fall accountid ist.
• Geben Sie alle Eigenschaften an, die Sie überschreiben möchten, in diesem Fall die name Eigenschaft.

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
}

Mit dieser statischen SetCleanupIntervalInDays Methode können Sie den CleanupIntervalInDays Spaltenwert für eine bestimmte Tabelle festlegen.

/// <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($"Recycle bin configuration for table '{tableLogicalName}' not found.");
    }
}

Das SDK für .NET verwenden

Diese Set-CleanupIntervalInDays PowerShell-Funktion ruft die recyclebinconfig Zeile mit der Entitäts-ID ab, die dem $tableEntityId Parameter entspricht. Anschließend wird die cleanupintervalindays Spalteneigenschaft des Datensatzes auf den Wert des $cleanupIntervalInDays Parameters aktualisiert.

Diese Funktion hängt von den Funktionen Get-Records und Update-Record, die in Tabellenerstellungsoperationsfunktionen beschrieben sind, ab.

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 "Recycle bin configuration for table $tableEntityId not found."
      }
}

• Microsoft Dataverse-Web-API verwenden
• Schnellstart-Web-API mit PowerShell und Visual Studio Code
• PowerShell und Visual Studio Code mit der Dataverse-Web-API verwenden

Verwenden Sie diese statische DisableRecycleBinForTable Methode, um den Papierkorb für eine bestimmte Tabelle zu deaktivieren.

/// <summary>
/// Disable the Recycle bin for a specified table
/// </summary>
/// <param name="service">The authenticated IOrganizationService instance</param>
/// <param name="tableEntityId">The entityId of the table</param>
static void DisableRecycleBinForTable(
    IOrganizationService service,
    Guid tableEntityId)
{

    QueryExpression query = new("recyclebinconfig")
    {
        ColumnSet = new ColumnSet("recyclebinconfigid")
    };

    LinkEntity entityLink = query.AddLink(
      "entity", 
      "extensionofrecordid", 
      "entityid");

    entityLink.LinkCriteria.AddCondition(
      "extensionofrecordid", 
      ConditionOperator.Equal, 
      tableEntityId);

    EntityCollection recyclebinconfigs = service.RetrieveMultiple(query);

    if (recyclebinconfigs.Entities.Count.Equals(1))
    {

        var id = recyclebinconfigs.Entities[0].GetAttributeValue<Guid>("recyclebinconfigid");

        Entity recyclebinconfig = new("recyclebinconfig", id)
        {
            Attributes = {
                { "statecode", new OptionSetValue(1) },
                { "statuscode", new OptionSetValue(2) }
            }
        };

        service.Update(recyclebinconfig);
    }
    else
    {
        string message = $"Recycle bin configuration for table '{extensionofrecordid}' not found.";
        throw new Exception(message);
    }
}

Das SDK für .NET verwenden

Verwenden Sie diese Disable-RecycleBinForTable-PowerShell-Funktion, um den Papierkorb für eine bestimmte Tabelle zu deaktivieren. Diese Funktion hängt von den in den Funktionen Get-Records und Update-Record beschriebenen Create table operations functions-Funktionen ab.

function Disable-RecycleBinForTable {
   param(
      [Parameter(Mandatory)]
      [guid]$tableId
   )

   $query = "?`$filter=_extensionofrecordid_value eq "
   $query += $tableId
   $query += "&`$select=recyclebinconfigid"

   $recyclebinconfigs = (Get-Records `
         -setName 'recyclebinconfigs' `
         -query $query).value

   if ($recyclebinconfigs.Count -eq 1) {
      $recyclebinconfigId = $recyclebinconfigs[0].recyclebinconfigid

      Update-Record `
         -setName 'recyclebinconfigs' `
         -id $recyclebinconfigId `
         -body @{
         'statecode'  = 1
         'statuscode' = 2
      } | Out-Null
   }
   else {
      Write-Host "Recycle bin configuration for table $tableId not found."
   }
}

• Microsoft Dataverse-Web-API verwenden
• PowerShell und Visual Studio Code mit der Dataverse-Web-API verwenden
• Aktualisieren einer Tabellenzeile