Gelöschte Datensätze mit Code wiederherstellen (Vorschauversion)

Artikel
08/24/2024

[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Manchmal löschen wir Datensätze, die wir nicht löschen sollten. Administrierende können einen Papierkorb für Tabellen aktivieren, damit sie gelöschte Datensätze innerhalb eines bestimmten Zeitraums wiederherstellen können. Erfahren Sie, wie Administrierende gelöschte Datensätze wiederherstellen können

Wenn der Papierkorb aktiviert ist, können Fachkräfte in der Entwicklung die Restore-Nachricht verwenden, um gelöschte Datensätze vor dem angegebenen Zeitraum wiederherzustellen. Der Zeitraum kann bis zu 30 Tage betragen.

Gelöschte Datensätze, die wiederhergestellt werden können, abrufen

Um gelöschte Datensätze, die wiederhergestellt werden können, abzurufen, legen Sie die Datenquelle der Abfrage auf bin fest. In den folgenden Beispielen werden bis zu drei gelöschte Firmendatensätze zurückgegeben.

SDK für .NET
Web-API

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

Wenn Sie Daten mit FetchXml abrufen, legen Sie beim Abrufen von Datensätzen das datasource-Attribut Element abrufen auf bin fest.

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 mit QueryExpression abrufen, legen Sie beim Abrufen von Datensätzen die Eigenschaft QueryExpression.DataSource auf bin fest.

static EntityCollection GetDeletedAccountRecordsQueryExpression(IOrganizationService service) {

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

   return service.RetrieveMultiple(query);
}

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

Hinweis

Mit der Web-API können Sie gelöschte Datensätze derzeit nur mithilfe FetchXml abrufen.

Wenn Sie Daten mit FetchXml abrufen, legen Sie beim Abrufen von Datensätzen das datasource-Attribut Element abrufen auf bin fest.

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

Dieses und andere Web-API-Beispiele in diesem Artikel hängen von den $environmentUrl- und $baseHeaders-Variablen ab, wie in Schnellstart-Web-API mit PowerShell und Visual Studio Code beschrieben.

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

}

Einen gelöschten Datensatz wiederherstellen

Verwenden Sie die Restore-Nachricht, um einen gelöschten Datensatz wiederherzustellen. Der Target-Parameter ist kein Verweis auf einen gelöschten Datensatz, sondern ein vollständiger Datensatz, sodass Sie beim Wiederherstellen des Datensatzes Spaltenwerte festlegen können. Alle ursprünglichen Spaltenwerte werden wiederhergestellt, sofern Sie sie nicht durch das Setzen von Werten während des Restore-Vorgangs überschreiben.

Hinweis

Derzeit können Sie Datensätze nur mit dem Primärschlüsselwert wiederherstellen. Sie können Alternativschlüssel nicht zum Wiederherstellen eines Datensatzes verwenden.

Wie Sie einen gelöschten Datensatz wiederherstellen, hängt davon ab, ob Sie das SDK für .NET oder die Web-API verwenden.

SDK für .NET
Web-API

Wie Sie einen Datensatz mit dem SDK für .NET wiederherstellen, hängt davon ab, ob Sie Typen mit früher Bindung mit pac modelbuilder generieren oder den Stil mit später Bindung verwenden.

Erfahren Sie mehr über die Programmierung mit später oder früher Bindung mit dem SDK für .NET

Beispiel mit früher Bindung

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

/// <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 zum Aufrufen der Restore-Nachricht, wodurch der Target-Parameter festgelegt wird.

/// <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 komplexen RestoreResponse-Typ, bei dem die id-Eigenschaft auf die ID des wiederhergestellten Datensatzes festgelegt ist.

Jeden Datensatztyp wiederherstellen, ohne die Spaltenwerte zu überschreiben

Die Restore-AnyRecord-PowerShell-Funktion zeigt, wie jeder Datensatztyp wiederhergestellt werden kann, indem er mit der vollständigen URL des Datensatzes und der @odata.id-Anmerkung darauf verweisen. Übergeben Sie eine relative URL wie contacts(0ad63f65-990d-ef11-9f89-6045bdece8bb) an den relativeUri-Parameter dieser Funktion. Allerdings können mit dieser Vorgehensweise keine Werte für den Datensatz überschrieben werden.

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
}

Einen Datensatz wiederherstellen und Spaltenwerte überschreiben

Diese Restore-AccountRecord-PowerShell-Funktion zeigt, wie ein Firmendatensatz wiederhergestellt und ein Wert überschrieben wird. Es gibt drei Anforderungen:

Legen Sie den Tabellentypparameter mithilfe von @odata.type durch den vollqualifizierten Namen des Entitätstyps fest. Diese Anmerkund teilt OData mit, um welchen Datensatztyp es sich handelt.
Um den Datensatz anzugeben, nehmen Sie den Primärschlüsselwert mit auf, in diesem Fall accountid.
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
}

Bewährte Methoden für die Wiederherstellung von Datensätzen

Die folgenden Probleme lassen sich beim Wiederherstellen von Datensätzen vermeiden:

Wiederherstellen verknüpfter Datensätze vor Wiederherstellung des primären Datensatzes
Beim Erstellen von Datensätzen keine Primärschlüsselwerte angeben
Datensätze mit übereinstimmenden Alternativschlüsselwerten blockieren die Wiederherstellung
Datensätze mit entfernten Auswahloptionen werden nicht wiederhergestellt
Primärschlüsselverstoß beim Löschen

Wenn einige verknüpfte Datensätze, deren Referenz im Rahmen der Kaskadenbeziehung entfernt wurde, nicht mehr vorhanden sind, schlägt der Wiederherstellungsvorgang fehl. Um dieses Problem zu vermeiden, stellen Sie stets die verknüpften Datensätze wieder her, die nicht als Teil des aktuellen Datensatzes gelöscht wurden, bevor Sie versuchen, den primären Datensatz wiederherzustellen.

Name: RefCannotBeRestoredRecycleBinNotFound
Code: 0x80049959
Nummer: -2147182247
Meldung: Entity with id '<Guid Value>' and logical name '<Entity.LogicalName>' does not exist. We cannot restore the reference '<Referred Primary Key Name>' that must be restored as part of this Restore call. ValueToBeRestored: <Guid Value>, ReferencedEntityName: <Referenced Entity Name>, AttributeName: <Referred Attribute Name>

Beim Erstellen von Datensätzen keine Primärschlüsselwerte angeben

Es hat sich grundsätzlich bewährt, Dataverse beim Erstellen eines Datensatzes immer den Primärschlüssel festlegen zu lassen. Wenn Sie einen neuen Datensatz erstellen, der denselben Primärschlüsselwert wie ein gelöschter Datensatz hat, kann der gelöschte Datensatz nicht wiederhergestellt werden. In diesem Fall müssen Sie den neuen Datensatz löschen, bevor Sie den gelöschten wiederherstellen können.

Name: DuplicateExceptionRestoreRecycleBin
Code: 0x80044a02
Nummer: -2147182279
Meldung: Please delete the existing conflicting record '<Entity Platform Name>' with primary key '<Primary Key Name>' and primary key value '<Primary Key Value>' before attempting restore.

Datensätze mit übereinstimmenden Alternativschlüsselwerten blockieren die Wiederherstellung

Wenn Sie einen Datensatz erstellen, der dieselben Alternativschlüssel-Spaltenwerte wie ein gelöschter Datensatz hat, können Sie ihn nicht wiederherstellen. In diesem Fall müssen Sie den neuen Datensatz löschen, bevor Sie den gelöschten wiederherstellen können.

Name: DuplicateExceptionEntityKeyRestoreRecycleBin
Code: 0x80049929
Nummer: -2147182295
Meldung: Duplicate entity key preventing restore of record '<Entity Platform Name>' with primary key '<Primary Key Name>' and primary key value '<Primary Key Value>'. See inner exception for entity key details.

Datensätze mit entfernten Auswahloptionen werden nicht wiederhergestellt

Wenn Sie eine Optionssatzoption löschen und diese Option in einem gelöschten Datensatz verwendet wurde, können Sie sie nicht wiederherstellen, da die Option jetzt ungültig ist. Überprüfen Sie vor dem Löschen einer Optionssatzoption, dass diese Option in keinem Datensatz (auch keinem gelöschten Datensatz) verwendet wird.

Name: PicklistValueOutOfRangeRecycleBin
Code: 0x80049949
Nummer: -2147182263
Meldung: Picklist value not valid, please add the invalid value back to the picklist before restoring record

Primärschlüsselverstoß beim Löschen

Wenn der Datensatz mit demselben Primärschlüssel zuvor bereits gelöscht wurde, wird das Kopieren in den Papierkorb für den Datensatz ignoriert. Um zu erzwingen, dass alle gelöschten Elemente im Papierkorb gespeichert werden, können Sie die DoNotEnforcePrimaryKeyOrgSettingRecycleBin-Einstellung mit dem OrgDBOrgSettings-Tool für Microsoft Dynamics CRM festlegen.

Nach dem Aktivieren dieser Einstellung erhalten Sie möglicherweise die folgende Fehlermeldung:

Name: DuplicateExceptionRestoreRecycleBin
Code: 0x80049939
Nummer: -2147182279
Meldung: A record that has the attribute values Deleted Object already exists on Delete.

Herausfinden, bei welchen Tabellen der Papierkorb aktiviert ist

Bevor das Papierkorb-Feature aktiviert wird, hat die Tabelle „Papierkorbkonfiguration“ (RecycleBinConfig) keine Zeilen.

Wir gehen davon aus, dass mit der Zeit die Papierkorbfunktion für die meisten Tabellen verfügbar sein wird. Lösungskomponenten, virtuelle Tabellen und elastische Tabellen werden für den Papierkorb nicht unterstützt. Während dieses Vorschauversion werden möglicherweise einige derzeit nicht aktivierte Tabellen später aktiviert (z. B. Tabellen mit mehr als 400 Spalten). Eine Liste der Tabellen, die den Papierkorb nicht unterstützen, finden Sie unter Tabellen, die derzeit nicht für den Papierkorb unterstützt werden.

Sie können den Papierkorb auch für bestimmte Tabellen deaktivieren und den Papierkorb für die Umgebung deaktivieren. Wenn der Papierkorb für eine Tabelle nicht aktiviert ist, gibt es keine Datensätze, die wiederhergestellt werden können. Sie können eine Abfrage in Dataverse durchführen, um herauszufinden, ob der Papierkorb für eine Tabelle aktiviert ist oder nicht.

Tabellen, die für den Papierkorb aktiviert sind, haben eine Zeile in der RecycleBinConfig-Tabelle, in welcher der statecode aktiv und isreadyforrecyclebin auf „true“ gesetzt ist. Die RecycleBinConfig-Tabelle enthält nicht den Namen der Tabelle, sondern verweist auf eine Zeile in der Entitätstabelle, in der die logicalname-Spalte den LogicalName der Tabelle enthält.

Verwenden Sie die folgende FetchXml-Abfrage, um herauszufinden, für welche Tabellen der Papierkorb aktiviert ist:

<fetch>
  <entity name='recyclebinconfig'>
    <filter type='and'>
      <condition attribute='statecode'
        operator='eq'
        value='0' />
      <condition attribute='isreadyforrecyclebin'
        operator='eq'
        value='1' />
    </filter>
    <link-entity name='entity'
      from='entityid'
      to='extensionofrecordid'
      link-type='inner'
      alias='entity'>
      <attribute name='logicalname' />
      <order attribute='logicalname' />
    </link-entity>
  </entity>
</fetch>

Lernen Sie, Daten mithilfe von FetchXML abzufragen

Herausfinden, bei welchen Tabellen der Papierkorb nicht aktiviert ist

Um herauszufinden, bei welchen Tabellen der Papierkorb nicht aktiviert ist, verwenden Sie die folgende FetchXml-Abfrage, bei der es sich um die umgekehrte Abfrage von Herausfinden, bei welchen Tabellen der Papierkorb aktiviert ist handelt.

<fetch>
  <entity name='entity'>
    <attribute name='logicalname' />
    <filter type='or'>
      <condition entityname='recyclebin'
        attribute='extensionofrecordid'
        operator='null' />
      <condition entityname='recyclebin'
        attribute='statecode'
        operator='ne'
        value='0' />
      <condition entityname='recyclebin'
        attribute='isreadyforrecyclebin'
        operator='ne'
        value='1' />
    </filter>
    <order attribute='logicalname' />
    <link-entity name='recyclebinconfig'
      from='extensionofrecordid'
      to='entityid'
      link-type='outer'
      alias='recyclebin' />
  </entity>
</fetch>

Lernen Sie, Daten mithilfe von FetchXML abzufragen

Die Ergebnisse dieser Abfrage finden sich Stand Mai 2024, als diese Vorschaufunktion begann, in Tabellen, die derzeit nicht für den Papierkorb unterstützt werden

Die Konfiguration des automatischen Bereinigungszeitraums für den Papierkorb abrufen und festlegen

Der Wert, der bestimmt, wie lange gelöschte Datensätze zur Wiederherstellung verfügbar sind, wird in der RecycleBinConfig.CleanupIntervalInDays-Spalte, in welcher der Name-Spaltenwert organization lautet. Jede zweite Zeile in der RecycleBinConfig-Tabelle hat einen CleanupIntervalInDays-Spaltenwert von -1. Dieser Wert gibt an, dass dieselben Werte verwendet werden, die für die organization-Tabelle festgelegt sind.

Um einen anderen Wert für eine andere Tabelle anzugeben, legen Sie den CleanupIntervalInDays-Spaltenwert fest, in dem der Name mit dem logischen Namen der Tabelle übereinstimmt. In dieser Spalte sind Werte von bis zu 30 zulässig. Wir empfehlen, sie nicht festzulegen, es sei denn, sie weicht vom Standardwert der Organisation ab.

SDK für .NET
Web-API

Sie können diese statische SetCleanupIntervalInDays-Methode zum Festlegen des CleanupIntervalInDays-Spaltenwert für eine bestimmte Tabelle verwenden.

/// <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 EntityId ab, die mit dem $tableEntityId-Parameter übereinstimmt. Anschließend aktualisiert sie die cleanupintervalindays-Spalteneigenschaft des Datensatzes auf den Wert des $cleanupIntervalInDays-Parameters.

Diese Funktion ist abhängig von den Get-Records- und Update-Record-Funktionen, die in Tabellenvorgangsfunktionen erstellen beschrieben sind.

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."
      }
}

Papierkorb für eine Tabelle deaktivieren

Um den Papierkorb für eine Tabelle zu deaktivieren, deaktivieren Sie den recyclebinconfig-Datensatz für die Tabelle, indem Sie die Eigenschaften statecode und statuscode auf ihre Inaktiv-Werte 2 bzw. 1 festlegen.

Hinweis

Die folgenden Abfragen vergleichen den EntityId-Wert mit dem Entity.EntityId-Spaltenwert, der die Tabelle EntityMetadata.MetadataId speichert.

SDK für .NET
Web-API

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 ist abhängig von den Get-Records- und Update-Record-Funktionen, die in Tabellenvorgangsfunktionen erstellen beschrieben sind

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."
   }
}

Papierkorb für die Umgebung deaktivieren

Hinweis

Die bevorzugte Methode zum Deaktivieren des Papierkorbs für eine Umgebung ist, ihn im im Power Platform Admin Center abzuschalten. Die hier beschriebene Methode kann sich ändern, bevor das Feature allgemein verfügbar wird.

Löschen Sie die Zeile in der RecycleBinConfig-Tabelle, in welcher der name-Wert "organization" lautet. Dies löst das Löschen aller Datensätze in der RecycleBinConfig-Tabelle aus und deaktiviert den Papierkorb für die Umgebung.

Wichtig

Versuchen Sie nicht, andere einzelne Datensätze zu löschen. Es ist wichtig, dass Dataverse dies erledigt.

Die Wiederherstellung von durch benutzerdefinierte Geschäftslogik gelöschten Datensätzen verwalten

Dataverse bietet einen Mechanismus zum Verwalten gewünschter Aktionen für verknüpfte Datensätze, wenn eine Zeile gelöscht wird. Diese Konfigurationsdaten gehören zur Definition der Beziehung. Wenn ein verknüpfter Datensatz gelöscht wird, können Sie vier mögliche Verhaltensweisen konfigurieren:

Löschen-Verhalten	Eigenschaft
Alle kaskadieren	Die verknüpften Datensätze werden gelöscht.
Link entfernen	Die Suchspalten für den gelöschten Datensatz werden auf Null gesetzt.
Nicht kaskadieren	Auf die zugehörigen Datensätze werden keine Änderungen angewendet. (Nur intern)
Einschränken	Dataverse verhindert das Löschen des Datensatzes, um die Datenintegrität aufrechtzuerhalten. Der Datensatz kann nicht gelöscht werden, es sei denn, es sind keine Datensätze mehr mit dieser Beziehung verknüpft.

Weitere Informationen zu Beziehungsverhalten

Es gibt nichts zu tun, wenn die Beziehung als Alle kaskadieren, Link entfernen und Beschränken konfiguriert ist, weil Dataverse sich um diese Verhaltensweisen kümmert.

Wenn Sie eine Beziehung konfiguriert haben, die das Verhalten Link entfernen verwenden soll, diese Beziehung aber den zugehörigen Datensatz löschen soll, verfügen Sie über eine benutzerdefinierte Logik, die benutzerdefiniertes Verhalten anwendet. Angenommen, Sie möchten auf dieses Verhalten anders reagieren und Ihr eigenes Verhalten Einige kaskadieren basierend auf von Ihnen festgelegten Regeln umsetzen. Sie können beispielsweise inaktive Datensätze oder Datensätze löschen, die innerhalb eines bestimmten Zeitraums nicht aktualisiert wurden. Diese Logik wird normalerweise mithilfe eines Plug-Ins implementiert, kann aber auch mithilfe des Microsoft Dataverse-Connectors: „Wenn eine Zeile hinzugefügt, geändert oder gelöscht wird“-Trigger über Power Automate erfolgen.

Wenn Sie über diese Art benutzerdefinierter Geschäftslogik verfügen, weiß Dataverse nichts davon und kann Ihre Logik nicht automatisch „rückgängig machen“. Sie können jedoch ein anderes Plug-In für die Restore-Nachricht registrieren, um Ihre benutzerdefinierte Logik umzukehren. Oder Sie könnten Power Automate und den Microsoft Dataverse-Connector: „Bei einer ausgeführten Aktion“-Trigger verwenden

Wichtig

Achten Sie auf den Kontext, wenn Sie Plug-In-Schritte für die Restore-Nachricht registrieren. Der wiederherzustellende Datensatz ist in der PreOperation-Phase nicht verfügbar. Wenn verknüpfte Datensätze erstellt werden müssen, verwenden Sie die PostOperation-Phase. Weitere Informationen zu Plug-In-Phasen.

Die InputParameters und OutputParameters der Restore-Nachricht ähneln der Create-Nachricht. Daher können Plug-Ins, die für die Registrierung für die Create-Nachricht geschrieben wurden, mit weniger Änderungen für die Restore-Nachricht wiederverwendet werden.

Tabellen, die derzeit nicht für den Papierkorb unterstützt werden

Die folgenden Tabellen sind das Ergebnis der Abfrage unter Herausfinden, bei welchen Tabellen der Papierkorb nicht aktiviert ist im Mai 2024, als dieses Feature in die Vorschau ging. Private Tabellen sind in dieser Liste nicht enthalten.

aaduser
aicopilot
aiplugin
aipluginconversationstartermapping
aipluginexternalschemaproperty
aipluginoperation
aipluginoperationresponsetemplate
annualfiscalcalendar
appaction_appactionrule_classicrules
appactionrule
appconfig
application
applicationuser
applicationuserrole
appmodulecomponent
appnotification
asyncoperation
attributeimageconfig
backgroundoperation
bot_botcomponent
bot_environmentvariabledefinition
botcomponent_aipluginoperation
botcomponent_connectionreference
botcomponent_environmentvariabledefinition
botcomponent_workflow
bulkdeletefailure
businessunit
callbackregistration
card
cardstateitem
catalogassignment
columnmapping
componentversion
componentversionnrddatasource
connectionreference
connectionroleassociation
copilotexamplequestion
copilotsynonyms
customapi
customapiresponseproperty
customcontroldefaultconfig
datalakefolder
datalakeworkspace
dataprocessingconfiguration
desktopflowbinary
displaystring
duplicaterulecondition
dvfilesearchattribute
dvtablesearch
dvtablesearchentity
entity
entitydataprovider
entityindex
entityrecordfilter
environmentvariabledefinition
eventexpanderbreadcrumb
expiredprocess
fabricaiskill
fieldpermission
fixedmonthlyfiscalcalendar
flowlog
flowmachinegroup
flowmachineimageversion
flowrun
goal
importentitymapping
importjob
importmap
interactionforemail
kbarticletemplate
lookupmapping
mainfewshot
managedproperty
metadataforarchival
mobileofflineprofileitem
mobileofflineprofileitemfilter
msdyn_aiconfiguration
msdyn_aitemplate
msdyn_componentlayer
msdyn_connectordatasource
msdyn_dataflow_datalakefolder
msdyn_dataflowtemplate
msdyn_dmsrequest
msdyn_entitylinkchatconfiguration
msdyn_insightsstorevirtualentity
msdyn_knowledgemanagementsetting
msdyn_mobileapp
msdyn_nonrelationalds
msdyn_pmanalysishistory
msdyn_pmcalendar
msdyn_pminferredtask
msdyn_pmprocesstemplate
msdyn_pmprocessversion
msdyn_pmtemplate
msdyn_salesforcestructuredobject
msdyn_schedule
msdyn_solutioncomponentcountdatasource
msdyn_solutioncomponentdatasource
msdyn_solutionhistory
msdyn_timelinepin
msdyn_workflowactionstatus
mspp_columnpermission
mspp_contentsnippet
mspp_entityformmetadata
mspp_entitypermission
mspp_pollplacement
mspp_publishingstate
mspp_redirect
mspp_sitemarker
mspp_webfile
mspp_webformmetadata
mspp_weblink
mspp_webpage
mspp_webrole
mspp_websiteaccess
mspp_webtemplate
newprocess
optionset
picklistmapping
pluginpackage
plugintype
powerbidataset
powerbireport
powerpagecomponent
powerpagesite
powerpageslog
principalentitymap
privilegesremovalsetting
processtrigger
publisheraddress
queue
recentlyused
recurringappointmentmaster
relationship
report
retaineddataexcel
ribbonmetadatatoprocess
roleeditorlayout
roletemplate
runtimedependency
savedqueryvisualization
sdkmessagefilter
sdkmessageprocessingstepimage
searchtelemetry
serviceendpoint
serviceplanappmodules
serviceplanmapping
sharedworkspaceaccesstoken
sharepointsite
sitemap
slaitem
solutioncomponent
solutioncomponentbatchconfiguration
solutioncomponentrelationshipconfiguration
subscriptionstatisticsoffline
synapsedatabase
synapselinkprofileentity
syncerror
systemuser
systemuserprofiles
teammobileofflineprofilemembership
teamroles
template
tracelog
transformationparametermapping
userform
userquery
virtualentitymetadata
webwizard
workflowbinary
workflowlog
workqueueitem

activityfileattachment
aicopilot_aiplugin
aipluginconversationstarter
aipluginexternalschema
aiplugininstance
aipluginoperationparameter
aiplugintitle
appaction
appactionmigration
appactionrule_webresource_scripts
appconfiginstance
applicationroles
applicationuserprofile
appmodule
appmoduleroles
appointment
attribute
attributemaskingrule
bot
bot_botcomponentcollection
botcomponent
botcomponent_botcomponent
botcomponent_dvtablesearch
botcomponent_msdyn_aimodel
botcomponentcollection
bulkdeleteoperation
calendar
canvasapp
cardentityconnections
catalog
channelaccessprofileentityaccesslevel
complexcontrol
componentversiondatasource
connectioninstance
connectionrole
connector
copilotglossaryterm
credential
customapirequestparameter
customcontrol
customcontrolresource
datalakefolderpermission
datalakeworkspacepermission
dependency
desktopflowmodule
duplicaterule
dvfilesearch
dvfilesearchentity
dvtablesearchattribute
elasticfileattachment
entityanalyticsconfig
entityimageconfig
entitykey
entityrelationship
environmentvariablevalue
exchangesyncidmapping
exportedexcel
featurecontrolsetting
fieldsecurityprofile
flowcredentialapplication
flowmachine
flowmachineimage
flowmachinenetwork
fxexpression
import
importfile
importlog
indexattributes
invaliddependency
keyvaultreference
mailmergetemplate
managedidentity
maskingrule
mobileofflineprofile
mobileofflineprofileitemassociation
monthlyfiscalcalendar
msdyn_aimodel
msdyn_appinsightsmetadata
msdyn_componentlayerdatasource
msdyn_dataflow
msdyn_dataflowconnectionreference
msdyn_datalakeds
msdyn_dmsrequeststatus
msdyn_helppage
msdyn_knowledgeassetconfiguration
msdyn_knowledgesearchfilter
msdyn_modulerundetail
msdyn_odatav4ds
msdyn_pmbusinessruleautomationconfig
msdyn_pmcalendarversion
msdyn_pmprocessextendedmetadataversion
msdyn_pmprocessusersettings
msdyn_pmrecording
msdyn_pmview
msdyn_salesforcestructuredqnaconfig
msdyn_slakpi
msdyn_solutioncomponentcountsummary
msdyn_solutioncomponentsummary
msdyn_solutionhistorydatasource
msdyn_tour
mspp_adplacement
mspp_columnpermissionprofile
mspp_entityform
mspp_entitylist
mspp_pagetemplate
mspp_powerpagescoreentityds
mspp_publishingstatetransitionrule
mspp_shortcut
mspp_sitesetting
mspp_webform
mspp_webformstep
mspp_weblinkset
mspp_webpageaccesscontrolrule
mspp_website
mspp_websitelanguage
navigationsetting
nlsqregistration
ownermapping
pluginassembly
plugintracelog
position
powerbimashupparameter
powerfxrule
powerpagecomponent_powerpagecomponent
powerpagesitelanguage
principalentitybusinessunitmap
privilege
processstage
publisher
quarterlyfiscalcalendar
queuemembership
recordfilter
recyclebinconfig
relationshipattribute
reportcategory
retentionconfig
role
roleprivileges
roletemplateprivileges
savedquery
sdkmessage
sdkmessageprocessingstep
searchresultscache
semiannualfiscalcalendar
serviceplan
serviceplancustomcontrol
sharedlinksetting
sharedworkspacenr
similarityrule
sla
solution
solutioncomponentattributeconfiguration
solutioncomponentconfiguration
solutionhistorydata
subscriptionsyncentryoffline
synapselinkprofile
synapselinkschedule
systemform
systemuserauthorizationchangetracker
systemuserroles
teamprofiles
teamtemplate
textanalyticsentitymapping
transformationmapping
translationprocess
usermobileofflineprofilemembership
userqueryvisualization
webresource
workflow
workflowcardconnections
workqueue

Siehe auch

Gelöschte Microsoft Dataverse-Tabellendatensätze wiederherstellen (Vorschauversion)

Freigeben über

Gelöschte Datensätze mit Code wiederherstellen (Vorschauversion)

Gelöschte Datensätze, die wiederhergestellt werden können, abrufen

Einen gelöschten Datensatz wiederherstellen

Beispiel mit früher Bindung

Beispiel mit später Bindung

Jeden Datensatztyp wiederherstellen, ohne die Spaltenwerte zu überschreiben

Einen Datensatz wiederherstellen und Spaltenwerte überschreiben

Bewährte Methoden für die Wiederherstellung von Datensätzen

Beim Erstellen von Datensätzen keine Primärschlüsselwerte angeben

Datensätze mit übereinstimmenden Alternativschlüsselwerten blockieren die Wiederherstellung

Datensätze mit entfernten Auswahloptionen werden nicht wiederhergestellt

Primärschlüsselverstoß beim Löschen

Herausfinden, bei welchen Tabellen der Papierkorb aktiviert ist

Herausfinden, bei welchen Tabellen der Papierkorb nicht aktiviert ist

Die Konfiguration des automatischen Bereinigungszeitraums für den Papierkorb abrufen und festlegen

Papierkorb für eine Tabelle deaktivieren

Papierkorb für die Umgebung deaktivieren

Die Wiederherstellung von durch benutzerdefinierte Geschäftslogik gelöschten Datensätzen verwalten

Tabellen, die derzeit nicht für den Papierkorb unterstützt werden

Siehe auch

Zusätzliche Ressourcen

Freigeben über

Gelöschte Datensätze mit Code wiederherstellen (Vorschauversion)

Gelöschte Datensätze, die wiederhergestellt werden können, abrufen

Einen gelöschten Datensatz wiederherstellen

Beispiel mit früher Bindung

Beispiel mit später Bindung

Bewährte Methoden für die Wiederherstellung von Datensätzen

Wiederherstellen verknüpfter Datensätze vor Wiederherstellung des primären Datensatzes

Beim Erstellen von Datensätzen keine Primärschlüsselwerte angeben

Datensätze mit übereinstimmenden Alternativschlüsselwerten blockieren die Wiederherstellung

Datensätze mit entfernten Auswahloptionen werden nicht wiederhergestellt

Primärschlüsselverstoß beim Löschen

Herausfinden, bei welchen Tabellen der Papierkorb aktiviert ist

Herausfinden, bei welchen Tabellen der Papierkorb nicht aktiviert ist

Die Konfiguration des automatischen Bereinigungszeitraums für den Papierkorb abrufen und festlegen

Papierkorb für eine Tabelle deaktivieren

Papierkorb für die Umgebung deaktivieren

Die Wiederherstellung von durch benutzerdefinierte Geschäftslogik gelöschten Datensätzen verwalten

Tabellen, die derzeit nicht für den Papierkorb unterstützt werden

Siehe auch

Zusätzliche Ressourcen